@outsidedata/dolex 0.1.0

package/dist/src/renderers/d3/flow/sankey.js

@@ -0,0 +1,141 @@
+/**
+ * Sankey diagram D3 renderer.
+ */
+import { createSvg, createTooltip, showTooltip, hideTooltip, positionTooltip, formatValue, renderEmptyState, isAllZeros, DEFAULT_PALETTE, TEXT_COLOR, truncateLabel, } from '../shared.js';
+import { computeSankeyLayout } from './sankey-layout.js';
+export function renderSankey(container, spec) {
+    const { config, encoding, data } = spec;
+    const sourceField = config.sourceField || encoding.source?.field;
+    const targetField = config.targetField || encoding.target?.field;
+    const valueField = config.valueField || encoding.size?.field;
+    const nodeWidth = config.nodeWidth ?? 20;
+    const nodePadding = config.nodePadding ?? 10;
+    const linkOpacity = config.linkOpacity ?? 0.4;
+    const { svg, g, dims } = createSvg(container, spec, { top: 40, left: 20, right: 20, bottom: 20 });
+    const tooltip = createTooltip(container);
+    // Check if all values are zero
+    if (valueField && isAllZeros(data, valueField)) {
+        renderEmptyState(g, dims);
+        return;
+    }
+    // Build nodes and links from data or config
+    let nodeNames;
+    let linkData;
+    if (config.nodes && config.links) {
+        nodeNames = config.nodes.map((n) => n.name);
+        linkData = config.links;
+    }
+    else {
+        const sources = data.map((d) => String(d[sourceField]));
+        const targets = data.map((d) => String(d[targetField]));
+        nodeNames = [...new Set([...sources, ...targets])];
+        linkData = data.map((d) => ({
+            source: String(d[sourceField]),
+            target: String(d[targetField]),
+            value: Number(d[valueField]) || 1,
+        }));
+    }
+    const { nodes, links } = computeSankeyLayout(nodeNames, linkData, dims.innerWidth, dims.innerHeight, nodeWidth, nodePadding);
+    const nodeColorScale = d3.scaleOrdinal().domain(nodeNames).range(DEFAULT_PALETTE);
+    drawLinks(g, links, nodeColorScale, linkOpacity, tooltip);
+    drawNodes(g, nodes, nodeColorScale, dims, tooltip);
+    if (config.showLabels !== false) {
+        drawNodeLabels(g, nodes, config, dims);
+    }
+}
+function drawLinks(g, links, colorScale, linkOpacity, tooltip) {
+    const linkPath = (link) => {
+        const sx = link.source.x1;
+        const tx = link.target.x0;
+        const mx = (sx + tx) / 2;
+        const sy0 = link.y0;
+        const ty0 = link.y1;
+        const w = link.width;
+        return `
+      M ${sx},${sy0}
+      C ${mx},${sy0} ${mx},${ty0} ${tx},${ty0}
+      L ${tx},${ty0 + w}
+      C ${mx},${ty0 + w} ${mx},${sy0 + w} ${sx},${sy0 + w}
+      Z
+    `;
+    };
+    g.selectAll('.sankey-link')
+        .data(links)
+        .join('path')
+        .attr('class', 'sankey-link')
+        .attr('d', linkPath)
+        .attr('fill', (d) => colorScale(d.source.name))
+        .attr('opacity', linkOpacity)
+        .attr('stroke', 'none')
+        .on('mouseover', function (event, d) {
+        d3.select(this).attr('opacity', linkOpacity + 0.3);
+        showTooltip(tooltip, `<strong>${d.source.name} → ${d.target.name}</strong><br/>Value: ${formatValue(d.value)}`, event);
+    })
+        .on('mousemove', (event) => {
+        positionTooltip(tooltip, event);
+    })
+        .on('mouseout', function () {
+        d3.select(this).attr('opacity', linkOpacity);
+        hideTooltip(tooltip);
+    });
+}
+function drawNodes(g, nodes, colorScale, dims, tooltip) {
+    g.selectAll('.sankey-node')
+        .data(nodes)
+        .join('rect')
+        .attr('class', 'sankey-node')
+        .attr('x', (d) => d.x0)
+        .attr('y', (d) => d.y0)
+        .attr('width', (d) => d.x1 - d.x0)
+        .attr('height', (d) => Math.max(d.y1 - d.y0, 3))
+        .attr('fill', (d) => colorScale(d.name))
+        .attr('rx', 2)
+        .attr('stroke', '#0f1117')
+        .attr('stroke-width', 1)
+        .on('mouseover', function (event, d) {
+        d3.select(this).attr('opacity', 0.8);
+        const inflow = d.targetLinks.reduce((s, l) => s + l.value, 0);
+        const outflow = d.sourceLinks.reduce((s, l) => s + l.value, 0);
+        let html = `<strong>${d.name}</strong><br/>Total: ${formatValue(d.value)}`;
+        if (inflow > 0)
+            html += `<br/>Inflow: ${formatValue(inflow)}`;
+        if (outflow > 0)
+            html += `<br/>Outflow: ${formatValue(outflow)}`;
+        showTooltip(tooltip, html, event);
+    })
+        .on('mousemove', (event) => {
+        positionTooltip(tooltip, event);
+    })
+        .on('mouseout', function () {
+        d3.select(this).attr('opacity', 1);
+        hideTooltip(tooltip);
+    });
+}
+function drawNodeLabels(g, nodes, config, dims) {
+    g.selectAll('.sankey-label')
+        .data(nodes)
+        .join('text')
+        .attr('class', 'sankey-label')
+        .attr('x', (d) => {
+        if (d.x0 < dims.innerWidth / 2)
+            return d.x1 + 6;
+        return d.x0 - 6;
+    })
+        .attr('y', (d) => (d.y0 + d.y1) / 2)
+        .attr('dy', '0.35em')
+        .attr('text-anchor', (d) => (d.x0 < dims.innerWidth / 2 ? 'start' : 'end'))
+        .attr('fill', TEXT_COLOR)
+        .attr('font-size', '11px')
+        .attr('font-family', 'Inter, system-ui, sans-serif')
+        .text((d) => {
+        const isRight = d.x0 >= dims.innerWidth / 2;
+        const availChars = isRight
+            ? Math.max(10, Math.floor((d.x0 - 6) / 6.5))
+            : Math.max(10, Math.floor((dims.innerWidth - d.x1 - 6) / 6.5));
+        const label = truncateLabel(d.name, Math.min(availChars, 30));
+        if (config.showValues !== false)
+            return `${label} (${formatValue(d.value)})`;
+        return label;
+    });
+}
+//# sourceMappingURL=sankey.js.map

package/dist/src/renderers/d3/flow/sankey.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sankey.js","sourceRoot":"","sources":["../../../../../src/renderers/d3/flow/sankey.ts"],"names":[],"mappings":"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"}

package/dist/src/renderers/d3/flow.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Flow renderers — sankey.
+ *
+ * Uses a custom simplified sankey layout since d3-sankey
+ * may not be available. The layout computes node positions
+ * and link paths from source/target/value data.
+ */
+import type { VisualizationSpec } from '../../types.js';
+export declare function renderSankey(container: HTMLElement, spec: VisualizationSpec): void;
+//# sourceMappingURL=flow.d.ts.map

package/dist/src/renderers/d3/flow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flow.d.ts","sourceRoot":"","sources":["../../../../src/renderers/d3/flow.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAsCxD,wBAAgB,YAAY,CAAC,SAAS,EAAE,WAAW,EAAE,IAAI,EAAE,iBAAiB,GAAG,IAAI,CA6IlF"}

package/dist/src/renderers/d3/flow.js

@@ -0,0 +1,274 @@
+/**
+ * Flow renderers — sankey.
+ *
+ * Uses a custom simplified sankey layout since d3-sankey
+ * may not be available. The layout computes node positions
+ * and link paths from source/target/value data.
+ */
+import { createSvg, createTooltip, showTooltip, hideTooltip, formatValue, DEFAULT_PALETTE, TEXT_COLOR, } from './shared.js';
+export function renderSankey(container, spec) {
+    const { config, encoding, data } = spec;
+    const sourceField = config.sourceField || encoding.source?.field;
+    const targetField = config.targetField || encoding.target?.field;
+    const valueField = config.valueField || encoding.size?.field;
+    const nodeWidth = config.nodeWidth ?? 20;
+    const nodePadding = config.nodePadding ?? 10;
+    const linkOpacity = config.linkOpacity ?? 0.4;
+    const { svg, g, dims } = createSvg(container, spec, { top: 40, left: 20, right: 20, bottom: 20 });
+    const tooltip = createTooltip(container);
+    // Build nodes and links from data or config
+    let nodeNames;
+    let linkData;
+    if (config.nodes && config.links) {
+        nodeNames = config.nodes.map((n) => n.name);
+        linkData = config.links;
+    }
+    else {
+        // Build from raw data
+        const sources = data.map((d) => String(d[sourceField]));
+        const targets = data.map((d) => String(d[targetField]));
+        nodeNames = [...new Set([...sources, ...targets])];
+        linkData = data.map((d) => ({
+            source: String(d[sourceField]),
+            target: String(d[targetField]),
+            value: Number(d[valueField]) || 1,
+        }));
+    }
+    // Compute layout
+    const { nodes, links } = computeSankeyLayout(nodeNames, linkData, dims.innerWidth, dims.innerHeight, nodeWidth, nodePadding);
+    // Color scale for nodes
+    const nodeColorScale = d3.scaleOrdinal().domain(nodeNames).range(DEFAULT_PALETTE);
+    // Draw links
+    const linkPath = (link) => {
+        const sx = link.source.x1;
+        const tx = link.target.x0;
+        const mx = (sx + tx) / 2;
+        const sy0 = link.y0;
+        const ty0 = link.y1;
+        const w = link.width;
+        return `
+      M ${sx},${sy0}
+      C ${mx},${sy0} ${mx},${ty0} ${tx},${ty0}
+      L ${tx},${ty0 + w}
+      C ${mx},${ty0 + w} ${mx},${sy0 + w} ${sx},${sy0 + w}
+      Z
+    `;
+    };
+    g.selectAll('.sankey-link')
+        .data(links)
+        .join('path')
+        .attr('class', 'sankey-link')
+        .attr('d', linkPath)
+        .attr('fill', (d) => nodeColorScale(d.source.name))
+        .attr('opacity', linkOpacity)
+        .attr('stroke', 'none')
+        .on('mouseover', function (event, d) {
+        d3.select(this).attr('opacity', linkOpacity + 0.3);
+        showTooltip(tooltip, `<strong>${d.source.name} → ${d.target.name}</strong><br/>Value: ${formatValue(d.value)}`, event);
+    })
+        .on('mousemove', (event) => {
+        tooltip.style.left = event.clientX + 12 + 'px';
+        tooltip.style.top = event.clientY - 12 + 'px';
+    })
+        .on('mouseout', function () {
+        d3.select(this).attr('opacity', linkOpacity);
+        hideTooltip(tooltip);
+    });
+    // Draw nodes
+    g.selectAll('.sankey-node')
+        .data(nodes)
+        .join('rect')
+        .attr('class', 'sankey-node')
+        .attr('x', (d) => d.x0)
+        .attr('y', (d) => d.y0)
+        .attr('width', (d) => d.x1 - d.x0)
+        .attr('height', (d) => Math.max(d.y1 - d.y0, 1))
+        .attr('fill', (d) => nodeColorScale(d.name))
+        .attr('rx', 2)
+        .attr('stroke', '#0f1117')
+        .attr('stroke-width', 1)
+        .on('mouseover', function (event, d) {
+        d3.select(this).attr('opacity', 0.8);
+        const inflow = d.targetLinks.reduce((s, l) => s + l.value, 0);
+        const outflow = d.sourceLinks.reduce((s, l) => s + l.value, 0);
+        let html = `<strong>${d.name}</strong><br/>Total: ${formatValue(d.value)}`;
+        if (inflow > 0)
+            html += `<br/>Inflow: ${formatValue(inflow)}`;
+        if (outflow > 0)
+            html += `<br/>Outflow: ${formatValue(outflow)}`;
+        showTooltip(tooltip, html, event);
+    })
+        .on('mousemove', (event) => {
+        tooltip.style.left = event.clientX + 12 + 'px';
+        tooltip.style.top = event.clientY - 12 + 'px';
+    })
+        .on('mouseout', function () {
+        d3.select(this).attr('opacity', 1);
+        hideTooltip(tooltip);
+    });
+    // Node labels
+    if (config.showLabels !== false) {
+        g.selectAll('.sankey-label')
+            .data(nodes)
+            .join('text')
+            .attr('class', 'sankey-label')
+            .attr('x', (d) => {
+            // Label on the right for left-side nodes, left for right-side nodes
+            if (d.x0 < dims.innerWidth / 2)
+                return d.x1 + 6;
+            return d.x0 - 6;
+        })
+            .attr('y', (d) => (d.y0 + d.y1) / 2)
+            .attr('dy', '0.35em')
+            .attr('text-anchor', (d) => (d.x0 < dims.innerWidth / 2 ? 'start' : 'end'))
+            .attr('fill', TEXT_COLOR)
+            .attr('font-size', '11px')
+            .attr('font-family', 'Inter, system-ui, sans-serif')
+            .text((d) => {
+            const label = d.name;
+            if (config.showValues !== false)
+                return `${label} (${formatValue(d.value)})`;
+            return label;
+        });
+    }
+}
+/**
+ * Simplified sankey layout computation.
+ * Assigns nodes to layers via topological ordering,
+ * then positions nodes and links within available space.
+ */
+function computeSankeyLayout(nodeNames, linkData, width, height, nodeWidth, nodePadding) {
+    // Create node map
+    const nodeMap = new Map();
+    nodeNames.forEach((name) => {
+        nodeMap.set(name, {
+            name,
+            x0: 0,
+            x1: 0,
+            y0: 0,
+            y1: 0,
+            value: 0,
+            sourceLinks: [],
+            targetLinks: [],
+            layer: 0,
+        });
+    });
+    // Create links
+    const links = linkData
+        .map((l) => {
+        const source = nodeMap.get(l.source);
+        const target = nodeMap.get(l.target);
+        if (!source || !target)
+            return null;
+        const link = {
+            source,
+            target,
+            value: l.value,
+            width: 0,
+            y0: 0,
+            y1: 0,
+        };
+        source.sourceLinks.push(link);
+        target.targetLinks.push(link);
+        return link;
+    })
+        .filter(Boolean);
+    const nodes = [...nodeMap.values()];
+    // Compute node values
+    nodes.forEach((node) => {
+        const outSum = node.sourceLinks.reduce((s, l) => s + l.value, 0);
+        const inSum = node.targetLinks.reduce((s, l) => s + l.value, 0);
+        node.value = Math.max(outSum, inSum);
+    });
+    // Assign layers via topological order (BFS from sources)
+    const sources = nodes.filter((n) => n.targetLinks.length === 0);
+    const visited = new Set();
+    const queue = sources.map((n) => ({ node: n, layer: 0 }));
+    while (queue.length > 0) {
+        const { node, layer } = queue.shift();
+        if (visited.has(node.name))
+            continue;
+        visited.add(node.name);
+        node.layer = layer;
+        node.sourceLinks.forEach((link) => {
+            if (!visited.has(link.target.name)) {
+                queue.push({ node: link.target, layer: layer + 1 });
+            }
+        });
+    }
+    // Handle unvisited nodes (cycles or disconnected)
+    nodes.forEach((n) => {
+        if (!visited.has(n.name)) {
+            n.layer = 0;
+            visited.add(n.name);
+        }
+    });
+    // Group by layer
+    const maxLayer = d3.max(nodes, (n) => n.layer) || 0;
+    const layerGap = maxLayer > 0 ? (width - nodeWidth) / maxLayer : 0;
+    // Assign x positions
+    nodes.forEach((node) => {
+        node.x0 = node.layer * layerGap;
+        node.x1 = node.x0 + nodeWidth;
+    });
+    // Assign y positions within each layer
+    const layers = [];
+    for (let i = 0; i <= maxLayer; i++) {
+        layers[i] = nodes.filter((n) => n.layer === i);
+    }
+    layers.forEach((layerNodes) => {
+        // Sort by total value descending for better layout
+        layerNodes.sort((a, b) => b.value - a.value);
+        const totalValue = layerNodes.reduce((s, n) => s + n.value, 0);
+        const totalPadding = (layerNodes.length - 1) * nodePadding;
+        const availableHeight = height - totalPadding;
+        const scale = totalValue > 0 ? availableHeight / totalValue : 1;
+        let y = 0;
+        layerNodes.forEach((node) => {
+            node.y0 = y;
+            node.y1 = y + Math.max(node.value * scale, 1);
+            y = node.y1 + nodePadding;
+        });
+        // If total exceeds height, compress
+        const excess = y - nodePadding - height;
+        if (excess > 0 && layerNodes.length > 0) {
+            const compressionFactor = height / (y - nodePadding);
+            let cy = 0;
+            layerNodes.forEach((node) => {
+                const h = (node.y1 - node.y0) * compressionFactor;
+                node.y0 = cy;
+                node.y1 = cy + h;
+                cy += h + nodePadding * compressionFactor;
+            });
+        }
+    });
+    // Compute link widths and y positions
+    // Total value per node is used to compute widths proportionally
+    links.forEach((link) => {
+        const sourceTotal = link.source.value || 1;
+        const sourceHeight = link.source.y1 - link.source.y0;
+        link.width = (link.value / sourceTotal) * sourceHeight;
+    });
+    // Stack source links and target links to assign y0, y1
+    nodes.forEach((node) => {
+        let sy = node.y0;
+        // Sort source links by target y position for cleaner layout
+        node.sourceLinks.sort((a, b) => a.target.y0 - b.target.y0);
+        node.sourceLinks.forEach((link) => {
+            link.y0 = sy;
+            sy += link.width;
+        });
+        let ty = node.y0;
+        node.targetLinks.sort((a, b) => a.source.y0 - b.source.y0);
+        node.targetLinks.forEach((link) => {
+            const targetTotal = node.value || 1;
+            const targetHeight = node.y1 - node.y0;
+            const w = (link.value / targetTotal) * targetHeight;
+            link.y1 = ty;
+            link.width = Math.min(link.width, w) || link.width; // Use source width for path
+            ty += w;
+        });
+    });
+    return { nodes, links };
+}
+//# sourceMappingURL=flow.js.map

package/dist/src/renderers/d3/flow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flow.js","sourceRoot":"","sources":["../../../../src/renderers/d3/flow.ts"],"names":[],"mappings":"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"}

package/dist/src/renderers/d3/geo/choropleth.d.ts

@@ -0,0 +1,3 @@
+import type { VisualizationSpec } from '../../../types.js';
+export declare function renderChoropleth(container: HTMLElement, spec: VisualizationSpec): void;
+//# sourceMappingURL=choropleth.d.ts.map

package/dist/src/renderers/d3/geo/choropleth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"choropleth.d.ts","sourceRoot":"","sources":["../../../../../src/renderers/d3/geo/choropleth.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AA2B3D,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,WAAW,EAAE,IAAI,EAAE,iBAAiB,GAAG,IAAI,CA0KtF"}

package/dist/src/renderers/d3/geo/choropleth.js

@@ -0,0 +1,176 @@
+import { createSvg, createTooltip, showTooltip, hideTooltip, positionTooltip, formatValue, TEXT_COLOR, TEXT_MUTED, AXIS_COLOR, } from '../shared.js';
+function getInterpolator(scheme) {
+    const map = {
+        blues: d3.interpolateBlues,
+        greens: d3.interpolateGreens,
+        reds: d3.interpolateReds,
+        oranges: d3.interpolateOranges,
+        purples: d3.interpolatePurples,
+    };
+    return map[scheme.toLowerCase()] || d3.interpolateBlues;
+}
+export function renderChoropleth(container, spec) {
+    const { config = {}, encoding, data } = spec;
+    const geoField = config.geoField || (encoding.geo && encoding.geo.field);
+    const valueField = config.valueField || (encoding.color && encoding.color.field);
+    const projection = config.projection || 'naturalEarth1';
+    const mapType = config.mapType || 'world';
+    const colorScheme = config.colorScheme || 'blues';
+    const objectName = config.objectName;
+    const nameProperty = config.nameProperty || 'name';
+    const customCenter = config.center;
+    const customScale = config.scale;
+    const parallels = config.parallels;
+    const rotate = config.rotate;
+    const topojsonData = config.topojsonData;
+    if (!topojsonData) {
+        container.innerHTML = '<div style="color:#ef4444;padding:20px">TopoJSON data must be embedded at spec-generation time. No CDN fetches.</div>';
+        return;
+    }
+    const { svg, g, dims } = createSvg(container, spec, { top: 50, right: 20, bottom: 40, left: 20 });
+    const tooltip = createTooltip(container);
+    const valueLookup = {};
+    data.forEach((d) => {
+        const key = String(d[geoField]).toLowerCase().trim();
+        valueLookup[key] = Number(d[valueField]);
+    });
+    const allValues = data.map((d) => Number(d[valueField])).filter((v) => !isNaN(v));
+    const valExtent = d3.extent(allValues);
+    const hasMixedSign = valExtent[0] < 0 && valExtent[1] > 0;
+    const allNegative = valExtent[1] <= 0 && valExtent[0] < 0;
+    let colorScale;
+    if (hasMixedSign) {
+        const maxAbs = Math.max(Math.abs(valExtent[0]), Math.abs(valExtent[1]));
+        colorScale = d3.scaleDiverging(d3.interpolateRdBu).domain([maxAbs, 0, -maxAbs]);
+    }
+    else if (allNegative) {
+        colorScale = d3.scaleSequential(d3.interpolateReds).domain([valExtent[0], valExtent[1]]);
+    }
+    else {
+        const interpolator = getInterpolator(colorScheme);
+        const rangeRatio = valExtent[0] > 0 ? valExtent[1] / valExtent[0] : valExtent[1] > 0 ? Infinity : 1;
+        colorScale = rangeRatio > 100
+            ? d3.scaleQuantize().domain(valExtent).range(d3.quantize(interpolator, 7))
+            : d3.scaleSequential(interpolator).domain(valExtent);
+    }
+    var features;
+    if (objectName) {
+        features = topojson.feature(topojsonData, topojsonData.objects[objectName]);
+    }
+    else {
+        var objects = topojsonData.objects;
+        var objKey;
+        if (objects.countries)
+            objKey = 'countries';
+        else if (objects.states)
+            objKey = 'states';
+        else
+            objKey = Object.keys(objects)[0];
+        features = topojson.feature(topojsonData, objects[objKey]);
+    }
+    var geoProjection;
+    if (projection === 'albersUsa') {
+        geoProjection = d3.geoAlbersUsa().fitSize([dims.innerWidth, dims.innerHeight], features);
+    }
+    else {
+        var projName = 'geo' + projection.charAt(0).toUpperCase() + projection.slice(1);
+        var projFn = d3[projName] || d3.geoNaturalEarth1;
+        geoProjection = projFn();
+        if (rotate)
+            geoProjection.rotate(rotate);
+        if (parallels && typeof geoProjection.parallels === 'function')
+            geoProjection.parallels(parallels);
+        if (customScale) {
+            if (customCenter)
+                geoProjection.center(customCenter);
+            geoProjection.scale(customScale);
+            geoProjection.translate([dims.innerWidth / 2, dims.innerHeight / 2]);
+        }
+        else {
+            geoProjection.fitSize([dims.innerWidth, dims.innerHeight], features);
+        }
+    }
+    var path = d3.geoPath().projection(geoProjection);
+    function lookupValue(feature) {
+        var props = feature.properties || {};
+        var nameFields = [nameProperty, 'name', 'NAME', 'admin', 'ADMIN', 'geounit'];
+        var name = '';
+        for (var i = 0; i < nameFields.length; i++) {
+            if (props[nameFields[i]]) {
+                name = String(props[nameFields[i]]).toLowerCase().trim();
+                break;
+            }
+        }
+        if (name && valueLookup[name] != null)
+            return valueLookup[name];
+        for (var key in valueLookup) {
+            if (name && (name.indexOf(key) >= 0 || key.indexOf(name) >= 0)) {
+                return valueLookup[key];
+            }
+        }
+        return null;
+    }
+    g.selectAll('path.region')
+        .data(features.features)
+        .enter()
+        .append('path')
+        .attr('class', 'region')
+        .attr('d', path)
+        .attr('fill', function (d) {
+        var val = lookupValue(d);
+        return val != null ? colorScale(val) : '#1e2028';
+    })
+        .attr('stroke', '#2d3041')
+        .attr('stroke-width', 0.5)
+        .on('mouseover', function (event, d) {
+        var props = d.properties || {};
+        var name = props[nameProperty] || props.name || props.NAME || props.admin || props.geounit || 'Unknown';
+        var val = lookupValue(d);
+        d3.select(this).attr('stroke', TEXT_COLOR).attr('stroke-width', 1.5);
+        showTooltip(tooltip, '<strong>' + name + '</strong>' +
+            (val != null
+                ? '<br/>' + valueField + ': ' + formatValue(val)
+                : '<br/><em>No data</em>'), event);
+    })
+        .on('mousemove', function (event) {
+        positionTooltip(tooltip, event);
+    })
+        .on('mouseout', function () {
+        d3.select(this).attr('stroke', '#2d3041').attr('stroke-width', 0.5);
+        hideTooltip(tooltip);
+    });
+    var legendWidth = Math.min(200, dims.innerWidth * 0.3);
+    var legendHeight = 10;
+    var legendX = dims.innerWidth - legendWidth - 10;
+    var legendY = dims.innerHeight - 30;
+    var legendScale = d3.scaleLinear().domain(valExtent).range([0, legendWidth]);
+    var legendAxis = d3
+        .axisBottom(legendScale)
+        .ticks(4)
+        .tickFormat(function (d) {
+        return formatValue(d);
+    });
+    var gradientId = 'choropleth-gradient-' + Math.random().toString(36).slice(2, 8);
+    var defs = svg.append('defs');
+    var gradient = defs.append('linearGradient').attr('id', gradientId);
+    gradient.append('stop').attr('offset', '0%').attr('stop-color', colorScale(valExtent[0]));
+    gradient.append('stop').attr('offset', '50%').attr('stop-color', colorScale((valExtent[0] + valExtent[1]) / 2));
+    gradient.append('stop').attr('offset', '100%').attr('stop-color', colorScale(valExtent[1]));
+    var legendG = g.append('g').attr('transform', 'translate(' + legendX + ',' + legendY + ')');
+    legendG
+        .append('rect')
+        .attr('width', legendWidth)
+        .attr('height', legendHeight)
+        .attr('rx', 3)
+        .style('fill', 'url(#' + gradientId + ')');
+    legendG
+        .append('g')
+        .attr('transform', 'translate(0,' + legendHeight + ')')
+        .call(legendAxis)
+        .selectAll('text')
+        .attr('fill', TEXT_MUTED)
+        .attr('font-size', '9px')
+        .attr('font-family', 'Inter, system-ui, sans-serif');
+    legendG.selectAll('.domain, .tick line').attr('stroke', AXIS_COLOR);
+}
+//# sourceMappingURL=choropleth.js.map