Updates to Dependencies, Build Chain, and Examples (#374)

Non-trivial updates to some of our dependencies, our build chain, and our examples, including:

* Switch from ESLint to Oxlint
* Upgrade TypeScript 6 to TypeScript 7
* Replace ts-node with tsx
* Replace browserify with esbuild
* Convert examples to full mini-projects
* Remove checked in cql4browsers.js
* Stop support for Node 18

Author: cmoesel

.github/pull_request_template.md

@@ -9,10 +9,8 @@ For items that are not-applicable, mark "N/A" and ✔.
 - [ ] Tests are included and test edge cases
 - [ ] Tests have been run locally and pass
 - [ ] Code coverage has not gone down and all code touched or added is covered.
-- [ ] Code passes lint and prettier (hint: use `npm run test:plus` to run tests, lint, and prettier)
+- [ ] Code passes lint and prettier (hint: use `npm run check` to run tests, lint, and prettier)
 - [ ] All dependent libraries are appropriately updated or have a corresponding PR related to this change
-- [ ] `cql4browsers.js` built with `npm run build:browserify` if source changed.
-
 **Reviewer:**
 
 Name:

.github/workflows/ci-workflow.yml

@@ -12,15 +12,6 @@ jobs:
         with:
           node-version: 24.x
       - run: npm audit --omit=dev
-  cql4browsers:
-    name: Check cql4browsers
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v6
-      - uses: actions/setup-node@v6
-        with:
-          node-version: 24.x
-      - run: ./bin/validate_cql4browsers.sh
   lint:
     name: Check lint and prettier
     runs-on: ubuntu-latest
@@ -38,7 +29,7 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        node: [18.x, 22.x, 24.x]
+        node: [20.x, 22.x, 24.x]
     steps:
       - uses: actions/checkout@v6
       - uses: actions/setup-node@v6
@@ -73,3 +64,24 @@ jobs:
         working-directory: test-server
       - run: npm run check
         working-directory: test-server
+  examples:
+    name: Check examples
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+      - uses: actions/setup-node@v6
+        with:
+          node-version: 24.x
+      - run: npm ci
+      - run: npm ci
+        working-directory: examples/browser
+      - run: npm test
+        working-directory: examples/browser
+      - run: npm ci
+        working-directory: examples/node
+      - run: npm test
+        working-directory: examples/node
+      - run: npm ci
+        working-directory: examples/typescript
+      - run: npm test
+        working-directory: examples/typescript

.gitignore

@@ -1,9 +1,12 @@
 lib
 lib-test
+dist
 node_modules
 .DS_Store
 .nyc_output
-.vscode
+.vscode/*
+!.vscode/extensions.json
+!.vscode/settings.sample.json
 coverage
 *.original.coffee
 yarn-error.log

.mocharc.json

@@ -1,5 +1,5 @@
 {
   "ignore": ["test/spec-tests/*.js"],
   "extension": ["ts"],
-  "require": ["ts-node/register", "./test/should-extensions.ts"]
+  "require": ["tsx/cjs", "./test/should-extensions.ts"]
 }

.npmignore

@@ -6,3 +6,4 @@
 /test
 /test-server
 /CQL_Execution_Features.xlsx
+/examples

.oxlintrc.json

@@ -0,0 +1,48 @@
+{
+  "$schema": "./node_modules/oxlint/configuration_schema.json",
+  "env": {
+    "builtin": true,
+    "es6": true,
+    "mocha": true,
+    "node": true
+  },
+  "ignorePatterns": [
+    "**/lib",
+    "**/lib-test",
+    "**/dist",
+    "test-server/**"
+  ],
+  "rules": {
+    "no-loss-of-precision": "off",
+    "no-unused-vars": [
+      "error",
+      {
+        "argsIgnorePattern": "^_"
+      }
+    ],
+    "no-var": "error",
+    "prefer-const": "error",
+    "prefer-rest-params": "error",
+    "prefer-spread": "error",
+    "curly": "error",
+    "no-console": [
+      "warn",
+      {
+        "allow": [
+          "warn",
+          "error"
+        ]
+      }
+    ]
+  },
+  "overrides": [
+    {
+      "files": [
+        "test/elm/**/*.js"
+      ],
+      "rules": {
+        "unicorn/no-empty-file": "off"
+      }
+    }
+  ]
+}

.prettierignore

@@ -1,10 +1,10 @@
 lib
 lib-test
+dist
 node_modules
 .nyc_output
 .vscode
 coverage
-cql4browsers.js
 # the following uses its own prettier config
 test-server
 # the following are generated by the test generator

.vscode/extensions.json

@@ -0,0 +1,7 @@
+{
+  "recommendations": [
+    // recommended for lint and code formatting
+    "oxc.oxc-vscode",
+    "esbenp.prettier-vscode"
+  ]
+}

.vscode/settings.sample.json

@@ -0,0 +1,10 @@
+{
+  "[javascript][typescript][typescriptreact]": {
+    "editor.formatOnSave": true,
+    "editor.defaultFormatter": "esbenp.prettier-vscode"
+  },
+  "[json]": {
+    "editor.formatOnSave": true,
+    "editor.defaultFormatter": "vscode.json-language-features"
+  }
+}

DEPENDENCY_NOTES.md

@@ -3,5 +3,4 @@ The following notes about the app's dependencies should be revisited and resolve
 As of 2026-07-27:
 
 - `@types/node`: Consider updating to `26.x` in the future, but for now `24.x` still has plent of time in LTS.
-- `typescript`: `7.x` uses a new native compiler without a native API. Libraries like `ts-node` and `typescript-eslint` do not yet support it.
 - `tslog` (test-server only): `5.x` is ESM-only and replaces v4's flat logger settings such as `hideLogPositionForProduction` and `prettyLogTemplate`. Updating will require some migration.