@rowsncolumns/utils 9.2.35

package/dist/esm/table-styles.js

@@ -0,0 +1,367 @@
+/**
+ * Table styles and banded range utilities
+ * Shared between toolkit (import) and app (rendering)
+ */
+const stripeTint = 0.8;
+const colorIndexes = [1, 4, 5, 6, 7, 8, 9];
+/**
+ * Get table border styles map with all table themes and their banded definitions
+ */
+export const getTableBorderStyles = (showRowStripes, showColumnStripes) => {
+    let runningLightIndex = 1;
+    let runningMediumIndex = 1;
+    let runningDarkIndex = 1;
+    return new Map([
+        [
+            "Light",
+            [
+                ["None", 0, 0, undefined],
+                ...colorIndexes.map((value) => {
+                    return [
+                        ("TableStyleLight" + runningLightIndex++),
+                        stripeTint,
+                        1,
+                        {
+                            rowProperties: {
+                                firstBandColor: {
+                                    theme: value,
+                                    tint: showRowStripes ? stripeTint : 1,
+                                },
+                                secondBandColor: showRowStripes
+                                    ? {
+                                        theme: 0,
+                                    }
+                                    : undefined,
+                                headerBorder: {
+                                    top: {
+                                        width: 1,
+                                        style: "solid",
+                                        color: { theme: value },
+                                    },
+                                    bottom: {
+                                        width: 1,
+                                        style: "solid",
+                                        color: { theme: value },
+                                    },
+                                },
+                                footerBorder: {
+                                    bottom: {
+                                        width: 1,
+                                        style: "solid",
+                                        color: { theme: value },
+                                    },
+                                },
+                            },
+                            columnProperties: showColumnStripes
+                                ? {
+                                    firstBandColor: {
+                                        theme: value,
+                                        tint: showColumnStripes ? stripeTint : 1,
+                                    },
+                                }
+                                : undefined,
+                        },
+                    ];
+                }),
+                ...colorIndexes.map((value) => {
+                    return [
+                        ("TableStyleLight" + runningLightIndex++),
+                        undefined,
+                        undefined,
+                        {
+                            rowProperties: {
+                                headerColor: { theme: value },
+                            },
+                        },
+                    ];
+                }),
+                ...colorIndexes.map((value) => {
+                    const border = {
+                        width: 1,
+                        style: "solid",
+                        color: { theme: value },
+                    };
+                    return [
+                        ("TableStyleLight" + runningLightIndex++),
+                        stripeTint,
+                        1,
+                        {
+                            rowProperties: {
+                                firstBandColor: {
+                                    theme: value,
+                                    tint: showRowStripes ? stripeTint : 1,
+                                },
+                                secondBandColor: showRowStripes
+                                    ? {
+                                        theme: 0,
+                                    }
+                                    : undefined,
+                                firstBandBorder: {
+                                    top: border,
+                                    left: border,
+                                    right: border,
+                                    bottom: border,
+                                },
+                                headerBorder: {
+                                    top: border,
+                                    left: border,
+                                    right: border,
+                                    bottom: border,
+                                },
+                            },
+                            columnProperties: showColumnStripes
+                                ? {
+                                    firstBandColor: {
+                                        theme: value,
+                                        tint: showColumnStripes ? stripeTint : 1,
+                                    },
+                                }
+                                : undefined,
+                        },
+                    ];
+                }),
+            ],
+        ],
+        [
+            "Medium",
+            [
+                ...colorIndexes.map((value) => {
+                    return [
+                        ("TableStyleMedium" + runningMediumIndex++),
+                        stripeTint,
+                        1,
+                        {
+                            rowProperties: {
+                                headerColor: { theme: value },
+                                firstBandColor: {
+                                    theme: value,
+                                    tint: showRowStripes ? stripeTint : 1,
+                                },
+                                secondBandColor: showRowStripes
+                                    ? {
+                                        theme: 0,
+                                    }
+                                    : undefined,
+                                firstBandBorder: {
+                                    bottom: {
+                                        width: 1,
+                                        style: "solid",
+                                        color: { theme: value },
+                                    },
+                                },
+                            },
+                            columnProperties: showColumnStripes
+                                ? {
+                                    firstBandColor: {
+                                        theme: value,
+                                        tint: showColumnStripes ? stripeTint : 1,
+                                    },
+                                }
+                                : undefined,
+                        },
+                    ];
+                }),
+                ...colorIndexes.map((value) => {
+                    return [
+                        ("TableStyleMedium" + runningMediumIndex++),
+                        0.6,
+                        0.8,
+                        {
+                            rowProperties: {
+                                headerColor: { theme: value },
+                                firstBandColor: {
+                                    theme: value,
+                                    tint: showRowStripes ? 0.6 : 0.8,
+                                },
+                                secondBandColor: {
+                                    theme: value,
+                                    tint: 0.8,
+                                },
+                            },
+                            columnProperties: showColumnStripes
+                                ? {
+                                    firstBandColor: {
+                                        theme: value,
+                                        tint: showColumnStripes ? 0.6 : 0.8,
+                                    },
+                                }
+                                : undefined,
+                        },
+                    ];
+                }),
+                ...colorIndexes.map((value) => {
+                    const border = {
+                        width: 2,
+                        style: "solid",
+                        color: { theme: 1 },
+                    };
+                    return [
+                        ("TableStyleMedium" + runningMediumIndex++),
+                        -0.15,
+                        1,
+                        {
+                            rowProperties: {
+                                headerColor: { theme: value },
+                                firstBandColor: {
+                                    theme: 0,
+                                    tint: showRowStripes ? -0.15 : 1,
+                                },
+                                secondBandColor: showRowStripes
+                                    ? {
+                                        theme: 0,
+                                    }
+                                    : undefined,
+                                headerBorder: {
+                                    top: border,
+                                },
+                                footerBorder: {
+                                    bottom: border,
+                                },
+                            },
+                            columnProperties: showColumnStripes
+                                ? {
+                                    firstBandColor: {
+                                        theme: 0,
+                                        tint: showColumnStripes ? -0.15 : 1,
+                                    },
+                                }
+                                : undefined,
+                        },
+                    ];
+                }),
+                ...colorIndexes.map((value) => {
+                    const border = {
+                        width: 1,
+                        style: "solid",
+                        color: { theme: value },
+                    };
+                    return [
+                        ("TableStyleMedium" + runningMediumIndex++),
+                        stripeTint,
+                        0.9,
+                        {
+                            rowProperties: {
+                                headerColor: {
+                                    theme: value,
+                                    tint: 0.9,
+                                },
+                                firstBandColor: {
+                                    theme: value,
+                                    tint: showRowStripes ? stripeTint : 0.9,
+                                },
+                                secondBandColor: {
+                                    theme: value,
+                                    tint: 0.9,
+                                },
+                                firstBandBorder: {
+                                    top: border,
+                                    left: border,
+                                    right: border,
+                                    bottom: border,
+                                },
+                                headerBorder: {
+                                    top: border,
+                                    left: border,
+                                    right: border,
+                                    bottom: border,
+                                },
+                            },
+                            columnProperties: showColumnStripes
+                                ? {
+                                    firstBandColor: {
+                                        theme: value,
+                                        tint: showColumnStripes ? stripeTint : 0.9,
+                                    },
+                                }
+                                : undefined,
+                        },
+                    ];
+                }),
+            ],
+        ],
+        [
+            "Dark",
+            [
+                ...colorIndexes.map((value) => {
+                    const firstTint = value - 1 === 0 ? 0.25 : -0.25;
+                    const secondTint = value - 1 === 0 ? 0.5 : 0;
+                    return [
+                        ("TableStyleDark" + runningDarkIndex++),
+                        firstTint,
+                        secondTint,
+                        {
+                            rowProperties: {
+                                headerColor: { theme: 1 },
+                                firstBandColor: {
+                                    theme: value,
+                                    tint: showRowStripes ? firstTint : secondTint,
+                                },
+                                secondBandColor: {
+                                    theme: value,
+                                    tint: secondTint,
+                                },
+                            },
+                            columnProperties: showColumnStripes
+                                ? {
+                                    firstBandColor: {
+                                        theme: value,
+                                        tint: showColumnStripes ? firstTint : secondTint,
+                                    },
+                                }
+                                : undefined,
+                        },
+                    ];
+                }),
+                ...[1, 5, 7, 9].map((value) => {
+                    const firstTint = value - 1 === 0 ? -0.35 : 0.6;
+                    const secondTint = value - 1 === 0 ? -0.15 : 0.8;
+                    return [
+                        ("TableStyleDark" + runningDarkIndex++),
+                        firstTint,
+                        secondTint,
+                        {
+                            rowProperties: {
+                                headerColor: { theme: value },
+                                firstBandColor: {
+                                    theme: value - 1,
+                                    tint: showRowStripes ? firstTint : secondTint,
+                                },
+                                secondBandColor: {
+                                    theme: value - 1,
+                                    tint: secondTint,
+                                },
+                            },
+                            columnProperties: showColumnStripes
+                                ? {
+                                    firstBandColor: {
+                                        theme: value - 1,
+                                        tint: showColumnStripes ? firstTint : secondTint,
+                                    },
+                                }
+                                : undefined,
+                        },
+                    ];
+                }),
+            ],
+        ],
+    ]);
+};
+/**
+ * Find the banded definition for a given table theme
+ */
+export const findMatchingBandProperty = (tableTheme, showRowStripes, showColumnStripes) => {
+    const bandProperties = getTableBorderStyles(showRowStripes, showColumnStripes);
+    let result;
+    bandProperties.forEach((tableStyles) => {
+        if (result)
+            return;
+        for (let i = 0; i < tableStyles.length; i++) {
+            const [themeName, , , bandDefinition] = tableStyles[i];
+            if (themeName === tableTheme) {
+                result = bandDefinition ? { ...bandDefinition } : undefined;
+                return;
+            }
+        }
+    });
+    return result;
+};

package/dist/esm/tsconfig.esm.tsbuildinfo

@@ -0,0 +1 @@
+{"root":["../../array.ts","../../cell-data-helpers.ts","../../color.ts","../../colors.ts","../../conditional-format.ts","../../content-hash.ts","../../data-validation.ts","../../date.ts","../../dom.ts","../../formatter.ts","../../formula-refs.ts","../../formula.ts","../../index.ts","../../locale.ts","../../log.ts","../../memoize.ts","../../numbers.ts","../../selection.ts","../../shared-string-canonical.ts","../../sort.ts","../../string.ts","../../table-styles.ts","../../typeguards.ts","../../uuid.ts","../../vitest.config.ts"],"version":"5.8.3"}

package/dist/esm/typeguards.d.ts

@@ -0,0 +1,4 @@
+export declare const isDefined: <T>(val: T | undefined | null) => val is T;
+export declare const isNil: <T>(value: T | undefined | null) => value is undefined | null;
+export declare const isNilOrBlank: (value: string | undefined | null) => value is "" | null | undefined;
+//# sourceMappingURL=typeguards.d.ts.map

package/dist/esm/typeguards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typeguards.d.ts","sourceRoot":"","sources":["../../typeguards.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,SAAS,GAAI,CAAC,EAAE,KAAK,CAAC,GAAG,SAAS,GAAG,IAAI,KAAG,GAAG,IAAI,CAC7B,CAAC;AAGpC,eAAO,MAAM,KAAK,GAAI,CAAC,EACrB,OAAO,CAAC,GAAG,SAAS,GAAG,IAAI,KAC1B,KAAK,IAAI,SAAS,GAAG,IAAyB,CAAC;AAElD,eAAO,MAAM,YAAY,GACvB,OAAO,MAAM,GAAG,SAAS,GAAG,IAAI,KAC/B,KAAK,IAAI,EAAE,GAAG,IAAI,GAAG,SAEvB,CAAC"}

package/dist/esm/typeguards.js

@@ -0,0 +1,7 @@
+// Typeguards
+export const isDefined = (val) => val !== undefined && val !== null;
+// Typeguards isNil
+export const isNil = (value) => !isDefined(value);
+export const isNilOrBlank = (value) => {
+    return isNil(value) || String(value).trim() === "";
+};

package/dist/esm/uuid.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Generate a random uuid
+ * Conform to Google Sheet 9 Digit ID
+ * @returns
+ */
+export declare const uuid: () => number;
+export declare const uuidString: () => string;
+//# sourceMappingURL=uuid.d.ts.map

package/dist/esm/uuid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uuid.d.ts","sourceRoot":"","sources":["../../uuid.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,IAAI,cAA0D,CAAC;AAE5E,eAAO,MAAM,UAAU,cAqBtB,CAAC"}

package/dist/esm/uuid.js

@@ -0,0 +1,25 @@
+/**
+ * Generate a random uuid
+ * Conform to Google Sheet 9 Digit ID
+ * @returns
+ */
+export const uuid = () => Math.floor(Math.random() * 900000000) + 100000000;
+export const uuidString = () => {
+    // Check for crypto in various environments (Node.js, browser, etc.)
+    const cryptoObj = typeof crypto !== "undefined"
+        ? crypto
+        : typeof window !== "undefined" && window.crypto
+            ? window.crypto
+            : typeof global !== "undefined" && global.crypto
+                ? global.crypto
+                : null;
+    if (cryptoObj && typeof cryptoObj.randomUUID === "function") {
+        return cryptoObj.randomUUID();
+    }
+    const chars = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789";
+    let result = "";
+    for (let i = 0; i < 9; i++) {
+        result += chars.charAt(Math.floor(Math.random() * chars.length));
+    }
+    return result;
+};

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,49 @@
+{
+  "name": "@rowsncolumns/utils",
+  "version": "9.2.35",
+  "author": "Vinay M",
+  "license": "SEE LICENSE IN LICENSE.md",
+  "main": "./dist/cjs/index.js",
+  "module": "./dist/esm/index.js",
+  "exports": {
+    ".": {
+      "import": "./dist/esm/index.js",
+      "require": "./dist/cjs/index.js"
+    },
+    "./selection": {
+      "import": "./dist/esm/selection.js",
+      "require": "./dist/cjs/selection.js"
+    },
+    "./colors": {
+      "import": "./dist/esm/colors.js",
+      "require": "./dist/cjs/colors.js"
+    },
+    "./formula-refs": {
+      "import": "./dist/esm/formula-refs.js",
+      "require": "./dist/cjs/formula-refs.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",
+    "types": "tsc -p . --noEmit"
+  },
+  "files": [
+    "dist"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/rowsncolumns/spreadsheet.git"
+  },
+  "bugs": {
+    "url": "https://github.com/rowsncolumns/spreadsheet/issues"
+  },
+  "dependencies": {
+    "numfmt": "^3.2.2",
+    "@rowsncolumns/common-types": ">=5.2.29"
+  },
+  "devDependencies": {},
+  "peerDependencies": {}
+}