rstackjs · chenjiahan · Aug 11, 2026 · Aug 11, 2026 · Aug 11, 2026
diff --git a/.github/workflows/lint.yml b/.github/workflows/lint.yml
@@ -43,6 +43,9 @@ jobs:
       - name: Lint Rust
         run: cargo clippy --workspace --all-targets --locked -- -D warnings
 
+      - name: Build Native Binding
+        run: pnpm --filter rstack build:native
+
       - name: Lint
         run: node --run lint
 

diff --git a/Cargo.lock b/Cargo.lock
diff --git a/Cargo.toml b/Cargo.toml
@@ -1,5 +1,5 @@
 [workspace]
-members = ["crates/rstack-binding"]
+members = ["crates/rstack-binding", "crates/rstack-ignore"]
 resolver = "2"
 
 [workspace.package]
@@ -9,9 +9,12 @@ repository = "https://github.com/rstackjs/rstack-cli"
 rust-version = "1.88"
 
 [workspace.dependencies]
+ignore = { version = "0.4.33", default-features = false }
 napi = { version = "3.12.0", default-features = false, features = ["napi9"] }
 napi-build = "2.4.0"
 napi-derive = "3.6.2"
+pathdiff = "0.2.3"
+rstack-ignore = { path = "crates/rstack-ignore" }
 
 [profile.release]
 lto = true

diff --git a/crates/rstack-binding/Cargo.toml b/crates/rstack-binding/Cargo.toml
@@ -9,10 +9,12 @@ publish = false
 
 [lib]
 crate-type = ["cdylib"]
+test = false
 
 [dependencies]
 napi.workspace = true
 napi-derive.workspace = true
+rstack-ignore.workspace = true
 
 [build-dependencies]
 napi-build.workspace = true
diff --git a/crates/rstack-binding/src/lib.rs b/crates/rstack-binding/src/lib.rs
@@ -1,18 +1,44 @@
 #![deny(clippy::all)]
 
+use std::path::Path;
+
+use napi::Error;
 use napi_derive::napi;
+use rstack_ignore::{IgnoreMatcher as CoreIgnoreMatcher, IgnoreSource as CoreIgnoreSource};
+
+/// A Gitignore-compatible pattern source received from JavaScript.
+#[napi(object, object_to_js = false)]
+pub struct IgnoreSource {
+    /// Directory that patterns are resolved from.
+    pub root_path: String,
+    /// Newline-delimited Gitignore patterns.
+    pub patterns: String,
+}
 
+/// JavaScript-facing wrapper around the compiled Rust matcher.
 #[napi]
-pub fn native_ping(input: String) -> String {
-    format!("pong:{input}")
+pub struct IgnoreMatcher {
+    inner: CoreIgnoreMatcher,
 }
 
-#[cfg(test)]
-mod tests {
-    use super::native_ping;
+#[napi]
+impl IgnoreMatcher {
+    /// Compiles all pattern sources once and keeps the result for repeated path checks.
+    #[napi(constructor)]
+    pub fn new(sources: Vec<IgnoreSource>) -> napi::Result<Self> {
+        let sources = sources
+            .into_iter()
+            .map(|source| CoreIgnoreSource::new(source.root_path, source.patterns));
+        let inner = CoreIgnoreMatcher::new(sources).map_err(|error| {
+            Error::from_reason(format!("Failed to compile ignore patterns: {error}"))
+        })?;
+
+        Ok(Self { inner })
+    }
 
-    #[test]
-    fn formats_ping_response() {
-        assert_eq!(native_ping("rstack".to_string()), "pong:rstack");
+    /// Returns whether a file or directory is ignored by any source.
+    #[napi]
+    pub fn is_ignored(&mut self, file_path: String, is_directory: bool) -> bool {
+        self.inner.is_ignored(Path::new(&file_path), is_directory)
     }
 }
diff --git a/crates/rstack-ignore/Cargo.toml b/crates/rstack-ignore/Cargo.toml
@@ -0,0 +1,12 @@
+[package]
+name = "rstack-ignore"
+version = "0.1.0"
+edition.workspace = true
+license.workspace = true
+repository.workspace = true
+rust-version.workspace = true
+publish = false
+
+[dependencies]
+ignore.workspace = true
+pathdiff.workspace = true