@nshiab/simple-data-analysis-core 1.0.1 → 2.0.0

package/script/methods/accumulate.js

@@ -0,0 +1,43 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = accumulate;
+const quoteIdentifier_js_1 = __importDefault(require("../helpers/quoteIdentifier.js"));
+const assertNewColumns_js_1 = __importDefault(require("../helpers/assertNewColumns.js"));
+const stringToArray_js_1 = __importDefault(require("../helpers/stringToArray.js"));
+const mergeOptions_js_1 = __importDefault(require("../helpers/mergeOptions.js"));
+const queryDB_js_1 = __importDefault(require("../helpers/queryDB.js"));
+const queueOp_js_1 = __importDefault(require("../helpers/queueOp.js"));
+function accumulate(simpleTable, column, newColumn, options = {}) {
+    // The accumulation order is based on rowid, which only exists on the
+    // materialized table, not on the output of a fused step: it executes as a
+    // barrier.
+    options = structuredClone(options);
+    (0, queueOp_js_1.default)(simpleTable, {
+        kind: "barrier",
+        method: "accumulate()",
+        parameters: { column, newColumn, options },
+        execute: async () => {
+            // A SELECT *, expr AS col colliding with an existing column would be
+            // silently renamed by DuckDB (col -> col_1) instead of erroring.
+            (0, assertNewColumns_js_1.default)(await simpleTable.getTypes(), [newColumn], "accumulate()");
+            await (0, queryDB_js_1.default)(simpleTable, accumulateQuery(simpleTable.name, column, newColumn, options), (0, mergeOptions_js_1.default)(simpleTable, {
+                table: simpleTable.name,
+                method: "accumulate()",
+                parameters: { column, newColumn, options },
+            }));
+        },
+    });
+}
+function accumulateQuery(table, column, newColumn, options = {}) {
+    const by = options.by ? (0, stringToArray_js_1.default)(options.by) : [];
+    const partition = by.length > 0
+        ? `PARTITION BY ${by.map((d) => `${(0, quoteIdentifier_js_1.default)(d)}`).join(", ")} `
+        : "";
+    const query = `CREATE OR REPLACE TABLE ${(0, quoteIdentifier_js_1.default)(table)} AS SELECT *, SUM(${(0, quoteIdentifier_js_1.default)(column)}) OVER (${partition}ORDER BY rowid) AS ${(0, quoteIdentifier_js_1.default)(newColumn)}
+    FROM ${(0, quoteIdentifier_js_1.default)(table)}
+    ORDER BY rowid;`;
+    return query;
+}

package/script/methods/addBoundingBox.d.ts

@@ -0,0 +1,6 @@
+import type SimpleTable from "../class/SimpleTable.js";
+export default function addBoundingBox(simpleTable: SimpleTable, options?: {
+    column?: string;
+    decimals?: number;
+}): void;
+//# sourceMappingURL=addBoundingBox.d.ts.map

package/script/methods/addBoundingBox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"addBoundingBox.d.ts","sourceRoot":"","sources":["../../src/methods/addBoundingBox.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,WAAW,MAAM,yBAAyB,CAAC;AAEvD,MAAM,CAAC,OAAO,UAAU,cAAc,CACpC,WAAW,EAAE,WAAW,EACxB,OAAO,GAAE;IACP,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACd,QAwBP"}

package/script/methods/addBoundingBox.js

@@ -0,0 +1,32 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = addBoundingBox;
+const quoteIdentifier_js_1 = __importDefault(require("../helpers/quoteIdentifier.js"));
+const findGeoColumnFromSchema_js_1 = __importDefault(require("../helpers/findGeoColumnFromSchema.js"));
+const queueOp_js_1 = __importDefault(require("../helpers/queueOp.js"));
+function addBoundingBox(simpleTable, options = {}) {
+    options = structuredClone(options);
+    (0, queueOp_js_1.default)(simpleTable, {
+        kind: "fusable",
+        method: "addBoundingBox()",
+        parameters: { options },
+        needsSchema: true,
+        needsSpatial: true,
+        buildSelect: (input, types) => {
+            const column = options.column ??
+                (0, findGeoColumnFromSchema_js_1.default)(types, "addBoundingBox()", simpleTable.name);
+            const round = (expression) => typeof options.decimals === "number"
+                ? `ROUND(${expression}, ${options.decimals})`
+                : expression;
+            return `SELECT *,
+    ${round(`ST_XMin(${(0, quoteIdentifier_js_1.default)(column)})`)} AS minLon,
+    ${round(`ST_YMin(${(0, quoteIdentifier_js_1.default)(column)})`)} AS minLat,
+    ${round(`ST_XMax(${(0, quoteIdentifier_js_1.default)(column)})`)} AS maxLon,
+    ${round(`ST_YMax(${(0, quoteIdentifier_js_1.default)(column)})`)} AS maxLat
+    FROM ${input}`;
+        },
+    });
+}

package/script/methods/addColumn.d.ts

@@ -0,0 +1,3 @@
+import type SimpleTable from "../class/SimpleTable.js";
+export default function addColumn(simpleTable: SimpleTable, newColumn: string, type: "integer" | "float" | "number" | "string" | "date" | "time" | "datetime" | "datetimeTz" | "bigint" | "double" | "varchar" | "timestamp" | "timestamp with time zone" | "boolean" | `geometry('${string}')` | `GEOMETRY('${string}')`, definition: string): void;
+//# sourceMappingURL=addColumn.d.ts.map

package/script/methods/addColumn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"addColumn.d.ts","sourceRoot":"","sources":["../../src/methods/addColumn.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,WAAW,MAAM,yBAAyB,CAAC;AAEvD,MAAM,CAAC,OAAO,UAAU,SAAS,CAC/B,WAAW,EAAE,WAAW,EACxB,SAAS,EAAE,MAAM,EACjB,IAAI,EACA,SAAS,GACT,OAAO,GACP,QAAQ,GACR,QAAQ,GACR,MAAM,GACN,MAAM,GACN,UAAU,GACV,YAAY,GACZ,QAAQ,GACR,QAAQ,GACR,SAAS,GACT,WAAW,GACX,0BAA0B,GAC1B,SAAS,GACT,aAAa,MAAM,IAAI,GACvB,aAAa,MAAM,IAAI,EAC3B,UAAU,EAAE,MAAM,QAuBnB"}

package/script/methods/addColumn.js

@@ -0,0 +1,30 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = addColumn;
+const quoteIdentifier_js_1 = __importDefault(require("../helpers/quoteIdentifier.js"));
+const assertNewColumns_js_1 = __importDefault(require("../helpers/assertNewColumns.js"));
+const queueOp_js_1 = __importDefault(require("../helpers/queueOp.js"));
+const parseTypes_js_1 = __importDefault(require("../helpers/parseTypes.js"));
+function addColumn(simpleTable, newColumn, type, definition) {
+    const newType = (0, parseTypes_js_1.default)(type);
+    (0, queueOp_js_1.default)(simpleTable, {
+        kind: "fusable",
+        method: "addColumn()",
+        parameters: { newColumn, type, definition },
+        // The schema is needed to reject a duplicate column, as v1's ALTER TABLE
+        // ADD did.
+        needsSchema: true,
+        // A geometry column needs the spatial extension, both to cast to the
+        // GEOMETRY type and for the spatial functions in the definition.
+        needsSpatial: newType.toLowerCase().includes("geometry"),
+        rawSQL: [definition],
+        outputSchema: (types) => ({ ...types, [newColumn]: newType }),
+        buildSelect: (input, types) => {
+            (0, assertNewColumns_js_1.default)(types, [newColumn], "addColumn()");
+            return `SELECT *, CAST((${definition}) AS ${newType}) AS ${(0, quoteIdentifier_js_1.default)(newColumn)} FROM ${input}`;
+        },
+    });
+}

package/script/methods/addGeoClosedStatus.d.ts

@@ -0,0 +1,5 @@
+import type SimpleTable from "../class/SimpleTable.js";
+export default function addGeoClosedStatus(simpleTable: SimpleTable, newColumn: string, options?: {
+    column?: string;
+}): void;
+//# sourceMappingURL=addGeoClosedStatus.d.ts.map

package/script/methods/addGeoClosedStatus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"addGeoClosedStatus.d.ts","sourceRoot":"","sources":["../../src/methods/addGeoClosedStatus.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,WAAW,MAAM,yBAAyB,CAAC;AAEvD,MAAM,CAAC,OAAO,UAAU,kBAAkB,CACxC,WAAW,EAAE,WAAW,EACxB,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAO,QAuBlC"}

package/script/methods/addGeoClosedStatus.js

@@ -0,0 +1,27 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = addGeoClosedStatus;
+const quoteIdentifier_js_1 = __importDefault(require("../helpers/quoteIdentifier.js"));
+const assertNewColumns_js_1 = __importDefault(require("../helpers/assertNewColumns.js"));
+const findGeoColumnFromSchema_js_1 = __importDefault(require("../helpers/findGeoColumnFromSchema.js"));
+const queueOp_js_1 = __importDefault(require("../helpers/queueOp.js"));
+function addGeoClosedStatus(simpleTable, newColumn, options = {}) {
+    options = structuredClone(options);
+    (0, queueOp_js_1.default)(simpleTable, {
+        kind: "fusable",
+        method: "addGeoClosedStatus()",
+        parameters: { newColumn, options },
+        needsSchema: true,
+        needsSpatial: true,
+        buildSelect: (input, types) => {
+            (0, assertNewColumns_js_1.default)(types, [newColumn], "addGeoClosedStatus()");
+            const column = typeof options.column === "string"
+                ? options.column
+                : (0, findGeoColumnFromSchema_js_1.default)(types, "addGeoClosedStatus()", simpleTable.name);
+            return `SELECT *, CAST(ST_IsClosed(${(0, quoteIdentifier_js_1.default)(column)}) AS BOOLEAN) AS ${(0, quoteIdentifier_js_1.default)(newColumn)} FROM ${input}`;
+        },
+    });
+}

package/script/methods/addGeoType.d.ts

@@ -0,0 +1,5 @@
+import type SimpleTable from "../class/SimpleTable.js";
+export default function addGeoType(simpleTable: SimpleTable, newColumn: string, options?: {
+    column?: string;
+}): void;
+//# sourceMappingURL=addGeoType.d.ts.map

package/script/methods/addGeoType.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"addGeoType.d.ts","sourceRoot":"","sources":["../../src/methods/addGeoType.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,WAAW,MAAM,yBAAyB,CAAC;AAEvD,MAAM,CAAC,OAAO,UAAU,UAAU,CAChC,WAAW,EAAE,WAAW,EACxB,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAO,QAmBlC"}

package/script/methods/addGeoType.js

@@ -0,0 +1,27 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = addGeoType;
+const quoteIdentifier_js_1 = __importDefault(require("../helpers/quoteIdentifier.js"));
+const assertNewColumns_js_1 = __importDefault(require("../helpers/assertNewColumns.js"));
+const findGeoColumnFromSchema_js_1 = __importDefault(require("../helpers/findGeoColumnFromSchema.js"));
+const queueOp_js_1 = __importDefault(require("../helpers/queueOp.js"));
+function addGeoType(simpleTable, newColumn, options = {}) {
+    options = structuredClone(options);
+    (0, queueOp_js_1.default)(simpleTable, {
+        kind: "fusable",
+        method: "addGeoType()",
+        parameters: { newColumn, options },
+        needsSchema: true,
+        needsSpatial: true,
+        buildSelect: (input, types) => {
+            (0, assertNewColumns_js_1.default)(types, [newColumn], "addGeoType()");
+            const column = typeof options.column === "string"
+                ? options.column
+                : (0, findGeoColumnFromSchema_js_1.default)(types, "addGeoType()", simpleTable.name);
+            return `SELECT *, CAST(ST_GeometryType(${(0, quoteIdentifier_js_1.default)(column)}) AS VARCHAR) AS ${(0, quoteIdentifier_js_1.default)(newColumn)} FROM ${input}`;
+        },
+    });
+}

package/script/methods/addGeoValidity.d.ts

@@ -0,0 +1,5 @@
+import type SimpleTable from "../class/SimpleTable.js";
+export default function addGeoValidity(simpleTable: SimpleTable, newColumn: string, options?: {
+    column?: string;
+}): void;
+//# sourceMappingURL=addGeoValidity.d.ts.map

package/script/methods/addGeoValidity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"addGeoValidity.d.ts","sourceRoot":"","sources":["../../src/methods/addGeoValidity.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,WAAW,MAAM,yBAAyB,CAAC;AAEvD,MAAM,CAAC,OAAO,UAAU,cAAc,CACpC,WAAW,EAAE,WAAW,EACxB,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAO,QAmBlC"}

package/script/methods/addGeoValidity.js

@@ -0,0 +1,27 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = addGeoValidity;
+const quoteIdentifier_js_1 = __importDefault(require("../helpers/quoteIdentifier.js"));
+const assertNewColumns_js_1 = __importDefault(require("../helpers/assertNewColumns.js"));
+const findGeoColumnFromSchema_js_1 = __importDefault(require("../helpers/findGeoColumnFromSchema.js"));
+const queueOp_js_1 = __importDefault(require("../helpers/queueOp.js"));
+function addGeoValidity(simpleTable, newColumn, options = {}) {
+    options = structuredClone(options);
+    (0, queueOp_js_1.default)(simpleTable, {
+        kind: "fusable",
+        method: "addGeoValidity()",
+        parameters: { newColumn, options },
+        needsSchema: true,
+        needsSpatial: true,
+        buildSelect: (input, types) => {
+            (0, assertNewColumns_js_1.default)(types, [newColumn], "addGeoValidity()");
+            const column = typeof options.column === "string"
+                ? options.column
+                : (0, findGeoColumnFromSchema_js_1.default)(types, "addGeoValidity()", simpleTable.name);
+            return `SELECT *, CAST(ST_IsValid(${(0, quoteIdentifier_js_1.default)(column)}) AS BOOLEAN) AS ${(0, quoteIdentifier_js_1.default)(newColumn)} FROM ${input}`;
+        },
+    });
+}

package/script/methods/addRowNumber.d.ts

@@ -0,0 +1,5 @@
+import type SimpleTable from "../class/SimpleTable.js";
+export default function addRowNumber(simpleTable: SimpleTable, newColumn: string, options?: {
+    by?: string | string[];
+}): void;
+//# sourceMappingURL=addRowNumber.d.ts.map

package/script/methods/addRowNumber.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"addRowNumber.d.ts","sourceRoot":"","sources":["../../src/methods/addRowNumber.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,WAAW,MAAM,yBAAyB,CAAC;AAEvD,MAAM,CAAC,OAAO,UAAU,YAAY,CAClC,WAAW,EAAE,WAAW,EACxB,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE;IAAE,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;CAAO,QA8BzC"}

package/script/methods/addRowNumber.js

@@ -0,0 +1,32 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = addRowNumber;
+const quoteIdentifier_js_1 = __importDefault(require("../helpers/quoteIdentifier.js"));
+const mergeOptions_js_1 = __importDefault(require("../helpers/mergeOptions.js"));
+const queryDB_js_1 = __importDefault(require("../helpers/queryDB.js"));
+const queueOp_js_1 = __importDefault(require("../helpers/queueOp.js"));
+const stringToArray_js_1 = __importDefault(require("../helpers/stringToArray.js"));
+function addRowNumber(simpleTable, newColumn, options = {}) {
+    // The row number is based on rowid, which only exists on the materialized
+    // table, not on the output of a fused step: it executes as a barrier.
+    options = structuredClone(options);
+    (0, queueOp_js_1.default)(simpleTable, {
+        kind: "barrier",
+        method: "addRowNumber()",
+        parameters: { newColumn, options },
+        execute: async () => {
+            const by = options.by ? (0, stringToArray_js_1.default)(options.by) : [];
+            const partition = by.length > 0
+                ? `PARTITION BY ${by.map((d) => `${(0, quoteIdentifier_js_1.default)(d)}`).join(", ")}`
+                : "";
+            await (0, queryDB_js_1.default)(simpleTable, `CREATE OR REPLACE TABLE ${(0, quoteIdentifier_js_1.default)(simpleTable.name)} AS SELECT *, (ROW_NUMBER() OVER(${partition} ORDER BY rowid) - 1) AS ${(0, quoteIdentifier_js_1.default)(newColumn)} FROM ${(0, quoteIdentifier_js_1.default)(simpleTable.name)} ORDER BY rowid`, (0, mergeOptions_js_1.default)(simpleTable, {
+                table: simpleTable.name,
+                method: "addRowNumber()",
+                parameters: { newColumn, options },
+            }));
+        },
+    });
+}

package/script/methods/addSummaryRows.d.ts

@@ -0,0 +1,14 @@
+import { type Stat } from "../helpers/getStatExpression.js";
+import type SimpleTable from "../class/SimpleTable.js";
+type StatRowOperation = Exclude<Stat, "count">;
+type StatRow = StatRowOperation | {
+    stat: StatRowOperation;
+    label?: string;
+};
+type AddSummaryRowsOptions = {
+    stats?: StatRow | StatRow[];
+    position?: "top" | "bottom";
+};
+export default function addSummaryRows(simpleTable: SimpleTable, columns: "all" | string | string[], labelColumn: string, options?: AddSummaryRowsOptions): void;
+export {};
+//# sourceMappingURL=addSummaryRows.d.ts.map

package/script/methods/addSummaryRows.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"addSummaryRows.d.ts","sourceRoot":"","sources":["../../src/methods/addSummaryRows.ts"],"names":[],"mappings":"AACA,OAA0B,EAExB,KAAK,IAAI,EACV,MAAM,iCAAiC,CAAC;AAMzC,OAAO,KAAK,WAAW,MAAM,yBAAyB,CAAC;AAEvD,KAAK,gBAAgB,GAAG,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AAC/C,KAAK,OAAO,GACR,gBAAgB,GAChB;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAE/C,KAAK,qBAAqB,GAAG;IAC3B,KAAK,CAAC,EAAE,OAAO,GAAG,OAAO,EAAE,CAAC;IAC5B,QAAQ,CAAC,EAAE,KAAK,GAAG,QAAQ,CAAC;CAC7B,CAAC;AAMF,MAAM,CAAC,OAAO,UAAU,cAAc,CACpC,WAAW,EAAE,WAAW,EACxB,OAAO,EAAE,KAAK,GAAG,MAAM,GAAG,MAAM,EAAE,EAClC,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,qBAA0B,QAyDpC"}

package/script/methods/addSummaryRows.js

@@ -0,0 +1,161 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = addSummaryRows;
+const assertColumnsExist_js_1 = __importDefault(require("../helpers/assertColumnsExist.js"));
+const getStatExpression_js_1 = __importStar(require("../helpers/getStatExpression.js"));
+const keepNumericalColumns_js_1 = __importDefault(require("../helpers/keepNumericalColumns.js"));
+const queueOp_js_1 = __importDefault(require("../helpers/queueOp.js"));
+const quoteIdentifier_js_1 = __importDefault(require("../helpers/quoteIdentifier.js"));
+const stringToArray_js_1 = __importDefault(require("../helpers/stringToArray.js"));
+const allStatRowOperations = getStatExpression_js_1.allStats.filter((stat) => stat !== "count");
+function addSummaryRows(simpleTable, columns, labelColumn, options = {}) {
+    options = structuredClone(options);
+    if (options.position !== undefined &&
+        options.position !== "top" &&
+        options.position !== "bottom") {
+        throw new Error(`addSummaryRows() options.position must be "top" or "bottom". Received ${JSON.stringify(options.position)}.`);
+    }
+    const selectedColumns = columns === "all" ? "all" : (0, stringToArray_js_1.default)(columns);
+    if (selectedColumns !== "all" && selectedColumns.length === 0) {
+        throw new Error('addSummaryRows() requires at least one column or "all".');
+    }
+    if (selectedColumns !== "all") {
+        const duplicates = selectedColumns.filter((column, index) => selectedColumns.indexOf(column) !== index);
+        if (duplicates.length > 0) {
+            throw new Error(`addSummaryRows() received duplicate column${new Set(duplicates).size === 1 ? "" : "s"} ${[...new Set(duplicates)].map(quoteIdentifier_js_1.default).join(", ")}.`);
+        }
+        if (selectedColumns.includes(labelColumn)) {
+            throw new Error(`addSummaryRows() label column ${(0, quoteIdentifier_js_1.default)(labelColumn)} cannot also be summarized.`);
+        }
+    }
+    const statRows = normalizeStatRows(options.stats);
+    (0, queueOp_js_1.default)(simpleTable, {
+        kind: "fusable",
+        method: "addSummaryRows()",
+        parameters: { columns, labelColumn, options },
+        needsSchema: true,
+        values: statRows.map((row) => row.label),
+        buildSelect: (input, schema) => addSummaryRowsSelect(input, schema, selectedColumns, labelColumn, statRows, options.position ?? "bottom"),
+    });
+}
+function normalizeStatRows(stats) {
+    const rows = stats === undefined
+        ? [...allStatRowOperations]
+        : Array.isArray(stats)
+            ? stats
+            : [stats];
+    if (rows.length === 0) {
+        throw new Error("addSummaryRows() stats cannot be an empty array. Omit stats to add every supported stat.");
+    }
+    return rows.map((row) => {
+        if (typeof row === "string") {
+            assertStat(row);
+            return { stat: row, label: row };
+        }
+        if (row === null || typeof row !== "object") {
+            throw new Error("addSummaryRows() stats must contain stat names or objects with a stat property.");
+        }
+        assertStat(row.stat);
+        if (row.label !== undefined && typeof row.label !== "string") {
+            throw new Error("addSummaryRows() stat labels must be strings.");
+        }
+        return { stat: row.stat, label: row.label ?? row.stat };
+    });
+}
+function assertStat(stat) {
+    if (!allStatRowOperations.includes(stat)) {
+        throw new Error(`addSummaryRows() stat ${JSON.stringify(stat)} is not supported. Use ${allStatRowOperations.map((value) => JSON.stringify(value)).join(", ")}.`);
+    }
+}
+function addSummaryRowsSelect(input, schema, columns, labelColumn, statRows, position) {
+    const method = "addSummaryRows()";
+    const tableColumns = Object.keys(schema);
+    (0, assertColumnsExist_js_1.default)(schema, [labelColumn], method);
+    if (schema[labelColumn] !== "VARCHAR") {
+        throw new Error(`${method} label column ${(0, quoteIdentifier_js_1.default)(labelColumn)} must have type VARCHAR, but has type ${schema[labelColumn]}.`);
+    }
+    const numericalColumns = (0, keepNumericalColumns_js_1.default)(schema);
+    const selectedColumns = columns === "all" ? numericalColumns : columns;
+    if (selectedColumns.length === 0) {
+        throw new Error(`${method} could not find any numeric columns. Select numeric columns explicitly or convert columns to numeric types first.`);
+    }
+    if (columns !== "all") {
+        (0, assertColumnsExist_js_1.default)(schema, selectedColumns, method);
+        const numericalColumnSet = new Set(numericalColumns);
+        const nonNumericalColumns = selectedColumns.filter((column) => !numericalColumnSet.has(column));
+        if (nonNumericalColumns.length > 0) {
+            throw new Error(`${method} requires numeric columns, but ${nonNumericalColumns.map((column) => `${(0, quoteIdentifier_js_1.default)(column)} has type ${schema[column]}`).join(", ")}. Convert ${nonNumericalColumns.length === 1 ? "it" : "them"} to a numeric type first.`);
+        }
+    }
+    const selectedColumnSet = new Set(selectedColumns);
+    const kindColumn = unusedColumn(schema, "_sda_stat_kind");
+    const orderColumn = unusedColumn({ ...schema, [kindColumn]: "INTEGER" }, "_sda_stat_order");
+    const projectedColumns = tableColumns.map(quoteIdentifier_js_1.default).join(", ");
+    const dataKind = position === "top" ? 1 : 0;
+    const statKind = position === "top" ? 0 : 1;
+    const branches = [
+        `SELECT ${projectedColumns}, ${dataKind} AS ${(0, quoteIdentifier_js_1.default)(kindColumn)}, ROW_NUMBER() OVER () AS ${(0, quoteIdentifier_js_1.default)(orderColumn)} FROM ${input}`,
+        ...statRows.map((row, index) => {
+            const projections = tableColumns.map((column) => {
+                if (column === labelColumn) {
+                    return `CAST(? AS VARCHAR) AS ${(0, quoteIdentifier_js_1.default)(column)}`;
+                }
+                if (!selectedColumnSet.has(column)) {
+                    return `NULL AS ${(0, quoteIdentifier_js_1.default)(column)}`;
+                }
+                const expression = (0, getStatExpression_js_1.default)(row.stat, schema[column], (0, quoteIdentifier_js_1.default)(column), undefined);
+                if (expression === null) {
+                    throw new Error(`${method} stat ${JSON.stringify(row.stat)} cannot be computed for column ${(0, quoteIdentifier_js_1.default)(column)} with type ${schema[column]}.`);
+                }
+                return `${expression} AS ${(0, quoteIdentifier_js_1.default)(column)}`;
+            });
+            return `SELECT ${projections.join(", ")}, ${statKind} AS ${(0, quoteIdentifier_js_1.default)(kindColumn)}, ${index} AS ${(0, quoteIdentifier_js_1.default)(orderColumn)} FROM ${input}`;
+        }),
+    ];
+    return `SELECT ${projectedColumns}
+FROM (${branches.join("\nUNION ALL\n")}) AS ${(0, quoteIdentifier_js_1.default)("stats")}
+ORDER BY ${(0, quoteIdentifier_js_1.default)(kindColumn)}, ${(0, quoteIdentifier_js_1.default)(orderColumn)}`;
+}
+function unusedColumn(schema, base) {
+    let column = base;
+    while (schema[column] !== undefined) {
+        column += "_";
+    }
+    return column;
+}

package/script/methods/addVertexCount.d.ts

@@ -0,0 +1,5 @@
+import type SimpleTable from "../class/SimpleTable.js";
+export default function addVertexCount(simpleTable: SimpleTable, newColumn: string, options?: {
+    column?: string;
+}): void;
+//# sourceMappingURL=addVertexCount.d.ts.map

package/script/methods/addVertexCount.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"addVertexCount.d.ts","sourceRoot":"","sources":["../../src/methods/addVertexCount.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,WAAW,MAAM,yBAAyB,CAAC;AAEvD,MAAM,CAAC,OAAO,UAAU,cAAc,CACpC,WAAW,EAAE,WAAW,EACxB,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAO,QAmBlC"}

package/script/methods/addVertexCount.js

@@ -0,0 +1,27 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = addVertexCount;
+const quoteIdentifier_js_1 = __importDefault(require("../helpers/quoteIdentifier.js"));
+const assertNewColumns_js_1 = __importDefault(require("../helpers/assertNewColumns.js"));
+const findGeoColumnFromSchema_js_1 = __importDefault(require("../helpers/findGeoColumnFromSchema.js"));
+const queueOp_js_1 = __importDefault(require("../helpers/queueOp.js"));
+function addVertexCount(simpleTable, newColumn, options = {}) {
+    options = { ...options };
+    (0, queueOp_js_1.default)(simpleTable, {
+        kind: "fusable",
+        method: "addVertexCount()",
+        parameters: { newColumn, options },
+        needsSchema: true,
+        needsSpatial: true,
+        buildSelect: (input, types) => {
+            (0, assertNewColumns_js_1.default)(types, [newColumn], "addVertexCount()");
+            const column = typeof options.column === "string"
+                ? options.column
+                : (0, findGeoColumnFromSchema_js_1.default)(types, "addVertexCount()", simpleTable.name);
+            return `SELECT *, CAST(ST_NPoints(${(0, quoteIdentifier_js_1.default)(column)}) AS BIGINT) AS ${(0, quoteIdentifier_js_1.default)(newColumn)} FROM ${input}`;
+        },
+    });
+}

package/script/methods/aggregateGeo.d.ts

@@ -0,0 +1,7 @@
+import type SimpleTable from "../class/SimpleTable.js";
+export default function aggregateGeo(simpleTable: SimpleTable, method: "union" | "intersection", options?: {
+    column?: string;
+    by?: string | string[];
+    outputTable?: string | boolean;
+}): SimpleTable;
+//# sourceMappingURL=aggregateGeo.d.ts.map

package/script/methods/aggregateGeo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aggregateGeo.d.ts","sourceRoot":"","sources":["../../src/methods/aggregateGeo.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,WAAW,MAAM,yBAAyB,CAAC;AAEvD,MAAM,CAAC,OAAO,UAAU,YAAY,CAClC,WAAW,EAAE,WAAW,EACxB,MAAM,EAAE,OAAO,GAAG,cAAc,EAChC,OAAO,GAAE;IACP,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CAC3B,GACL,WAAW,CAmDb"}

package/script/methods/aggregateGeo.js

@@ -0,0 +1,75 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = aggregateGeo;
+const quoteIdentifier_js_1 = __importDefault(require("../helpers/quoteIdentifier.js"));
+const findGeoColumn_js_1 = __importDefault(require("../helpers/findGeoColumn.js"));
+const findGeoColumnFromSchema_js_1 = __importDefault(require("../helpers/findGeoColumnFromSchema.js"));
+const mergeOptions_js_1 = __importDefault(require("../helpers/mergeOptions.js"));
+const queryDB_js_1 = __importDefault(require("../helpers/queryDB.js"));
+const queueOp_js_1 = __importDefault(require("../helpers/queueOp.js"));
+const resolveOutputTable_js_1 = __importDefault(require("../helpers/resolveOutputTable.js"));
+const stringToArray_js_1 = __importDefault(require("../helpers/stringToArray.js"));
+function aggregateGeo(simpleTable, method, options = {}) {
+    options = structuredClone(options);
+    options.outputTable = (0, resolveOutputTable_js_1.default)(simpleTable, options.outputTable);
+    if (typeof options.outputTable === "string") {
+        // The output table instance is created at call time so it can be
+        // returned synchronously and chained on right away.
+        const outputTable = simpleTable.sdb.newTable(options.outputTable);
+        (0, queueOp_js_1.default)(outputTable, {
+            kind: "barrier",
+            method: "aggregateGeo()",
+            parameters: { method, options },
+            execute: async () => {
+                const column = typeof options.column === "string"
+                    ? options.column
+                    : await (0, findGeoColumn_js_1.default)(simpleTable, "aggregateGeo()");
+                await (0, queryDB_js_1.default)(simpleTable, `CREATE OR REPLACE TABLE ${(0, quoteIdentifier_js_1.default)(outputTable.name)} AS ${aggregateGeoSelect(`${(0, quoteIdentifier_js_1.default)(simpleTable.name)}`, column, method, options)}`, (0, mergeOptions_js_1.default)(simpleTable, {
+                    table: outputTable.name,
+                    method: "aggregateGeo()",
+                    parameters: { column, method, options },
+                }));
+            },
+        });
+        return outputTable;
+    }
+    (0, queueOp_js_1.default)(simpleTable, {
+        kind: "fusable",
+        method: "aggregateGeo()",
+        parameters: { method, options },
+        needsSchema: true,
+        needsSpatial: true,
+        buildSelect: (input, types) => {
+            const column = typeof options.column === "string"
+                ? options.column
+                : (0, findGeoColumnFromSchema_js_1.default)(types, "aggregateGeo()", simpleTable.name);
+            return aggregateGeoSelect(input, column, method, options);
+        },
+    });
+    return simpleTable;
+}
+function aggregateGeoSelect(input, column, method, options = {}) {
+    const categoriesOptions = options.by ?? [];
+    const by = (0, stringToArray_js_1.default)(categoriesOptions);
+    let query = `SELECT${by.length > 0
+        ? ` ${by.map((d) => `${(0, quoteIdentifier_js_1.default)(d)}`).join(", ")},`
+        : ""}`;
+    if (method === "union") {
+        query += ` CASE WHEN ST_IsEmpty(ST_Union_Agg(${(0, quoteIdentifier_js_1.default)(column)})) THEN NULL ELSE ST_Union_Agg(${(0, quoteIdentifier_js_1.default)(column)}) END AS ${(0, quoteIdentifier_js_1.default)(column)}`;
+    }
+    else if (method === "intersection") {
+        query += ` ST_Intersection_Agg(${(0, quoteIdentifier_js_1.default)(column)}) AS ${(0, quoteIdentifier_js_1.default)(column)}`;
+    }
+    else {
+        throw new Error(`aggregateGeo() received an unknown method: ${method}.`);
+    }
+    query += `\nFROM ${input}`;
+    if (by.length > 0) {
+        query += `\nGROUP BY ${by.map((d) => `${(0, quoteIdentifier_js_1.default)(d)}`).join(", ")}`;
+        query += `\nORDER BY ${by.map((d) => `${(0, quoteIdentifier_js_1.default)(d)} ASC`).join(", ")}`;
+    }
+    return query;
+}

package/script/methods/area.d.ts

@@ -0,0 +1,7 @@
+import type SimpleTable from "../class/SimpleTable.js";
+export default function area(simpleTable: SimpleTable, newColumn: string, options?: {
+    unit?: "m2" | "km2";
+    column?: string;
+    decimals?: number;
+}): void;
+//# sourceMappingURL=area.d.ts.map

package/script/methods/area.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"area.d.ts","sourceRoot":"","sources":["../../src/methods/area.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,WAAW,MAAM,yBAAyB,CAAC;AAEvD,MAAM,CAAC,OAAO,UAAU,IAAI,CAC1B,WAAW,EAAE,WAAW,EACxB,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE;IAAE,IAAI,CAAC,EAAE,IAAI,GAAG,KAAK,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAO,QAyB1E"}