mviz 1.4.2

package/dist/charts/waterfall.js

@@ -0,0 +1,232 @@
+/**
+ * Waterfall chart generator
+ */
+import { FONT_SIZE_TINY, FONT_SIZE_XXS, BAR_MAX_WIDTH, getThemeColors, getPalette, getWaterfallColors, getAxisLabelFormatterJs, } from '../core/themes.js';
+import { wrapHtml } from '../core/serializer.js';
+import { inferFormat } from '../core/formatting.js';
+import { registerChart, registerOptions } from './registry.js';
+/**
+ * Build ECharts options for a waterfall chart showing cumulative effect
+ */
+export function buildWaterfallOptions(spec) {
+    const data = (spec.data ?? []);
+    const theme = (spec.theme ?? 'light');
+    // Support both name/value and x/y field names for consistency with other chart types
+    const nameField = spec.name ?? spec.x ?? 'name';
+    const valueField = spec.value ?? spec.y ?? 'value';
+    const colors = getThemeColors(theme);
+    const palette = getPalette(theme);
+    const waterfallColors = getWaterfallColors();
+    // Infer format for y-axis
+    const sampleValue = data[0]?.[valueField] ?? 0;
+    const valueFormat = spec.format ?? inferFormat(valueField, sampleValue);
+    const isCurrency = valueFormat && (valueFormat.includes('usd') || valueFormat === 'usd_auto');
+    const categories = [];
+    const invisibleData = [];
+    const increaseData = [];
+    const decreaseData = [];
+    const totalData = [];
+    let runningTotal = 0;
+    for (const item of data) {
+        const name = String(item[nameField] ?? '');
+        let value = item[valueField];
+        // Support both type: 'total' and isTotal: true for marking total bars
+        const barType = item.type ?? (item.isTotal ? 'total' : 'change');
+        categories.push(name);
+        if (barType === 'total' || barType === 'subtotal') {
+            if (value === null || value === undefined) {
+                value = runningTotal;
+            }
+            else {
+                runningTotal = value;
+            }
+            invisibleData.push(0);
+            increaseData.push('-');
+            decreaseData.push('-');
+            totalData.push(value);
+        }
+        else {
+            if (value !== null && value !== undefined) {
+                if (value >= 0) {
+                    invisibleData.push(runningTotal);
+                    increaseData.push(value);
+                    decreaseData.push('-');
+                    totalData.push('-');
+                    runningTotal += value;
+                }
+                else {
+                    runningTotal += value;
+                    invisibleData.push(runningTotal);
+                    increaseData.push('-');
+                    decreaseData.push(Math.abs(value));
+                    totalData.push('-');
+                }
+            }
+        }
+    }
+    // Label formatter JS function
+    const labelFormatter = {
+        _js_: `function(params) {
+      var value = params.value;
+      if (value === '-' || value === null || value === undefined) return '';
+      var absVal = Math.abs(value);
+      var isNeg = value < 0;
+      var formatted;
+      if (absVal >= 1000000000) {
+        var scaled = absVal / 1000000000;
+        if (scaled >= 100) formatted = scaled.toFixed(1) + 'b';
+        else if (scaled >= 10) formatted = scaled.toFixed(2) + 'b';
+        else formatted = scaled.toFixed(3) + 'b';
+      } else if (absVal >= 1000000) {
+        var scaled = absVal / 1000000;
+        if (scaled >= 100) formatted = scaled.toFixed(1) + 'm';
+        else if (scaled >= 10) formatted = scaled.toFixed(2) + 'm';
+        else formatted = scaled.toFixed(3) + 'm';
+      } else if (absVal >= 10000) {
+        var scaled = absVal / 1000;
+        if (scaled >= 100) formatted = scaled.toFixed(1) + 'k';
+        else formatted = scaled.toFixed(2) + 'k';
+      } else if (absVal >= 1000) {
+        formatted = absVal.toLocaleString();
+      } else {
+        formatted = absVal.toString();
+      }
+      return isNeg ? '(' + formatted + ')' : formatted;
+    }`,
+    };
+    // Tooltip formatter
+    const tooltipFormatter = {
+        _js_: `function(params) {
+      var result = '<div style="font-weight:600;margin-bottom:4px">' + params[0].axisValue + '</div>';
+      var hasContent = false;
+      for (var i = 0; i < params.length; i++) {
+        var p = params[i];
+        if (p.seriesName === 'Invisible') continue;
+        if (p.value === '-' || p.value === 0 || p.value === null || p.value === undefined) continue;
+        result += '<div>' + p.marker + ' ' + p.seriesName + ': ' + p.value.toLocaleString() + '</div>';
+        hasContent = true;
+      }
+      return hasContent ? result : null;
+    }`,
+    };
+    return {
+        backgroundColor: 'transparent',
+        animation: false,
+        tooltip: {
+            trigger: 'axis',
+            axisPointer: { type: 'none' },
+            backgroundColor: colors.paper,
+            borderColor: colors.border,
+            borderWidth: 1,
+            borderRadius: 6,
+            shadowBlur: 12,
+            shadowColor: 'rgba(0, 0, 0, 0.15)',
+            shadowOffsetX: 0,
+            shadowOffsetY: 4,
+            padding: [10, 14],
+            textStyle: { color: colors.text, fontSize: 12 },
+            formatter: tooltipFormatter,
+        },
+        grid: {
+            left: '2%',
+            right: '2%',
+            top: '10%',
+            bottom: '8%',
+            containLabel: true,
+        },
+        xAxis: {
+            type: 'category',
+            data: categories,
+            axisLine: { show: false },
+            axisTick: { show: false },
+            axisLabel: {
+                color: colors.textSecondary,
+                fontSize: FONT_SIZE_XXS,
+                margin: 8,
+                interval: 0,
+                rotate: 45,
+            },
+        },
+        yAxis: {
+            type: 'value',
+            axisLine: { show: false },
+            axisTick: { show: false },
+            splitLine: { show: false },
+            axisLabel: {
+                color: colors.textSecondary,
+                fontSize: FONT_SIZE_TINY,
+                formatter: getAxisLabelFormatterJs(!!isCurrency),
+            },
+        },
+        series: [
+            {
+                name: 'Invisible',
+                type: 'bar',
+                stack: 'waterfall',
+                data: invisibleData,
+                itemStyle: { color: 'transparent' },
+                emphasis: { itemStyle: { color: 'transparent' } },
+            },
+            {
+                name: 'Increase',
+                type: 'bar',
+                stack: 'waterfall',
+                data: increaseData,
+                barMaxWidth: BAR_MAX_WIDTH,
+                itemStyle: { color: waterfallColors.increase },
+                label: {
+                    show: true,
+                    position: 'top',
+                    color: colors.textSecondary,
+                    fontSize: FONT_SIZE_TINY,
+                    offset: [0, -2],
+                    formatter: labelFormatter,
+                },
+            },
+            {
+                name: 'Decrease',
+                type: 'bar',
+                stack: 'waterfall',
+                data: decreaseData,
+                barMaxWidth: BAR_MAX_WIDTH,
+                itemStyle: { color: waterfallColors.decrease },
+                label: {
+                    show: true,
+                    position: 'bottom',
+                    color: colors.textSecondary,
+                    fontSize: FONT_SIZE_TINY,
+                    offset: [0, 2],
+                    formatter: labelFormatter,
+                },
+            },
+            {
+                name: 'Total',
+                type: 'bar',
+                stack: 'waterfall',
+                data: totalData,
+                barMaxWidth: BAR_MAX_WIDTH,
+                itemStyle: { color: palette[0] },
+                label: {
+                    show: true,
+                    position: 'top',
+                    color: colors.textSecondary,
+                    fontSize: FONT_SIZE_TINY,
+                    offset: [0, -2],
+                    formatter: labelFormatter,
+                },
+            },
+        ],
+    };
+}
+/**
+ * Generate a waterfall chart
+ */
+function generateWaterfall(spec) {
+    const height = typeof spec.height === 'number' ? spec.height : 300;
+    return wrapHtml('chart', buildWaterfallOptions(spec), '', '100%', height);
+}
+// Register the chart
+registerChart('waterfall')(generateWaterfall);
+registerOptions('waterfall')(buildWaterfallOptions);
+export { generateWaterfall };
+//# sourceMappingURL=waterfall.js.map

package/dist/charts/waterfall.js.map

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

package/dist/charts/xmr.d.ts

@@ -0,0 +1,14 @@
+/**
+ * XmR (Individual-Moving Range) control chart generator
+ */
+import type { ChartSpec } from '../types.js';
+/**
+ * Build ECharts options for an XmR control chart
+ */
+export declare function buildXmrOptions(spec: ChartSpec): Record<string, unknown>;
+/**
+ * Generate an XmR control chart
+ */
+declare function generateXmr(spec: ChartSpec): string;
+export { generateXmr };
+//# sourceMappingURL=xmr.d.ts.map

package/dist/charts/xmr.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xmr.d.ts","sourceRoot":"","sources":["../../charts/xmr.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAoB,MAAM,aAAa,CAAC;AA6J/D;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA6SxE;AAcD;;GAEG;AACH,iBAAS,WAAW,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAK5C;AAMD,OAAO,EAAE,WAAW,EAAE,CAAC"}