@rowsncolumns/charts 27.0.30

package/dist/esm/utils/waterfall.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Waterfall computation shared by chart renderers.
+ *
+ * Plotly has a native waterfall trace that takes raw values and computes
+ * the cumulative offsets itself. Echarts has no native waterfall; the
+ * renderer pre-computes two parallel series:
+ *   - placeholder: transparent bars at the cumulative offset, used as
+ *     "spacers" so the visible bar starts at the right baseline.
+ *   - value: the actual bar value (rendered on top of the placeholder).
+ *
+ * Total bars (where `isTotal` is true at that position) reset to baseline.
+ *
+ * `cumulative` is the running total after the bar — the y coordinate of
+ * the Excel-style connector line drawn across to the next bar.
+ */
+export type WaterfallStep = {
+    label: string;
+    placeholder: number;
+    value: number;
+    isTotal: boolean;
+    cumulative: number;
+};
+export declare const computeWaterfall: (values: (number | null | undefined)[], labels: string[], totalIndices?: Set<number>) => WaterfallStep[];
+//# sourceMappingURL=waterfall.d.ts.map

package/dist/esm/utils/waterfall.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"waterfall.d.ts","sourceRoot":"","sources":["../../../utils/waterfall.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,MAAM,MAAM,aAAa,GAAG;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAC3B,QAAQ,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,EAAE,EACrC,QAAQ,MAAM,EAAE,EAChB,eAAc,GAAG,CAAC,MAAM,CAAa,KACpC,aAAa,EAsCf,CAAC"}

package/dist/esm/utils/waterfall.js

@@ -0,0 +1,55 @@
+/**
+ * Waterfall computation shared by chart renderers.
+ *
+ * Plotly has a native waterfall trace that takes raw values and computes
+ * the cumulative offsets itself. Echarts has no native waterfall; the
+ * renderer pre-computes two parallel series:
+ *   - placeholder: transparent bars at the cumulative offset, used as
+ *     "spacers" so the visible bar starts at the right baseline.
+ *   - value: the actual bar value (rendered on top of the placeholder).
+ *
+ * Total bars (where `isTotal` is true at that position) reset to baseline.
+ *
+ * `cumulative` is the running total after the bar — the y coordinate of
+ * the Excel-style connector line drawn across to the next bar.
+ */
+export const computeWaterfall = (values, labels, totalIndices = new Set()) => {
+    const steps = [];
+    let cumulative = 0;
+    for (let i = 0; i < values.length; i++) {
+        const v = typeof values[i] === "number" ? values[i] : 0;
+        const isTotal = totalIndices.has(i);
+        if (isTotal) {
+            cumulative = v;
+            steps.push({
+                label: labels[i] ?? String(i),
+                placeholder: 0,
+                value: v,
+                isTotal: true,
+                cumulative,
+            });
+            continue;
+        }
+        if (v >= 0) {
+            steps.push({
+                label: labels[i] ?? String(i),
+                placeholder: cumulative,
+                value: v,
+                isTotal: false,
+                cumulative: cumulative + v,
+            });
+            cumulative += v;
+        }
+        else {
+            cumulative += v;
+            steps.push({
+                label: labels[i] ?? String(i),
+                placeholder: cumulative,
+                value: -v,
+                isTotal: false,
+                cumulative,
+            });
+        }
+    }
+    return steps;
+};

package/dist/esm/utils/webgl.d.ts

@@ -0,0 +1,12 @@
+/**
+ * WebGL availability probe for the 3-D chart pipeline.
+ *
+ * SSR-safe: nothing touches `document`/`window` at module scope, and the
+ * probe returns false when no DOM exists. The (browser) result is cached —
+ * context creation is not free and availability doesn't change within a
+ * page's lifetime.
+ */
+export declare const isWebGLAvailable: () => boolean;
+/** Test hook — clears the cached probe result. */
+export declare const __resetWebGLAvailabilityForTests: () => void;
+//# sourceMappingURL=webgl.d.ts.map

package/dist/esm/utils/webgl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webgl.d.ts","sourceRoot":"","sources":["../../../utils/webgl.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,eAAO,MAAM,gBAAgB,QAAO,OAgBnC,CAAC;AAEF,kDAAkD;AAClD,eAAO,MAAM,gCAAgC,QAAO,IAEnD,CAAC"}

package/dist/esm/utils/webgl.js

@@ -0,0 +1,30 @@
+/**
+ * WebGL availability probe for the 3-D chart pipeline.
+ *
+ * SSR-safe: nothing touches `document`/`window` at module scope, and the
+ * probe returns false when no DOM exists. The (browser) result is cached —
+ * context creation is not free and availability doesn't change within a
+ * page's lifetime.
+ */
+let cachedResult;
+export const isWebGLAvailable = () => {
+    if (cachedResult !== undefined)
+        return cachedResult;
+    if (typeof document === "undefined") {
+        // SSR / non-DOM environment. Not cached: the module instance could in
+        // principle be shared with a later DOM environment.
+        return false;
+    }
+    try {
+        const canvas = document.createElement("canvas");
+        cachedResult = Boolean(canvas.getContext("webgl") ?? canvas.getContext("experimental-webgl"));
+    }
+    catch {
+        cachedResult = false;
+    }
+    return cachedResult;
+};
+/** Test hook — clears the cached probe result. */
+export const __resetWebGLAvailabilityForTests = () => {
+    cachedResult = undefined;
+};

package/dist/esm/vitest.config.d.ts

@@ -0,0 +1,3 @@
+declare const _default: import("vite").UserConfig;
+export default _default;
+//# sourceMappingURL=vitest.config.d.ts.map

package/dist/esm/vitest.config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vitest.config.d.ts","sourceRoot":"","sources":["../../vitest.config.ts"],"names":[],"mappings":";AAEA,wBAKG"}

package/dist/esm/vitest.config.js

@@ -0,0 +1,7 @@
+import { defineConfig } from "vitest/config";
+export default defineConfig({
+    test: {
+        globals: true,
+        environment: "node",
+    },
+});

package/package.json

@@ -0,0 +1,96 @@
+{
+  "name": "@rowsncolumns/charts",
+  "version": "27.0.30",
+  "author": "Vinay M",
+  "license": "SEE LICENSE IN LICENSE.md",
+  "main": "./dist/cjs/index.js",
+  "module": "./dist/esm/index.js",
+  "exports": {
+    ".": {
+      "require": "./dist/cjs/index.js",
+      "import": "./dist/esm/index.js"
+    },
+    "./interface/create-chart": {
+      "types": "./dist/esm/interface/create-chart.d.ts",
+      "require": "./dist/cjs/interface/create-chart.js",
+      "import": "./dist/esm/interface/create-chart.js"
+    },
+    "./interface/delete-chart": {
+      "types": "./dist/esm/interface/delete-chart.d.ts",
+      "require": "./dist/cjs/interface/delete-chart.js",
+      "import": "./dist/esm/interface/delete-chart.js"
+    },
+    "./interface/move-chart": {
+      "types": "./dist/esm/interface/move-chart.d.ts",
+      "require": "./dist/cjs/interface/move-chart.js",
+      "import": "./dist/esm/interface/move-chart.js"
+    },
+    "./interface/resize-chart": {
+      "types": "./dist/esm/interface/resize-chart.d.ts",
+      "require": "./dist/cjs/interface/resize-chart.js",
+      "import": "./dist/esm/interface/resize-chart.js"
+    },
+    "./interface/update-chart": {
+      "types": "./dist/esm/interface/update-chart.d.ts",
+      "require": "./dist/cjs/interface/update-chart.js",
+      "import": "./dist/esm/interface/update-chart.js"
+    },
+    "./basic-chart": {
+      "require": "./dist/cjs/basic-chart/index.js",
+      "import": "./dist/esm/basic-chart/index.js"
+    },
+    "./plotly/basic-chart": {
+      "require": "./dist/cjs/plotly/basic-chart/index.js",
+      "import": "./dist/esm/plotly/basic-chart/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc -b ./tsconfig.cjs.json ./tsconfig.esm.json",
+    "clean": "rimraf dist",
+    "build:watch": "tsc -p ./tsconfig.esm.json --watch",
+    "test": "vitest --run",
+    "lint": "eslint . --ext .ts,.tsx",
+    "types": "tsc -p . --noEmit",
+    "list": "tsc --listFiles"
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "echarts": "^6.1.0",
+    "echarts-gl": "^2.1.0",
+    "formik": "^2.4.6",
+    "topojson-client": "^3.1.0",
+    "world-atlas": "^2.0.2"
+  },
+  "devDependencies": {
+    "@rowsncolumns/calculator": ">=7.2.29",
+    "@rowsncolumns/grid": ">=13.2.32",
+    "@rowsncolumns/spreadsheet": ">=10.2.68",
+    "@rowsncolumns/spreadsheet-state": ">=28.0.66",
+    "@rowsncolumns/toolkit": ">=24.4.1",
+    "@rowsncolumns/ui": ">=15.0.38",
+    "@rowsncolumns/utils": ">=9.2.35",
+    "@types/react-plotly.js": "^2.6.3",
+    "echarts": "^5.6.0",
+    "formik": "^2.4.6",
+    "immer": "^10.1.1",
+    "plotly.js": "^3.1.1",
+    "react-plotly.js": "^2.6.0"
+  },
+  "peerDependencies": {
+    "@rowsncolumns/calculator": ">=7.2.29",
+    "@rowsncolumns/grid": ">=13.2.32",
+    "@rowsncolumns/spreadsheet": ">=10.2.68",
+    "@rowsncolumns/spreadsheet-state": ">=28.0.66",
+    "@rowsncolumns/toolkit": ">=24.4.1",
+    "@rowsncolumns/ui": ">=15.0.38",
+    "@rowsncolumns/utils": ">=9.2.35",
+    "immer": ">10.0.0",
+    "jotai": ">=2.10.3",
+    "plotly.js": ">=3",
+    "react": ">=18.0.0",
+    "react-dom": ">=18.0.0",
+    "react-plotly.js": ">=2"
+  }
+}