@stylexswc/rs-compiler 0.11.1 → 0.11.2-rc.1

package/README.md

@@ -53,7 +53,7 @@ Internally, this compiler takes your StyleX code and transforms it into a format
 optimized for further processing.
 
 ```ts
-var { transform } = require('@stylexswc/compiler-rs');
+var { transform } = require('@stylexswc/rs-compiler');
 
 /// ...other logic
 
@@ -66,6 +66,100 @@ const { code, metadata, sourcemap } = transform(
 /// ...other logic
 ```
 
+### Path Filtering
+
+> [!NOTE]
+> **New Feature:** The `include` and `exclude` options are exclusive to this NAPI-RS compiler implementation and are not available in the official StyleX Babel plugin. They provide powerful file filtering capabilities to control which files are transformed.
+
+The compiler exports a `shouldTransformFile` function to determine whether a file should be transformed based on include/exclude patterns:
+
+```ts
+import { shouldTransformFile } from '@stylexswc/rs-compiler';
+
+const shouldTransform = shouldTransformFile(
+  '/path/to/file.tsx',
+  ['src/**/*.{ts,tsx}'], // include patterns (optional)
+  ['**/*.test.*', '**/__tests__/**'] // exclude patterns (optional)
+);
+
+if (shouldTransform) {
+  // Transform the file
+}
+```
+
+#### Pattern Types
+
+- **Glob patterns** (strings): Use standard glob syntax to match file paths
+  - `src/**/*.tsx` - All `.tsx` files in `src` directory and subdirectories
+  - `**/*.test.*` - All test files
+  - `**/node_modules/**` - All files in `node_modules`
+
+- **Regular expressions**: Use RegExp objects for complex pattern matching
+  - `/\.test\./` - Files containing `.test.`
+  - `/^src\/.*\.tsx$/` - `.tsx` files directly in the `src` directory
+
+  **Advanced: Lookahead/Lookbehind Support**
+
+  The Rust regex engine fully supports lookahead and lookbehind assertions, enabling sophisticated filtering patterns:
+
+  - **Negative Lookahead** `(?!...)`: Match if NOT followed by pattern
+    - `/node_modules(?!\/@stylexjs)/` - Exclude all node_modules except @stylexjs packages
+    - `/\.tsx(?!\.test)/` - Match .tsx files that are NOT test files
+
+  - **Positive Lookahead** `(?=...)`: Match if followed by pattern
+    - `/.*\.test(?=\.tsx$)/` - Match only .test.tsx files
+
+  - **Negative Lookbehind** `(?<!...)`: Match if NOT preceded by pattern
+    - `/(?<!src\/).*\.tsx$/` - Exclude .tsx files not in src/
+
+  - **Positive Lookbehind** `(?<=...)`: Match if preceded by pattern
+    - `/(?<=components\/).*\.tsx$/` - Match only .tsx files in components/
+
+#### Filtering Rules
+
+1. If `include` patterns are specified and not empty, files must match at least one pattern
+2. If `exclude` patterns are specified, files matching any pattern are excluded
+3. Exclude patterns take precedence over include patterns
+4. All paths are matched relative to the current working directory
+
+#### Common Use Cases
+
+**Exclude all node_modules except specific packages:**
+
+```ts
+// Exclude all node_modules except @stylexjs/open-props
+shouldTransformFile(
+  filePath,
+  undefined,
+  [/node_modules(?!\/@stylexjs\/open-props)/]
+);
+```
+
+**Transform only specific packages from node_modules:**
+
+```ts
+shouldTransformFile(
+  filePath,
+  [
+    'src/**/*.{ts,tsx}',
+    'node_modules/@stylexjs/open-props/**/*.js',
+    'node_modules/@my-org/design-system/**/*.js',
+  ],
+  ['**/*.test.*']
+);
+```
+
+**Exclude multiple node_modules packages except a few:**
+
+```ts
+// Exclude all node_modules except @stylexjs packages
+shouldTransformFile(
+  filePath,
+  undefined,
+  [/node_modules(?!\/@stylexjs)/]
+);
+```
+
 ### Output
 
 The output from the compiler includes the transformed code, metadata about the
@@ -144,6 +238,7 @@ You can enable debug logging for the StyleX compiler using the `STYLEX_DEBUG` en
 ### Log Levels
 
 The following log levels are available:
+
 - `error`: Only shows error messages
 - `warn`: Shows warnings and errors (default)
 - `info`: Shows informational messages, warnings, and errors
@@ -163,11 +258,13 @@ STYLEX_DEBUG=trace npm run dev
 ```
 
 For Windows Command Prompt:
+
 ```cmd
 set STYLEX_DEBUG=debug && npm run build
 ```
 
 For PowerShell:
+
 ```powershell
 $env:STYLEX_DEBUG="debug"; npm run build
 ```

package/dist/index.d.ts

@@ -46,6 +46,8 @@ export interface StyleXOptions {
   aliases?: Record<string, string[]>
   unstable_moduleResolution?: StyleXModuleResolution
   sourceMap?: SourceMaps
+  include?: Array<string | RegExp>
+  exclude?: Array<string | RegExp>
 }
 export interface StyleXMetadata {
   stylex: ([string, { ltr: string; rtl?: null | string }, number])[]
@@ -56,4 +58,5 @@ export interface StyleXTransformResult {
   map?: string
 }
 export declare function transform(filename: string, code: string, options: StyleXOptions): StyleXTransformResult
+export declare function shouldTransformFile(filePath: string, include?: Array<unknown> | undefined | null, exclude?: Array<unknown> | undefined | null): boolean
 export declare function normalizeRsOptions(options: StyleXOptions): StyleXOptions

package/dist/index.js

@@ -310,8 +310,9 @@ if (!nativeBinding) {
   throw new Error(`Failed to load native binding`)
 }
 
-const { SourceMaps, transform, normalizeRsOptions } = nativeBinding
+const { SourceMaps, transform, shouldTransformFile, normalizeRsOptions } = nativeBinding
 
 module.exports.SourceMaps = SourceMaps
 module.exports.transform = transform
+module.exports.shouldTransformFile = shouldTransformFile
 module.exports.normalizeRsOptions = normalizeRsOptions

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@stylexswc/rs-compiler",
   "description": "NAPI-RS compiler for transform StyleX code",
-  "version": "0.11.1",
+  "version": "0.11.2-rc.1",
   "private": false,
   "license": "MIT",
   "files": [
@@ -23,20 +23,20 @@
     "@napi-rs/cli": "^2.18.4",
     "@stylexjs/open-props": "^0.11.1",
     "@stylexjs/stylex": "^0.15.4",
-    "@stylexswc/shared": "0.11.1",
-    "@swc-node/register": "^1.10.10",
+    "@stylexswc/shared": "0.11.2-rc.1",
+    "@swc-node/register": "^1.11.1",
     "@swc/core": "^1.13.3",
     "@taplo/cli": "^0.7.0",
-    "@types/node": "^24.1.0",
+    "@types/node": "^24.7.2",
     "ava": "^6.4.1",
     "benchmark": "^2.1.4",
-    "chalk": "^5.4.1",
-    "lint-staged": "^16.1.2",
+    "chalk": "^5.6.2",
+    "lint-staged": "^16.2.3",
     "npm-run-all2": "^8.0.4",
     "oxlint": "^0.17.0",
     "prettier": "^3.6.2",
     "tinybench": "^4.0.1",
-    "typescript": "^5.9.2"
+    "typescript": "^5.9.3"
   },
   "ava": {
     "extensions": {
@@ -80,13 +80,13 @@
   },
   "repository": "https://github.com/Dwlad90/stylex-swc-plugin",
   "optionalDependencies": {
-    "@stylexswc/rs-compiler-win32-x64-msvc": "0.11.1",
-    "@stylexswc/rs-compiler-darwin-x64": "0.11.1",
-    "@stylexswc/rs-compiler-linux-x64-gnu": "0.11.1",
-    "@stylexswc/rs-compiler-darwin-arm64": "0.11.1",
-    "@stylexswc/rs-compiler-linux-arm64-gnu": "0.11.1",
-    "@stylexswc/rs-compiler-linux-x64-musl": "0.11.1",
-    "@stylexswc/rs-compiler-win32-arm64-msvc": "0.11.1"
+    "@stylexswc/rs-compiler-win32-x64-msvc": "0.11.2-rc.1",
+    "@stylexswc/rs-compiler-darwin-x64": "0.11.2-rc.1",
+    "@stylexswc/rs-compiler-linux-x64-gnu": "0.11.2-rc.1",
+    "@stylexswc/rs-compiler-darwin-arm64": "0.11.2-rc.1",
+    "@stylexswc/rs-compiler-linux-arm64-gnu": "0.11.2-rc.1",
+    "@stylexswc/rs-compiler-linux-x64-musl": "0.11.2-rc.1",
+    "@stylexswc/rs-compiler-win32-arm64-msvc": "0.11.2-rc.1"
   },
   "scripts": {
     "artifacts": "napi artifacts",
@@ -105,6 +105,7 @@
     "lint:check": " cargo clippy --all-targets --all-features -- -D warnings",
     "postbuild": "pnpm run check:artifacts",
     "test": "ava",
+    "typecheck": "scripty --rs",
     "version": "napi version"
   }
 }