initial attempt

Author: 2bndy5

Cargo.lock

@@ -1,7 +1,7 @@
 # See more keys and their definitions at https://doc.rust-lang.org/cargo/reference/manifest.html
 
 [workspace]
-members = ["cpp-linter", "py-binding", "docs"]
+members = ["cpp-linter", "py-binding", "node-binding", "docs"]
 resolver = "2"
 
 [workspace.package]

Cargo.toml

@@ -0,0 +1,6 @@
+target
+index.node
+**/node_modules
+**/.DS_Store
+npm-debug.log*cargo.log
+cross.log

node-binding/.gitignore

@@ -0,0 +1,27 @@
+[package]
+name = "cpp-linter-js"
+edition = "2021"
+exclude = ["index.node"]
+readme = "README.md"
+keywords = ["clang-tidy", "clang-format", "linter"]
+categories = ["command-line-utilities", "development-tools", "filesystem"]
+repository = "https://github.com/cpp-linter/cpp_linter_rs"
+version.workspace = true
+authors.workspace = true
+description.workspace = true
+homepage.workspace = true
+license.workspace = true
+
+[lib]
+crate-type = ["cdylib"]
+
+# See more keys and their definitions at https://doc.rust-lang.org/cargo/reference/manifest.html
+
+[dependencies]
+cpp-linter = { path = "../cpp-linter" }
+once_cell = "1.19.0"
+tokio = { version = "1.40.0", features = ["rt-multi-thread"]}
+
+[dependencies.neon]
+version = "1"
+features = ["napi-6"]

node-binding/Cargo.toml

@@ -0,0 +1,92 @@
+# cpp-linter-js
+
+This project was bootstrapped by [create-neon](https://www.npmjs.com/package/create-neon).
+
+## Building cpp-linter-js
+
+Building cpp-linter-js requires a [supported version of Node and Rust](https://github.com/neon-bindings/neon#platform-support).
+
+To run the build, run:
+
+```sh
+npm run build
+```
+
+This command uses the [@neon-rs/cli](https://www.npmjs.com/package/@neon-rs/cli) utility to assemble the binary Node addon from the output of `cargo`.
+
+## Exploring cpp-linter-js
+
+After building cpp-linter-js:
+
+```text
+cd node-binding
+npm i
+npm run build
+```
+
+You can explore its exports in the `node` console:
+
+```sh
+> cpp_linter_js = require('.')
+> // CLI args are passed as optional args to `run_main()`
+> await cpp_linter_js.run_main('--help')
+```
+
+## Available Scripts
+
+In the project directory, you can run:
+
+### `npm install`
+
+Installs the project, including running `npm run build`.
+
+### `npm run build`
+
+Builds the Node addon (`index.node`) from source, generating a release build with `cargo --release`.
+
+Additional [`cargo build`](https://doc.rust-lang.org/cargo/commands/cargo-build.html) arguments may be passed to `npm run build` and similar commands. For example, to enable a [cargo feature](https://doc.rust-lang.org/cargo/reference/features.html):
+
+```text
+npm run build -- --feature=beetle
+```
+
+### `npm run debug`
+
+Similar to `npm run build` but generates a debug build with `cargo`.
+
+### `npm run cross`
+
+Similar to `npm run build` but uses [cross-rs](https://github.com/cross-rs/cross) to cross-compile for another platform. Use the [`CARGO_BUILD_TARGET`](https://doc.rust-lang.org/cargo/reference/config.html#buildtarget) environment variable to select the build target.
+
+## Project Layout
+
+The directory structure of this project is:
+
+```text
+node-binding/
+├── Cargo.toml
+├── README.md
+├── src/
+|   └── lib.rs
+├── index.node
+├── package.json
+└── target/
+```
+
+| Entry          | Purpose                                                                                                                                  |
+|----------------|------------------------------------------------------------------------------------------------------------------------------------------|
+| `Cargo.toml`   | The Cargo [manifest file](https://doc.rust-lang.org/cargo/reference/manifest.html), which informs the `cargo` command.                   |
+| `README.md`    | This file.                                                                                                                               |
+| `src/`         | The directory tree containing the Rust source code for the project.                                                                      |
+| `lib.rs`       | Entry point for the Rust source code.                                                                                                          |
+| `index.node`   | The main module, a [Node addon](https://nodejs.org/api/addons.html) generated by the build and pointed to by `"main"` in `package.json`. |
+| `package.json` | The npm [manifest file](https://docs.npmjs.com/cli/v7/configuring-npm/package-json), which informs the `npm` command.                    |
+| `target/`      | Binary artifacts generated by the Rust build.                                                                                            |
+
+## Learn More
+
+Learn more about:
+
+- [Neon](https://neon-bindings.com).
+- [Rust](https://www.rust-lang.org).
+- [Node](https://nodejs.org).

node-binding/README.md

@@ -0,0 +1,21 @@
+{
+  "name": "cpp-linter-js",
+  "version": "2.0.0",
+  "description": "",
+  "main": "index.node",
+  "scripts": {
+    "test": "cargo test",
+    "cargo-build": "cargo build --message-format=json > cargo.log",
+    "cross-build": "cross build --message-format=json > cross.log",
+    "postcargo-build": "neon dist < cargo.log",
+    "postcross-build": "neon dist -m /target < cross.log",
+    "debug": "npm run cargo-build --",
+    "build": "npm run cargo-build -- --release",
+    "cross": "npm run cross-build -- --release"
+  },
+  "author": "",
+  "license": "MIT",
+  "devDependencies": {
+    "@neon-rs/cli": "0.1.73"
+  }
+}