mathlex 0.4.1

Mathematical expression parser for LaTeX and plain text notation, producing a language-agnostic AST
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75

# Build Scripts

## XCFramework Build

The `build-xcframework.sh` script creates a universal XCFramework for iOS, iOS Simulator, and macOS distribution.

### Required Rust Targets

Before running the script, install all required Rust targets:

```bash
# iOS Device (ARM64)
rustup target add aarch64-apple-ios

# iOS Simulator (ARM64 - Apple Silicon Macs)
rustup target add aarch64-apple-ios-sim

# iOS Simulator (x86_64 - Intel Macs)
rustup target add x86_64-apple-ios

# macOS (ARM64 - Apple Silicon)
rustup target add aarch64-apple-darwin

# macOS (x86_64 - Intel)
rustup target add x86_64-apple-darwin
```

Or install all at once:

```bash
rustup target add aarch64-apple-ios aarch64-apple-ios-sim x86_64-apple-ios aarch64-apple-darwin x86_64-apple-darwin
```

### Usage

From the project root:

```bash
./scripts/build-xcframework.sh
```

The XCFramework will be created at `target/xcframework/MathLex.xcframework`.

### What the Script Does

1. Cleans the build directory
2. Builds the Rust library for all required targets with the `ffi` feature
   - During the first build, `build.rs` generates Swift bindings via swift-bridge
   - Generated files are placed in `generated/mathlex/` and `generated/`
3. Copies generated Swift bindings to `Sources/MathLexRust/`:
   - `mathlex.swift` (project-specific FFI bindings)
   - `SwiftBridgeCore.swift` (swift-bridge core support)
4. Creates fat libraries for:
   - iOS Simulator (combines arm64 and x86_64)
   - macOS (combines arm64 and x86_64)
5. Creates the XCFramework with:
   - iOS device library (arm64)
   - iOS simulator library (universal)
   - macOS library (universal)
   - C headers from `generated/mathlex/`

### Requirements

- Xcode Command Line Tools
- Rust with all targets installed (see above)
- `cargo` in PATH
- `swift-bridge-cli` installed (if regenerating bindings)

### Troubleshooting

If the build fails:
- Ensure all Rust targets are installed: `rustup target list --installed`
- Verify Xcode tools are installed: `xcode-select --install`
- Check that the `ffi` feature is properly configured in `Cargo.toml`
- Ensure C headers exist in `generated/mathlex/` (run `cargo build --features ffi` first)