nucleation 0.1.58 → 0.1.67

package/README.md

@@ -9,22 +9,19 @@
 [![Crates.io](https://img.shields.io/crates/v/nucleation.svg)](https://crates.io/crates/nucleation)
 [![npm](https://img.shields.io/npm/v/nucleation.svg)](https://www.npmjs.com/package/nucleation)
 [![PyPI](https://img.shields.io/pypi/v/nucleation.svg)](https://pypi.org/project/nucleation)
-[![CI/CD](https://github.com/Schem-at/Nucleation/workflows/Nucleation%20CI%2FCD/badge.svg)](https://github.com/Schem-at/Nucleation/actions)
 
 ---
 
 ## ✨ Features
 
-- ✅ **Multi-format support**: `.schematic`, `.litematic`, `.nbt`, etc.
-- 🧠 **Memory-safe Rust core** with zero-copy deserialization
-- 🌐 **WASM module** for browser + Node.js with TypeScript support
-- 🐍 **Native Python bindings** (`pip install nucleation`)
-- ⚙️ **C-compatible FFI** for PHP, C, Go, etc.
-- 🎨 **Blockpedia integration** for color analysis and block transformations (native targets)
-- 🔄 **Feature parity** across all interfaces via single API definition
-- 📦 **Binary builds** for Linux, macOS, Windows (x86_64 + ARM64)
-- 🚀 **Automatic binding generation** from centralized API definitions
-- 🧪 **Comprehensive test suite** with CI/CD pipeline
+- ✅ Multi-format support: `.schematic`, `.litematic`, `.nbt`, etc.
+- 🧠 Memory-safe Rust core with zero-copy deserialization
+- 🌐 WASM module for browser + Node.js
+- 🐍 Native Python bindings (`pip install nucleation`)
+- ⚙️ C-compatible FFI for PHP, C, Go, etc.
+- 🔄 Feature parity across all interfaces
+- 📦 Binary builds for Linux, macOS, Windows (x86_64 + ARM64)
+- 🧱 Seamless integration with [Cubane](https://github.com/Nano112/cubane)
 
 ---
 
@@ -72,7 +69,7 @@ schematic.load_from_data(&bytes)?;
 println!("{:?}", schematic.get_info());
 ```
 
-📖 → [Documentation](examples/rust.md) | [Complete Code Example](examples/rust_example.rs)
+📖 → [More in `examples/rust.md`](examples/rust.md)
 
 ---
 
@@ -88,7 +85,7 @@ await parser.fromData(new Uint8Array(bytes));
 console.log(parser.getDimensions());
 ```
 
-📖 → [Documentation](examples/wasm.md) | [Complete Code Example](examples/wasm_example.js)
+📖 → [More in `examples/wasm.md`](examples/wasm.md)
 
 ---
 
@@ -106,7 +103,7 @@ schem.load_from_bytes(data)
 print(schem.get_info())
 ```
 
-📖 → [Documentation](examples/python.md) | [Complete Code Example](examples/python_example.py)
+📖 → [More in `examples/python.md`](examples/python.md)
 
 ---
 
@@ -125,20 +122,17 @@ printf("Size: %dx%dx%d\n", info.width, info.height, info.depth);
 schematic_free(handle);
 ```
 
-📖 → [Documentation](examples/ffi.md) | [Complete Code Example](examples/ffi_example.c)
+📖 → [More in `examples/ffi.md`](examples/ffi.md)
 
 ---
 
 ## 🔧 Development
 
-### Building
-
 ```bash
 # Build the Rust core
 cargo build --release
 
-# Build WASM module with target support
-cargo build --target wasm32-unknown-unknown --features wasm
+# Build WASM module
 ./build-wasm.sh
 
 # Build Python bindings locally
@@ -148,77 +142,21 @@ maturin develop --features python
 ./build-ffi.sh
 ```
 
-### 🤖 Automated Binding Generation
-
-Nucleation uses a **single source of truth** approach for all bindings. The API is defined once in `src/api_definition.rs` and automatically translated to all supported languages:
-
-```bash
-# Generate all binding files from API definition
-cargo run --bin generate-bindings
-
-# Check if bindings are up to date
-cargo run --bin generate-bindings check
-
-# Generate API documentation report
-cargo run --bin generate-bindings report
-```
-
-This generates:
-- **WASM**: TypeScript definitions and JavaScript bindings
-- **Python**: PyO3 bindings and `.pyi` type stubs  
-- **FFI**: C header files and Rust FFI implementations
-
-### 🧪 Testing
-
-```bash
-# Run all tests
-cargo test
-
-# Test specific targets
-cargo test --features wasm --test wasm_tests        # WASM tests
-cargo test --test python_tests                      # Python tests
-cargo test --test blockpedia_integration_test       # Blockpedia tests (non-WASM only)
-
-# Test WASM build specifically
-cargo build --target wasm32-unknown-unknown --features wasm
-```
-
-**Note**: WASM builds exclude blockpedia features for compatibility. Color analysis and block transformations are available only on native targets.
-
-### Version Management
-
-Versions are centrally managed in `version.toml`. Use the Makefile commands:
-
-```bash
-# Check version consistency across all files
-make version-check
-
-# Bump versions automatically
-make version-bump-patch    # 0.1.0 → 0.1.1
-make version-bump-minor    # 0.1.0 → 0.2.0  
-make version-bump-major    # 0.1.0 → 1.0.0
-
-# Update all files from version.toml
-make version-update
-```
-
-📖 → [Full Version Management Guide](docs/VERSION_MANAGEMENT.md)
-
 ---
 
 ## 📚 Submodules & Bindings
 
-### 📄 Documentation & Examples
+### Rust
+* [`examples/rust.md`](examples/rust.md)
 
-Each binding includes comprehensive documentation and working code examples:
+### JavaScript/TypeScript
+* [`examples/wasm.md`](examples/wasm.md)
 
-| Language | API Documentation | Working Example | Type Definitions |
-|----------|------------------|-----------------|------------------|
-| **Rust** | [`examples/rust.md`](examples/rust.md) | [`examples/rust_example.rs`](examples/rust_example.rs) | Native Rust docs |
-| **JavaScript/WASM** | [`examples/wasm.md`](examples/wasm.md) | [`examples/wasm_example.js`](examples/wasm_example.js) | [`pkg/nucleation.d.ts`](pkg/nucleation.d.ts) |
-| **Python** | [`examples/python.md`](examples/python.md) | [`examples/python_example.py`](examples/python_example.py) | [`python-stubs/nucleation.pyi`](python-stubs/nucleation.pyi) |
-| **C/FFI** | [`examples/ffi.md`](examples/ffi.md) | [`examples/ffi_example.c`](examples/ffi_example.c) | [`include/nucleation.h`](include/nucleation.h) |
+### Python
+* [`examples/python.md`](examples/python.md)
 
+### FFI (C/PHP)
+* [`examples/ffi.md`](examples/ffi.md)
 
 ---
 

package/nucleation-original.js

@@ -476,29 +476,54 @@ export class SchematicWrapper {
         return v1;
     }
     /**
-     * @param {number} x
-     * @param {number} y
-     * @param {number} z
-     * @param {string} block_name
+     * @param {string} version
+     * @returns {Uint8Array}
      */
-    set_block(x, y, z, block_name) {
-        const ptr0 = passStringToWasm0(block_name, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+    to_schematic_version(version) {
+        const ptr0 = passStringToWasm0(version, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
         const len0 = WASM_VECTOR_LEN;
-        wasm.schematicwrapper_set_block(this.__wbg_ptr, x, y, z, ptr0, len0);
+        const ret = wasm.schematicwrapper_to_schematic_version(this.__wbg_ptr, ptr0, len0);
+        if (ret[3]) {
+            throw takeFromExternrefTable0(ret[2]);
+        }
+        var v2 = getArrayU8FromWasm0(ret[0], ret[1]).slice();
+        wasm.__wbindgen_free(ret[0], ret[1] * 1, 1);
+        return v2;
+    }
+    /**
+     * @returns {Array<any>}
+     */
+    get_available_schematic_versions() {
+        const ret = wasm.schematicwrapper_get_available_schematic_versions(this.__wbg_ptr);
+        return ret;
+    }
+    /**
+     * @returns {any}
+     */
+    get_palette() {
+        const ret = wasm.schematicwrapper_get_palette(this.__wbg_ptr);
+        return ret;
+    }
+    /**
+     * @param {string} region_name
+     * @returns {any}
+     */
+    get_palette_from_region(region_name) {
+        const ptr0 = passStringToWasm0(region_name, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len0 = WASM_VECTOR_LEN;
+        const ret = wasm.schematicwrapper_get_palette_from_region(this.__wbg_ptr, ptr0, len0);
+        return ret;
     }
     /**
      * @param {number} x
      * @param {number} y
      * @param {number} z
-     * @param {string} block_string
+     * @param {string} block_name
      */
-    set_block_from_string(x, y, z, block_string) {
-        const ptr0 = passStringToWasm0(block_string, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+    set_block(x, y, z, block_name) {
+        const ptr0 = passStringToWasm0(block_name, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
         const len0 = WASM_VECTOR_LEN;
-        const ret = wasm.schematicwrapper_set_block_from_string(this.__wbg_ptr, x, y, z, ptr0, len0);
-        if (ret[1]) {
-            throw takeFromExternrefTable0(ret[0]);
-        }
+        wasm.schematicwrapper_set_block(this.__wbg_ptr, x, y, z, ptr0, len0);
     }
     /**
      * @param {SchematicWrapper} from_schematic

package/nucleation.d.ts

@@ -25,8 +25,11 @@ export class SchematicWrapper {
   to_litematic(): Uint8Array;
   from_schematic(data: Uint8Array): void;
   to_schematic(): Uint8Array;
+  to_schematic_version(version: string): Uint8Array;
+  get_available_schematic_versions(): Array<any>;
+  get_palette(): any;
+  get_palette_from_region(region_name: string): any;
   set_block(x: number, y: number, z: number, block_name: string): void;
-  set_block_from_string(x: number, y: number, z: number, block_string: string): void;
   copy_region(from_schematic: SchematicWrapper, min_x: number, min_y: number, min_z: number, max_x: number, max_y: number, max_z: number, target_x: number, target_y: number, target_z: number, excluded_blocks: any): void;
   set_block_with_properties(x: number, y: number, z: number, block_name: string, properties: any): void;
   get_block(x: number, y: number, z: number): string | undefined;
@@ -65,8 +68,11 @@ export interface InitOutput {
   readonly schematicwrapper_to_litematic: (a: number) => [number, number, number, number];
   readonly schematicwrapper_from_schematic: (a: number, b: number, c: number) => [number, number];
   readonly schematicwrapper_to_schematic: (a: number) => [number, number, number, number];
+  readonly schematicwrapper_to_schematic_version: (a: number, b: number, c: number) => [number, number, number, number];
+  readonly schematicwrapper_get_available_schematic_versions: (a: number) => any;
+  readonly schematicwrapper_get_palette: (a: number) => any;
+  readonly schematicwrapper_get_palette_from_region: (a: number, b: number, c: number) => any;
   readonly schematicwrapper_set_block: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
-  readonly schematicwrapper_set_block_from_string: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number];
   readonly schematicwrapper_copy_region: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number, k: number, l: any) => [number, number];
   readonly schematicwrapper_set_block_with_properties: (a: number, b: number, c: number, d: number, e: number, f: number, g: any) => [number, number];
   readonly schematicwrapper_get_block: (a: number, b: number, c: number, d: number) => [number, number];

package/package.json

@@ -2,10 +2,10 @@
   "name": "nucleation",
   "type": "module",
   "collaborators": [
-    "Nano <nano@schem.at>"
+    "Nano nano@schem.at"
   ],
   "description": "A high-performance Minecraft schematic parser and utility library",
-  "version": "0.1.58",
+  "version": "0.1.67",
   "license": "MIT OR Apache-2.0",
   "repository": {
     "type": "git",