Upgrading
Upgrade and migrate flag imports
Retain native SVG and source semantics when adopting the docs.
Move from a flag icon set
A Hata import gives SVG text at its original proportions, not a CSS class or a universally square flag. Decide whether you need a whole flag, an adapted drawing or an explicit crop. Preserve author/licence metadata rather than applying the package licence to every image. Keep language labels and status/variant choices explicit. Major-version CDN pins are independent from package-manager locks; update asset and JavaScript versions together when intentionally upgrading.