@smallwebco/tinypivot-core 1.0.0

package/dist/utils/index.js

@@ -0,0 +1,176 @@
+/**
+ * Detect column data type from values
+ */
+export function detectColumnType(values) {
+    const nonNullValues = values.filter(v => v !== null && v !== undefined && v !== '');
+    if (nonNullValues.length === 0)
+        return 'string';
+    const sample = nonNullValues.slice(0, 100);
+    let numberCount = 0;
+    let dateCount = 0;
+    let booleanCount = 0;
+    for (const val of sample) {
+        if (typeof val === 'boolean') {
+            booleanCount++;
+        }
+        else if (typeof val === 'number' || (!Number.isNaN(Number(val)) && val !== '')) {
+            numberCount++;
+        }
+        else if (val instanceof Date || !Number.isNaN(Date.parse(String(val)))) {
+            dateCount++;
+        }
+    }
+    const threshold = sample.length * 0.8;
+    if (booleanCount >= threshold)
+        return 'boolean';
+    if (numberCount >= threshold)
+        return 'number';
+    if (dateCount >= threshold)
+        return 'date';
+    return 'string';
+}
+/**
+ * Detect field type from sample data (for pivot)
+ */
+export function detectFieldType(data, field) {
+    const values = data.map(row => row[field]).filter(v => v !== null && v !== undefined && v !== '');
+    const sample = values.slice(0, 100);
+    let numberCount = 0;
+    const uniqueSet = new Set();
+    for (const val of sample) {
+        uniqueSet.add(String(val));
+        if (typeof val === 'number' || (!Number.isNaN(Number(val)) && val !== '')) {
+            numberCount++;
+        }
+    }
+    const isNumeric = numberCount >= sample.length * 0.8;
+    return {
+        field,
+        type: isNumeric ? 'number' : 'string',
+        uniqueCount: uniqueSet.size,
+        isNumeric,
+    };
+}
+/**
+ * Get unique values for a column (for Excel-style filter dropdown)
+ */
+export function getColumnUniqueValues(data, columnKey, maxValues = 500) {
+    const values = [];
+    let nullCount = 0;
+    for (const row of data) {
+        const value = row[columnKey];
+        if (value === null || value === undefined || value === '') {
+            nullCount++;
+        }
+        else {
+            values.push(value);
+        }
+    }
+    // Get unique values
+    const uniqueSet = new Set();
+    for (const val of values) {
+        uniqueSet.add(String(val));
+        if (uniqueSet.size >= maxValues)
+            break;
+    }
+    const uniqueValues = Array.from(uniqueSet).sort((a, b) => {
+        // Natural sort for numbers
+        const numA = Number.parseFloat(a);
+        const numB = Number.parseFloat(b);
+        if (!Number.isNaN(numA) && !Number.isNaN(numB)) {
+            return numA - numB;
+        }
+        return a.localeCompare(b);
+    });
+    return {
+        uniqueValues,
+        totalCount: data.length,
+        nullCount,
+        type: detectColumnType(values),
+    };
+}
+/**
+ * Format cell value for display
+ */
+export function formatCellValue(value, type) {
+    if (value === null || value === undefined)
+        return '';
+    if (value === '')
+        return '';
+    switch (type) {
+        case 'number': {
+            const num = typeof value === 'number' ? value : Number.parseFloat(String(value));
+            if (Number.isNaN(num))
+                return String(value);
+            // Format with commas for large numbers
+            if (Math.abs(num) >= 1000) {
+                return num.toLocaleString('en-US', { maximumFractionDigits: 2 });
+            }
+            return num.toLocaleString('en-US', { maximumFractionDigits: 4 });
+        }
+        case 'date': {
+            const date = value instanceof Date ? value : new Date(String(value));
+            if (Number.isNaN(date.getTime()))
+                return String(value);
+            return date.toLocaleDateString('en-US', {
+                year: 'numeric',
+                month: 'short',
+                day: 'numeric',
+            });
+        }
+        case 'boolean':
+            return value ? 'Yes' : 'No';
+        default:
+            return String(value);
+    }
+}
+/**
+ * Format number for display with appropriate precision
+ */
+export function formatNumber(value, options) {
+    if (value === null)
+        return '-';
+    const maxDigits = options?.maximumFractionDigits ?? (Math.abs(value) >= 1000 ? 2 : 4);
+    return value.toLocaleString('en-US', { maximumFractionDigits: maxDigits });
+}
+/**
+ * Create a composite key from field values (for pivot grouping)
+ */
+export function makeKey(row, fields) {
+    return fields.map(f => String(row[f] ?? '(blank)')).join('|||');
+}
+/**
+ * Parse composite key back to values
+ */
+export function parseKey(key) {
+    return key.split('|||');
+}
+/**
+ * Natural sort comparator
+ */
+export function naturalSort(a, b) {
+    const numA = Number.parseFloat(a);
+    const numB = Number.parseFloat(b);
+    if (!Number.isNaN(numA) && !Number.isNaN(numB)) {
+        return numA - numB;
+    }
+    return a.localeCompare(b, undefined, { numeric: true, sensitivity: 'base' });
+}
+/**
+ * Debounce function
+ */
+export function debounce(fn, delay) {
+    let timeoutId = null;
+    return (...args) => {
+        if (timeoutId)
+            clearTimeout(timeoutId);
+        timeoutId = setTimeout(() => fn(...args), delay);
+    };
+}
+/**
+ * Clamp a number between min and max
+ */
+export function clamp(value, min, max) {
+    return Math.max(min, Math.min(max, value));
+}
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

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

package/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "@smallwebco/tinypivot-core",
+  "version": "1.0.0",
+  "description": "Core logic for TinyPivot - framework agnostic pivot table and data grid utilities",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "devDependencies": {
+    "typescript": "~5.3.3"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch"
+  }
+}