DIGIT-2257 Implement web platform channel

.github/workflows/flutter_ci.yml

@@ -29,6 +29,19 @@ jobs:
       - name: Flutter version
         run: flutter --version
 
+      - name: Suppress path dependency warnings (pre)
+        run: |
+          set -euo pipefail
+          for dir in parsec parsec_android parsec_linux parsec_windows parsec_web parsec_platform_interface; do
+            f="$dir/pubspec.yaml"
+            if [ -f "$f" ]; then
+              cp "$f" "$f.backup"
+              if ! grep -qE '^\s*publish_to:' "$f"; then
+                printf "\npublish_to: none\n" >> "$f"
+              fi
+            fi
+          done
+
       - name: Analyze parsec_platform_interface
         run: |
           cd parsec_platform_interface
@@ -38,6 +51,20 @@ jobs:
       - name: Analyze parsec
         run: |
           cd parsec
+          # Add dependency overrides for CI testing
+          echo "" >> pubspec.yaml
+          echo "dependency_overrides:" >> pubspec.yaml
+          echo "  parsec_platform_interface:" >> pubspec.yaml
+          echo "    path: ../parsec_platform_interface" >> pubspec.yaml
+          echo "  parsec_android:" >> pubspec.yaml
+          echo "    path: ../parsec_android" >> pubspec.yaml
+          echo "  parsec_linux:" >> pubspec.yaml
+          echo "    path: ../parsec_linux" >> pubspec.yaml
+          echo "  parsec_windows:" >> pubspec.yaml
+          echo "    path: ../parsec_windows" >> pubspec.yaml
+          echo "  parsec_web:" >> pubspec.yaml
+          echo "    path: ../parsec_web" >> pubspec.yaml
+
           flutter pub get
           flutter analyze --no-fatal-infos
 
@@ -59,3 +86,9 @@ jobs:
           flutter pub get
           flutter analyze --no-fatal-infos
 
+      - name: Analyze parsec_web
+        run: |
+          cd parsec_web
+          flutter pub get
+          flutter analyze --no-fatal-infos
+

.github/workflows/web_tests.yml

@@ -0,0 +1,163 @@
+name: Web Integration Tests
+
+on:
+  push:
+    branches:
+      - '**'
+  pull_request:
+    branches:
+      - '**'
+  workflow_dispatch:
+
+jobs:
+  web_tests:
+    name: Web Tests (WebAssembly)
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+
+    strategy:
+      matrix:
+        flutter_version: [3.19.0, 3.24.0, 3.29.3]
+
+    steps:
+    - name: Checkout repository
+      uses: actions/checkout@v4
+      with:
+        submodules: recursive
+
+    - name: Setup Flutter
+      uses: subosito/flutter-action@v2
+      with:
+        flutter-version: ${{ matrix.flutter_version }}
+        channel: stable
+        cache: true
+
+    - name: Install system dependencies
+      run: |
+        sudo apt-get update
+        sudo apt-get install -y emscripten
+
+    - name: Install Chrome for Web testing
+      uses: browser-actions/setup-chrome@v1
+      with:
+        chrome-version: stable
+
+    - name: Generate Web Assets
+      run: |
+        cd parsec_web
+        dart bin/generate.dart
+
+    - name: Upload WASM artifacts
+      if: ${{ matrix.flutter_version == '3.29.3' }}
+      uses: actions/upload-artifact@v4
+      with:
+        name: parsec-web-wasm
+        path: |
+          parsec_web/lib/parsec-web/wasm/
+        retention-days: 3
+
+    - name: Get Flutter dependencies
+      run: |
+        cd parsec_platform_interface && flutter pub get
+        cd ../parsec_web && flutter pub get
+        cd ../parsec && flutter pub get
+
+    - name: Run parsec_web JavaScript tests (Node.js)
+      run: |
+        cd parsec_web/lib/parsec-web
+        npm install
+        npm test
+
+    - name: Run Flutter Web integration tests
+      run: |
+        cd parsec
+        # Backup original pubspec.yaml for publication
+        cp pubspec.yaml pubspec.yaml.backup
+
+        # Add dependency overrides to use local packages with WASM files
+        echo "" >> pubspec.yaml
+        echo "dependency_overrides:" >> pubspec.yaml
+        echo "  # Use local packages for CI testing with WASM files" >> pubspec.yaml
+        echo "  parsec_platform_interface:" >> pubspec.yaml
+        echo "    path: ../parsec_platform_interface" >> pubspec.yaml
+        echo "  parsec_web:" >> pubspec.yaml
+        echo "    path: ../parsec_web" >> pubspec.yaml
+        echo "  parsec_android:" >> pubspec.yaml
+        echo "    path: ../parsec_android" >> pubspec.yaml
+        echo "  parsec_linux:" >> pubspec.yaml
+        echo "    path: ../parsec_linux" >> pubspec.yaml
+        echo "  parsec_windows:" >> pubspec.yaml
+        echo "    path: ../parsec_windows" >> pubspec.yaml
+
+        # Get dependencies with overrides
+        flutter pub get
+
+        # Run web tests with local packages
+        flutter test --platform chrome test/parsec_test.dart
+
+        # Restore original pubspec.yaml (publication-ready)
+        mv pubspec.yaml.backup pubspec.yaml
+
+
+    - name: Build Web example (validation)
+      run: |
+        cd parsec/example
+        flutter build web --release
+
+    - name: Upload test artifacts
+      if: failure()
+      uses: actions/upload-artifact@v4
+      with:
+        name: web-test-artifacts-${{ matrix.flutter_version }}
+        path: |
+          parsec/coverage/
+          parsec_web/lib/parsec-web/coverage/
+          parsec/test-results.xml
+        retention-days: 3
+
+  web_compatibility:
+    name: Web Compatibility Tests
+    runs-on: ubuntu-latest
+    needs: web_tests
+    timeout-minutes: 30
+
+    steps:
+    - name: Checkout repository
+      uses: actions/checkout@v4
+      with:
+        submodules: recursive
+
+    - name: Setup Flutter
+      uses: subosito/flutter-action@v2
+      with:
+        flutter-version: 3.29.3
+        channel: stable
+        cache: true
+
+    - name: Download WASM artifacts
+      uses: actions/download-artifact@v4
+      with:
+        name: parsec-web-wasm
+        path: parsec_web/lib/parsec-web/wasm
+
+    - name: Test parsec-web npm package
+      run: |
+        cd parsec_web/lib/parsec-web
+        npm install
+        npm test
+
+    - name: Validate WebAssembly module
+      run: |
+        cd parsec_web/lib/parsec-web
+        if [ -f wasm/equations_parser.js ]; then
+          file wasm/equations_parser.js
+          ls -la wasm/
+        else
+          echo "❌ WASM glue JS missing at wasm/equations_parser.js" && exit 1
+        fi
+
+    - name: Test JavaScript imports
+      run: |
+        cd parsec_web/lib/parsec-web
+        node -e "const E = require('./index.cjs'); console.log('✅ CommonJS works')"
+        node --input-type=module -e "import('./index.mjs').then(()=>console.log('✅ ES6 works'))"

.gitignore

@@ -2,3 +2,13 @@
 /local
 .aider*
 .claude/
+
+# Dart/Flutter build artifacts
+**/.dart_tool/**
+**/build/**
+**/.packages
+
+# IDE/editor files
+.idea/
+.vscode/
+.DS_Store

.gitmodules

@@ -8,3 +8,6 @@
 	path = parsec_windows/windows/ext/equations-parser
 	url = https://github.com/niltonvasques/equations-parser
 	branch = windows-version
+[submodule "parsec_web/lib/parsec-web"]
+	path = parsec_web/lib/parsec-web
+	url = https://github.com/oxeanbits/parsec-web.git

CLAUDE.md

@@ -20,6 +20,12 @@ This repository follows a federated Flutter plugin architecture:
 
 ## Key Commands
 
+### Web Asset Generation
+```bash
+# Generate WebAssembly files for parsec_web (required for web platform)
+cd parsec_web && dart bin/generate.dart
+```
+
 ### Testing
 ```bash
 # Test all packages from their respective directories
@@ -28,6 +34,9 @@ cd parsec_android && flutter test
 cd parsec_linux && flutter test
 cd parsec_windows && flutter test
 cd parsec_platform_interface && flutter test
+
+# Web platform testing (requires WASM files)
+cd parsec && flutter test --platform chrome
 ```
 
 ### Linting & Analysis
@@ -152,7 +161,7 @@ pubspec.yaml                 # Platform-specific dependencies
 
 ## Dependencies & Versioning
 
-- **Platform Interface Version**: Currently ^0.2.0 across all implementations
+- **Platform Interface Version**: Currently ^0.2.1 across all implementations
 - **Flutter Lints**: ^4.0.0 (latest) for strict code quality
 - **Plugin Platform Interface**: ^2.1.8 for base platform functionality
 
@@ -170,14 +179,50 @@ pubspec.yaml                 # Platform-specific dependencies
 - Local path dependencies are used for development (see pubspec.yaml files)
 - No iOS/macOS/Web support in main plugin (separate web library exists)
 
+## Web Platform Development
+
+The **parsec_web** package uses WebAssembly compiled from C++ for high performance:
+
+### Prerequisites
+- **Emscripten**: Required to compile C++ to WebAssembly
+  ```bash
+  # Ubuntu/Debian
+  sudo apt-get install emscripten
+
+  # Or install via emsdk
+  git clone https://github.com/emscripten-core/emsdk.git
+  cd emsdk && ./emsdk install latest && ./emsdk activate latest
+  source ./emsdk_env.sh
+  ```
+
+### Development Workflow
+1. **Generate WASM files**: `cd parsec_web && dart bin/generate.dart`
+2. **Test functionality**: `cd parsec_web/lib/parsec-web && npm test`
+3. **Integration testing**: `cd parsec && flutter test --platform chrome`
+
+### What `dart bin/generate.dart` does:
+- Validates parsec-web submodule exists
+- Compiles C++ equations-parser (38 source files) to WebAssembly using Emscripten
+- Generates `wasm/equations_parser.js` (WASM glue + binary, ~635KB)
+- Verifies JavaScript wrapper and WASM files are present
+- Provides user-friendly output and next steps
+
+### Web Platform Architecture
+
+**parsec_web** uses `evalRaw()` function for direct C++ JSON output:
+- **Data flow**: Dart → `evalRaw()` → WebAssembly → Raw JSON → Dart
+- **Platform consistency**: All platforms receive identical JSON from C++
+- **Simplified code**: Eliminated complex type conversion layers
+
 ## When Working on This Codebase
 
-1. **Always test across platforms** - changes to interface affect all implementations
-2. **Maintain version consistency** - keep platform interface versions aligned
-3. **Follow Flutter plugin conventions** - use established patterns for method channels
-4. **Preserve JSON contract** - native libraries expect specific response format
-5. **Update documentation** - especially README.md examples if API changes
-6. **Run analysis** - ensure all packages pass `flutter analyze` before commits
+1. **Generate WASM first** - run `cd parsec_web && dart bin/generate.dart` before web testing
+2. **Always test across platforms** - changes to interface affect all implementations
+3. **Maintain version consistency** - keep platform interface versions aligned
+4. **Follow Flutter plugin conventions** - use established patterns for method channels
+5. **Preserve JSON contract** - native libraries expect specific response format
+6. **Update documentation** - especially README.md examples if API changes
+7. **Run analysis** - ensure all packages pass `flutter analyze` before commits
 
 ## Pull Request Guidance
 

parsec/CHANGELOG.md

@@ -1,3 +1,16 @@
+## 0.5.0
+
+- **NEW: Web Support with WebAssembly** - Added comprehensive web platform support using high-performance WebAssembly compiled from C++
+- **Web Implementation** - Published `parsec_web ^0.1.0` package provides offline-first, client-side equation evaluation for Flutter web applications
+- **Complete Multi-Platform Coverage** - Now supports Android, Linux, Windows, and Web platforms with identical mathematical precision
+- **Updated Dependencies** - All platform implementations updated to use latest `parsec_platform_interface ^0.2.0`
+- **Publishing Ready** - Converted from development path dependencies to hosted pub.dev packages
+- **Enhanced Testing** - Comprehensive cross-platform testing including WebAssembly validation
+
+## 0.4.0
+
+- Initial Web platform support (maintenance release)
+
 ## 0.3.1
 
 - Supports Windows.