Add consumer-style testing for Turf

pnpm-workspace.yaml

@@ -1,5 +1,6 @@
 packages:
   - "packages/*"
+  - "test/*"
 
 catalog:
   "@types/benchmark": ^2.1.5

test/README.md

@@ -0,0 +1,7 @@
+# Consumer test harnesses
+
+Each directory is an example configuration that we may expect a Turf consumer to depend on. It allows us to test various configurations in CI and avoid shipping breaking changes unintentionally across a variety of different user groups.
+
+Note that the CI runs include a matrix of Node versions, so each of these scenarios is tested across those as well.
+
+The TypeScript settings were inspired by the [Choosing Compiler Options](https://www.typescriptlang.org/docs/handbook/modules/guides/choosing-compiler-options.html) documentation on the recommended configurations in May 2026.

test/node-cjs/index.cjs

@@ -0,0 +1,17 @@
+/* eslint-disable @typescript-eslint/no-require-imports */
+
+const turf = require("@turf/turf");
+
+const polygon = turf.polygon([
+  [
+    [125, -15],
+    [113, -22],
+    [154, -27],
+    [144, -15],
+    [125, -15],
+  ],
+]);
+
+const area = turf.area(polygon);
+
+console.log(area);

test/node-cjs/package.json

@@ -0,0 +1,14 @@
+{
+  "name": "node-cjs",
+  "version": "1.0.0",
+  "private": true,
+  "license": "MIT",
+  "funding": "https://opencollective.com/turf",
+  "scripts": {
+    "test": "pnpm run /test:.*/",
+    "test:node": "node index.cjs"
+  },
+  "dependencies": {
+    "@turf/turf": "workspace:*"
+  }
+}

test/node-esm/index.mjs

@@ -0,0 +1,15 @@
+import * as turf from "@turf/turf";
+
+const polygon = turf.polygon([
+  [
+    [125, -15],
+    [113, -22],
+    [154, -27],
+    [144, -15],
+    [125, -15],
+  ],
+]);
+
+const area = turf.area(polygon);
+
+console.log(area);

test/node-esm/package.json

@@ -0,0 +1,15 @@
+{
+  "name": "node-esm",
+  "version": "1.0.0",
+  "private": true,
+  "license": "MIT",
+  "funding": "https://opencollective.com/turf",
+  "keywords": [],
+  "scripts": {
+    "test": "pnpm run /test:.*/",
+    "test:node": "node index.mjs"
+  },
+  "dependencies": {
+    "@turf/turf": "workspace:*"
+  }
+}

test/ts-bundler-cjs/package.json

@@ -0,0 +1,18 @@
+{
+  "name": "ts-bundler-cjs",
+  "version": "1.0.0",
+  "private": true,
+  "license": "MIT",
+  "funding": "https://opencollective.com/turf",
+  "keywords": [],
+  "scripts": {
+    "test": "pnpm run /test:.*/",
+    "test:ts": "tsc"
+  },
+  "devDependencies": {
+    "typescript": "catalog:"
+  },
+  "dependencies": {
+    "@turf/turf": "workspace:*"
+  }
+}

test/ts-bundler-cjs/ts-bundler-cjs.ts

@@ -0,0 +1,16 @@
+/* eslint-disable-next-line @typescript-eslint/no-require-imports */
+const turf = require("@turf/turf");
+
+const polygon = turf.polygon([
+  [
+    [125, -15],
+    [113, -22],
+    [154, -27],
+    [144, -15],
+    [125, -15],
+  ],
+]);
+
+const area = turf.area(polygon);
+
+console.log(area);

test/ts-bundler-cjs/tsconfig.json

@@ -0,0 +1,12 @@
+{
+  "include": ["ts-bundler-cjs.ts"],
+  "compilerOptions": {
+    "noEmit": true,
+    "module": "esnext",
+    "moduleResolution": "bundler",
+    "esModuleInterop": false,
+    "verbatimModuleSyntax": true,
+    "strict": true,
+    "skipLibCheck": false
+  }
+}

test/ts-bundler-esm/package.json

@@ -0,0 +1,19 @@
+{
+  "name": "ts-bundler-esm",
+  "version": "1.0.0",
+  "private": true,
+  "license": "MIT",
+  "funding": "https://opencollective.com/turf",
+  "keywords": [],
+  "type": "module",
+  "scripts": {
+    "test": "pnpm run /test:.*/",
+    "test:ts": "tsc"
+  },
+  "devDependencies": {
+    "typescript": "catalog:"
+  },
+  "dependencies": {
+    "@turf/turf": "workspace:*"
+  }
+}

test/ts-bundler-esm/ts-bundler-esm.ts

@@ -0,0 +1,15 @@
+import * as turf from "@turf/turf";
+
+const polygon = turf.polygon([
+  [
+    [125, -15],
+    [113, -22],
+    [154, -27],
+    [144, -15],
+    [125, -15],
+  ],
+]);
+
+const area = turf.area(polygon);
+
+console.log(area);

test/ts-bundler-esm/tsconfig.json

@@ -0,0 +1,12 @@
+{
+  "include": ["ts-bundler-esm.ts"],
+  "compilerOptions": {
+    "noEmit": true,
+    "module": "esnext",
+    "moduleResolution": "bundler",
+    "esModuleInterop": false,
+    "verbatimModuleSyntax": true,
+    "strict": true,
+    "skipLibCheck": false
+  }
+}

test/ts-node-cjs/package.json

@@ -0,0 +1,18 @@
+{
+  "name": "ts-node-cjs",
+  "version": "1.0.0",
+  "private": true,
+  "license": "MIT",
+  "funding": "https://opencollective.com/turf",
+  "keywords": [],
+  "scripts": {
+    "test": "pnpm run /test:.*/",
+    "test:ts": "tsc"
+  },
+  "devDependencies": {
+    "typescript": "catalog:"
+  },
+  "dependencies": {
+    "@turf/turf": "workspace:*"
+  }
+}

test/ts-node-cjs/ts-node-cjs.ts

@@ -0,0 +1,16 @@
+/* eslint-disable-next-line @typescript-eslint/no-require-imports */
+const turf = require("@turf/turf");
+
+const polygon = turf.polygon([
+  [
+    [125, -15],
+    [113, -22],
+    [154, -27],
+    [144, -15],
+    [125, -15],
+  ],
+]);
+
+const area = turf.area(polygon);
+
+console.log(area);

test/ts-node-cjs/tsconfig.json

@@ -0,0 +1,11 @@
+{
+  "include": ["ts-node-cjs.ts"],
+  "compilerOptions": {
+    "noEmit": true,
+    "module": "nodenext",
+    "moduleResolution": "nodenext",
+    "verbatimModuleSyntax": true,
+    "strict": true,
+    "skipLibCheck": false
+  }
+}

test/ts-node-esm/package.json

@@ -0,0 +1,19 @@
+{
+  "name": "ts-node-esm",
+  "version": "1.0.0",
+  "private": true,
+  "license": "MIT",
+  "funding": "https://opencollective.com/turf",
+  "keywords": [],
+  "type": "module",
+  "scripts": {
+    "test": "pnpm run /test:.*/",
+    "test:ts": "tsc"
+  },
+  "devDependencies": {
+    "typescript": "catalog:"
+  },
+  "dependencies": {
+    "@turf/turf": "workspace:*"
+  }
+}

test/ts-node-esm/ts-node-esm.ts

@@ -0,0 +1,15 @@
+import * as turf from "@turf/turf";
+
+const polygon = turf.polygon([
+  [
+    [125, -15],
+    [113, -22],
+    [154, -27],
+    [144, -15],
+    [125, -15],
+  ],
+]);
+
+const area = turf.area(polygon);
+
+console.log(area);

test/ts-node-esm/tsconfig.json

@@ -0,0 +1,11 @@
+{
+  "include": ["ts-node-esm.ts"],
+  "compilerOptions": {
+    "noEmit": true,
+    "module": "nodenext",
+    "moduleResolution": "nodenext",
+    "verbatimModuleSyntax": true,
+    "strict": true,
+    "skipLibCheck": false
+  }
+}