@leta-io/components 0.1.0 → 0.2.0

package/README.md

@@ -30,11 +30,23 @@ and load order decides the winner.
 React 18 or 19. `leaflet` and `lottie-web` are required only if you use the map
 or loading-overlay components.
 
-## Notes
+## Bundle size
 
-- The package entry is a barrel. Importing from it pulls in the whole library,
-  including Leaflet and Lottie; import the component's own path if bundle size
-  matters.
+Import what you need from the package root — the barrel tree-shakes. Every
+component factory carries a `/* @__PURE__ */` annotation, so a bundler drops the
+ones you never reference. Measured on an app importing only `Badge` and `Title`:
+1.69 MB → 565 KB raw, 739 KB → 175 KB gzip.
+
+There are no per-component subpaths, and you don't need them.
+
+Two caveats worth knowing:
+
+- **Icons are all-or-nothing.** Components take an icon as a name string
+  (`leadingIcon="Check"`), so any component that can show one needs the whole
+  registry available — about 327 KB, and most of what remains above. Nothing you
+  can do at the import site changes that.
+- **Leaflet and Lottie are already lazy.** They load only when `MapView` or
+  `LoadingOverlay` actually renders, so they never touch your initial bundle.
 - Components never hardcode colours or sizes — every value resolves to a token
   from `@leta-io/design-tokens`.