rustica 0.1.0

package/dist/validator/index.js

@@ -0,0 +1,118 @@
+/**
+ * Lazy-loaded WASM module singleton
+ */
+let wasmModule = null;
+/**
+ * Initialize WASM module
+ * Must be called before validation
+ */
+export async function initWasm() {
+    if (wasmModule)
+        return;
+    try {
+        // Dynamic import of WASM module
+        const module = (await import("../../pkg/rustica.js"));
+        // For web target, call init function. For nodejs target, it's already loaded
+        if (typeof module.default === "function") {
+            await module.default();
+        }
+        wasmModule = module;
+    }
+    catch (error) {
+        throw new Error(`Failed to load WASM module. Make sure to run 'npm run build:wasm' first. Error: ${error}`);
+    }
+}
+/**
+ * Get initialized WASM module
+ */
+function getWasm() {
+    if (!wasmModule) {
+        throw new Error("WASM module not initialized. Call initWasm() before validation.");
+    }
+    return wasmModule;
+}
+/**
+ * Core validator using WASM
+ */
+export class Validator {
+    /**
+     * Validate data against a schema
+     *
+     * @param schema - Schema definition (builder or JSON)
+     * @param value - Data to validate
+     * @returns Validation result with errors if any
+     */
+    static validate(schema, value) {
+        const wasm = getWasm();
+        // Serialize schema to JSON
+        const schemaJson = JSON.stringify(schema instanceof Object && "toJSON" in schema ? schema.toJSON() : schema);
+        // Serialize value to JSON
+        const valueJson = JSON.stringify(value);
+        // Call WASM validator (single call, zero-copy)
+        const resultJson = wasm.WasmValidator.validate(schemaJson, valueJson);
+        // Parse result
+        return JSON.parse(resultJson);
+    }
+    /**
+     * Validate data at a specific path in the schema
+     * Useful for field-level validation in forms
+     *
+     * @param schema - Schema definition
+     * @param value - Complete data object
+     * @param path - Path to validate (e.g., ['user', 'email'])
+     * @returns Validation result for the specific field
+     */
+    static validateAtPath(schema, value, path) {
+        const wasm = getWasm();
+        // Serialize inputs
+        const schemaJson = JSON.stringify(schema instanceof Object && "toJSON" in schema ? schema.toJSON() : schema);
+        const valueJson = JSON.stringify(value);
+        const pathJson = JSON.stringify(path);
+        // Call WASM validator (single call)
+        const resultJson = wasm.WasmValidator.validate_at_path(schemaJson, valueJson, pathJson);
+        // Parse result
+        return JSON.parse(resultJson);
+    }
+    /**
+     * Validate and throw on error (for convenience)
+     */
+    static parse(schema, value) {
+        const result = this.validate(schema, value);
+        if (!result.success) {
+            throw new ValidationException(result.errors || []);
+        }
+        return value;
+    }
+    /**
+     * Safe parse that returns result object
+     */
+    static safeParse(schema, value) {
+        const result = this.validate(schema, value);
+        if (result.success) {
+            return { success: true, data: value };
+        }
+        else {
+            return { success: false, errors: result.errors || [] };
+        }
+    }
+}
+/**
+ * Validation exception for parse() method
+ */
+export class ValidationException extends Error {
+    constructor(errors) {
+        super("Validation failed:\n" +
+            errors.map((e) => `  - ${e.path.join(".")}: ${e.message}`).join("\n"));
+        this.errors = errors;
+        this.name = "ValidationException";
+    }
+}
+/**
+ * Auto-initialization wrapper
+ * Automatically initializes WASM on first use
+ */
+export async function createValidator() {
+    await initWasm();
+    return Validator;
+}
+//# sourceMappingURL=index.js.map

package/dist/validator/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/validator/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,72 @@
+{
+  "name": "rustica",
+  "version": "0.1.0",
+  "description": "Production-grade schema validation powered by Rust and WebAssembly",
+  "author": "Nikos Kechris",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/fourth-ally/rustica.git"
+  },
+  "homepage": "https://github.com/fourth-ally/rustica#readme",
+  "bugs": {
+    "url": "https://github.com/fourth-ally/rustica/issues"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "pkg",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build:wasm": "wasm-pack build --target bundler --out-dir pkg",
+    "build:wasm:node": "wasm-pack build --target nodejs --out-dir pkg",
+    "build:ts": "tsc",
+    "build": "npm run build:wasm && npm run build:ts",
+    "build:npm": "node scripts/build-npm.cjs",
+    "dev": "tsc --watch",
+    "test": "cargo test && npm run test:ts",
+    "test:ts": "npm run build:wasm:node && node --import tsx --test tests/*.test.ts",
+    "prepublishOnly": "npm run build:npm"
+  },
+  "keywords": [
+    "validation",
+    "schema",
+    "wasm",
+    "webassembly",
+    "rust",
+    "zod",
+    "forms",
+    "react",
+    "typescript",
+    "validator",
+    "yup",
+    "joi",
+    "form-validation",
+    "schema-validation"
+  ],
+  "devDependencies": {
+    "@types/node": "^25.0.9",
+    "@types/react": "^18.2.0",
+    "react": "^18.2.0",
+    "tsx": "^4.7.0",
+    "typescript": "^5.3.0"
+  },
+  "peerDependencies": {
+    "react": ">=18.0.0"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    }
+  }
+}

package/pkg/README.md

@@ -0,0 +1,228 @@
+# Rust-JS Validator
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.3-blue)](https://www.typescriptlang.org/)
+[![Rust](https://img.shields.io/badge/Rust-1.70+-orange)](https://www.rust-lang.org/)
+[![WebAssembly](https://img.shields.io/badge/WebAssembly-✓-blueviolet)](https://webassembly.org/)
+
+Production-grade Zod-like schema and form validation system powered by Rust and WebAssembly.
+
+## ✨ Features
+
+<table>
+<tr>
+<td width="50%">
+
+### 🦀 Rust Core
+
+- **WASM-powered** validation
+- **Zero-copy** architecture
+- **~0.1-0.5ms** per validation
+- **Single call** per validation
+
+</td>
+<td width="50%">
+
+### 📝 TypeScript API
+
+- **Fluent API** like Zod
+- **Full type inference**
+- **Schema serialization**
+- **Custom error messages**
+- **UI metadata** support
+
+</td>
+</tr>
+<tr>
+<td width="50%">
+
+### ⚛️ React Integration
+
+- **useWasmForm** hook
+- **Field registration**
+- **Auto re-rendering**
+- **RHF-compatible** API
+
+</td>
+<td width="50%">
+
+### 🔧 Framework Agnostic
+
+- **createForm** for any framework
+- **Vanilla JS** support
+- **Node.js** compatible
+- **Browser** ready
+
+</td>
+</tr>
+</table>
+
+## Installation
+
+```bash
+npm install rustica
+```
+
+## Quick Start
+
+```typescript
+import { r, useWasmForm } from 'rustica';
+
+// Define schema
+const loginSchema = r.object({
+  email: r.string().min(3, 'Email must be at least 3 characters').email('Please enter a valid email').ui({ label: "Email" }),
+  password: r.string().min(8, 'Password must be at least 8 characters').ui({ label: "Password" })
+});
+
+// Infer types
+type LoginForm = r.Infer<typeof loginSchema>;
+
+// Use in React
+function LoginForm() {
+  const form = useWasmForm({
+    schema: loginSchema,
+    defaultValues: { email: '', password: '' },
+    onSubmit: async (data) => {
+      console.log('Valid data:', data);
+    }
+  });
+
+  return (
+    <form onSubmit={form.handleSubmit}>
+      <input {...form.register('email')} />
+      {form.errors.email && <span>{form.errors.email.message}</span>}
+
+      <input type="password" {...form.register('password')} />
+      {form.errors.password && <span>{form.errors.password.message}</span>}
+
+      <button type="submit">Login</button>
+    </form>
+  );
+}
+```
+
+## Building from Source
+
+```bash
+# Quick setup (recommended)
+chmod +x scripts/setup.sh
+./scripts/setup.sh
+
+# Or manual setup
+npm install
+npm run build
+```
+
+See [Getting Started Guide](./docs/GETTING_STARTED.md) for detailed instructions.
+
+## Architecture
+
+- **Rust Core** (`src/lib.rs`, `src/schema.rs`, `src/validator.rs`) - Schema definitions and validation logic
+- **WASM Interface** (`src/wasm.rs`) - WebAssembly bindings with wasm-bindgen
+- **TypeScript Schema Builder** (`src/schema/`) - Fluent API for schema definition
+- **Form Runtime** (`src/form/`) - Form state management
+- **React Hook** (`src/react/`) - React integration
+
+## Documentation
+
+- 📖 **[Complete Documentation Index](./docs/INDEX.md)** - All docs in one place
+- 🚀 **[Getting Started Guide](./docs/GETTING_STARTED.md)** - Quick start tutorial
+- 📚 **[API Reference](./docs/API.md)** - Complete API documentation
+- 💬 **[Custom Error Messages](./docs/custom-messages.md)** - User-friendly validation messages
+- 🏗️ **[Architecture Guide](./docs/ARCHITECTURE.md)** - How it works
+- 📊 **[Feature Comparison](./docs/COMPARISON.md)** - vs Zod, Yup, Joi
+- 🤝 **[Contributing Guide](./CONTRIBUTING.md)** - How to contribute
+
+## Project Structure
+
+```
+rustica/
+├── src/                      # Rust source (validation core)
+│   ├── lib.rs               # Module exports
+│   ├── schema.rs            # Schema AST types
+│   ├── validator.rs         # Validation engine
+│   └── wasm.rs              # WASM bindings
+├── src/                      # TypeScript source
+│   ├── schema/              # Schema builders (r.string(), etc.)
+│   ├── validator/           # WASM wrapper
+│   ├── form/                # Form runtime
+│   ├── react/               # React hooks
+│   └── index.ts             # Main entry point
+├── examples/                 # Usage examples
+│   ├── quick-test.ts        # Basic validation tests
+│   ├── standalone.ts        # Standalone examples
+│   ├── forms.tsx            # Form component examples
+│   └── react-form-app/      # Full React app with API integration
+├── tests/                    # Test suite
+├── docs/                     # Documentation
+└── scripts/                  # Build scripts
+```
+
+## Commands
+
+```bash
+# Development
+make install       # Install dependencies
+make build         # Build WASM + TypeScript
+make test          # Run all tests
+make dev           # Watch mode
+
+# Quick Commands
+make example       # Run quick test
+make clean         # Clean build artifacts
+make help          # Show all commands
+```
+
+## Performance
+
+<table>
+<tr>
+<td><b>Metric</b></td>
+<td><b>Value</b></td>
+<td><b>Notes</b></td>
+</tr>
+<tr>
+<td>Validation Speed</td>
+<td>~0.1-0.5ms</td>
+<td>Per validation (warm)</td>
+</tr>
+<tr>
+<td>Throughput</td>
+<td>5,000-10,000/sec</td>
+<td>1000 validations in ~100-200ms</td>
+</tr>
+<tr>
+<td>WASM Size</td>
+<td>~15-20KB</td>
+<td>Gzipped: ~8-10KB</td>
+</tr>
+<tr>
+<td>Overhead</td>
+<td>Single call</td>
+<td>Zero-copy where possible</td>
+</tr>
+</table>
+
+See [Performance Comparison](./docs/COMPARISON.md) for detailed benchmarks.
+
+## Contributing
+
+We welcome contributions! See [CONTRIBUTING.md](./CONTRIBUTING.md) for guidelines.
+
+## Roadmap
+
+- [x] Core validation (string, number, boolean, object)
+- [x] React hooks
+- [x] Form runtime
+- [x] Type inference
+- [x] Custom error messages
+- [ ] Array/tuple schemas
+- [ ] Union/intersection types
+- [ ] Async validation helpers
+- [ ] i18n support
+
+See [CHANGELOG.md](./CHANGELOG.md) for version history.
+
+## License
+
+MIT