runtime-checker 1.0.0

package/Cargo.toml

@@ -0,0 +1,46 @@
+[package]
+name = "runtime-checker"
+version = "1.0.0"
+edition = "2024"
+description = "Detect minimum runtime versions required by JavaScript and TypeScript codebases."
+license = "BSD-3-Clause"
+repository = "https://github.com/usebarekey/runtime-checker"
+homepage = "https://github.com/usebarekey/runtime-checker"
+readme = "README.md"
+keywords = ["node", "deno", "bun", "runtime", "cli"]
+categories = ["command-line-utilities", "development-tools"]
+
+[dependencies]
+aho-corasick = "1.1.4"
+anstream = "0.6.21"
+anstyle = "1.0.13"
+anyhow = "1.0.102"
+clap = { version = "4.5.53", features = ["derive"] }
+fff-grep = "0.9.5-nightly.7d7910b"
+ignore = "0.4.25"
+mimalloc = "0.1"
+node-semver = "2.2.0"
+oxc_allocator = "0.135.0"
+oxc_ast = "0.135.0"
+oxc_ast_visit = "0.135.0"
+oxc_parser = "0.135.0"
+oxc_semantic = "0.135.0"
+oxc_span = "0.135.0"
+oxc_syntax = "0.135.0"
+ron = "0.12.0"
+serde = { version = "1.0.228", features = ["derive"] }
+serde_json = "1.0.150"
+terminal_size = "0.4.4"
+thiserror = "2.0.17"
+ureq = "2.12.1"
+
+[dev-dependencies]
+assert_cmd = "2.1.1"
+tempfile = "3.24.0"
+
+[profile.release]
+opt-level = 3
+lto = "thin"
+codegen-units = 1
+panic = "abort"
+strip = "symbols"

package/LICENSE

@@ -0,0 +1,29 @@
+BSD 3-Clause License
+
+Copyright (c) 2026, Barekey
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

package/README.md

@@ -0,0 +1,26 @@
+# runtime-checker
+Detects the minimum version needed for **Node.js**, **Bun**, **Deno** and browsers to execute your codebase.
+
+## Installation
+```sh
+deno add npm:runtime-checker
+bun add runtime-checker
+pnpm add runtime-checker
+npm install runtime-checker
+```
+
+## Usage
+`$ runtime-checker <dir>`
+
+### Arguments
+ `--fast:` uses [fff](https://github.com/dmtrKovalenko/fff) instead of oxc AST parsing. Faster<sup>1</sup>, but less accurate.
+ 
+ <sup>1</sup> fff is only faster (and actually slower!) than oxc when your codebase is around 250,000~ or more lines of code, from testing on a Windows machine with a 9800X3D.
+
+ `--fix`: Automatically fixes your `engines.node` field to a supported version if an issue is found.
+
+ `--inspect <symbol, e.g.: Symbol.asyncDispose>`: Shows each detection of a specific symbol
+
+ `--summary`: Only prints the summary
+
+ `--runtime <all|deno|bun|node|safari|chrome|firefox>`: Only shows the results for a specific runtime

package/data/mdn/README.md

@@ -0,0 +1,30 @@
+# MDN Browser Compatibility Data Source
+
+This directory is generated from `@mdn/browser-compat-data`.
+
+MDN does not expose this as a query API. The maintained machine-readable source is the `@mdn/browser-compat-data` npm package, which also publishes a raw `data.json` file through package CDNs.
+
+The pinned BCD version is stored in `data/mdn-bcd.version`.
+
+Regenerate from the pinned CDN release:
+
+```sh
+cargo run --bin generate-mdn-data -- --output-dir data/mdn
+```
+
+Regenerate from an already downloaded `data.json` file:
+
+```sh
+cargo run --bin generate-mdn-data -- --input path/to/data.json --output-dir data/mdn
+```
+
+The generator emits:
+
+- `node.ron` from BCD runtime id `nodejs`
+- `deno.ron` from BCD runtime id `deno`
+- `bun.ron` from BCD runtime id `bun`
+- `safari.ron` from BCD runtime id `safari`
+- `chrome.ron` from BCD runtime id `chrome`
+- `firefox.ron` from BCD runtime id `firefox`
+
+Important: this is a source layer for JavaScript builtins and Web APIs. It does not cover Node core modules such as `fs`, `path`, or `http`; those need a separate Node documentation source layer before replacing the main `data/node.ron`.