json-eval-rs 0.0.92

High-performance JSON Logic evaluator with schema validation and dependency tracking. Built on blazing-fast Rust engine.
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
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153

# JSON Eval RS - React Native Example

This is a React Native example demonstrating the `@json-eval-rs/react-native` binding with native Rust-powered validation and evaluation.

## Features

- ✅ **Form Validation** - Native form validation with JSON schema rules
- 🔄 **Dependent Fields** - Automatic calculation of dependent fields
- ⚡ **Native Performance** - Rust-powered, runs on native threads
- 🎨 **Modern UI** - Clean, responsive design with dark mode support
- 📱 **Cross-Platform** - Works on iOS and Android

## Prerequisites

>**Note**: Make sure you have completed the [React Native - Environment Setup](https://reactnative.dev/docs/environment-setup) instructions before proceeding.

## Step 1: Start the Metro Server

First, you will need to start **Metro**, the JavaScript _bundler_ that ships _with_ React Native.

To start Metro, run the following command from the _root_ of your React Native project:

```bash
# using npm
npm start

# OR using Yarn
yarn start
```

## Step 2: Start your Application

Let Metro Bundler run in its _own_ terminal. Open a _new_ terminal from the _root_ of your React Native project. Run the following command to start your _Android_ or _iOS_ app:

### For Android

```bash
# using npm
npm run android

# OR using Yarn
yarn android
```

### For iOS

```bash
# using npm
npm run ios

# OR using Yarn
yarn ios
```

If everything is set up _correctly_, you should see your new app running in your _Android Emulator_ or _iOS Simulator_ shortly provided you have set up your emulator/simulator correctly.

This is one way to run your app — you can also run it directly from within Android Studio and Xcode respectively.

## What's Inside

The example includes two screens demonstrating key features:

### 1. Form Validation Screen
- Validates form inputs using JSON schema rules
- Real-time error display
- Uses native Rust validation for 10-50x better performance

### 2. Dependent Fields Screen
- Automatic calculation of dependent fields (subtotal, tax, total)
- Real-time updates as you type
- Demonstrates dependency tracking with `evaluateDependents`

## Project Structure

```
rncli/
├── App.tsx                          # Main app with tab navigation
├── src/
│   └── screens/
│       ├── FormValidationScreen.tsx # Form validation demo
│       └── DependentFieldsScreen.tsx # Dependent fields demo
├── babel.config.js                  # Configured for local binding
├── metro.config.js                  # Monorepo configuration
└── tsconfig.json                    # TypeScript paths
```

## How It Works

This example uses the local `@json-eval-rs/react-native` binding from the parent directory:

```typescript
import { useJSONEval } from '@json-eval-rs/react-native';

const evalInstance = useJSONEval({ schema });

// Validate
const result = await evalInstance.validate({ data });

// Evaluate dependents
const updated = await evalInstance.evaluateDependents({
  changedPaths: ['field1', 'field2'],
  data,
  nested: true
});
```

## Building Native Bindings

Before running the app, you need to build the native bindings:

### iOS
```bash
cd ../../..  # Navigate to json-eval-rs root
cargo build --release --features ffi --target aarch64-apple-ios
cargo build --release --features ffi --target x86_64-apple-ios
```

### Android
```bash
cd ../../..  # Navigate to json-eval-rs root
cargo install cargo-ndk
cargo ndk -t arm64-v8a -o bindings/react-native/android/src/main/jniLibs build --release --features ffi
```

## Performance

- **Schema parsing**: < 5ms
- **Validation**: < 3ms per validation
- **Dependent field updates**: < 3ms per update

Native performance is 10-50x faster than JavaScript-only solutions.

# Troubleshooting

If you can't get this to work, see the [Troubleshooting](https://reactnative.dev/docs/troubleshooting) page.

# Learn More

## JSON Eval RS Resources

- [json-eval-rs Documentation](../../../README.md) - Main library documentation
- [React Native Bindings Guide](../../README.md) - API reference and usage guide
- [Build Instructions](../../BUILD.md) - How to build native bindings

## React Native Resources

- [React Native Website](https://reactnative.dev) - Learn more about React Native
- [Getting Started](https://reactnative.dev/docs/environment-setup) - Environment setup guide
- [Learn the Basics](https://reactnative.dev/docs/getting-started) - React Native basics tutorial

## License

MIT