unreal-engine-mcp-server 0.4.6 → 0.5.0

package/wasm/Cargo.lock

@@ -0,0 +1,363 @@
+# This file is automatically @generated by Cargo.
+# It is not intended for manual editing.
+version = 4
+
+[[package]]
+name = "bumpalo"
+version = "3.19.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "46c5e41b57b8bba42a04676d81cb89e9ee8e859a1a66f80a5a72e1cb76b34d43"
+
+[[package]]
+name = "cc"
+version = "1.2.47"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "cd405d82c84ff7f35739f175f67d8b9fb7687a0e84ccdc78bd3568839827cf07"
+dependencies = [
+ "find-msvc-tools",
+ "shlex",
+]
+
+[[package]]
+name = "cfg-if"
+version = "1.0.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9330f8b2ff13f34540b44e946ef35111825727b38d33286ef986142615121801"
+
+[[package]]
+name = "console_error_panic_hook"
+version = "0.1.7"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "a06aeb73f470f66dcdbf7223caeebb85984942f22f1adb2a088cf9668146bbbc"
+dependencies = [
+ "cfg-if",
+ "wasm-bindgen",
+]
+
+[[package]]
+name = "find-msvc-tools"
+version = "0.1.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "3a3076410a55c90011c298b04d0cfa770b00fa04e1e3c97d3f6c9de105a03844"
+
+[[package]]
+name = "getrandom"
+version = "0.2.16"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "335ff9f135e4384c8150d6f27c6daed433577f86b4750418338c01a1a2528592"
+dependencies = [
+ "cfg-if",
+ "js-sys",
+ "libc",
+ "wasi",
+ "wasm-bindgen",
+]
+
+[[package]]
+name = "itoa"
+version = "1.0.15"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "4a5f13b858c8d314ee3e8f639011f7ccefe71f97f96e50151fb991f267928e2c"
+
+[[package]]
+name = "js-sys"
+version = "0.3.82"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b011eec8cc36da2aab2d5cff675ec18454fad408585853910a202391cf9f8e65"
+dependencies = [
+ "once_cell",
+ "wasm-bindgen",
+]
+
+[[package]]
+name = "libc"
+version = "0.2.177"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "2874a2af47a2325c2001a6e6fad9b16a53b802102b528163885171cf92b15976"
+
+[[package]]
+name = "memchr"
+version = "2.7.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f52b00d39961fc5b2736ea853c9cc86238e165017a493d1d5c8eac6bdc4cc273"
+
+[[package]]
+name = "minicov"
+version = "0.3.7"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f27fe9f1cc3c22e1687f9446c2083c4c5fc7f0bcf1c7a86bdbded14985895b4b"
+dependencies = [
+ "cc",
+ "walkdir",
+]
+
+[[package]]
+name = "once_cell"
+version = "1.21.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "42f5e15c9953c5e4ccceeb2e7382a716482c34515315f7b03532b8b4e8393d2d"
+
+[[package]]
+name = "proc-macro2"
+version = "1.0.103"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "5ee95bc4ef87b8d5ba32e8b7714ccc834865276eab0aed5c9958d00ec45f49e8"
+dependencies = [
+ "unicode-ident",
+]
+
+[[package]]
+name = "quote"
+version = "1.0.42"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "a338cc41d27e6cc6dce6cefc13a0729dfbb81c262b1f519331575dd80ef3067f"
+dependencies = [
+ "proc-macro2",
+]
+
+[[package]]
+name = "rustversion"
+version = "1.0.22"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b39cdef0fa800fc44525c84ccb54a029961a8215f9619753635a9c0d2538d46d"
+
+[[package]]
+name = "ryu"
+version = "1.0.20"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "28d3b2b1366ec20994f1fd18c3c594f05c5dd4bc44d8bb0c1c632c8d6829481f"
+
+[[package]]
+name = "same-file"
+version = "1.0.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "93fc1dc3aaa9bfed95e02e6eadabb4baf7e3078b0bd1b4d7b6b0b68378900502"
+dependencies = [
+ "winapi-util",
+]
+
+[[package]]
+name = "serde"
+version = "1.0.228"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9a8e94ea7f378bd32cbbd37198a4a91436180c5bb472411e48b5ec2e2124ae9e"
+dependencies = [
+ "serde_core",
+ "serde_derive",
+]
+
+[[package]]
+name = "serde-wasm-bindgen"
+version = "0.6.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8302e169f0eddcc139c70f139d19d6467353af16f9fce27e8c30158036a1e16b"
+dependencies = [
+ "js-sys",
+ "serde",
+ "wasm-bindgen",
+]
+
+[[package]]
+name = "serde_core"
+version = "1.0.228"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "41d385c7d4ca58e59fc732af25c3983b67ac852c1a25000afe1175de458b67ad"
+dependencies = [
+ "serde_derive",
+]
+
+[[package]]
+name = "serde_derive"
+version = "1.0.228"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d540f220d3187173da220f885ab66608367b6574e925011a9353e4badda91d79"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn",
+]
+
+[[package]]
+name = "serde_json"
+version = "1.0.145"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "402a6f66d8c709116cf22f558eab210f5a50187f702eb4d7e5ef38d9a7f1c79c"
+dependencies = [
+ "itoa",
+ "memchr",
+ "ryu",
+ "serde",
+ "serde_core",
+]
+
+[[package]]
+name = "shlex"
+version = "1.3.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0fda2ff0d084019ba4d7c6f371c95d8fd75ce3524c3cb8fb653a3023f6323e64"
+
+[[package]]
+name = "syn"
+version = "2.0.111"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "390cc9a294ab71bdb1aa2e99d13be9c753cd2d7bd6560c77118597410c4d2e87"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "unicode-ident",
+]
+
+[[package]]
+name = "unicode-ident"
+version = "1.0.22"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9312f7c4f6ff9069b165498234ce8be658059c6728633667c526e27dc2cf1df5"
+
+[[package]]
+name = "unreal-mcp-wasm"
+version = "0.1.0"
+dependencies = [
+ "console_error_panic_hook",
+ "getrandom",
+ "js-sys",
+ "serde",
+ "serde-wasm-bindgen",
+ "serde_json",
+ "wasm-bindgen",
+ "wasm-bindgen-test",
+ "web-sys",
+]
+
+[[package]]
+name = "walkdir"
+version = "2.5.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "29790946404f91d9c5d06f9874efddea1dc06c5efe94541a7d6863108e3a5e4b"
+dependencies = [
+ "same-file",
+ "winapi-util",
+]
+
+[[package]]
+name = "wasi"
+version = "0.11.1+wasi-snapshot-preview1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ccf3ec651a847eb01de73ccad15eb7d99f80485de043efb2f370cd654f4ea44b"
+
+[[package]]
+name = "wasm-bindgen"
+version = "0.2.105"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "da95793dfc411fbbd93f5be7715b0578ec61fe87cb1a42b12eb625caa5c5ea60"
+dependencies = [
+ "cfg-if",
+ "once_cell",
+ "rustversion",
+ "serde",
+ "serde_json",
+ "wasm-bindgen-macro",
+ "wasm-bindgen-shared",
+]
+
+[[package]]
+name = "wasm-bindgen-futures"
+version = "0.4.55"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "551f88106c6d5e7ccc7cd9a16f312dd3b5d36ea8b4954304657d5dfba115d4a0"
+dependencies = [
+ "cfg-if",
+ "js-sys",
+ "once_cell",
+ "wasm-bindgen",
+ "web-sys",
+]
+
+[[package]]
+name = "wasm-bindgen-macro"
+version = "0.2.105"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "04264334509e04a7bf8690f2384ef5265f05143a4bff3889ab7a3269adab59c2"
+dependencies = [
+ "quote",
+ "wasm-bindgen-macro-support",
+]
+
+[[package]]
+name = "wasm-bindgen-macro-support"
+version = "0.2.105"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "420bc339d9f322e562942d52e115d57e950d12d88983a14c79b86859ee6c7ebc"
+dependencies = [
+ "bumpalo",
+ "proc-macro2",
+ "quote",
+ "syn",
+ "wasm-bindgen-shared",
+]
+
+[[package]]
+name = "wasm-bindgen-shared"
+version = "0.2.105"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "76f218a38c84bcb33c25ec7059b07847d465ce0e0a76b995e134a45adcb6af76"
+dependencies = [
+ "unicode-ident",
+]
+
+[[package]]
+name = "wasm-bindgen-test"
+version = "0.3.55"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "bfc379bfb624eb59050b509c13e77b4eb53150c350db69628141abce842f2373"
+dependencies = [
+ "js-sys",
+ "minicov",
+ "wasm-bindgen",
+ "wasm-bindgen-futures",
+ "wasm-bindgen-test-macro",
+]
+
+[[package]]
+name = "wasm-bindgen-test-macro"
+version = "0.3.55"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "085b2df989e1e6f9620c1311df6c996e83fe16f57792b272ce1e024ac16a90f1"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn",
+]
+
+[[package]]
+name = "web-sys"
+version = "0.3.82"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "3a1f95c0d03a47f4ae1f7a64643a6bb97465d9b740f0fa8f90ea33915c99a9a1"
+dependencies = [
+ "js-sys",
+ "wasm-bindgen",
+]
+
+[[package]]
+name = "winapi-util"
+version = "0.1.11"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c2a7b1c03c876122aa43f3020e6c3c3ee5c05081c9a00739faf7503aeba10d22"
+dependencies = [
+ "windows-sys",
+]
+
+[[package]]
+name = "windows-link"
+version = "0.2.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f0805222e57f7521d6a62e36fa9163bc891acd422f971defe97d64e70d0a4fe5"
+
+[[package]]
+name = "windows-sys"
+version = "0.61.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ae137229bcbd6cdf0f7b80a31df61766145077ddf49416a728b02cb3921ff3fc"
+dependencies = [
+ "windows-link",
+]

package/wasm/Cargo.toml

@@ -0,0 +1,42 @@
+[package]
+name = "unreal-mcp-wasm"
+version = "0.1.0"
+edition = "2021"
+authors = ["Unreal Engine MCP Team"]
+description = "WebAssembly module for performance-critical operations in Unreal Engine MCP Server"
+license = "MIT"
+repository = "https://github.com/ChiR24/unreal-engine-mcp-server"
+
+[lib]
+crate-type = ["cdylib"]
+
+[dependencies]
+wasm-bindgen = { version = "0.2", features = ["serde-serialize"] }
+serde = { version = "1.0", features = ["derive"] }
+serde_json = "1.0"
+js-sys = "0.3"
+getrandom = { version = "0.2", features = ["js"] }
+console_error_panic_hook = "0.1"
+serde-wasm-bindgen = "0.6"
+
+[dependencies.web-sys]
+version = "0.3"
+features = [
+  "console",
+  "Performance",
+  "Window",
+  "Document"
+]
+
+[dev-dependencies]
+wasm-bindgen-test = "0.3"
+
+[profile.release]
+opt-level = 3
+lto = true
+codegen-units = 1
+panic = "abort"
+strip = true
+
+[package.metadata.wasm-pack.profile.release]
+wasm-opt = false

package/wasm/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Unreal Engine MCP Server 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/wasm/README.md

@@ -0,0 +1,253 @@
+# Unreal MCP WASM Module
+
+WebAssembly module providing high-performance operations for the Unreal Engine MCP Server.
+
+## Features
+
+- **Property Parser**: Efficient JSON property parsing and serialization
+- **Transform Math**: Optimized 3D vector and matrix operations
+- **Dependency Resolver**: Asset dependency graph traversal and analysis
+- **Utils**: Common mathematical utilities
+
+## Prerequisites
+
+- Rust (latest stable)
+- wasm-pack
+- Node.js (for integration testing)
+
+## Build Instructions
+
+### Install wasm-pack
+
+```bash
+curl https://rustwasm.github.io/wasm-pack/installer/init.sh -sSf | sh
+```
+
+### Build for Release
+
+```bash
+wasm-pack build --release --target web
+```
+
+This creates a `pkg/` directory with:
+- `unreal_mcp_wasm.js` - JavaScript bindings
+- `unreal_mcp_wasm_bg.wasm` - Compiled WebAssembly binary
+- `unreal_mcp_wasm.d.ts` - TypeScript definitions
+
+### Build for Development
+
+```bash
+wasm-pack build --dev --target web --watch
+```
+
+The `--watch` flag enables hot reloading during development.
+
+### Testing
+
+```bash
+# Run Rust tests
+cargo test
+
+# Run integration tests
+wasm-pack test --headless --firefox
+```
+
+## Usage
+
+### In TypeScript
+
+```typescript
+import init, {
+  PropertyParser,
+  TransformCalculator,
+  Vector
+} from './pkg/unreal_mcp_wasm.js';
+
+async function main() {
+  await init();
+
+  // Property parsing
+  const parser = new PropertyParser();
+  const json = '{"name": "Test", "value": 42}';
+  const result = parser.parse_properties(json);
+  console.log(result);
+
+  // Vector math
+  const v1 = new Vector(1, 2, 3);
+  const v2 = new Vector(4, 5, 6);
+  const sum = v1.add(v2);
+  console.log(sum); // { x: 5, y: 7, z: 9 }
+
+  // Transform calculations
+  const calculator = new TransformCalculator();
+  const location = [100, 200, 300];
+  const rotation = [0, 90, 0];
+  const scale = [1, 1, 1];
+  const matrix = calculator.compose_transform(location, rotation, scale);
+  console.log(matrix);
+}
+
+main();
+```
+
+## API Reference
+
+### PropertyParser
+
+```typescript
+new PropertyParser(maxDepth?: number)
+parse_properties(jsonStr: string, maxDepth?: number): Promise<ParseResult>
+serialize_properties(properties: JsValue): Promise<string>
+extract_property_names(jsonStr: string): Promise<string[]>
+get_property_type(jsonStr: string): string
+```
+
+### TransformCalculator
+
+```typescript
+new TransformCalculator()
+compose_transform(location: [number, number, number], rotation: [number, number, number], scale: [number, number, number]): number[]
+decompose_matrix(matrix: number[]): number[]
+apply_transform(point: number[], transform: number[]): number[]
+```
+
+### Vector
+
+```typescript
+new Vector(x: number, y: number, z: number)
+add(other: Vector): Vector
+subtract(other: Vector): Vector
+multiply(other: Vector): Vector
+scale(scalar: number): Vector
+dot(other: Vector): number
+cross(other: Vector): Vector
+length(): number
+normalize(): Vector
+distance_to(other: Vector): number
+lerp(other: Vector, t: number): Vector
+to_array(): number[]
+```
+
+### DependencyResolver
+
+```typescript
+new DependencyResolver(maxDepth?: number)
+analyze_dependencies(assetPath: string, dependenciesJson: string, maxDepth?: number): Promise<DependencyAnalysis>
+find_dependents(assetPath: string, dependenciesJson: string): string[]
+calculate_depth(assetPath: string, dependenciesJson: string, maxDepth?: number): number
+find_circular_dependencies(dependenciesJson: string, maxDepth?: number): string[][]
+topological_sort(dependenciesJson: string): string[]
+```
+
+### Utils
+
+```typescript
+now(): number
+random(): number
+clamp(value: number, min: number, max: number): number
+lerp(a: number, b: number, t: number): number
+deg_to_rad(degrees: number): number
+rad_to_deg(radians: number): number
+```
+
+### Metrics
+
+```typescript
+new Metrics()
+record(name: string, durationMs: number): void
+average_for(name: string): number
+count(): number
+clear(): void
+```
+
+## Performance
+
+### Benchmarks (Approximate)
+
+| Operation | WASM | TypeScript | Speedup |
+|-----------|------|------------|---------|
+| Parse 1000 properties | 20-40ms | 150-300ms | **5-8x** |
+| Vector operations (1000) | 1-2ms | 5-10ms | **5x** |
+| Transform composition | 0.5ms | 5ms | **10x** |
+| Dependency analysis | 10-20ms | 50-100ms | **5x** |
+
+## Limitations
+
+1. Requires WebAssembly support (all modern browsers)
+2. Limited to f32 for floating-point operations (performance optimization)
+3. Maximum recursion depth defaults to 100 (configurable)
+
+## Troubleshooting
+
+### Build Errors
+
+**Error: `wasm-pack` not found**
+```bash
+curl https://rustwasm.github.io/wasm-pack/installer/init.sh -sSf | sh
+```
+
+**Error: `cargo` not found**
+Install Rust from https://rustup.rs/
+
+### Runtime Errors
+
+**Error: "WebAssembly module not initialized"**
+```typescript
+await init(); // Must be called before using WASM functions
+```
+
+**Error: "Maximum nesting depth exceeded"**
+```typescript
+const parser = new PropertyParser(200); // Increase max depth
+```
+
+## Development
+
+### Project Structure
+
+```
+wasm/
+├── src/
+│   ├── lib.rs              # Entry point
+│   ├── property_parser.rs  # Property parsing
+│   ├── transform_math.rs   # Vector/matrix math
+│   └── dependency_resolver.rs # Dependency graphs
+├── tests/
+│   └── integration.rs      # Integration tests
+├── Cargo.toml              # Rust configuration
+└── README.md              # This file
+```
+
+### Adding New Functions
+
+1. Add function to appropriate module
+2. Mark with `#[wasm_bindgen]`
+3. Build with `wasm-pack build --dev`
+4. Run tests with `cargo test`
+
+### Code Style
+
+- Use `f32` for floating-point numbers
+- Prefer simple types over complex generics
+- Add documentation comments
+- Include tests for new functionality
+
+## License
+
+MIT
+
+## Contributing
+
+1. Fork the repository
+2. Create a feature branch
+3. Make your changes
+4. Add tests
+5. Run `cargo test`
+6. Submit a pull request
+
+## See Also
+
+- [WebAssembly.org](https://webassembly.org/)
+- [wasm-bindgen](https://rustwasm.github.io/wasm-bindgen/)
+- [wasm-pack](https://rustwasm.github.io/wasm-pack/)
+- [serde](https://serde.rs/)