rustica 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 rustica contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,289 @@
+# Rustica
+
+![Rustica - Validate 'Em All'](./assets/rustica-banner.png)
+
+[![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 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**
+- **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 with optional custom error messages
+// WASM auto-initializes on first validation - no setup needed!
+const loginSchema = r.object({
+  email: r.string()
+    .min(3)
+    .email()
+    .ui({ label: "Email" })
+    .messages({
+      email: "Please enter a valid email address",
+      min: "Email must be at least 3 characters"
+    }),
+  password: r.string()
+    .min(8)
+    .ui({ label: "Password" })
+    .messages({
+      min: "Password must be at least 8 characters for security"
+    })
+});
+
+// Infer types
+type LoginForm = r.Infer<typeof loginSchema>;
+
+// Use in React - works immediately!
+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>
+  );
+}
+```
+
+**Note**: WASM auto-initializes on the first validation call. For eager loading (optional), you can manually call `await initWasm()` at app startup.
+
+````
+
+## Custom Error Messages (Optional)
+
+Customize validation error messages for better UX:
+
+```typescript
+// String validation with custom messages
+const usernameSchema = r.string().min(3).max(20).messages({
+  invalid_type: "Username must be text",
+  min: "Username is too short - minimum 3 characters",
+  max: "Username is too long - maximum 20 characters",
+});
+
+// Number validation with custom messages
+const ageSchema = r.number().min(18).integer().messages({
+  invalid_type: "Age must be a number",
+  min: "You must be at least 18 years old",
+  integer: "Age must be a whole number",
+});
+
+// Object validation with custom messages
+const formSchema = r
+  .object({
+    email: r.string().email().messages({
+      email: "Please enter a valid email like user@example.com",
+    }),
+    terms: r.boolean().messages({
+      invalid_type: "You must accept the terms and conditions",
+    }),
+  })
+  .messages({
+    invalid_type: "Form data must be an object",
+    required: "This field is required",
+  });
+````
+
+**Available message keys by type:**
+
+- **String**: `invalid_type`, `min`, `max`, `email`, `url`, `pattern`
+- **Number**: `invalid_type`, `min`, `max`, `integer`, `positive`
+- **Boolean**: `invalid_type`
+- **Object**: `invalid_type`, `required`
+
+If not provided, default messages are used. See [examples/custom-messages.ts](./examples/custom-messages.ts) for more examples.
+
+## 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
+- 🏗️ **[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 (optional)
+- [ ] Array/tuple schemas
+- [ ] Union/intersection types
+- [ ] Async validation helpers
+- [ ] i18n support
+
+See [CHANGELOG.md](./CHANGELOG.md) for version history.
+
+## License
+
+MIT

package/dist/form/index.d.ts

@@ -0,0 +1,60 @@
+import type { Schema, ValidationError } from "../schema/types";
+import type { SchemaBuilder } from "../schema/builders";
+/**
+ * Form field state
+ */
+export interface FieldState {
+    value: any;
+    touched: boolean;
+    error: ValidationError | null;
+}
+/**
+ * Form state
+ */
+export interface FormState<T extends Record<string, any>> {
+    values: T;
+    touched: Record<keyof T, boolean>;
+    errors: Record<keyof T, ValidationError | null>;
+    isSubmitting: boolean;
+    isValid: boolean;
+}
+/**
+ * Form configuration
+ */
+export interface FormConfig<T extends Record<string, any>> {
+    schema: SchemaBuilder<T> | Schema;
+    defaultValues: T;
+    onSubmit: (data: T) => void | Promise<void>;
+    validateOnBlur?: boolean;
+    validateOnChange?: boolean;
+}
+/**
+ * Form instance API
+ */
+export interface Form<T extends Record<string, any>> {
+    values: T;
+    touched: Record<keyof T, boolean>;
+    errors: Record<keyof T, ValidationError | null>;
+    isSubmitting: boolean;
+    isValid: boolean;
+    setValue(field: keyof T, value: any): void;
+    setTouched(field: keyof T, touched: boolean): void;
+    validateField(field: keyof T): Promise<ValidationError | null>;
+    validateForm(): Promise<Record<keyof T, ValidationError | null>>;
+    handleBlur(field: keyof T): void;
+    handleChange(field: keyof T, value: any): void;
+    handleSubmit(event?: Event): Promise<void>;
+    reset(): void;
+    subscribe(listener: (state: FormState<T>) => void): () => void;
+}
+/**
+ * Create a form instance with validation
+ *
+ * This is the core form runtime that manages:
+ * - Form values
+ * - Touch state
+ * - Validation errors
+ * - Submit handling
+ */
+export declare function createForm<T extends Record<string, any>>(config: FormConfig<T>): Form<T>;
+//# sourceMappingURL=index.d.ts.map

package/dist/form/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/form/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAC/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGxD;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,GAAG,CAAC;IACX,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,eAAe,GAAG,IAAI,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,SAAS,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IACtD,MAAM,EAAE,CAAC,CAAC;IACV,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC;IAClC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,eAAe,GAAG,IAAI,CAAC,CAAC;IAChD,YAAY,EAAE,OAAO,CAAC;IACtB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IACvD,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC;IAClC,aAAa,EAAE,CAAC,CAAC;IACjB,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,IAAI,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAEjD,MAAM,EAAE,CAAC,CAAC;IACV,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC;IAClC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,eAAe,GAAG,IAAI,CAAC,CAAC;IAChD,YAAY,EAAE,OAAO,CAAC;IACtB,OAAO,EAAE,OAAO,CAAC;IAGjB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE,KAAK,EAAE,GAAG,GAAG,IAAI,CAAC;IAC3C,UAAU,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IACnD,aAAa,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAAC;IAC/D,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,eAAe,GAAG,IAAI,CAAC,CAAC,CAAC;IACjE,UAAU,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;IACjC,YAAY,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE,KAAK,EAAE,GAAG,GAAG,IAAI,CAAC;IAC/C,YAAY,CAAC,KAAK,CAAC,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3C,KAAK,IAAI,IAAI,CAAC;IACd,SAAS,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;CAChE;AAED;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACtD,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,GACpB,IAAI,CAAC,CAAC,CAAC,CAuOT"}

package/dist/form/index.js

@@ -0,0 +1,194 @@
+import { Validator } from "../validator";
+/**
+ * Create a form instance with validation
+ *
+ * This is the core form runtime that manages:
+ * - Form values
+ * - Touch state
+ * - Validation errors
+ * - Submit handling
+ */
+export function createForm(config) {
+    const { schema, defaultValues, onSubmit, validateOnBlur = true, validateOnChange = false, } = config;
+    // Internal state
+    let state = {
+        values: { ...defaultValues },
+        touched: Object.keys(defaultValues).reduce((acc, key) => ({ ...acc, [key]: false }), {}),
+        errors: Object.keys(defaultValues).reduce((acc, key) => ({ ...acc, [key]: null }), {}),
+        isSubmitting: false,
+        isValid: true,
+    };
+    // Subscribers for reactive updates
+    const listeners = new Set();
+    /**
+     * Notify all subscribers of state change
+     */
+    function notify() {
+        listeners.forEach((listener) => listener(state));
+    }
+    /**
+     * Update isValid flag based on errors
+     */
+    function updateValidity() {
+        state.isValid = Object.values(state.errors).every((error) => error === null);
+    }
+    /**
+     * Validate a single field
+     */
+    async function validateField(field) {
+        const path = [String(field)];
+        const result = await Validator.validateAtPath(schema, state.values, path);
+        if (!result.success && result.errors && result.errors.length > 0) {
+            // Return the first error for this field
+            return result.errors[0];
+        }
+        return null;
+    }
+    /**
+     * Validate entire form
+     */
+    async function validateForm() {
+        const result = await Validator.validate(schema, state.values);
+        const fieldErrors = {
+            ...state.errors,
+        };
+        // Clear all errors first
+        for (const key in fieldErrors) {
+            fieldErrors[key] = null;
+        }
+        // Populate errors from validation result
+        if (!result.success && result.errors) {
+            for (const error of result.errors) {
+                if (error.path.length > 0) {
+                    const fieldName = error.path[0];
+                    if (fieldName in fieldErrors) {
+                        fieldErrors[fieldName] = error;
+                    }
+                }
+            }
+        }
+        return fieldErrors;
+    }
+    /**
+     * Set field value
+     */
+    function setValue(field, value) {
+        state.values[field] = value;
+        if (validateOnChange) {
+            validateField(field).then((error) => {
+                state.errors[field] = error;
+                updateValidity();
+                notify();
+            });
+        }
+        notify();
+    }
+    /**
+     * Set field touched state
+     */
+    function setTouched(field, touched) {
+        state.touched[field] = touched;
+        notify();
+    }
+    /**
+     * Handle field blur event
+     */
+    function handleBlur(field) {
+        state.touched[field] = true;
+        if (validateOnBlur) {
+            validateField(field).then((error) => {
+                state.errors[field] = error;
+                updateValidity();
+                notify();
+            });
+        }
+        else {
+            notify();
+        }
+    }
+    /**
+     * Handle field change event
+     */
+    function handleChange(field, value) {
+        setValue(field, value);
+    }
+    /**
+     * Handle form submission
+     */
+    async function handleSubmit(event) {
+        if (event) {
+            event.preventDefault();
+        }
+        // Mark all fields as touched
+        for (const key in state.values) {
+            state.touched[key] = true;
+        }
+        // Validate entire form
+        state.errors = await validateForm();
+        updateValidity();
+        state.isSubmitting = true;
+        notify();
+        // If valid, call onSubmit
+        if (state.isValid) {
+            try {
+                await onSubmit(state.values);
+            }
+            catch (error) {
+                console.error("Form submission error:", error);
+            }
+        }
+        state.isSubmitting = false;
+        notify();
+    }
+    /**
+     * Reset form to default values
+     */
+    function reset() {
+        state = {
+            values: { ...defaultValues },
+            touched: Object.keys(defaultValues).reduce((acc, key) => ({ ...acc, [key]: false }), {}),
+            errors: Object.keys(defaultValues).reduce((acc, key) => ({ ...acc, [key]: null }), {}),
+            isSubmitting: false,
+            isValid: true,
+        };
+        notify();
+    }
+    /**
+     * Subscribe to form state changes
+     */
+    function subscribe(listener) {
+        listeners.add(listener);
+        // Return unsubscribe function
+        return () => {
+            listeners.delete(listener);
+        };
+    }
+    // Return form instance
+    return {
+        get values() {
+            return state.values;
+        },
+        get touched() {
+            return state.touched;
+        },
+        get errors() {
+            return state.errors;
+        },
+        get isSubmitting() {
+            return state.isSubmitting;
+        },
+        get isValid() {
+            return state.isValid;
+        },
+        setValue,
+        setTouched,
+        validateField,
+        validateForm,
+        handleBlur,
+        handleChange,
+        handleSubmit,
+        reset,
+        subscribe,
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/form/index.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Rustica
+ * Production-grade schema and form validation powered by Rust and WebAssembly
+ */
+export { r, type Infer, type UiConfig } from "./schema";
+export type { Schema, StringSchema, NumberSchema, BooleanSchema, ObjectSchema, ValidationError, ValidationResult, } from "./schema/types";
+export { ZString, ZNumber, ZBoolean, ZObject, SchemaBuilder, } from "./schema/builders";
+export { Validator, ValidationException, initWasm, createValidator, } from "./validator";
+export { createForm, type Form, type FormConfig, type FormState, type FieldState, } from "./form";
+export { useWasmForm, useFieldError, useFieldHasError, type UseWasmFormReturn, type FieldRegistration, } from "./react";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,CAAC,EAAE,KAAK,KAAK,EAAE,KAAK,QAAQ,EAAE,MAAM,UAAU,CAAC;AACxD,YAAY,EACV,MAAM,EACN,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,eAAe,EACf,gBAAgB,GACjB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,OAAO,EACP,OAAO,EACP,QAAQ,EACR,OAAO,EACP,aAAa,GACd,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,SAAS,EACT,mBAAmB,EACnB,QAAQ,EACR,eAAe,GAChB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,UAAU,EACV,KAAK,IAAI,EACT,KAAK,UAAU,EACf,KAAK,SAAS,EACd,KAAK,UAAU,GAChB,MAAM,QAAQ,CAAC;AAGhB,OAAO,EACL,WAAW,EACX,aAAa,EACb,gBAAgB,EAChB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,GACvB,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,14 @@
+/**
+ * Rustica
+ * Production-grade schema and form validation powered by Rust and WebAssembly
+ */
+// Schema builder API
+export { r } from "./schema";
+export { ZString, ZNumber, ZBoolean, ZObject, SchemaBuilder, } from "./schema/builders";
+// Validator
+export { Validator, ValidationException, initWasm, createValidator, } from "./validator";
+// Form runtime
+export { createForm, } from "./form";
+// React hooks (optional peer dependency)
+export { useWasmForm, useFieldError, useFieldHasError, } from "./react";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,qBAAqB;AACrB,OAAO,EAAE,CAAC,EAA6B,MAAM,UAAU,CAAC;AAUxD,OAAO,EACL,OAAO,EACP,OAAO,EACP,QAAQ,EACR,OAAO,EACP,aAAa,GACd,MAAM,mBAAmB,CAAC;AAE3B,YAAY;AACZ,OAAO,EACL,SAAS,EACT,mBAAmB,EACnB,QAAQ,EACR,eAAe,GAChB,MAAM,aAAa,CAAC;AAErB,eAAe;AACf,OAAO,EACL,UAAU,GAKX,MAAM,QAAQ,CAAC;AAEhB,yCAAyC;AACzC,OAAO,EACL,WAAW,EACX,aAAa,EACb,gBAAgB,GAGjB,MAAM,SAAS,CAAC"}

package/dist/react/index.d.ts

@@ -0,0 +1,55 @@
+import type { ValidationError } from "../schema/types";
+import { type FormConfig } from "../form";
+/**
+ * Form field registration return type
+ * Compatible with React Hook Form style
+ */
+export interface FieldRegistration {
+    name: string;
+    value: any;
+    onChange: (event: React.ChangeEvent<HTMLInputElement | HTMLTextAreaElement>) => void;
+    onBlur: (event: React.FocusEvent<HTMLInputElement | HTMLTextAreaElement>) => void;
+}
+/**
+ * React form hook return type
+ */
+export interface UseWasmFormReturn<T extends Record<string, any>> {
+    register: (name: keyof T) => FieldRegistration;
+    values: T;
+    errors: Record<keyof T, ValidationError | null>;
+    touched: Record<keyof T, boolean>;
+    isSubmitting: boolean;
+    isValid: boolean;
+    setValue: (field: keyof T, value: any) => void;
+    setError: (field: keyof T, error: ValidationError | null) => void;
+    handleSubmit: (event?: React.FormEvent<HTMLFormElement>) => Promise<void>;
+    reset: () => void;
+}
+/**
+ * React hook for WASM-powered form validation
+ *
+ * Usage:
+ * ```tsx
+ * const form = useWasmForm({
+ *   schema: loginSchema,
+ *   defaultValues: { email: '', password: '' },
+ *   onSubmit: async (data) => console.log(data)
+ * });
+ *
+ * <form onSubmit={form.handleSubmit}>
+ *   <input {...form.register('email')} />
+ *   {form.errors.email && <span>{form.errors.email.message}</span>}
+ * </form>
+ * ```
+ */
+export declare function useWasmForm<T extends Record<string, any>>(config: FormConfig<T>): UseWasmFormReturn<T>;
+/**
+ * Hook to get field error message
+ * Returns error message if field is touched and has error
+ */
+export declare function useFieldError<T extends Record<string, any>>(form: UseWasmFormReturn<T>, field: keyof T): string | null;
+/**
+ * Hook to check if field has error
+ */
+export declare function useFieldHasError<T extends Record<string, any>>(form: UseWasmFormReturn<T>, field: keyof T): boolean;
+//# sourceMappingURL=index.d.ts.map

package/dist/react/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/react/index.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAU,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAE/D,OAAO,EAAc,KAAK,UAAU,EAAE,MAAM,SAAS,CAAC;AAEtD;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,GAAG,CAAC;IACX,QAAQ,EAAE,CACR,KAAK,EAAE,KAAK,CAAC,WAAW,CAAC,gBAAgB,GAAG,mBAAmB,CAAC,KAC7D,IAAI,CAAC;IACV,MAAM,EAAE,CACN,KAAK,EAAE,KAAK,CAAC,UAAU,CAAC,gBAAgB,GAAG,mBAAmB,CAAC,KAC5D,IAAI,CAAC;CACX;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAE9D,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,KAAK,iBAAiB,CAAC;IAG/C,MAAM,EAAE,CAAC,CAAC;IACV,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,eAAe,GAAG,IAAI,CAAC,CAAC;IAChD,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC;IAClC,YAAY,EAAE,OAAO,CAAC;IACtB,OAAO,EAAE,OAAO,CAAC;IAGjB,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE,KAAK,EAAE,GAAG,KAAK,IAAI,CAAC;IAC/C,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE,KAAK,EAAE,eAAe,GAAG,IAAI,KAAK,IAAI,CAAC;IAClE,YAAY,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC,eAAe,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1E,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACvD,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,GACpB,iBAAiB,CAAC,CAAC,CAAC,CAwGtB;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACzD,IAAI,EAAE,iBAAiB,CAAC,CAAC,CAAC,EAC1B,KAAK,EAAE,MAAM,CAAC,GACb,MAAM,GAAG,IAAI,CASf;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC5D,IAAI,EAAE,iBAAiB,CAAC,CAAC,CAAC,EAC1B,KAAK,EAAE,MAAM,CAAC,GACb,OAAO,CAKT"}