identifier-js 0.0.15 → 0.0.16

package/.github/workflows/test.yml

@@ -0,0 +1,55 @@
+# Verify the complete public test suite across supported Node.js releases and operating systems.
+name: Cross-platform tests
+
+on:
+  push:
+    branches: [master]
+  pull_request:
+  workflow_dispatch:
+
+# Tests need read access to the project and its public workspace-data source.
+permissions:
+  contents: read
+
+jobs:
+  test:
+    name: ${{ matrix.os }} / Node.js ${{ matrix.node }}
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, windows-latest, macos-latest]
+        node: [20, 22, 24]
+
+    steps:
+      # Check out the exact project revision selected by the workflow event.
+      - name: Check out repository
+        uses: actions/checkout@v7
+
+      # Install each supported Node.js runtime independently on every operating system.
+      - name: Set up Node.js
+        uses: actions/setup-node@v7
+        with:
+          node-version: ${{ matrix.node }}
+
+      # Install development dependencies without requiring a generated package lock.
+      - name: Install dependencies
+        run: npm install --no-audit --no-fund
+
+      # Check out only this project's test concern from the public workspace-data source.
+      - name: Check out public tests
+        uses: actions/checkout@v7
+        with:
+          repository: SorinGFS/public-data
+          ref: master
+          path: workspace-data
+          sparse-checkout: tests/github.com/SorinGFS/identifier-js
+
+      # Reproduce the ordinary workspace layout consumed by the package test script.
+      - name: Materialize public tests
+        run: >-
+          node -e "require('node:fs').cpSync('workspace-data/tests/github.com/SorinGFS/identifier-js', '#/public/tests', { recursive: true })"
+
+      # Execute the materialized Vitest suite and propagate any failed result.
+      - name: Run tests
+        run: npm test

package/package.json

@@ -1,41 +1,44 @@
-{
-  "name": "identifier-js",
-  "version": "0.0.15",
-  "description": "A RFC3986 / RFC3987 compliant fast parser/validator/resolver/composer for NodeJS and browser.",
-  "keywords": [
-    "IRI",
-    "URI",
-    "IRI-reference",
-    "URI-reference",
-    "ipv4",
-    "ipv6",
-    "uuid",
-    "parser",
-    "validator",
-    "RFC3986",
-    "RFC3987"
-  ],
-  "homepage": "https://github.com/SorinGFS/identifier-js#readme",
-  "bugs": {
-    "url": "https://github.com/SorinGFS/identifier-js/issues"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/SorinGFS/identifier-js.git"
-  },
-  "license": "MIT",
-  "author": "SorinGFS",
-  "type": "commonjs",
-  "main": "index.js",
-  "scripts": {
-    "update-deps": "npx npm-check-updates -u && npm install",
-    "test": "node \"#/public/tests/vitest-setup.js\" && npm test"
-  },
-  "dependencies": {
-    "url-templates": "^1.0.7"
-  },
-  "engines": {
-    "node": ">=18.0.0"
-  },
-  "engineStrict": true
-}
+{
+  "name": "identifier-js",
+  "version": "0.0.16",
+  "description": "A RFC3986 / RFC3987 compliant fast parser/validator/resolver/composer for NodeJS and browser.",
+  "keywords": [
+    "IRI",
+    "URI",
+    "IRI-reference",
+    "URI-reference",
+    "ipv4",
+    "ipv6",
+    "uuid",
+    "parser",
+    "validator",
+    "RFC3986",
+    "RFC3987"
+  ],
+  "homepage": "https://github.com/SorinGFS/identifier-js#readme",
+  "bugs": {
+    "url": "https://github.com/SorinGFS/identifier-js/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/SorinGFS/identifier-js.git"
+  },
+  "license": "MIT",
+  "author": "SorinGFS",
+  "type": "commonjs",
+  "main": "index.js",
+  "scripts": {
+    "update-deps": "npx npm-check-updates -u && npm install",
+    "test": "node \"#/public/tests/vitest-run.js\""
+  },
+  "dependencies": {
+    "url-templates": "^1.0.7"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "engineStrict": true,
+  "devDependencies": {
+    "vitest": "^4.1.11"
+  }
+}

package/readme.md

@@ -17,7 +17,7 @@ description: An RFC 3986 and RFC 3987 parser, validator, and reference resolver
 - UUID and UUIDv4 lexical validation;
 - lazily compiled and cached regular expressions.
 
-The package is synchronous, CommonJS, and supports Node.js 18 or newer. Browser use requires a bundler or runtime that supports CommonJS dependencies and Unicode regular expressions.
+The package is synchronous, CommonJS, and supports Node.js 20 or newer. Browser use requires a bundler or runtime that supports CommonJS dependencies and Unicode regular expressions.
 
 ## Install
 
@@ -435,11 +435,21 @@ The current suite contains 418 active tests covering URI/IRI validation and pars
 
 The reference-conversion changes were additionally checked against 2,646 combinations of paths, absent/empty/non-empty queries, and absent/empty/non-empty fragments.
 
+Continuous integration materializes the public test suite and runs it on Node.js 20, 22, and 24 across Ubuntu, Windows, and macOS.
+
 <details>
 <summary><strong>Tests</strong></summary>
 
 The test suite and supporting ABNF source documents are maintained separately as public workspace data, so they are not included in the package or canonical repository. Users and contributors who need them can materialize them into a cloned repository with [gh-workspace-data](https://github.com/SorinGFS/gh-workspace-data).
 
+Install the project development dependencies:
+
+```sh
+npm install
+```
+
+Vitest is a development dependency and is not installed for consumers of the published library.
+
 Install the GitHub CLI extension once:
 
 ```sh
@@ -455,13 +465,13 @@ gh workspace-data load
 
 The tests are materialized as ordinary local files under `#/public/tests/`, and the supporting documents are available under `#/public/docs/`. Both remain excluded from the canonical Git repository.
 
-Run the materialized suite with:
+Run the materialized suite:
 
 ```sh
 npm test
 ```
 
-When Vitest is not yet declared, the first run installs it and replaces the one-time bootstrap command with the materialized test runner. Later runs invoke that runner directly.
+`npm test` exits unsuccessfully when any discovered test, hook, or test-module import fails.
 
 </details>