Convert to native ESM (vitest + oxc toolchain)

.github/workflows/ci-module.yml

@@ -1,12 +1,12 @@
 name: ci
 
 on:
-  push:
-    branches:
-      - master
-  pull_request:
-  workflow_dispatch:
+    push:
+        branches:
+            - master
+    pull_request:
+    workflow_dispatch:
 
 jobs:
-  test:
-    uses: hapijs/.github/.github/workflows/ci-module.yml@master
+    test:
+        uses: hapijs/.github/.github/workflows/ci-module.yml@min-node-22-hapi-21

.gitignore

@@ -1,7 +1,7 @@
 **/node_modules
 **/package-lock.json
 
-coverage.*
+coverage/
 
 **/.DS_Store
 **/._*

API.md

@@ -3,32 +3,30 @@
 ```js
 const Formula = require('@hapi/formula');
 
-
 const functions = {
-    x: (value) => value + 10
+    x: (value) => value + 10,
 };
 
 const constants = {
-    Z: 100
+    Z: 100,
 };
 
 const reference = function (name) {
-
     return (context) => context[name];
 };
 
-
 const formula = new Formula.Parser('1 + a.b.c.2.4.x + [b] + x([y + 4] + Z)', { functions, constants, reference });
 
-formula.evaluate({ 'a.b.c.2.4.x': 2, b: 3, 'y + 4': 5 });       // 1 + 2 + 3 + 5 + 10 + 100
-formula.evaluate({ 'a.b.c.2.4.x': '2', b: 3, 'y + 4': '5' });   // '123510010'
+formula.evaluate({ 'a.b.c.2.4.x': 2, b: 3, 'y + 4': 5 }); // 1 + 2 + 3 + 5 + 10 + 100
+formula.evaluate({ 'a.b.c.2.4.x': '2', b: 3, 'y + 4': '5' }); // '123510010'
 ```
 
 ## Methods
 
 ### `new Formula.Parser(formula, [options])`
 
 Creates a new formula parser object where:
+
 - `formula` - the formula string to parse.
 - `options` - optional settings:
     - `constants` - a hash of key-value pairs used to convert constants to values.
@@ -39,6 +37,7 @@ Creates a new formula parser object where:
 ### `parser.evaluate([context])`
 
 Evaluate the formula where:
+
 - `context` - optional object with runtime formula context used to resolve variables.
 
 Returns the string or number outcome of the resolved formula.

README.md

@@ -1,4 +1,4 @@
-# @sideway/formula
+# @hapi/formula
 
 #### Math and string formula parser.
 

oxfmt.config.ts

@@ -0,0 +1,8 @@
+import DefaultOxfmtConfig from '@hapi/oxc-plugin/oxfmt';
+import { defineConfig } from 'oxfmt';
+
+import type { OxfmtConfig } from 'oxfmt';
+
+export default defineConfig({
+    ...DefaultOxfmtConfig,
+}) as OxfmtConfig;

oxlint.config.ts

@@ -0,0 +1,11 @@
+import HapiRecommended from '@hapi/oxc-plugin/oxlint';
+import { defineConfig } from 'oxlint';
+
+import type { OxlintConfig } from 'oxlint';
+
+export default defineConfig({
+    extends: [HapiRecommended],
+    env: {
+        ...HapiRecommended.env,
+    },
+}) as OxlintConfig;

package.json

@@ -1,29 +1,45 @@
 {
     "name": "@hapi/formula",
-    "description": "Math and string formula parser.",
     "version": "3.0.2",
-    "repository": "git://github.com/hapijs/formula",
-    "main": "lib/index.js",
-    "types": "lib/index.d.ts",
+    "description": "Math and string formula parser.",
     "keywords": [
         "formula",
-        "parser",
         "math",
+        "parser",
         "string"
     ],
+    "license": "BSD-3-Clause",
+    "repository": "git://github.com/hapijs/formula",
     "files": [
-        "lib"
+        "src",
+        "API.md"
     ],
-    "dependencies": {},
-    "devDependencies": {
-        "@hapi/code": "^9.0.3",
-        "@hapi/lab": "^25.1.2",
-        "@types/node": "^14.18.36",
-        "typescript": "4.0.x"
+    "type": "module",
+    "types": "src/index.d.ts",
+    "exports": {
+        ".": {
+            "types": "./src/index.d.ts",
+            "default": "./src/index.js"
+        }
     },
     "scripts": {
-        "test": "lab -a @hapi/code -t 100 -L -Y",
-        "test-cov-html": "lab -a @hapi/code -t 100 -L -r html -o coverage.html"
+        "test": "vitest run --coverage",
+        "typecheck": "tsc --noEmit",
+        "lint": "oxlint",
+        "lint:fix": "oxlint --fix",
+        "fmt": "oxfmt --check",
+        "fmt:fix": "oxfmt",
+        "check": "npm run lint && npm run fmt && npm run typecheck && npm test"
+    },
+    "devDependencies": {
+        "@hapi/oxc-plugin": "^1.0.1",
+        "@vitest/coverage-v8": "^4.1.9",
+        "oxfmt": "^0.57.0",
+        "oxlint": "^1.72.0",
+        "typescript": "^6.0.3",
+        "vitest": "^4.1.9"
     },
-    "license": "BSD-3-Clause"
+    "engines": {
+        "node": ">=22"
+    }
 }

src/index.d.ts

@@ -0,0 +1,36 @@
+/** Formula parser */
+export class Parser<T extends string | number> {
+    /**
+     * Create a new formula parser.
+     *
+     * @param formula - The formula string to parse.
+     * @param options - Optional settings.
+     */
+    constructor(formula: string, options?: Options);
+
+    /**
+     * Evaluate the formula.
+     *
+     * @param context - Optional object with runtime formula context used to resolve variables.
+     * @returns The string or number outcome of the resolved formula.
+     */
+    evaluate(context?: any): T;
+}
+
+export interface Options {
+    /** A hash of key - value pairs used to convert constants to values. */
+    readonly constants?: Record<string, any>;
+
+    /** A regular expression used to validate token variables. */
+    readonly tokenRx?: RegExp;
+
+    /** A variable resolver factory function. */
+    readonly reference?: Options.Reference;
+
+    /** A hash of key-value pairs used to resolve formula functions. */
+    readonly functions?: Record<string, Function>;
+}
+
+export namespace Options {
+    type Reference = (name: string) => (context: any) => any;
+}