Support parsing CSV by WASM (#70)

* Prepare Rust support for parsing CSV

* Update Rust setup in CI/CD workflows

* Update Rust setup action

* Update CI configuration to target wasm32-unknown-unknown

* Fix CI

* Add wasm-opt dependency

* Add libstdc++-12-dev installation to CI workflow

* Add libstdc++-12-dev installation step

* Update libstdc++-12-dev installation in CI/CD workflows

* Update CI configuration and dependencies

* Add artifact upload step and update import path

* Add dependency on build job in test_deno workflow

* Add WASM CSV parsing functionality

* Remove rust-cache action

* Change build method

* Improve building WASM and loading WASM from Node.js

* Add wasm-pack dependency

* Add wasm-pack installation to CI/CD workflows

* Add wasm-pack installation step to CI workflow

* Refactor vite-plugin-wasm-pack configuration

* Update dependabot configuration

* Add Rust checking workflow

* Add clippy component to Rust CI workflow

* Add linting and formatting on git stageed

* Update cargo commands in ci.yaml

* Add rustfmt component to CI workflow

* Update parseStringToArraySyncWASM function and add fast-check library for property-based testing

* Add doc for experimental WebAssembly parsing support for high performance

* Update package.json dependencies

* Create yellow-chefs-run.md

* Update changeset

Author: kamiazya

.changeset/yellow-chefs-run.md

@@ -0,0 +1,18 @@
+---
+"web-csv-toolbox": minor
+---
+
+Support parsing CSV by WASM build by Rust
+
+- **New Features**
+	- Introduced WebAssembly support for high-performance CSV parsing in the CSV Toolbox, including new APIs and limitations.
+	- Added a weekly update schedule for cargo package dependencies.
+	- Implemented a Vite plugin for integrating WebAssembly modules into projects.
+
+- **Enhancements**
+	- Added new configuration rule for Rust files, setting indent size to 4 spaces.
+	- Enhanced continuous integration and deployment workflows with additional steps for Rust and WebAssembly setup.
+	- Updated documentation to reflect WebAssembly features and usage in CSV parsing.
+
+- **Chores**
+	- Introduced linting and formatting checks for JavaScript, TypeScript, JSON, and Rust files.

.editorconfig

@@ -10,3 +10,6 @@ end_of_line = lf
 charset = utf-8
 trim_trailing_whitespace = true
 insert_final_newline = true
+
+[*.rs]
+indent_size = 4

.github/dependabot.yml

@@ -5,7 +5,11 @@
 
 version: 2
 updates:
-  - package-ecosystem: npm # See documentation for possible values
-    directory: "/" # Location of package manifests
+  - package-ecosystem: npm
+    directory: "/"
+    schedule:
+      interval: "weekly"
+  - package-ecosystem: cargo
+    directory: "/web-csv-toolbox-wasm"
     schedule:
       interval: "weekly"

.github/workflows/cd.yaml

@@ -25,6 +25,16 @@ jobs:
       - uses: pnpm/action-setup@v2
         with:
           version: 8
+      - run: |
+          sudo apt-get update
+          sudo apt-get install libstdc++-12-dev
+      - name: Install latest
+        uses: moonrepo/setup-rust@v1
+        with:
+          targets: wasm32-unknown-unknown
+          channel: nightly
+      - name: Install wasm-pack
+        run: curl https://rustwasm.github.io/wasm-pack/installer/init.sh -sSf | sh
       - name: Setup Node.js 20
         uses: actions/setup-node@v3
         with:

.github/workflows/ci.yaml

@@ -11,6 +11,16 @@ jobs:
     steps:
       - name: Checkout Repo
         uses: actions/checkout@v4
+      - run: |
+          sudo apt-get update
+          sudo apt-get install libstdc++-12-dev
+      - name: Install latest
+        uses: moonrepo/setup-rust@v1
+        with:
+          targets: wasm32-unknown-unknown
+          channel: nightly
+      - name: Install wasm-pack
+        run: curl https://rustwasm.github.io/wasm-pack/installer/init.sh -sSf | sh
       - uses: pnpm/action-setup@v2
         with:
           version: 8
@@ -23,6 +33,10 @@ jobs:
         run: pnpm install --frozen-lockfile
       - name: Build
         run: pnpm run build
+      - uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist
   test_nodejs:
     runs-on: ubuntu-latest
     strategy:
@@ -40,20 +54,29 @@ jobs:
       with:
         node-version: ${{ matrix.node-version }}
         cache: pnpm
+    - name: Install latest
+      uses: moonrepo/setup-rust@v1
+      with:
+        targets: wasm32-unknown-unknown
+        channel: nightly
+    - name: Install wasm-pack
+      run: curl https://rustwasm.github.io/wasm-pack/installer/init.sh -sSf | sh
     - run: pnpm install --frozen-lockfile
     - run: pnpm run build
     - run: pnpm test run
 
   test_deno:
     runs-on: ubuntu-latest
+    needs: build
     steps:
     - uses: actions/checkout@v3
+    - uses: actions/download-artifact@v4
     - uses: denoland/setup-deno@v1
       with:
         deno-version: v1.x
     - run: |
         deno eval '
-        import { parse } from "./src/web-csv-toolbox.ts";
+        import { parse } from "./dist/es/web-csv-toolbox.js";
 
         const csv = `name,age
         Alice,42
@@ -73,6 +96,16 @@ jobs:
           - firefox
     steps:
       - uses: actions/checkout@v3
+      - run: |
+          sudo apt-get update
+          sudo apt-get install libstdc++-12-dev
+      - name: Install latest
+        uses: moonrepo/setup-rust@v1
+        with:
+          targets: wasm32-unknown-unknown
+          channel: nightly
+      - name: Install wasm-pack
+        run: curl https://rustwasm.github.io/wasm-pack/installer/init.sh -sSf | sh
       - uses: pnpm/action-setup@v2
         with:
           version: 8
@@ -97,6 +130,13 @@ jobs:
           # - safari
     steps:
       - uses: actions/checkout@v3
+      - name: Install latest
+        uses: moonrepo/setup-rust@v1
+        with:
+          targets: wasm32-unknown-unknown
+          channel: nightly
+      - name: Install wasm-pack
+        run: curl https://rustwasm.github.io/wasm-pack/installer/init.sh -sSf | sh
       - uses: pnpm/action-setup@v2
         with:
           version: 8
@@ -121,6 +161,13 @@ jobs:
           - edge
     steps:
       - uses: actions/checkout@v3
+      - name: Install latest
+        uses: moonrepo/setup-rust@v1
+        with:
+          targets: wasm32-unknown-unknown
+          channel: nightly
+      - name: Install wasm-pack
+        run: curl https://rustwasm.github.io/wasm-pack/installer/init.sh -sSf | sh
       - uses: pnpm/action-setup@v2
         with:
           version: 8
@@ -129,10 +176,12 @@ jobs:
         with:
           node-version: 20
           cache: pnpm
+      - name: Install wasm-pack
+        run: curl https://rustwasm.github.io/wasm-pack/installer/init.sh -sSf | sh
       - run: pnpm install --frozen-lockfile
       - run: pnpm test run -- --browser.name=${{ matrix.browsers }} --browser.headless
 
-  check:
+  check_nodejs:
     name: Check
     runs-on: ubuntu-latest
     permissions:
@@ -152,3 +201,28 @@ jobs:
         run: pnpm install --frozen-lockfile
       - name: Check
         run: npx biome ci .
+  check_rust:
+    name: Check Rust
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+    steps:
+      - name: Checkout Repo
+        uses: actions/checkout@v4
+      - run: |
+          sudo apt-get update
+          sudo apt-get install libstdc++-12-dev
+      - name: Install latest
+        uses: moonrepo/setup-rust@v1
+        with:
+          targets: wasm32-unknown-unknown
+          channel: nightly
+          components: clippy,rustfmt
+      - name: Install wasm-pack
+        run: curl https://rustwasm.github.io/wasm-pack/installer/init.sh -sSf | sh
+      - name: Run Clippy
+        run: cargo clippy --manifest-path=./web-csv-toolbox-wasm/Cargo.toml --all-targets --all-features
+        env:
+          RUSTFLAGS: -D warnings
+      - name: Run Fmt
+        run: cargo fmt --manifest-path=./web-csv-toolbox-wasm/Cargo.toml --all -- --check

.lintstagedrc.js

@@ -0,0 +1,7 @@
+export default  {
+  "*.{js,ts,json}": "biome check --no-errors-on-unmatched --apply",
+  "*.rs": [
+    () => "cargo fmt --manifest-path=./web-csv-toolbox-wasm/Cargo.toml --all",
+    () => "cargo clippy --manifest-path=./web-csv-toolbox-wasm/Cargo.toml --all-targets --all-features",
+  ],
+};

.lintstagedrc.yaml

@@ -55,6 +55,10 @@ A CSV Toolbox utilizing Web Standard APIs.
   - 🔄 Flexible BOM handling.
   - 🗜️ Supports various compression formats.
   - 🔤 Charset specification for diverse encoding.
+- 📦 **Lightweight and Zero Dependencies**: No external dependencies, only Web Standards APIs.
+- 📚 **Fully Typed and Documented**: Fully typed and documented with [TypeDoc](https://typedoc.org/).
+- 🚀 **Using WebAssembly for High Performance**: WebAssembly is used for high performance parsing. (_Experimental_)
+  - 📦 WebAssembly is used for high performance parsing.
 
 ## Installation 📥
 
@@ -276,6 +280,41 @@ ideal for developers looking for in-depth control and flexibility.
 - **`class RecordAssemblerTransformer`**: [📑](https://kamiazya.github.io/web-csv-toolbox/classes/RecordAssemblerTransformer.html)
   - Handles the assembly of parsed data into records.
 
+### Experimental APIs 🧪
+
+These APIs are experimental and may change in the future.
+
+#### Parsing using WebAssembly for high performance.
+
+You can use WebAssembly to parse CSV data for high performance.
+
+- Parsing with WebAssembly is faster than parsing with JavaScript,
+but it takes time to load the WebAssembly module.
+- Supports only UTF-8 encoding csv data.
+- Demiliter characters are limited to single-byte characters.
+- Quotation characters is only `"`. (Double quotation mark)
+  - If you pass a different character, it will throw an error.
+
+```ts
+import { loadWASM, parseStringWASM } from "web-csv-toolbox";
+
+// load WebAssembly module
+await loadWASM();
+
+const csv = "a,b,c\n1,2,3";
+
+// parse CSV string
+const result = parseStringToArraySyncWASM(csv);
+console.log(result);
+// Prints:
+// [{ a: "1", b: "2", c: "3" }]
+```
+
+- **`function loadWASM(): Promise<void>`**: [📑](https://kamiazya.github.io/web-csv-toolbox/functions/loadWASM.html)
+  - Loads the WebAssembly module.
+- **`function parseStringToArraySyncWASM(string[, options]): CSVRecord[]`**: [📑](https://kamiazya.github.io/web-csv-toolbox/functions/parseStringToArraySyncWASM.html)
+  - Parses CSV strings into an array of records.
+
 ## Options Configuration 🛠️
 
 ### Common Options ⚙️