@validationcloud/fractal-ui 1.77.0 → 1.79.0

package/README.md

@@ -23,6 +23,26 @@ Add styles to your global stylesheet (requires Tailwind 4):
 @import '@validationcloud/fractal-ui/tailwind.css';
 ```
 
+## ECharts Maps
+
+The package bundles GeoJSON maps (world, continents, regions, and per-continent breakdowns) and lazy-loads them automatically when you use `EChartsRenderer` with `type: 'map'`. Import map utilities from `@validationcloud/fractal-ui/charts`. Install `echarts` as a peer dependency.
+
+A machine-readable catalog of all available maps, their descriptions, and region names is published at `@validationcloud/fractal-ui/maps.json`. From non-JS environments you can fetch it directly from unpkg:
+
+```sh
+curl -L https://unpkg.com/@validationcloud/fractal-ui/dist/maps.json
+```
+
+## Adding A New Map
+
+To add another generated map to this package:
+
+1. Add a new `MapDefinition` entry in `scripts/generate-maps.ts` with a `fileName`, `description`, and `buildRegions` implementation.
+2. Update `src/components/echarts-renderer/register-map.ts` so the new map name points at its generated GeoJSON file.
+3. Update `src/components/echarts-renderer/natural-earth-projection.ts` if the new map needs world-style projection handling or custom Lambert parameters.
+4. Run `pnpm generate:maps` to regenerate the GeoJSON assets, map centers, map styles, and `src/maps.json`.
+5. Add or update a Storybook example so the new map can be verified visually.
+
 ## Development
 
 Requires Node.js 22.14.0+ and pnpm.

package/dist/charts.d.ts

@@ -8,3 +8,5 @@ export { hasHorizontalBars } from './components/echarts-renderer/detect-horizont
 export { sanitizeChartOptionsForStaticRendering } from './components/echarts-renderer/sanitize-chart-options-for-static-rendering';
 export { FormatterToken, isFormatterToken } from './components/echarts-renderer/formatters/formatter-tokens';
 export { replaceFormatterTokens } from './components/echarts-renderer/formatters/replace-formatter-tokens';
+export { createLambertProjection, createMapProjection, createNaturalEarthProjection, naturalEarthProjection, } from './components/echarts-renderer/natural-earth-projection';
+export { MAP_ITEM_STYLE, MAP_EMPHASIS_ITEM_STYLE, MAP_VISUAL_MAP_COLORS, } from './components/echarts-renderer/map-style';

package/dist/charts.js

@@ -1,26 +1,35 @@
 import { EChartsRenderer as e } from "./components/echarts-renderer/echarts-renderer.js";
 import { isChartTheme as a } from "./components/echarts-renderer/chart-theme.js";
-import { EChartsChartOption as p, isEChartsChartOption as s } from "./components/echarts-renderer/echarts-chart-option.js";
-import { useChartInstance as n } from "./components/echarts-renderer/use-chart-instance.js";
-import { MavrikChart as f } from "./components/echarts-renderer/mavrik-chart.js";
-import { MAVRIK_THEME as C, MAVRIK_THEME_HORIZONTAL as T, selectMavrikTheme as E } from "./components/echarts-renderer/mavrik-theme.js";
-import { hasHorizontalBars as k } from "./components/echarts-renderer/detect-horizontal-bars.js";
-import { sanitizeChartOptionsForStaticRendering as R } from "./components/echarts-renderer/sanitize-chart-options-for-static-rendering.js";
-import { FormatterToken as F, isFormatterToken as H } from "./components/echarts-renderer/formatters/formatter-tokens.js";
-import { replaceFormatterTokens as l } from "./components/echarts-renderer/formatters/replace-formatter-tokens.js";
+import { EChartsChartOption as n, isEChartsChartOption as i } from "./components/echarts-renderer/echarts-chart-option.js";
+import { useChartInstance as h } from "./components/echarts-renderer/use-chart-instance.js";
+import { MavrikChart as E } from "./components/echarts-renderer/mavrik-chart.js";
+import { MAVRIK_THEME as f, MAVRIK_THEME_HORIZONTAL as x, selectMavrikTheme as T } from "./components/echarts-renderer/mavrik-theme.js";
+import { hasHorizontalBars as _ } from "./components/echarts-renderer/detect-horizontal-bars.js";
+import { sanitizeChartOptionsForStaticRendering as A } from "./components/echarts-renderer/sanitize-chart-options-for-static-rendering.js";
+import { FormatterToken as I, isFormatterToken as O } from "./components/echarts-renderer/formatters/formatter-tokens.js";
+import { replaceFormatterTokens as L } from "./components/echarts-renderer/formatters/replace-formatter-tokens.js";
+import { createLambertProjection as k, createMapProjection as l, createNaturalEarthProjection as H, naturalEarthProjection as j } from "./components/echarts-renderer/natural-earth-projection.js";
+import { MAP_EMPHASIS_ITEM_STYLE as u, MAP_ITEM_STYLE as V, MAP_VISUAL_MAP_COLORS as d } from "./components/echarts-renderer/map-style.js";
 export {
-  p as EChartsChartOption,
+  n as EChartsChartOption,
   e as EChartsRenderer,
-  F as FormatterToken,
-  C as MAVRIK_THEME,
-  T as MAVRIK_THEME_HORIZONTAL,
-  f as MavrikChart,
-  k as hasHorizontalBars,
+  I as FormatterToken,
+  u as MAP_EMPHASIS_ITEM_STYLE,
+  V as MAP_ITEM_STYLE,
+  d as MAP_VISUAL_MAP_COLORS,
+  f as MAVRIK_THEME,
+  x as MAVRIK_THEME_HORIZONTAL,
+  E as MavrikChart,
+  k as createLambertProjection,
+  l as createMapProjection,
+  H as createNaturalEarthProjection,
+  _ as hasHorizontalBars,
   a as isChartTheme,
-  s as isEChartsChartOption,
-  H as isFormatterToken,
-  l as replaceFormatterTokens,
-  R as sanitizeChartOptionsForStaticRendering,
-  E as selectMavrikTheme,
-  n as useChartInstance
+  i as isEChartsChartOption,
+  O as isFormatterToken,
+  j as naturalEarthProjection,
+  L as replaceFormatterTokens,
+  A as sanitizeChartOptionsForStaticRendering,
+  T as selectMavrikTheme,
+  h as useChartInstance
 };

package/dist/components/dropdown-menu/dropdown-menu.js

@@ -31,34 +31,42 @@ function w({
 }) {
   return /* @__PURE__ */ u(t.Root, { ...c, children: [
     /* @__PURE__ */ e(t.Trigger, { className: s("", a), asChild: !0, disabled: d, children: o }),
-    /* @__PURE__ */ e(t.Portal, { children: /* @__PURE__ */ e(n.Root, { type: "hover", style: { "--scrollbar-size": "10px" }, asChild: !0, children: /* @__PURE__ */ u(
-      t.Content,
+    /* @__PURE__ */ e(t.Portal, { children: /* @__PURE__ */ e(
+      n.Root,
       {
-        onCloseAutoFocus: (h) => {
-          h.preventDefault();
-        },
-        className: s(
-          "max-h-(--radix-dropdown-menu-content-available-height) overflow-hidden rounded-lg shadow-[0px_8px_20px_2px_rgba(0,0,0,0.40)]",
-          r === "bg-neutral-60" && "bg-neutral-60",
-          r === "bg-neutral-80" && "bg-neutral-80",
-          i
-        ),
-        align: "end",
-        sideOffset: 8,
-        collisionPadding: 8,
-        children: [
-          /* @__PURE__ */ e(n.Viewport, { className: "max-h-(--radix-dropdown-menu-content-available-height) p-1", children: l }),
-          /* @__PURE__ */ e(
-            n.Scrollbar,
-            {
-              className: "hover:bg-neutral-60 flex w-(--scrollbar-size) touch-none px-0.5 py-4 transition-all select-none hover:px-0",
-              orientation: "vertical",
-              children: /* @__PURE__ */ e(n.Thumb, { className: "bg-neutral-10/50 hover:bg-neutral-10 flex-1 rounded-(--scrollbar-size) transition-colors" })
-            }
-          )
-        ]
+        type: "hover",
+        style: { "--scrollbar-size": "10px" },
+        asChild: !0,
+        children: /* @__PURE__ */ u(
+          t.Content,
+          {
+            onCloseAutoFocus: (h) => {
+              h.preventDefault();
+            },
+            className: s(
+              "max-h-(--radix-dropdown-menu-content-available-height) overflow-hidden rounded-lg shadow-[0px_8px_20px_2px_rgba(0,0,0,0.40)]",
+              r === "bg-neutral-60" && "bg-neutral-60",
+              r === "bg-neutral-80" && "bg-neutral-80",
+              i
+            ),
+            align: "end",
+            sideOffset: 8,
+            collisionPadding: 8,
+            children: [
+              /* @__PURE__ */ e(n.Viewport, { className: "max-h-(--radix-dropdown-menu-content-available-height) p-1", children: l }),
+              /* @__PURE__ */ e(
+                n.Scrollbar,
+                {
+                  className: "hover:bg-neutral-60 flex w-(--scrollbar-size) touch-none px-0.5 py-4 transition-all select-none hover:px-0",
+                  orientation: "vertical",
+                  children: /* @__PURE__ */ e(n.Thumb, { className: "bg-neutral-10/50 hover:bg-neutral-10 flex-1 rounded-(--scrollbar-size) transition-colors" })
+                }
+              )
+            ]
+          }
+        )
       }
-    ) }) })
+    ) })
   ] });
 }
 export {