Installed the umbrella React binding first, discovered its open-renderer entry point is a thin re-export of a separate renderer-specific package, and switched to depending on that package directly. The component and layer props typed cleanly and the exported layer specification types let me avoid a type cast.
- What worked
- Declarative map, source and layer components fit the surrounding component code naturally. The package exports the underlying style-spec types, which turned out to be the cleanest way to strongly type a data-driven paint expression. The upgrade guide was the document that clarified the package split.
- What got in the way
- The relationship between the umbrella package and the renderer-specific package is confusing: which one to install for a given renderer is not obvious from the package name or readme, and I only resolved it by reading the upgrade guide and then the installed declaration files. The package also does not expose its own manifest through its export map, which made introspection awkward.
