@fusedashlabs/widgets 0.3.1 → 0.4.0

package/dist/components/map-chart/lib/geojson.js

@@ -0,0 +1,47 @@
+const cache = /* @__PURE__ */ new Map();
+function isFeatureCollection(value) {
+  if (!value || typeof value !== "object") return false;
+  const obj = value;
+  return obj.type === "FeatureCollection" && Array.isArray(obj.features);
+}
+async function fetchMapGeoJson(mapType, baseUrl) {
+  const trimmed = baseUrl == null ? void 0 : baseUrl.trim();
+  if (!trimmed || !mapType) return null;
+  const url = `${trimmed.replace(/\/$/, "")}/${geoJsonFileName(mapType)}`;
+  const hit = cache.get(url);
+  if (hit) return hit;
+  const pending = (async () => {
+    try {
+      const res = await fetch(url);
+      if (!res.ok) return null;
+      const json = await res.json();
+      return isFeatureCollection(json) ? json : null;
+    } catch {
+      return null;
+    }
+  })();
+  cache.set(url, pending);
+  return pending;
+}
+function geoJsonFileName(mapType) {
+  switch (mapType) {
+    case "city":
+      return "city.json";
+    case "county":
+      return "county.json";
+    case "state":
+      return "state.json";
+    case "province":
+    case "region":
+      return "province.json";
+    case "country":
+    default:
+      return "country.json";
+  }
+}
+export {
+  fetchMapGeoJson,
+  geoJsonFileName,
+  isFeatureCollection
+};
+//# sourceMappingURL=geojson.js.map

package/dist/components/map-chart/lib/geojson.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"geojson.js","sources":["../../../../src/components/map-chart/lib/geojson.ts"],"sourcesContent":["import type { GeoJsonFeatureCollection } from './types.js';\n\nconst cache = new Map<string, Promise<GeoJsonFeatureCollection | null>>();\n\nexport function isFeatureCollection(value: unknown): value is GeoJsonFeatureCollection {\n  if (!value || typeof value !== 'object') return false;\n  const obj = value as { type?: string; features?: unknown };\n  return obj.type === 'FeatureCollection' && Array.isArray(obj.features);\n}\n\nexport async function fetchMapGeoJson(\n  mapType: string,\n  baseUrl?: string,\n): Promise<GeoJsonFeatureCollection | null> {\n  const trimmed = baseUrl?.trim();\n  if (!trimmed || !mapType) return null;\n  const url = `${trimmed.replace(/\\/$/, '')}/${geoJsonFileName(mapType)}`;\n  const hit = cache.get(url);\n  if (hit) return hit;\n\n  const pending = (async () => {\n    try {\n      const res = await fetch(url);\n      if (!res.ok) return null;\n      const json: unknown = await res.json();\n      return isFeatureCollection(json) ? json : null;\n    } catch {\n      return null;\n    }\n  })();\n  cache.set(url, pending);\n  return pending;\n}\n\nexport function geoJsonFileName(mapType: string): string {\n  switch (mapType) {\n    case 'city':\n      return 'city.json';\n    case 'county':\n      return 'county.json';\n    case 'state':\n      return 'state.json';\n    case 'province':\n    case 'region':\n      return 'province.json';\n    case 'country':\n    default:\n      return 'country.json';\n  }\n}\n"],"names":[],"mappings":"AAEA,MAAM,4BAAY,IAAA;AAEX,SAAS,oBAAoB,OAAmD;AACrF,MAAI,CAAC,SAAS,OAAO,UAAU,SAAU,QAAO;AAChD,QAAM,MAAM;AACZ,SAAO,IAAI,SAAS,uBAAuB,MAAM,QAAQ,IAAI,QAAQ;AACvE;AAEA,eAAsB,gBACpB,SACA,SAC0C;AAC1C,QAAM,UAAU,mCAAS;AACzB,MAAI,CAAC,WAAW,CAAC,QAAS,QAAO;AACjC,QAAM,MAAM,GAAG,QAAQ,QAAQ,OAAO,EAAE,CAAC,IAAI,gBAAgB,OAAO,CAAC;AACrE,QAAM,MAAM,MAAM,IAAI,GAAG;AACzB,MAAI,IAAK,QAAO;AAEhB,QAAM,WAAW,YAAY;AAC3B,QAAI;AACF,YAAM,MAAM,MAAM,MAAM,GAAG;AAC3B,UAAI,CAAC,IAAI,GAAI,QAAO;AACpB,YAAM,OAAgB,MAAM,IAAI,KAAA;AAChC,aAAO,oBAAoB,IAAI,IAAI,OAAO;AAAA,IAC5C,QAAQ;AACN,aAAO;AAAA,IACT;AAAA,EACF,GAAA;AACA,QAAM,IAAI,KAAK,OAAO;AACtB,SAAO;AACT;AAEO,SAAS,gBAAgB,SAAyB;AACvD,UAAQ,SAAA;AAAA,IACN,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AAAA,IACL,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AAAA,IACL;AACE,aAAO;AAAA,EAAA;AAEb;"}

package/dist/components/map-chart/lib/index.d.ts

@@ -0,0 +1,13 @@
+export { COUNTRY_SYNONYMS, DEFAULT_BUBBLES_RADIUS, DEFAULT_SPIKE_SIZES, GEOJSON_KEYS, LAYER_ORDER, MAP_ADMIN_TYPES, MAP_STYLES, MAPBOX_CSS_HREF, MAX_COLOR_RANGE, sanitizeId, sanitizeKey, } from './constants.js';
+export { collectionBBox, colorForValue, featureBBox, featureCenter, generateColorRanges, rangesFromPaletteStops, valuesOfRows, } from './domain.js';
+export { darkenColor, formatMapValue, formatRangeLabel, hexToRgba, numericValue } from './format.js';
+export { createFeaturesIndex, getRegionId, getRegionIdFromFeatureProperties, inferMapTypeFromKeyNames, normalizeDataValue, } from './geo-index.js';
+export { fetchMapGeoJson, geoJsonFileName, isFeatureCollection } from './geojson.js';
+export { isMapVisualisation, joinLayerFeatures, joinModelLayers, orderedLayers } from './join.js';
+export { clampLayerSlider, defaultLayerSlider, featuresForYear, featuresInSliderRange, formatAverage, formatFieldLabel, formatLegendBucket, legendLayerOrder, layerAverage, legendSpikeHeight, MUTED_LEGEND_FILL, rangeTrackOffset, slideThumb, sliderIndexFromPointer, sliderValueWindow, thumbTrackPercent, } from './legend.js';
+export type { LayerSlider } from './legend.js';
+export { normalizeMapData } from './normalize.js';
+export { choroplethPmtilesSource, featuresHavePolygonGeometry, getPmtilesConfig, PMTILES_CONFIG, resolvePmtilesUrl, } from './pmtiles.js';
+export type { PmtilesLayerConfig } from './pmtiles.js';
+export type { ColorRange, FeaturesIndex, GeoJsonFeature, GeoJsonFeatureCollection, MapChartInput, MapHoverEntry, MapLayerModel, MapModel, MapRow, MapVisualisation, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/map-chart/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/map-chart/lib/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,sBAAsB,EACtB,mBAAmB,EACnB,YAAY,EACZ,WAAW,EACX,eAAe,EACf,UAAU,EACV,eAAe,EACf,eAAe,EACf,UAAU,EACV,WAAW,GACZ,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,cAAc,EACd,aAAa,EACb,WAAW,EACX,aAAa,EACb,mBAAmB,EACnB,sBAAsB,EACtB,YAAY,GACb,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,gBAAgB,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACrG,OAAO,EACL,mBAAmB,EACnB,WAAW,EACX,gCAAgC,EAChC,wBAAwB,EACxB,kBAAkB,GACnB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACrF,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAClG,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,eAAe,EACf,qBAAqB,EACrB,aAAa,EACb,gBAAgB,EAChB,kBAAkB,EAClB,gBAAgB,EAChB,YAAY,EACZ,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,UAAU,EACV,sBAAsB,EACtB,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EACL,uBAAuB,EACvB,2BAA2B,EAC3B,gBAAgB,EAChB,cAAc,EACd,iBAAiB,GAClB,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AACvD,YAAY,EACV,UAAU,EACV,aAAa,EACb,cAAc,EACd,wBAAwB,EACxB,aAAa,EACb,aAAa,EACb,aAAa,EACb,QAAQ,EACR,MAAM,EACN,gBAAgB,GACjB,MAAM,YAAY,CAAC"}

package/dist/components/map-chart/lib/join.d.ts

@@ -0,0 +1,7 @@
+import { MapVisualisation } from './constants.js';
+import { GeoJsonFeatureCollection, MapLayerModel } from './types.js';
+export declare function joinLayerFeatures(layer: MapLayerModel, collection: GeoJsonFeatureCollection | null | undefined): MapLayerModel;
+export declare function joinModelLayers(layers: MapLayerModel[], geoJsonByType: Record<string, GeoJsonFeatureCollection | undefined>): MapLayerModel[];
+export declare function orderedLayers(layers: MapLayerModel[]): MapLayerModel[];
+export declare function isMapVisualisation(value: string | undefined): value is MapVisualisation;
+//# sourceMappingURL=join.d.ts.map

package/dist/components/map-chart/lib/join.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"join.d.ts","sourceRoot":"","sources":["../../../../src/components/map-chart/lib/join.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwC,KAAK,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAI7F,OAAO,KAAK,EAGV,wBAAwB,EACxB,aAAa,EAEd,MAAM,YAAY,CAAC;AAMpB,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,aAAa,EACpB,UAAU,EAAE,wBAAwB,GAAG,IAAI,GAAG,SAAS,GACtD,aAAa,CAuEf;AAED,wBAAgB,eAAe,CAC7B,MAAM,EAAE,aAAa,EAAE,EACvB,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,wBAAwB,GAAG,SAAS,CAAC,GAClE,aAAa,EAAE,CAEjB;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,aAAa,EAAE,CAKtE;AA2FD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,KAAK,IAAI,gBAAgB,CAEvF"}

package/dist/components/map-chart/lib/join.js

@@ -0,0 +1,156 @@
+import { sanitizeKey, LAYER_ORDER, MAX_SPIKES } from "./constants.js";
+import { colorForValue, featureCenter } from "./domain.js";
+import { numericValue, hexToRgba } from "./format.js";
+import { createFeaturesIndex, getRegionId } from "./geo-index.js";
+function rawRegionValue(row, layer) {
+  return row[layer.geoKey] ?? row[layer.mapType];
+}
+function joinLayerFeatures(layer, collection) {
+  var _a, _b;
+  if (!((_a = collection == null ? void 0 : collection.features) == null ? void 0 : _a.length)) {
+    return { ...layer, features: [], colorById: {}, matchTotal: 0, matchHit: 0 };
+  }
+  const index = createFeaturesIndex(collection.features, layer.mapType);
+  let matchTotal = 0;
+  let matchHit = 0;
+  const features = [];
+  const colorById = {};
+  for (const row of layer.rows) {
+    const raw = rawRegionValue(row, layer);
+    if (Array.isArray(raw)) {
+      const value2 = numericValue(row[layer.valueKey]);
+      if (raw.length < 2) continue;
+      features.push({
+        type: "Feature",
+        properties: { ...row, value: value2, regionId: null, regionName: null },
+        geometry: { type: "Point", coordinates: raw }
+      });
+      continue;
+    }
+    const dataValue = String(raw ?? "").toLowerCase();
+    if (!dataValue) continue;
+    matchTotal += 1;
+    const regionId = getRegionId(dataValue, layer.mapType, index);
+    if (!regionId) continue;
+    matchHit += 1;
+    const regionFeature = index.byId.get(regionId);
+    if (!regionFeature) continue;
+    const value = numericValue(row[layer.valueKey]);
+    const regionName = (typeof row[layer.geoKey] === "string" && row[layer.geoKey] ? String(row[layer.geoKey]) : void 0) ?? (typeof ((_b = regionFeature.properties) == null ? void 0 : _b.name) === "string" ? regionFeature.properties.name : regionId);
+    if (layer.visualisationType === "choropleth") {
+      features.push({
+        ...regionFeature,
+        id: regionId,
+        properties: {
+          ...regionFeature.properties,
+          id: regionId,
+          regionId,
+          value,
+          regionName
+        }
+      });
+      colorById[regionId] = hexToRgba(colorForValue(value, layer.colorRanges), 1);
+      continue;
+    }
+    const center = featureCenter(regionFeature);
+    if (!center) continue;
+    features.push({
+      type: "Feature",
+      properties: { ...row, value, regionId, regionName },
+      geometry: { type: "Point", coordinates: [center.lng, center.lat] }
+    });
+  }
+  const nextFeatures = layer.visualisationType === "spike" ? spikeFeatures(features, layer) : features;
+  return { ...layer, features: nextFeatures, colorById, matchTotal, matchHit };
+}
+function orderedLayers(layers) {
+  return [...layers].sort(
+    (a, b) => (LAYER_ORDER[a.visualisationType] ?? 99) - (LAYER_ORDER[b.visualisationType] ?? 99)
+  );
+}
+function spikeFeatures(features, layer) {
+  const points = features.filter((f) => {
+    var _a;
+    return ((_a = f.geometry) == null ? void 0 : _a.type) === "Point";
+  });
+  if (!points.length) return [];
+  const ranked = [...points].sort(
+    (a, b) => {
+      var _a, _b;
+      return numericValue((_a = b.properties) == null ? void 0 : _a.value) - numericValue((_b = a.properties) == null ? void 0 : _b.value);
+    }
+  );
+  const limited = ranked.slice(0, MAX_SPIKES);
+  const values = limited.map((f) => {
+    var _a;
+    return numericValue((_a = f.properties) == null ? void 0 : _a.value) || 1;
+  });
+  const minValue = Math.min(...values);
+  const maxValue = Math.max(...values);
+  const layerIdClean = sanitizeKey(layer.layerId);
+  return limited.map((feature, index) => {
+    var _a, _b, _c, _d;
+    const value = numericValue((_a = feature.properties) == null ? void 0 : _a.value);
+    const size = spikeSize(value, layer.colorRanges, minValue, maxValue);
+    const regionId = String(((_b = feature.properties) == null ? void 0 : _b.regionId) ?? "");
+    const iconName = `spike-icon-${layerIdClean}_${index}${regionId ? `_${sanitizeKey(regionId)}` : ""}`;
+    const color = layer.fillColor.replace("#", "");
+    const spikeText = typeof ((_c = feature.properties) == null ? void 0 : _c.spikeText) === "string" ? feature.properties.spikeText : typeof ((_d = feature.properties) == null ? void 0 : _d.label) === "string" ? feature.properties.label : void 0;
+    const svgContent = spikeSvg(size, color, spikeText);
+    return {
+      ...feature,
+      properties: {
+        ...feature.properties,
+        size,
+        iconName,
+        svgContent,
+        layerId: layer.layerId
+      }
+    };
+  });
+}
+function spikeSize(value, ranges, minValue, maxValue) {
+  if (ranges.length) {
+    const range = ranges.find((r) => value >= r.start && value <= r.end);
+    if (range == null ? void 0 : range.height) return range.height;
+    if (value < ranges[0].start && ranges[0].height) return ranges[0].height;
+    const last = ranges[ranges.length - 1];
+    if (value > last.end && last.height) return last.height;
+  }
+  if (maxValue === minValue) return 28;
+  const ratio = (value - minValue) / (maxValue - minValue);
+  const heights = [8, 12, 16, 22, 28, 34, 42, 54];
+  return heights[Math.round(ratio * (heights.length - 1))] ?? 28;
+}
+function spikeSvg(size, color, text) {
+  const hex = color.startsWith("#") ? color : `#${color}`;
+  const fill = hexToRgba(hex, 1);
+  const actualHeight = size;
+  const fontSize = 20;
+  const textHeight = fontSize + 8;
+  const gap = 4;
+  const totalHeight = text ? textHeight + gap + actualHeight : actualHeight;
+  const spikeOffsetY = text ? textHeight + gap : 0;
+  const spikeWidth = 30;
+  const svgWidth = text ? Math.max(spikeWidth, text.length * 12 + 10) : spikeWidth;
+  const spikeOffsetX = text ? (svgWidth - spikeWidth) / 2 : 0;
+  const centerX = spikeWidth / 2;
+  const left = centerX - 6;
+  const right = centerX + 6;
+  const top = 0.25;
+  const bottom = actualHeight - 0.75;
+  const textEl = text ? `<text x="${svgWidth / 2}" y="${fontSize + 4}" text-anchor="middle" fill="black" font-size="${fontSize}" font-weight="bold" font-family="Arial, sans-serif" stroke="white" stroke-width="1" paint-order="stroke">${escapeXml(text)}</text>` : "";
+  return `<svg width="${svgWidth}" height="${totalHeight}" viewBox="0 0 ${svgWidth} ${totalHeight}" fill="none" xmlns="http://www.w3.org/2000/svg"><g transform="translate(${spikeOffsetX}, ${spikeOffsetY})"><path d="M${right} ${bottom}L${centerX} ${top}L${left} ${bottom}Z" fill="${fill}"/><path d="M${centerX + 10} ${bottom}H${right + 2}L${centerX} ${top}L${left - 2} ${bottom}H${centerX - 10}" stroke="${fill}" fill="none" stroke-width="1"/></g>${textEl}</svg>`;
+}
+function escapeXml(value) {
+  return value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
+}
+function isMapVisualisation(value) {
+  return value === "choropleth" || value === "bubbles" || value === "spike" || value === "markers";
+}
+export {
+  isMapVisualisation,
+  joinLayerFeatures,
+  orderedLayers
+};
+//# sourceMappingURL=join.js.map

package/dist/components/map-chart/lib/join.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"join.js","sources":["../../../../src/components/map-chart/lib/join.ts"],"sourcesContent":["import { LAYER_ORDER, MAX_SPIKES, sanitizeKey, type MapVisualisation } from './constants.js';\nimport { colorForValue, featureCenter } from './domain.js';\nimport { hexToRgba, numericValue } from './format.js';\nimport { createFeaturesIndex, getRegionId } from './geo-index.js';\nimport type {\n  ColorRange,\n  GeoJsonFeature,\n  GeoJsonFeatureCollection,\n  MapLayerModel,\n  MapRow,\n} from './types.js';\n\nfunction rawRegionValue(row: MapRow, layer: MapLayerModel): unknown {\n  return row[layer.geoKey] ?? row[layer.mapType];\n}\n\nexport function joinLayerFeatures(\n  layer: MapLayerModel,\n  collection: GeoJsonFeatureCollection | null | undefined,\n): MapLayerModel {\n  if (!collection?.features?.length) {\n    return { ...layer, features: [], colorById: {}, matchTotal: 0, matchHit: 0 };\n  }\n\n  const index = createFeaturesIndex(collection.features, layer.mapType);\n  let matchTotal = 0;\n  let matchHit = 0;\n  const features: GeoJsonFeature[] = [];\n  const colorById: Record<string, string> = {};\n\n  for (const row of layer.rows) {\n    const raw = rawRegionValue(row, layer);\n    if (Array.isArray(raw)) {\n      const value = numericValue(row[layer.valueKey]);\n      if (raw.length < 2) continue;\n      features.push({\n        type: 'Feature',\n        properties: { ...row, value, regionId: null, regionName: null },\n        geometry: { type: 'Point', coordinates: raw },\n      });\n      continue;\n    }\n\n    const dataValue = String(raw ?? '').toLowerCase();\n    if (!dataValue) continue;\n    matchTotal += 1;\n    const regionId = getRegionId(dataValue, layer.mapType, index);\n    if (!regionId) continue;\n    matchHit += 1;\n\n    const regionFeature = index.byId.get(regionId);\n    if (!regionFeature) continue;\n    const value = numericValue(row[layer.valueKey]);\n    const regionName =\n      (typeof row[layer.geoKey] === 'string' && row[layer.geoKey]\n        ? String(row[layer.geoKey])\n        : undefined) ??\n      (typeof regionFeature.properties?.name === 'string'\n        ? regionFeature.properties.name\n        : regionId);\n\n    if (layer.visualisationType === 'choropleth') {\n      features.push({\n        ...regionFeature,\n        id: regionId,\n        properties: {\n          ...regionFeature.properties,\n          id: regionId,\n          regionId,\n          value,\n          regionName,\n        },\n      });\n      colorById[regionId] = hexToRgba(colorForValue(value, layer.colorRanges), 1);\n      continue;\n    }\n\n    const center = featureCenter(regionFeature);\n    if (!center) continue;\n    features.push({\n      type: 'Feature',\n      properties: { ...row, value, regionId, regionName },\n      geometry: { type: 'Point', coordinates: [center.lng, center.lat] },\n    });\n  }\n\n  const nextFeatures =\n    layer.visualisationType === 'spike' ? spikeFeatures(features, layer) : features;\n\n  return { ...layer, features: nextFeatures, colorById, matchTotal, matchHit };\n}\n\nexport function joinModelLayers(\n  layers: MapLayerModel[],\n  geoJsonByType: Record<string, GeoJsonFeatureCollection | undefined>,\n): MapLayerModel[] {\n  return layers.map((layer) => joinLayerFeatures(layer, geoJsonByType[layer.mapType]));\n}\n\nexport function orderedLayers(layers: MapLayerModel[]): MapLayerModel[] {\n  return [...layers].sort(\n    (a, b) =>\n      (LAYER_ORDER[a.visualisationType] ?? 99) - (LAYER_ORDER[b.visualisationType] ?? 99),\n  );\n}\n\nfunction spikeFeatures(features: GeoJsonFeature[], layer: MapLayerModel): GeoJsonFeature[] {\n  const points = features.filter((f) => f.geometry?.type === 'Point');\n  if (!points.length) return [];\n  const ranked = [...points].sort(\n    (a, b) => numericValue(b.properties?.value) - numericValue(a.properties?.value),\n  );\n  const limited = ranked.slice(0, MAX_SPIKES);\n  const values = limited.map((f) => numericValue(f.properties?.value) || 1);\n  const minValue = Math.min(...values);\n  const maxValue = Math.max(...values);\n  const layerIdClean = sanitizeKey(layer.layerId);\n\n  return limited.map((feature, index) => {\n    const value = numericValue(feature.properties?.value);\n    const size = spikeSize(value, layer.colorRanges, minValue, maxValue);\n    const regionId = String(feature.properties?.regionId ?? '');\n    const iconName = `spike-icon-${layerIdClean}_${index}${regionId ? `_${sanitizeKey(regionId)}` : ''}`;\n    const color = layer.fillColor.replace('#', '');\n    const spikeText =\n      typeof feature.properties?.spikeText === 'string'\n        ? feature.properties.spikeText\n        : typeof feature.properties?.label === 'string'\n          ? feature.properties.label\n          : undefined;\n    const svgContent = spikeSvg(size, color, spikeText);\n    return {\n      ...feature,\n      properties: {\n        ...feature.properties,\n        size,\n        iconName,\n        svgContent,\n        layerId: layer.layerId,\n      },\n    };\n  });\n}\n\nfunction spikeSize(\n  value: number,\n  ranges: ColorRange[],\n  minValue: number,\n  maxValue: number,\n): number {\n  if (ranges.length) {\n    const range = ranges.find((r) => value >= r.start && value <= r.end);\n    if (range?.height) return range.height;\n    if (value < ranges[0].start && ranges[0].height) return ranges[0].height;\n    const last = ranges[ranges.length - 1];\n    if (value > last.end && last.height) return last.height;\n  }\n  if (maxValue === minValue) return 28;\n  const ratio = (value - minValue) / (maxValue - minValue);\n  const heights = [8, 12, 16, 22, 28, 34, 42, 54];\n  return heights[Math.round(ratio * (heights.length - 1))] ?? 28;\n}\n\nfunction spikeSvg(size: number, color: string, text?: string): string {\n  const hex = color.startsWith('#') ? color : `#${color}`;\n  const fill = hexToRgba(hex, 1);\n  const actualHeight = size;\n  const fontSize = 20;\n  const textHeight = fontSize + 8;\n  const gap = 4;\n  const totalHeight = text ? textHeight + gap + actualHeight : actualHeight;\n  const spikeOffsetY = text ? textHeight + gap : 0;\n  const spikeWidth = 30;\n  const svgWidth = text ? Math.max(spikeWidth, text.length * 12 + 10) : spikeWidth;\n  const spikeOffsetX = text ? (svgWidth - spikeWidth) / 2 : 0;\n  const centerX = spikeWidth / 2;\n  const left = centerX - 6;\n  const right = centerX + 6;\n  const top = 0.25;\n  const bottom = actualHeight - 0.75;\n  const textEl = text\n    ? `<text x=\"${svgWidth / 2}\" y=\"${fontSize + 4}\" text-anchor=\"middle\" fill=\"black\" font-size=\"${fontSize}\" font-weight=\"bold\" font-family=\"Arial, sans-serif\" stroke=\"white\" stroke-width=\"1\" paint-order=\"stroke\">${escapeXml(text)}</text>`\n    : '';\n\n  return `<svg width=\"${svgWidth}\" height=\"${totalHeight}\" viewBox=\"0 0 ${svgWidth} ${totalHeight}\" fill=\"none\" xmlns=\"http://www.w3.org/2000/svg\"><g transform=\"translate(${spikeOffsetX}, ${spikeOffsetY})\"><path d=\"M${right} ${bottom}L${centerX} ${top}L${left} ${bottom}Z\" fill=\"${fill}\"/><path d=\"M${centerX + 10} ${bottom}H${right + 2}L${centerX} ${top}L${left - 2} ${bottom}H${centerX - 10}\" stroke=\"${fill}\" fill=\"none\" stroke-width=\"1\"/></g>${textEl}</svg>`;\n}\n\nfunction escapeXml(value: string): string {\n  return value\n    .replace(/&/g, '&amp;')\n    .replace(/</g, '&lt;')\n    .replace(/>/g, '&gt;')\n    .replace(/\"/g, '&quot;');\n}\n\nexport function isMapVisualisation(value: string | undefined): value is MapVisualisation {\n  return value === 'choropleth' || value === 'bubbles' || value === 'spike' || value === 'markers';\n}\n"],"names":["value"],"mappings":";;;;AAYA,SAAS,eAAe,KAAa,OAA+B;AAClE,SAAO,IAAI,MAAM,MAAM,KAAK,IAAI,MAAM,OAAO;AAC/C;AAEO,SAAS,kBACd,OACA,YACe;;AACf,MAAI,GAAC,8CAAY,aAAZ,mBAAsB,SAAQ;AACjC,WAAO,EAAE,GAAG,OAAO,UAAU,IAAI,WAAW,CAAA,GAAI,YAAY,GAAG,UAAU,EAAA;AAAA,EAC3E;AAEA,QAAM,QAAQ,oBAAoB,WAAW,UAAU,MAAM,OAAO;AACpE,MAAI,aAAa;AACjB,MAAI,WAAW;AACf,QAAM,WAA6B,CAAA;AACnC,QAAM,YAAoC,CAAA;AAE1C,aAAW,OAAO,MAAM,MAAM;AAC5B,UAAM,MAAM,eAAe,KAAK,KAAK;AACrC,QAAI,MAAM,QAAQ,GAAG,GAAG;AACtB,YAAMA,SAAQ,aAAa,IAAI,MAAM,QAAQ,CAAC;AAC9C,UAAI,IAAI,SAAS,EAAG;AACpB,eAAS,KAAK;AAAA,QACZ,MAAM;AAAA,QACN,YAAY,EAAE,GAAG,KAAK,OAAAA,QAAO,UAAU,MAAM,YAAY,KAAA;AAAA,QACzD,UAAU,EAAE,MAAM,SAAS,aAAa,IAAA;AAAA,MAAI,CAC7C;AACD;AAAA,IACF;AAEA,UAAM,YAAY,OAAO,OAAO,EAAE,EAAE,YAAA;AACpC,QAAI,CAAC,UAAW;AAChB,kBAAc;AACd,UAAM,WAAW,YAAY,WAAW,MAAM,SAAS,KAAK;AAC5D,QAAI,CAAC,SAAU;AACf,gBAAY;AAEZ,UAAM,gBAAgB,MAAM,KAAK,IAAI,QAAQ;AAC7C,QAAI,CAAC,cAAe;AACpB,UAAM,QAAQ,aAAa,IAAI,MAAM,QAAQ,CAAC;AAC9C,UAAM,cACH,OAAO,IAAI,MAAM,MAAM,MAAM,YAAY,IAAI,MAAM,MAAM,IACtD,OAAO,IAAI,MAAM,MAAM,CAAC,IACxB,YACH,SAAO,mBAAc,eAAd,mBAA0B,UAAS,WACvC,cAAc,WAAW,OACzB;AAEN,QAAI,MAAM,sBAAsB,cAAc;AAC5C,eAAS,KAAK;AAAA,QACZ,GAAG;AAAA,QACH,IAAI;AAAA,QACJ,YAAY;AAAA,UACV,GAAG,cAAc;AAAA,UACjB,IAAI;AAAA,UACJ;AAAA,UACA;AAAA,UACA;AAAA,QAAA;AAAA,MACF,CACD;AACD,gBAAU,QAAQ,IAAI,UAAU,cAAc,OAAO,MAAM,WAAW,GAAG,CAAC;AAC1E;AAAA,IACF;AAEA,UAAM,SAAS,cAAc,aAAa;AAC1C,QAAI,CAAC,OAAQ;AACb,aAAS,KAAK;AAAA,MACZ,MAAM;AAAA,MACN,YAAY,EAAE,GAAG,KAAK,OAAO,UAAU,WAAA;AAAA,MACvC,UAAU,EAAE,MAAM,SAAS,aAAa,CAAC,OAAO,KAAK,OAAO,GAAG,EAAA;AAAA,IAAE,CAClE;AAAA,EACH;AAEA,QAAM,eACJ,MAAM,sBAAsB,UAAU,cAAc,UAAU,KAAK,IAAI;AAEzE,SAAO,EAAE,GAAG,OAAO,UAAU,cAAc,WAAW,YAAY,SAAA;AACpE;AASO,SAAS,cAAc,QAA0C;AACtE,SAAO,CAAC,GAAG,MAAM,EAAE;AAAA,IACjB,CAAC,GAAG,OACD,YAAY,EAAE,iBAAiB,KAAK,OAAO,YAAY,EAAE,iBAAiB,KAAK;AAAA,EAAA;AAEtF;AAEA,SAAS,cAAc,UAA4B,OAAwC;AACzF,QAAM,SAAS,SAAS,OAAO,CAAC;;AAAM,oBAAE,aAAF,mBAAY,UAAS;AAAA,GAAO;AAClE,MAAI,CAAC,OAAO,OAAQ,QAAO,CAAA;AAC3B,QAAM,SAAS,CAAC,GAAG,MAAM,EAAE;AAAA,IACzB,CAAC,GAAG;;AAAM,2BAAa,OAAE,eAAF,mBAAc,KAAK,IAAI,cAAa,OAAE,eAAF,mBAAc,KAAK;AAAA;AAAA,EAAA;AAEhF,QAAM,UAAU,OAAO,MAAM,GAAG,UAAU;AAC1C,QAAM,SAAS,QAAQ,IAAI,CAAC,MAAA;;AAAM,yBAAa,OAAE,eAAF,mBAAc,KAAK,KAAK;AAAA,GAAC;AACxE,QAAM,WAAW,KAAK,IAAI,GAAG,MAAM;AACnC,QAAM,WAAW,KAAK,IAAI,GAAG,MAAM;AACnC,QAAM,eAAe,YAAY,MAAM,OAAO;AAE9C,SAAO,QAAQ,IAAI,CAAC,SAAS,UAAU;;AACrC,UAAM,QAAQ,cAAa,aAAQ,eAAR,mBAAoB,KAAK;AACpD,UAAM,OAAO,UAAU,OAAO,MAAM,aAAa,UAAU,QAAQ;AACnE,UAAM,WAAW,SAAO,aAAQ,eAAR,mBAAoB,aAAY,EAAE;AAC1D,UAAM,WAAW,cAAc,YAAY,IAAI,KAAK,GAAG,WAAW,IAAI,YAAY,QAAQ,CAAC,KAAK,EAAE;AAClG,UAAM,QAAQ,MAAM,UAAU,QAAQ,KAAK,EAAE;AAC7C,UAAM,YACJ,SAAO,aAAQ,eAAR,mBAAoB,eAAc,WACrC,QAAQ,WAAW,YACnB,SAAO,aAAQ,eAAR,mBAAoB,WAAU,WACnC,QAAQ,WAAW,QACnB;AACR,UAAM,aAAa,SAAS,MAAM,OAAO,SAAS;AAClD,WAAO;AAAA,MACL,GAAG;AAAA,MACH,YAAY;AAAA,QACV,GAAG,QAAQ;AAAA,QACX;AAAA,QACA;AAAA,QACA;AAAA,QACA,SAAS,MAAM;AAAA,MAAA;AAAA,IACjB;AAAA,EAEJ,CAAC;AACH;AAEA,SAAS,UACP,OACA,QACA,UACA,UACQ;AACR,MAAI,OAAO,QAAQ;AACjB,UAAM,QAAQ,OAAO,KAAK,CAAC,MAAM,SAAS,EAAE,SAAS,SAAS,EAAE,GAAG;AACnE,QAAI,+BAAO,OAAQ,QAAO,MAAM;AAChC,QAAI,QAAQ,OAAO,CAAC,EAAE,SAAS,OAAO,CAAC,EAAE,OAAQ,QAAO,OAAO,CAAC,EAAE;AAClE,UAAM,OAAO,OAAO,OAAO,SAAS,CAAC;AACrC,QAAI,QAAQ,KAAK,OAAO,KAAK,eAAe,KAAK;AAAA,EACnD;AACA,MAAI,aAAa,SAAU,QAAO;AAClC,QAAM,SAAS,QAAQ,aAAa,WAAW;AAC/C,QAAM,UAAU,CAAC,GAAG,IAAI,IAAI,IAAI,IAAI,IAAI,IAAI,EAAE;AAC9C,SAAO,QAAQ,KAAK,MAAM,SAAS,QAAQ,SAAS,EAAE,CAAC,KAAK;AAC9D;AAEA,SAAS,SAAS,MAAc,OAAe,MAAuB;AACpE,QAAM,MAAM,MAAM,WAAW,GAAG,IAAI,QAAQ,IAAI,KAAK;AACrD,QAAM,OAAO,UAAU,KAAK,CAAC;AAC7B,QAAM,eAAe;AACrB,QAAM,WAAW;AACjB,QAAM,aAAa,WAAW;AAC9B,QAAM,MAAM;AACZ,QAAM,cAAc,OAAO,aAAa,MAAM,eAAe;AAC7D,QAAM,eAAe,OAAO,aAAa,MAAM;AAC/C,QAAM,aAAa;AACnB,QAAM,WAAW,OAAO,KAAK,IAAI,YAAY,KAAK,SAAS,KAAK,EAAE,IAAI;AACtE,QAAM,eAAe,QAAQ,WAAW,cAAc,IAAI;AAC1D,QAAM,UAAU,aAAa;AAC7B,QAAM,OAAO,UAAU;AACvB,QAAM,QAAQ,UAAU;AACxB,QAAM,MAAM;AACZ,QAAM,SAAS,eAAe;AAC9B,QAAM,SAAS,OACX,YAAY,WAAW,CAAC,QAAQ,WAAW,CAAC,kDAAkD,QAAQ,6GAA6G,UAAU,IAAI,CAAC,YAClO;AAEJ,SAAO,eAAe,QAAQ,aAAa,WAAW,kBAAkB,QAAQ,IAAI,WAAW,4EAA4E,YAAY,KAAK,YAAY,gBAAgB,KAAK,IAAI,MAAM,IAAI,OAAO,IAAI,GAAG,IAAI,IAAI,IAAI,MAAM,YAAY,IAAI,gBAAgB,UAAU,EAAE,IAAI,MAAM,IAAI,QAAQ,CAAC,IAAI,OAAO,IAAI,GAAG,IAAI,OAAO,CAAC,IAAI,MAAM,IAAI,UAAU,EAAE,aAAa,IAAI,uCAAuC,MAAM;AACtc;AAEA,SAAS,UAAU,OAAuB;AACxC,SAAO,MACJ,QAAQ,MAAM,OAAO,EACrB,QAAQ,MAAM,MAAM,EACpB,QAAQ,MAAM,MAAM,EACpB,QAAQ,MAAM,QAAQ;AAC3B;AAEO,SAAS,mBAAmB,OAAsD;AACvF,SAAO,UAAU,gBAAgB,UAAU,aAAa,UAAU,WAAW,UAAU;AACzF;"}

package/dist/components/map-chart/lib/legend.d.ts

@@ -0,0 +1,45 @@
+import { MapVisualisation } from './constants.js';
+import { ColorRange, GeoJsonFeature } from './types.js';
+/** Inclusive-left, exclusive-right bucket window — FuseDash MapLegend RangeInput. */
+export type LayerSlider = {
+    leftSlider: number;
+    rightSlider: number;
+};
+export declare const MUTED_LEGEND_FILL = "#6C758429";
+export declare function defaultLayerSlider(rangeCount: number): LayerSlider;
+/**
+ * FuseDash RangeInput: left stays strictly below right, right strictly above
+ * left — thumbs never share a slot.
+ */
+export declare function slideThumb(current: LayerSlider, edge: 'leftSlider' | 'rightSlider', raw: number, rangeCount: number): LayerSlider;
+export declare function clampLayerSlider(next: LayerSlider, rangeCount: number): LayerSlider | null;
+export declare function sliderIndexFromPointer(clientX: number, track: {
+    left: number;
+    width: number;
+}, rangeCount: number): number;
+/** FuseDash RangeInput `getThumbPosition` — percent along that thumb's track. */
+export declare function thumbTrackPercent(value: number, rangeCount: number): string;
+/** FuseDash RangeInput track shift: 7px when a thumb sits on 0 or MAX. */
+export declare function rangeTrackOffset(edge: 'left' | 'right', value: number, rangeCount: number): string;
+export declare function sliderValueWindow(ranges: ColorRange[], slider: LayerSlider): {
+    start: number;
+    end: number;
+};
+/** FuseDash year filter — rows without the selected year drop out. */
+export declare function featuresForYear(features: GeoJsonFeature[], year: string | undefined, yearKey: string): GeoJsonFeature[];
+/** Keep marks whose value sits inside the legend thumb window. */
+export declare function featuresInSliderRange(features: GeoJsonFeature[], ranges: ColorRange[], slider: LayerSlider): GeoJsonFeature[];
+/** FuseDash MapLegend lists markers → spikes → bubbles → choropleth. */
+export declare function legendLayerOrder<T extends {
+    visualisationType: MapVisualisation;
+}>(layers: T[]): T[];
+export declare function layerAverage(values: number[]): number;
+/** Client MapLegendItem `renderValue`. */
+export declare function formatAverage(value: number): string;
+/** Client `formatCapitalizedText` — first word capped, `_`/`-` → spaces. */
+export declare function formatFieldLabel(text: string): string;
+/** Client MapLegendItem `formatValue` — abbreviated bucket edge. */
+export declare function formatLegendBucket(value: number, toFixed?: number): string;
+/** Legend spikes use DEFAULT_SPIKE_SIZES, not the map `range.height` (those go to 100px). */
+export declare function legendSpikeHeight(index: number): number;
+//# sourceMappingURL=legend.d.ts.map

package/dist/components/map-chart/lib/legend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"legend.d.ts","sourceRoot":"","sources":["../../../../src/components/map-chart/lib/legend.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoC,KAAK,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAEzF,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE7D,qFAAqF;AACrF,MAAM,MAAM,WAAW,GAAG;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,eAAO,MAAM,iBAAiB,cAAc,CAAC;AAE7C,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,WAAW,CAElE;AAED;;;GAGG;AACH,wBAAgB,UAAU,CACxB,OAAO,EAAE,WAAW,EACpB,IAAI,EAAE,YAAY,GAAG,aAAa,EAClC,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,MAAM,GACjB,WAAW,CAYb;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAM1F;AAED,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,MAAM,EACf,KAAK,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EACtC,UAAU,EAAE,MAAM,GACjB,MAAM,CAKR;AAED,iFAAiF;AACjF,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAG3E;AAED,0EAA0E;AAC1E,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAIlG;AAED,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,UAAU,EAAE,EACpB,MAAM,EAAE,WAAW,GAClB;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAIhC;AAED,sEAAsE;AACtE,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,cAAc,EAAE,EAC1B,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,OAAO,EAAE,MAAM,GACd,cAAc,EAAE,CAGlB;AAED,kEAAkE;AAClE,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,cAAc,EAAE,EAC1B,MAAM,EAAE,UAAU,EAAE,EACpB,MAAM,EAAE,WAAW,GAClB,cAAc,EAAE,CAOlB;AAED,wEAAwE;AACxE,wBAAgB,gBAAgB,CAAC,CAAC,SAAS;IAAE,iBAAiB,EAAE,gBAAgB,CAAA;CAAE,EAAE,MAAM,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,CAIpG;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAGrD;AAED,0CAA0C;AAC1C,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAInD;AAED,4EAA4E;AAC5E,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKrD;AAED,oEAAoE;AACpE,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,SAAI,GAAG,MAAM,CASrE;AAED,6FAA6F;AAC7F,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGvD"}

package/dist/components/map-chart/lib/legend.js

@@ -0,0 +1,108 @@
+import { LAYER_ORDER, DEFAULT_SPIKE_SIZES } from "./constants.js";
+import { numericValue } from "./format.js";
+const MUTED_LEGEND_FILL = "#6C758429";
+function defaultLayerSlider(rangeCount) {
+  return { leftSlider: 0, rightSlider: Math.max(rangeCount, 1) };
+}
+function slideThumb(current, edge, raw, rangeCount) {
+  const max = Math.max(rangeCount, 1);
+  if (edge === "leftSlider") {
+    return {
+      leftSlider: Math.max(0, Math.min(current.rightSlider - 1, raw)),
+      rightSlider: current.rightSlider
+    };
+  }
+  return {
+    leftSlider: current.leftSlider,
+    rightSlider: Math.max(current.leftSlider + 1, Math.min(max, raw))
+  };
+}
+function sliderIndexFromPointer(clientX, track, rangeCount) {
+  const max = Math.max(rangeCount, 1);
+  if (track.width <= 0) return 0;
+  const ratio = (clientX - track.left) / track.width;
+  return Math.max(0, Math.min(max, Math.round(ratio * max)));
+}
+function thumbTrackPercent(value, rangeCount) {
+  const max = Math.max(rangeCount, 1);
+  return `${value / max * 100}%`;
+}
+function rangeTrackOffset(edge, value, rangeCount) {
+  const max = Math.max(rangeCount, 1);
+  if (edge === "left") return value === 0 ? "7px" : "0px";
+  return value === max ? "7px" : "0px";
+}
+function sliderValueWindow(ranges, slider) {
+  var _a, _b;
+  const start = ((_a = ranges[slider.leftSlider]) == null ? void 0 : _a.start) ?? 0;
+  const end = ((_b = ranges[Math.max(0, slider.rightSlider - 1)]) == null ? void 0 : _b.end) ?? 0;
+  return { start, end };
+}
+function featuresForYear(features, year, yearKey) {
+  if (!year) return features;
+  return features.filter((feature) => {
+    var _a;
+    return String(((_a = feature.properties) == null ? void 0 : _a[yearKey]) ?? "") === year;
+  });
+}
+function featuresInSliderRange(features, ranges, slider) {
+  if (!ranges.length) return features;
+  const { start, end } = sliderValueWindow(ranges, slider);
+  return features.filter((feature) => {
+    var _a;
+    const value = numericValue((_a = feature.properties) == null ? void 0 : _a.value);
+    return value >= start && value <= end;
+  });
+}
+function legendLayerOrder(layers) {
+  return [...layers].sort(
+    (a, b) => (LAYER_ORDER[a.visualisationType] ?? 99) - (LAYER_ORDER[b.visualisationType] ?? 99)
+  ).reverse();
+}
+function layerAverage(values) {
+  if (!values.length) return 0;
+  return values.reduce((sum, value) => sum + value, 0) / values.length;
+}
+function formatAverage(value) {
+  if (!Number.isFinite(value)) return "0";
+  const decimals = value % 1 !== 0 ? 2 : 0;
+  return value.toFixed(decimals).replace(/\B(?=(\d{3})+(?!\d))/g, ",");
+}
+function formatFieldLabel(text) {
+  if (!text) return "";
+  if (!Number.isNaN(Number(text))) return text;
+  const formatted = text.replace(/[_-]/g, " ").replace(/\s+/g, " ").trim();
+  return formatted.charAt(0).toUpperCase() + formatted.slice(1).toLowerCase();
+}
+function formatLegendBucket(value, toFixed = 2) {
+  if (!Number.isFinite(value) || value === Infinity || value === -Infinity) return "0";
+  if (Math.abs(value) < 1e3) return value.toFixed(toFixed);
+  const abbreviations = ["B", "M", "K"];
+  for (let i = 0; i < abbreviations.length; i++) {
+    const unit = Math.pow(1e3, abbreviations.length - i);
+    if (Math.abs(value) >= unit) return `${(value / unit).toFixed(1)} ${abbreviations[i]}`;
+  }
+  return value.toFixed(toFixed);
+}
+function legendSpikeHeight(index) {
+  const size = DEFAULT_SPIKE_SIZES[index] ?? 8;
+  return Math.max(0, Math.round(size - size / 5));
+}
+export {
+  MUTED_LEGEND_FILL,
+  defaultLayerSlider,
+  featuresForYear,
+  featuresInSliderRange,
+  formatAverage,
+  formatFieldLabel,
+  formatLegendBucket,
+  layerAverage,
+  legendLayerOrder,
+  legendSpikeHeight,
+  rangeTrackOffset,
+  slideThumb,
+  sliderIndexFromPointer,
+  sliderValueWindow,
+  thumbTrackPercent
+};
+//# sourceMappingURL=legend.js.map

package/dist/components/map-chart/lib/legend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"legend.js","sources":["../../../../src/components/map-chart/lib/legend.ts"],"sourcesContent":["import { DEFAULT_SPIKE_SIZES, LAYER_ORDER, type MapVisualisation } from './constants.js';\nimport { numericValue } from './format.js';\nimport type { ColorRange, GeoJsonFeature } from './types.js';\n\n/** Inclusive-left, exclusive-right bucket window — FuseDash MapLegend RangeInput. */\nexport type LayerSlider = {\n  leftSlider: number;\n  rightSlider: number;\n};\n\nexport const MUTED_LEGEND_FILL = '#6C758429';\n\nexport function defaultLayerSlider(rangeCount: number): LayerSlider {\n  return { leftSlider: 0, rightSlider: Math.max(rangeCount, 1) };\n}\n\n/**\n * FuseDash RangeInput: left stays strictly below right, right strictly above\n * left — thumbs never share a slot.\n */\nexport function slideThumb(\n  current: LayerSlider,\n  edge: 'leftSlider' | 'rightSlider',\n  raw: number,\n  rangeCount: number,\n): LayerSlider {\n  const max = Math.max(rangeCount, 1);\n  if (edge === 'leftSlider') {\n    return {\n      leftSlider: Math.max(0, Math.min(current.rightSlider - 1, raw)),\n      rightSlider: current.rightSlider,\n    };\n  }\n  return {\n    leftSlider: current.leftSlider,\n    rightSlider: Math.max(current.leftSlider + 1, Math.min(max, raw)),\n  };\n}\n\nexport function clampLayerSlider(next: LayerSlider, rangeCount: number): LayerSlider | null {\n  const max = Math.max(rangeCount, 1);\n  const left = Math.max(0, Math.min(max, next.leftSlider));\n  const right = Math.max(0, Math.min(max, next.rightSlider));\n  if (left >= right) return null;\n  return { leftSlider: left, rightSlider: right };\n}\n\nexport function sliderIndexFromPointer(\n  clientX: number,\n  track: { left: number; width: number },\n  rangeCount: number,\n): number {\n  const max = Math.max(rangeCount, 1);\n  if (track.width <= 0) return 0;\n  const ratio = (clientX - track.left) / track.width;\n  return Math.max(0, Math.min(max, Math.round(ratio * max)));\n}\n\n/** FuseDash RangeInput `getThumbPosition` — percent along that thumb's track. */\nexport function thumbTrackPercent(value: number, rangeCount: number): string {\n  const max = Math.max(rangeCount, 1);\n  return `${(value / max) * 100}%`;\n}\n\n/** FuseDash RangeInput track shift: 7px when a thumb sits on 0 or MAX. */\nexport function rangeTrackOffset(edge: 'left' | 'right', value: number, rangeCount: number): string {\n  const max = Math.max(rangeCount, 1);\n  if (edge === 'left') return value === 0 ? '7px' : '0px';\n  return value === max ? '7px' : '0px';\n}\n\nexport function sliderValueWindow(\n  ranges: ColorRange[],\n  slider: LayerSlider,\n): { start: number; end: number } {\n  const start = ranges[slider.leftSlider]?.start ?? 0;\n  const end = ranges[Math.max(0, slider.rightSlider - 1)]?.end ?? 0;\n  return { start, end };\n}\n\n/** FuseDash year filter — rows without the selected year drop out. */\nexport function featuresForYear(\n  features: GeoJsonFeature[],\n  year: string | undefined,\n  yearKey: string,\n): GeoJsonFeature[] {\n  if (!year) return features;\n  return features.filter((feature) => String(feature.properties?.[yearKey] ?? '') === year);\n}\n\n/** Keep marks whose value sits inside the legend thumb window. */\nexport function featuresInSliderRange(\n  features: GeoJsonFeature[],\n  ranges: ColorRange[],\n  slider: LayerSlider,\n): GeoJsonFeature[] {\n  if (!ranges.length) return features;\n  const { start, end } = sliderValueWindow(ranges, slider);\n  return features.filter((feature) => {\n    const value = numericValue(feature.properties?.value);\n    return value >= start && value <= end;\n  });\n}\n\n/** FuseDash MapLegend lists markers → spikes → bubbles → choropleth. */\nexport function legendLayerOrder<T extends { visualisationType: MapVisualisation }>(layers: T[]): T[] {\n  return [...layers].sort(\n    (a, b) => (LAYER_ORDER[a.visualisationType] ?? 99) - (LAYER_ORDER[b.visualisationType] ?? 99),\n  ).reverse();\n}\n\nexport function layerAverage(values: number[]): number {\n  if (!values.length) return 0;\n  return values.reduce((sum, value) => sum + value, 0) / values.length;\n}\n\n/** Client MapLegendItem `renderValue`. */\nexport function formatAverage(value: number): string {\n  if (!Number.isFinite(value)) return '0';\n  const decimals = value % 1 !== 0 ? 2 : 0;\n  return value.toFixed(decimals).replace(/\\B(?=(\\d{3})+(?!\\d))/g, ',');\n}\n\n/** Client `formatCapitalizedText` — first word capped, `_`/`-` → spaces. */\nexport function formatFieldLabel(text: string): string {\n  if (!text) return '';\n  if (!Number.isNaN(Number(text))) return text;\n  const formatted = text.replace(/[_-]/g, ' ').replace(/\\s+/g, ' ').trim();\n  return formatted.charAt(0).toUpperCase() + formatted.slice(1).toLowerCase();\n}\n\n/** Client MapLegendItem `formatValue` — abbreviated bucket edge. */\nexport function formatLegendBucket(value: number, toFixed = 2): string {\n  if (!Number.isFinite(value) || value === Infinity || value === -Infinity) return '0';\n  if (Math.abs(value) < 1000) return value.toFixed(toFixed);\n  const abbreviations = ['B', 'M', 'K'];\n  for (let i = 0; i < abbreviations.length; i++) {\n    const unit = Math.pow(1000, abbreviations.length - i);\n    if (Math.abs(value) >= unit) return `${(value / unit).toFixed(1)} ${abbreviations[i]}`;\n  }\n  return value.toFixed(toFixed);\n}\n\n/** Legend spikes use DEFAULT_SPIKE_SIZES, not the map `range.height` (those go to 100px). */\nexport function legendSpikeHeight(index: number): number {\n  const size = DEFAULT_SPIKE_SIZES[index] ?? 8;\n  return Math.max(0, Math.round(size - size / 5));\n}\n"],"names":[],"mappings":";;AAUO,MAAM,oBAAoB;AAE1B,SAAS,mBAAmB,YAAiC;AAClE,SAAO,EAAE,YAAY,GAAG,aAAa,KAAK,IAAI,YAAY,CAAC,EAAA;AAC7D;AAMO,SAAS,WACd,SACA,MACA,KACA,YACa;AACb,QAAM,MAAM,KAAK,IAAI,YAAY,CAAC;AAClC,MAAI,SAAS,cAAc;AACzB,WAAO;AAAA,MACL,YAAY,KAAK,IAAI,GAAG,KAAK,IAAI,QAAQ,cAAc,GAAG,GAAG,CAAC;AAAA,MAC9D,aAAa,QAAQ;AAAA,IAAA;AAAA,EAEzB;AACA,SAAO;AAAA,IACL,YAAY,QAAQ;AAAA,IACpB,aAAa,KAAK,IAAI,QAAQ,aAAa,GAAG,KAAK,IAAI,KAAK,GAAG,CAAC;AAAA,EAAA;AAEpE;AAUO,SAAS,uBACd,SACA,OACA,YACQ;AACR,QAAM,MAAM,KAAK,IAAI,YAAY,CAAC;AAClC,MAAI,MAAM,SAAS,EAAG,QAAO;AAC7B,QAAM,SAAS,UAAU,MAAM,QAAQ,MAAM;AAC7C,SAAO,KAAK,IAAI,GAAG,KAAK,IAAI,KAAK,KAAK,MAAM,QAAQ,GAAG,CAAC,CAAC;AAC3D;AAGO,SAAS,kBAAkB,OAAe,YAA4B;AAC3E,QAAM,MAAM,KAAK,IAAI,YAAY,CAAC;AAClC,SAAO,GAAI,QAAQ,MAAO,GAAG;AAC/B;AAGO,SAAS,iBAAiB,MAAwB,OAAe,YAA4B;AAClG,QAAM,MAAM,KAAK,IAAI,YAAY,CAAC;AAClC,MAAI,SAAS,OAAQ,QAAO,UAAU,IAAI,QAAQ;AAClD,SAAO,UAAU,MAAM,QAAQ;AACjC;AAEO,SAAS,kBACd,QACA,QACgC;;AAChC,QAAM,UAAQ,YAAO,OAAO,UAAU,MAAxB,mBAA2B,UAAS;AAClD,QAAM,QAAM,YAAO,KAAK,IAAI,GAAG,OAAO,cAAc,CAAC,CAAC,MAA1C,mBAA6C,QAAO;AAChE,SAAO,EAAE,OAAO,IAAA;AAClB;AAGO,SAAS,gBACd,UACA,MACA,SACkB;AAClB,MAAI,CAAC,KAAM,QAAO;AAClB,SAAO,SAAS,OAAO,CAAC;;AAAY,oBAAO,aAAQ,eAAR,mBAAqB,aAAY,EAAE,MAAM;AAAA,GAAI;AAC1F;AAGO,SAAS,sBACd,UACA,QACA,QACkB;AAClB,MAAI,CAAC,OAAO,OAAQ,QAAO;AAC3B,QAAM,EAAE,OAAO,IAAA,IAAQ,kBAAkB,QAAQ,MAAM;AACvD,SAAO,SAAS,OAAO,CAAC,YAAY;;AAClC,UAAM,QAAQ,cAAa,aAAQ,eAAR,mBAAoB,KAAK;AACpD,WAAO,SAAS,SAAS,SAAS;AAAA,EACpC,CAAC;AACH;AAGO,SAAS,iBAAoE,QAAkB;AACpG,SAAO,CAAC,GAAG,MAAM,EAAE;AAAA,IACjB,CAAC,GAAG,OAAO,YAAY,EAAE,iBAAiB,KAAK,OAAO,YAAY,EAAE,iBAAiB,KAAK;AAAA,EAAA,EAC1F,QAAA;AACJ;AAEO,SAAS,aAAa,QAA0B;AACrD,MAAI,CAAC,OAAO,OAAQ,QAAO;AAC3B,SAAO,OAAO,OAAO,CAAC,KAAK,UAAU,MAAM,OAAO,CAAC,IAAI,OAAO;AAChE;AAGO,SAAS,cAAc,OAAuB;AACnD,MAAI,CAAC,OAAO,SAAS,KAAK,EAAG,QAAO;AACpC,QAAM,WAAW,QAAQ,MAAM,IAAI,IAAI;AACvC,SAAO,MAAM,QAAQ,QAAQ,EAAE,QAAQ,yBAAyB,GAAG;AACrE;AAGO,SAAS,iBAAiB,MAAsB;AACrD,MAAI,CAAC,KAAM,QAAO;AAClB,MAAI,CAAC,OAAO,MAAM,OAAO,IAAI,CAAC,EAAG,QAAO;AACxC,QAAM,YAAY,KAAK,QAAQ,SAAS,GAAG,EAAE,QAAQ,QAAQ,GAAG,EAAE,KAAA;AAClE,SAAO,UAAU,OAAO,CAAC,EAAE,gBAAgB,UAAU,MAAM,CAAC,EAAE,YAAA;AAChE;AAGO,SAAS,mBAAmB,OAAe,UAAU,GAAW;AACrE,MAAI,CAAC,OAAO,SAAS,KAAK,KAAK,UAAU,YAAY,UAAU,UAAW,QAAO;AACjF,MAAI,KAAK,IAAI,KAAK,IAAI,IAAM,QAAO,MAAM,QAAQ,OAAO;AACxD,QAAM,gBAAgB,CAAC,KAAK,KAAK,GAAG;AACpC,WAAS,IAAI,GAAG,IAAI,cAAc,QAAQ,KAAK;AAC7C,UAAM,OAAO,KAAK,IAAI,KAAM,cAAc,SAAS,CAAC;AACpD,QAAI,KAAK,IAAI,KAAK,KAAK,KAAM,QAAO,IAAI,QAAQ,MAAM,QAAQ,CAAC,CAAC,IAAI,cAAc,CAAC,CAAC;AAAA,EACtF;AACA,SAAO,MAAM,QAAQ,OAAO;AAC9B;AAGO,SAAS,kBAAkB,OAAuB;AACvD,QAAM,OAAO,oBAAoB,KAAK,KAAK;AAC3C,SAAO,KAAK,IAAI,GAAG,KAAK,MAAM,OAAO,OAAO,CAAC,CAAC;AAChD;"}

package/dist/components/map-chart/lib/normalize.d.ts

@@ -0,0 +1,3 @@
+import { GeoJsonFeatureCollection, MapChartInput, MapModel } from './types.js';
+export declare function normalizeMapData(input: MapChartInput, geoJson?: GeoJsonFeatureCollection | Record<string, GeoJsonFeatureCollection>): MapModel;
+//# sourceMappingURL=normalize.d.ts.map

package/dist/components/map-chart/lib/normalize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.d.ts","sourceRoot":"","sources":["../../../../src/components/map-chart/lib/normalize.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EACV,wBAAwB,EACxB,aAAa,EAIb,QAAQ,EAGT,MAAM,YAAY,CAAC;AAsBpB,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,aAAa,EACpB,OAAO,CAAC,EAAE,wBAAwB,GAAG,MAAM,CAAC,MAAM,EAAE,wBAAwB,CAAC,GAC5E,QAAQ,CAqFV"}

package/dist/components/map-chart/lib/normalize.js

@@ -0,0 +1,177 @@
+import { resolveFormattingColor, SEQUENTIAL_1, QUALITATIVE_2 } from "../../../utils/fuse-palette.js";
+import { valuesOfRows, rangesFromPaletteStops, generateColorRanges } from "./domain.js";
+import { inferMapTypeFromKeyNames } from "./geo-index.js";
+import { isFeatureCollection } from "./geojson.js";
+import { isMapVisualisation, joinLayerFeatures } from "./join.js";
+import { layerAverage } from "./legend.js";
+const EMPTY = { title: "", terrain: false, showLegend: true, layers: [] };
+function asRecord(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) return null;
+  return value;
+}
+function rowsFromUnknown(value) {
+  if (!Array.isArray(value)) return [];
+  return value.filter(
+    (row) => !!row && typeof row === "object" && !Array.isArray(row)
+  );
+}
+function isChatRow(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) return false;
+  const row = value;
+  return typeof row.label === "string" && typeof row.value === "number";
+}
+function normalizeMapData(input, geoJson) {
+  if (input == null) return EMPTY;
+  if (Array.isArray(input)) {
+    if (!input.length) return EMPTY;
+    if (isChatRow(input[0])) {
+      return normalizeMapData(
+        {
+          name: "",
+          chartType: "mapChart",
+          layers: [
+            {
+              name: "Map",
+              visualisationType: "choropleth",
+              geospatialData: ["label"],
+              arrangeByMetric: ["value"],
+              data: input.map((row) => ({
+                label: row.label,
+                value: row.value
+              })),
+              mapType: input[0].mapType ?? "country"
+            }
+          ]
+        },
+        geoJson
+      );
+    }
+    return EMPTY;
+  }
+  const obj = asRecord(input);
+  if (!obj) return EMPTY;
+  if (Array.isArray(obj.points)) {
+    const points = obj.points;
+    return normalizeMapData(
+      points.map((p) => ({ label: String(p.x ?? ""), value: Number(p.y ?? 0) })),
+      geoJson
+    );
+  }
+  if (Array.isArray(obj.regions)) {
+    const regions = obj.regions;
+    return normalizeMapData(
+      regions.map((r) => ({
+        label: String(r.name ?? r.label ?? ""),
+        value: Number(r.value ?? 0)
+      })),
+      geoJson
+    );
+  }
+  const widget = obj;
+  const rawLayers = (widget.layers ?? []).filter((layer) => !layer.hideLayer);
+  const fallbackRows = rowsFromUnknown(widget.data);
+  const layersIn = rawLayers.length > 0 ? rawLayers : fallbackRows.length ? [
+    {
+      name: widget.name ?? "Map",
+      visualisationType: widget.visualisationType ?? "choropleth",
+      geospatialData: inferKeys(fallbackRows),
+      arrangeByMetric: inferValueKeys(fallbackRows),
+      data: fallbackRows,
+      mapType: widget.mapType,
+      formatting: widget.formatting
+    }
+  ] : [];
+  if (!layersIn.length) return EMPTY;
+  const inlineGeo = resolveGeoJson(widget.geoJson ?? geoJson);
+  const layers = layersIn.map(
+    (layer, index) => buildLayer(layer, index, widget, inlineGeo[layer.mapType ?? ""] ?? widget.geoJson ?? void 0)
+  );
+  return {
+    title: typeof widget.name === "string" ? widget.name : "",
+    terrain: Boolean(widget.terrain),
+    showLegend: widget.legend !== false,
+    layers
+  };
+}
+function inferKeys(rows) {
+  const first = rows[0];
+  if (!first) return ["label"];
+  const geo = Object.keys(first).find((k) => inferMapTypeFromKeyNames([k]));
+  if (geo) return [geo];
+  if ("label" in first) return ["label"];
+  return [Object.keys(first)[0] ?? "label"];
+}
+function inferValueKeys(rows) {
+  const first = rows[0];
+  if (!first) return ["value"];
+  if ("value" in first) return ["value"];
+  const numeric = Object.keys(first).find((k) => typeof first[k] === "number");
+  return [numeric ?? "value"];
+}
+function resolveGeoJson(geoJson) {
+  if (!geoJson) return {};
+  if (isFeatureCollection(geoJson)) {
+    return { country: geoJson, "": geoJson };
+  }
+  return geoJson;
+}
+function buildLayer(layer, index, widget, geoJson) {
+  var _a, _b, _c, _d, _e, _f, _g, _h;
+  const rows = rowsFromUnknown(layer.data);
+  const visualisationType = isMapVisualisation(layer.visualisationType) ? layer.visualisationType : "choropleth";
+  const geoKey = ((_a = layer.geospatialData) == null ? void 0 : _a[0]) ?? inferKeys(rows)[0] ?? "label";
+  const valueKey = ((_b = layer.arrangeByMetric) == null ? void 0 : _b[0]) ?? inferValueKeys(rows)[0] ?? "value";
+  const mapType = layer.mapType || inferMapTypeFromKeyNames(layer.geospatialData ?? []) || inferMapTypeFromKeyNames([geoKey]) || "country";
+  const values = valuesOfRows(rows, valueKey);
+  const formatting = ((_c = layer.formatting) == null ? void 0 : _c.length) ? layer.formatting : widget.formatting ?? [];
+  const isQualitative = visualisationType === "bubbles" || visualisationType === "spike" || visualisationType === "markers";
+  const customHex = (_f = (_e = (_d = layer.palette) == null ? void 0 : _d.customColors) == null ? void 0 : _e.find((c) => c.hex)) == null ? void 0 : _f.hex;
+  const fillColor = customHex ?? (isQualitative ? resolveFormattingColor(formatting, "default", formatting.length || 1) : SEQUENTIAL_1[3]);
+  const paletteColors = isQualitative ? [fillColor, ...QUALITATIVE_2.filter((c) => c !== fillColor)] : [...SEQUENTIAL_1];
+  const paletteRange = (_g = layer.palette) == null ? void 0 : _g.range;
+  const colorRanges = paletteRange && paletteRange.length > 1 ? rangesFromPaletteStops(paletteRange, paletteColors) : generateColorRanges(values, paletteColors);
+  const years = collectYears(rows, layer.timePeriod);
+  const layerId = String(layer.layerId || layer.query || layer.name || `layer-${index}`);
+  const model = {
+    layerId,
+    layerName: layer.name || "Map",
+    visualisationType,
+    mapType,
+    geoKey,
+    valueKey,
+    yearKey: ((_h = layer.timePeriod) == null ? void 0 : _h.field) || "year",
+    rows,
+    values,
+    colorRanges,
+    fillColor,
+    average: layerAverage(values),
+    years: years.years,
+    selectedYear: years.year,
+    features: [],
+    colorById: {},
+    matchTotal: 0,
+    matchHit: 0
+  };
+  const layerGeo = layer.geoJson ?? geoJson;
+  return layerGeo ? joinLayerFeatures(model, layerGeo) : model;
+}
+function collectYears(rows, timePeriod) {
+  var _a;
+  if ((_a = timePeriod == null ? void 0 : timePeriod.values) == null ? void 0 : _a.length) {
+    return { year: timePeriod.values[0], years: [...timePeriod.values] };
+  }
+  const field = (timePeriod == null ? void 0 : timePeriod.field) || "year";
+  const years = [];
+  for (const row of rows) {
+    const value = row[field];
+    if (value == null || value === "") continue;
+    const text = String(value);
+    if (!years.includes(text)) years.push(text);
+  }
+  years.sort();
+  return { year: years[0], years };
+}
+export {
+  normalizeMapData
+};
+//# sourceMappingURL=normalize.js.map