@stylexswc/rs-compiler 0.3.0-rc.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Vladislav Buinovski
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,106 @@
+# NAPI-RS compiler for StyleX (\*\*unofficial)
+
+
+StyleX is a JavaScript library developed by Meta for defining styles optimized for user interfaces. You can find the official repository [here](https://www.github.com/facebook/stylex).
+
+> [!WARNING]
+> This is an unofficial style compiler for StyleX.
+
+## Overview
+
+This package provides an unofficial, high-performance compiler for StyleX, a popular library from Meta for building optimized user interfaces. It leverages the power of NAPI-RS and SWC to achieve several key advantages:
+
+> [!IMPORTANT]
+> The usage of StyleX does not change.
+> All changes are internal.
+
+- Faster Build Times: By utilizing SWC instead of Babel, you can potentially experience significant speed improvements during StyleX processing.
+- Seamless Integration: This compiler seamlessly integrates with Next.js's default SWC Compiler, ensuring a smooth workflow.
+- Drop-in Replacement: Designed to be a drop-in replacement for the official StyleX Babel plugin, minimizing disruption to existing codebases.
+- Advanced Tooling Capabilities: NAPI-RS compiler unlocks access to StyleX metadata and source maps, enabling the creation of advanced plugins and tools for StyleX, ex. for creating a plugin for Webpack, Rollup, or other tools.
+
+## Advantages of a `NAPI-RS` compiler versus a `SWC plugin`
+
+- Compability with SWC: under the hood, the NAPI-RS compiler uses SWC for parsing and transforming JavaScript code, ensuring compatibility with the latest ECMAScript features.
+- Direct Access to Node.js APIs: NAPI-RS allows you to directly access Node.js APIs from your Rust code, providing greater flexibility and control.
+- Improved Performance: NAPI-RS can often offer better performance than traditional Node.js addons, especially for computationally intensive tasks.
+- Simplified Development: NAPI-RS simplifies the process of developing Node.js addons in Rust, making it easier to create high-performance and efficient tools.
+
+## Installation
+
+To install the package, run the following command:
+
+```bash
+npm install --save-dev @stylexswc/rs-compiler
+```
+
+## Example
+
+Your StyleX code usage remains unchanged. Here's a simple example:
+
+```ts
+import stylex from '@stylexjs/stylex'
+
+export const styles = stylex.create({
+  default: {
+    backgroundColor: 'red',
+    color: 'blue',
+  },
+})
+```
+
+### Transformation Process
+
+Internally, this compiler takes your StyleX code and transforms it into a format optimized for further processing.
+
+```ts
+var { transform } = require('@stylexswc/compiler-rs')
+
+/// ...other logic
+
+const { code, metadata, sourcemap } = transform(filename, inputSourceCode, transformOptions)
+
+/// ...other logic
+```
+
+### Output
+
+The output from the compiler includes the transformed code, metadata about the generated styles, and an optional source map.
+
+```json
+{
+  "code": "import stylex from '@stylexjs/stylex';\nexport const styles = {\n    default: {\n        backgroundColor: \"xrkmrrc\",\n        color: \"xju2f9n\",\n        $$css: true\n    }\n};\n",
+  "metadata": {
+    "stylex": {
+      "styles": [
+        [
+          "xrkmrrc",
+          {
+            "ltr": ".xrkmrrc{background-color:red}",
+            "rtl": null
+          },
+          3000
+        ],
+        [
+          "xju2f9n",
+          {
+            "ltr": ".xju2f9n{color:blue}",
+            "rtl": null
+          },
+          3000
+        ]
+      ]
+    }
+  },
+  "map": "{\"version\":3,\"sources\":[\"<anon>\"],\"names\":[],\"mappings\":\"AACE;AACA;;;;;;EAKG\"}"
+}
+```
+
+## Compatibility
+
+> [!IMPORTANT]
+> The current resolution of the `exports` field from `package. json` is only partially supported, so if you encounter problems, please open an [issue](https://github.com/Dwlad90/stylex-swc-plugin/issues/new) with an attached link to reproduce the problem.
+
+## License
+
+StyleX is MIT licensed. Stylex NAPI-RS compiler is also MIT licensed.

package/dist/index.d.ts

@@ -0,0 +1,33 @@
+/* tslint:disable */
+/* eslint-disable */
+
+/* auto-generated by NAPI-RS */
+
+export interface StyleXModuleResolution {
+  type: string
+  rootDir?: string
+  themeFileExtension?: string
+}
+export interface StyleXOptions {
+  styleResolution?: string
+  useRemForFontSize?: boolean
+  runtimeInjection?: boolean
+  classNamePrefix?: string
+  definedStylexCssVariables?: Record<string, string>
+  importSources?: Array<string>
+  treeshakeCompensation?: boolean
+  genConditionalClasses?: boolean
+  dev?: boolean
+  test?: boolean
+  aliases?: Record<string, Array<string>>
+  unstable_moduleResolution?: StyleXModuleResolution
+}
+export interface StyleXMetadata {
+  stylex: Array<[string, { ltr: string; rtl?: null | string }, number]>
+}
+export interface StyleXTransformResult {
+  code: string
+  metadata: StyleXMetadata
+  map?: string
+}
+export declare function transform(filename: string, code: string, options: StyleXOptions): StyleXTransformResult

package/dist/index.js

@@ -0,0 +1,315 @@
+/* tslint:disable */
+/* eslint-disable */
+/* prettier-ignore */
+
+/* auto-generated by NAPI-RS */
+
+const { existsSync, readFileSync } = require('fs')
+const { join } = require('path')
+
+const { platform, arch } = process
+
+let nativeBinding = null
+let localFileExisted = false
+let loadError = null
+
+function isMusl() {
+  // For Node 10
+  if (!process.report || typeof process.report.getReport !== 'function') {
+    try {
+      const lddPath = require('child_process').execSync('which ldd').toString().trim()
+      return readFileSync(lddPath, 'utf8').includes('musl')
+    } catch (e) {
+      return true
+    }
+  } else {
+    const { glibcVersionRuntime } = process.report.getReport().header
+    return !glibcVersionRuntime
+  }
+}
+
+switch (platform) {
+  case 'android':
+    switch (arch) {
+      case 'arm64':
+        localFileExisted = existsSync(join(__dirname, 'rs-compiler.android-arm64.node'))
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./rs-compiler.android-arm64.node')
+          } else {
+            nativeBinding = require('@stylexswc/rs-compiler')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      case 'arm':
+        localFileExisted = existsSync(join(__dirname, 'rs-compiler.android-arm-eabi.node'))
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./rs-compiler.android-arm-eabi.node')
+          } else {
+            nativeBinding = require('@stylexswc/rs-compiler')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      default:
+        throw new Error(`Unsupported architecture on Android ${arch}`)
+    }
+    break
+  case 'win32':
+    switch (arch) {
+      case 'x64':
+        localFileExisted = existsSync(
+          join(__dirname, 'rs-compiler.win32-x64-msvc.node')
+        )
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./rs-compiler.win32-x64-msvc.node')
+          } else {
+            nativeBinding = require('@stylexswc/rs-compiler')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      case 'ia32':
+        localFileExisted = existsSync(
+          join(__dirname, 'rs-compiler.win32-ia32-msvc.node')
+        )
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./rs-compiler.win32-ia32-msvc.node')
+          } else {
+            nativeBinding = require('@stylexswc/rs-compiler')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      case 'arm64':
+        localFileExisted = existsSync(
+          join(__dirname, 'rs-compiler.win32-arm64-msvc.node')
+        )
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./rs-compiler.win32-arm64-msvc.node')
+          } else {
+            nativeBinding = require('@stylexswc/rs-compiler')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      default:
+        throw new Error(`Unsupported architecture on Windows: ${arch}`)
+    }
+    break
+  case 'darwin':
+    localFileExisted = existsSync(join(__dirname, 'rs-compiler.darwin-universal.node'))
+    try {
+      if (localFileExisted) {
+        nativeBinding = require('./rs-compiler.darwin-universal.node')
+      } else {
+        nativeBinding = require('@stylexswc/rs-compiler')
+      }
+      break
+    } catch {}
+    switch (arch) {
+      case 'x64':
+        localFileExisted = existsSync(join(__dirname, 'rs-compiler.darwin-x64.node'))
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./rs-compiler.darwin-x64.node')
+          } else {
+            nativeBinding = require('@stylexswc/rs-compiler')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      case 'arm64':
+        localFileExisted = existsSync(
+          join(__dirname, 'rs-compiler.darwin-arm64.node')
+        )
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./rs-compiler.darwin-arm64.node')
+          } else {
+            nativeBinding = require('@stylexswc/rs-compiler')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      default:
+        throw new Error(`Unsupported architecture on macOS: ${arch}`)
+    }
+    break
+  case 'freebsd':
+    if (arch !== 'x64') {
+      throw new Error(`Unsupported architecture on FreeBSD: ${arch}`)
+    }
+    localFileExisted = existsSync(join(__dirname, 'rs-compiler.freebsd-x64.node'))
+    try {
+      if (localFileExisted) {
+        nativeBinding = require('./rs-compiler.freebsd-x64.node')
+      } else {
+        nativeBinding = require('@stylexswc/rs-compiler')
+      }
+    } catch (e) {
+      loadError = e
+    }
+    break
+  case 'linux':
+    switch (arch) {
+      case 'x64':
+        if (isMusl()) {
+          localFileExisted = existsSync(
+            join(__dirname, 'rs-compiler.linux-x64-musl.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./rs-compiler.linux-x64-musl.node')
+            } else {
+              nativeBinding = require('@stylexswc/rs-compiler')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        } else {
+          localFileExisted = existsSync(
+            join(__dirname, 'rs-compiler.linux-x64-gnu.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./rs-compiler.linux-x64-gnu.node')
+            } else {
+              nativeBinding = require('@stylexswc/rs-compiler')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        }
+        break
+      case 'arm64':
+        if (isMusl()) {
+          localFileExisted = existsSync(
+            join(__dirname, 'rs-compiler.linux-arm64-musl.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./rs-compiler.linux-arm64-musl.node')
+            } else {
+              nativeBinding = require('@stylexswc/rs-compiler')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        } else {
+          localFileExisted = existsSync(
+            join(__dirname, 'rs-compiler.linux-arm64-gnu.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./rs-compiler.linux-arm64-gnu.node')
+            } else {
+              nativeBinding = require('@stylexswc/rs-compiler')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        }
+        break
+      case 'arm':
+        if (isMusl()) {
+          localFileExisted = existsSync(
+            join(__dirname, 'rs-compiler.linux-arm-musleabihf.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./rs-compiler.linux-arm-musleabihf.node')
+            } else {
+              nativeBinding = require('@stylexswc/rs-compiler')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        } else {
+          localFileExisted = existsSync(
+            join(__dirname, 'rs-compiler.linux-arm-gnueabihf.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./rs-compiler.linux-arm-gnueabihf.node')
+            } else {
+              nativeBinding = require('@stylexswc/rs-compiler')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        }
+        break
+      case 'riscv64':
+        if (isMusl()) {
+          localFileExisted = existsSync(
+            join(__dirname, 'rs-compiler.linux-riscv64-musl.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./rs-compiler.linux-riscv64-musl.node')
+            } else {
+              nativeBinding = require('@stylexswc/rs-compiler')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        } else {
+          localFileExisted = existsSync(
+            join(__dirname, 'rs-compiler.linux-riscv64-gnu.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./rs-compiler.linux-riscv64-gnu.node')
+            } else {
+              nativeBinding = require('@stylexswc/rs-compiler')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        }
+        break
+      case 's390x':
+        localFileExisted = existsSync(
+          join(__dirname, 'rs-compiler.linux-s390x-gnu.node')
+        )
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./rs-compiler.linux-s390x-gnu.node')
+          } else {
+            nativeBinding = require('@stylexswc/rs-compiler')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      default:
+        throw new Error(`Unsupported architecture on Linux: ${arch}`)
+    }
+    break
+  default:
+    throw new Error(`Unsupported OS: ${platform}, architecture: ${arch}`)
+}
+
+if (!nativeBinding) {
+  if (loadError) {
+    throw loadError
+  }
+  throw new Error(`Failed to load native binding`)
+}
+
+const { transform } = nativeBinding
+
+module.exports.transform = transform

package/package.json

@@ -0,0 +1,99 @@
+{
+  "name": "@stylexswc/rs-compiler",
+  "description": "NAPI-RS compiler for transform StyleX code",
+  "version": "0.3.0-rc.1",
+  "ava": {
+    "extensions": {
+      "ts": "module"
+    },
+    "timeout": "2m",
+    "workerThreads": false,
+    "environmentVariables": {
+      "TS_NODE_PROJECT": "./tsconfig.json"
+    },
+    "nodeArguments": [
+      "--import",
+      "@swc-node/register/esm-register"
+    ]
+  },
+  "devDependencies": {
+    "@napi-rs/cli": "^2.18.4",
+    "@stylexjs/open-props": "^0.7.5",
+    "@stylexjs/stylex": "^0.7.5",
+    "@swc-node/register": "^1.10.6",
+    "@swc/core": "^1.6.13",
+    "@taplo/cli": "^0.7.0",
+    "@types/node": "^20",
+    "ava": "^6.1.3",
+    "benchmark": "^2.1.2",
+    "chalk": "^5.3.0",
+    "husky": "^9.0.11",
+    "lint-staged": "^15.2.7",
+    "npm-run-all2": "^6.2.2",
+    "oxlint": "^0.9.0",
+    "prettier": "^3.3.3",
+    "tinybench": "^2.8.0",
+    "typescript": "^5.5.3"
+  },
+  "engines": {
+    "node": ">= 18"
+  },
+  "files": [
+    "dist/index.d.ts",
+    "dist/index.js",
+    "dist/*.node"
+  ],
+  "keywords": [
+    "N-API",
+    "NAPI",
+    "napi-rs",
+    "node-addon",
+    "node-addon-api",
+    "Rust",
+    "StyleX",
+    "SWC"
+  ],
+  "license": "MIT",
+  "main": "dist/index.js",
+  "napi": {
+    "name": "rs-compiler",
+    "triples": {
+      "defaults": true,
+      "additional": [
+        "aarch64-apple-darwin",
+        "aarch64-unknown-linux-gnu",
+        "x86_64-apple-darwin",
+        "x86_64-pc-windows-msvc",
+        "x86_64-unknown-linux-gnu",
+        "x86_64-unknown-linux-musl"
+      ]
+    }
+  },
+  "private": false,
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  },
+  "repository": "https://github.com/Dwlad90/stylex-swc-plugin",
+  "optionalDependencies": {
+    "@stylexswc/rs-compiler-win32-x64-msvc": "0.3.0-rc.1",
+    "@stylexswc/rs-compiler-darwin-x64": "0.3.0-rc.1",
+    "@stylexswc/rs-compiler-linux-x64-gnu": "0.3.0-rc.1",
+    "@stylexswc/rs-compiler-darwin-arm64": "0.3.0-rc.1",
+    "@stylexswc/rs-compiler-linux-arm64-gnu": "0.3.0-rc.1",
+    "@stylexswc/rs-compiler-linux-x64-musl": "0.3.0-rc.1"
+  },
+  "scripts": {
+    "artifacts": "napi artifacts",
+    "bench": "node --import @swc-node/register/esm-register benchmark/bench.ts",
+    "build": "napi build --platform --release dist",
+    "build:debug": "napi build --platform",
+    "format": "run-p format:prettier format:rs format:toml",
+    "format:prettier": "prettier . -w",
+    "format:rs": "cargo fmt",
+    "format:toml": "taplo format",
+    "lint": "oxlint .",
+    "test": "ava",
+    "version": "napi version"
+  }
+}