[Studio] Fix blank unit selection for the static Quantity Value transformer

[ValeriaMaltseva]

Problem

The unit select of the Quantity Value transformer is always empty when Unit source is set to
Static.

Fixes pimcore/platform-version#148 on 2026.x.

Root cause

UnitDataResponse documented its list under the OpenAPI property name UnitList, while the
serializer emits the actual property name — unitList:

{"unitList":[{"unitId":"kg","abbreviation":"kg"}],"additionalAttributes":[]}

The generated API client therefore typed the response as UnitList, and
quantity-value-transformer-form.tsx read unitData?.UnitList, which was always undefined →
empty option list → blank select.

The schema annotation was already corrected to unitList in 307aeb9, but the committed OpenAPI
snapshot and the generated client on 2026.x still carry the old name — so the type checker agrees
with the broken access and never flags it.

Change

Two commits, cherry-picked from #682 so both lines carry byte-identical content:

1. The fix
   • assets/studio/build/api/docs.jsonopenapi.json — snapshot property UnitList → unitList
   • data-importer-api-slice.gen.ts — regenerated via npm run build-api-client
   • quantity-value-transformer-form.tsx — reads unitData?.unitList
   • tests/unit/UnitDataResponseTest.php — regression test: the documented OpenAPI property name
     must match the key the serializer actually emits
2. Snapshot property metadata refresh — the committed snapshot predated several #[Property]
   annotations, so the client carried no descriptions for currentConfig.label and
   userPermissions.update/delete, and typed dataPreview.data as any.

Only the seven BundleDataImporter* schemas are touched. The snapshot keeps its existing 403 paths,
369 components and info.version: 0.13.20 — verified by structural comparison, changed paths: [].

CalculateTransformationResultTypeParameters::$currentConfig documents dataSourceIndex items as
integer, which contradicts both the frontend (dataSourceIndex?: string[] in types.ts and
throughout the advanced mapping modal) and the bundle's own ColumnHeadersResponse, where id and
dataIndex are string. That one property is deliberately left un-refreshed so dataSourceIndex
stays any until the annotation itself is corrected.

Verification

• npm run check-types — 7 errors on this branch, the same 7 as on origin/2026.x
  (colorFillAdditional / colorFillActive missing on FullToken, in *.styles.tsx files this PR
  does not touch). No new errors.
• npm run lint — the same 7 pre-existing no-unsafe-argument errors in those same style files.
  Nothing in the four changed files.
• Negative test: with the snapshot and client fixed but quantity-value-transformer-form.tsx left
  reading UnitList, check-types fails exactly at the bug site —
  Property 'UnitList' does not exist on type 'BundleDataImporterUnitDataResponse'. Did you mean 'unitList'?
  So the type checker now guards this.
• The Codeception suite was not run locally (vendor/ is not installed in this workspace; it
  needs the Docker test env + product-registration credentials) — CI validates it.
• No frontend build artifact is committed; the "Studio Frontend Build" workflow regenerates it.

Manual test

Data Importer config → mapping to a Quantity Value field → add the Quantity Value transformer →
set Unit source to Static → the Unit select lists all quantity-value units and is searchable.

Note for consumers

Anyone who worked around this by renaming unitList back to UnitList in the response (see the
issue comment) must drop that workaround.

Additional schema fixes forward-merged from #682

#682 (2026.2 line) had two more schema-type bugs surface after its own snapshot refresh, both from
the same 307aeb9 PR that this description already calls out for dataSourceIndex:

1. dataSourceIndex typed as integer — this PR's own snapshot refresh left it deliberately
   un-refreshed (see above), so it never broke here, but the underlying PHP annotation in
   CalculateTransformationResultTypeParameters.php was still wrong. Corrected to string,
   matching ColumnHeadersResponse and every frontend caller.
2. dataPreview[].data typed as string — PreviewData::getDataPreview() forwards interpreter
   values unchanged, and JsonFileInterpreter reads straight from json_decode, so a cell can be a
   string, number, boolean, array, object, or null. Three frontend call sites already worked around
   the incorrect narrowing (normalize-data-row.ts, preview-import-step.tsx,
   use-preview-record-query.ts). Reverted to unconstrained (no type key = arbitrary JSON value),
   matching the schema's original pre-307aeb9 shape.

Both PHP annotations were corrected, and docs.jsonopenapi.json was refreshed fresh from
https://feature.nightly.pimcore.app/pimcore-studio/api/docs/json?locale=en (2026.x's own nightly
instance — already reflects the unitList casing fix, but not these two, since neither PHP fix has
been merged/deployed there yet). Same caveat as #682: a plain re-fetch from that URL before this
merges will silently reintroduce both bugs; re-apply the corrections if that happens.

Relationship to #682

#682 carries the identical change against 2026.2 and is still open. This PR lands it directly on
2026.x as requested. Because the two branches were byte-identical in all affected paths and this is
a clean cherry-pick, the later 2026.2 → 2026.x forward merge resolves to the same content — if it
conflicts at all, either side is correct.

[Copilot]

Pull request overview

Verdict: Needs changes. The unitList fix addresses the root cause at the schema, generated-client, and UI boundaries, and the only frontend caller is updated.

Changes:

• Aligns the OpenAPI snapshot and generated client with serialized unitList.
• Updates the Quantity Value transformer to consume unitList.
• Adds regression tests and refreshes schema metadata.

The upgrade guide already documents the rename. However, the regression test does not validate the stale generated artifacts, and dataPreview.data is incorrectly narrowed to string.

Reviewed changes

Copilot reviewed 11 out of 32 changed files in this pull request and generated 3 comments.

File	Description
assets/studio/build/api/docs.jsonopenapi.json	Refreshes Data Importer OpenAPI schemas.
assets/studio/js/src/modules/data-importer/data-importer-api-slice.gen.ts	Regenerates client types, including unitList.
assets/studio/js/src/modules/data-importer/dynamic-types/transformer/quantity-value/quantity-value-transformer-form.tsx	Reads units from unitData.unitList.
tests/unit/UnitDataResponseTest.php	Adds DTO serialization/schema checks.

---

💡 Configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud

[Copilot]

🟡 Changes recommended

The OpenAPI snapshot contains unreported version drift, and the narrowed dataSourceIndex contract is not documented for consumers.

Once you've addressed the issues Copilot identified, you can request another Copilot review.

Review details

• Files reviewed: 13/34 changed files
• Comments generated: 2
• Review effort level: Balanced