nucleation 0.1.136__tar.gz → 0.1.138__tar.gz

{nucleation-0.1.136 → nucleation-0.1.138}/.gitignore

@@ -2,4 +2,5 @@
 /tests/output/*
 /pkg/
 .history/
-.DS_Store
+.DS_Store
+.vscode/

{nucleation-0.1.136 → nucleation-0.1.138}/Cargo.lock

@@ -1687,7 +1687,7 @@ dependencies = [
 
 [[package]]
 name = "nucleation"
-version = "0.1.136"
+version = "0.1.138"
 dependencies = [
  "base64",
  "bytemuck",

{nucleation-0.1.136 → nucleation-0.1.138}/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "nucleation"
-version = "0.1.136"
+version = "0.1.138"
 edition = "2021"
 description = "A high-performance Minecraft schematic parser and utility library"
 authors = ["Nano nano@schem.at"]

{nucleation-0.1.136 → nucleation-0.1.138}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nucleation
-Version: 0.1.136
+Version: 0.1.138
 Classifier: Development Status :: 4 - Beta
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: GNU Affero General Public License v3
@@ -39,7 +39,7 @@ Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
 
 ### Core
 
-- **Multi-format support**: `.schematic`, `.litematic`, `.nbt`, and more
+- **Multi-format support**: `.schematic`, `.litematic`, `.nbt`, `.mcstructure`, and more
 - **Memory-safe Rust core** with zero-copy deserialization
 - **Cross-platform**: Linux, macOS, Windows (x86_64 + ARM64)
 - **Multi-language**: Rust, JavaScript/TypeScript (WASM), Python, C/FFI
@@ -199,6 +199,9 @@ schematic-builder -i circuit.txt -o circuit.litematic
 
 # Choose format
 schematic-builder -i circuit.txt -o circuit.schem --format schem
+
+# Export as mcstructure
+schematic-builder -i circuit.txt -o circuit.mcstructure --format mcstructure
 ```
 
 ---

{nucleation-0.1.136/release-artifacts → nucleation-0.1.138}/README.md

@@ -16,7 +16,7 @@
 
 ### Core
 
-- **Multi-format support**: `.schematic`, `.litematic`, `.nbt`, and more
+- **Multi-format support**: `.schematic`, `.litematic`, `.nbt`, `.mcstructure`, and more
 - **Memory-safe Rust core** with zero-copy deserialization
 - **Cross-platform**: Linux, macOS, Windows (x86_64 + ARM64)
 - **Multi-language**: Rust, JavaScript/TypeScript (WASM), Python, C/FFI
@@ -176,6 +176,9 @@ schematic-builder -i circuit.txt -o circuit.litematic
 
 # Choose format
 schematic-builder -i circuit.txt -o circuit.schem --format schem
+
+# Export as mcstructure
+schematic-builder -i circuit.txt -o circuit.mcstructure --format mcstructure
 ```
 
 ---

{nucleation-0.1.136 → nucleation-0.1.138}/docs/javascript/README.md

@@ -96,6 +96,14 @@ class SchematicWrapper {
 	to_litematic(): Uint8Array;
 	to_schematic(): Uint8Array;
 
+	// Format Support
+	static get_supported_import_formats(): string[];
+	static get_supported_export_formats(): string[];
+	static get_format_versions(format: string): string[];
+	static get_default_format_version(format: string): string | undefined;
+	
+	save_as(format: string, version?: string): Uint8Array;
+
 	// Block operations
 	set_block(x: number, y: number, z: number, blockName: string): void;
 	set_block_with_properties(
@@ -217,6 +225,10 @@ import { readFileSync } from "fs";
 const bytes = new Uint8Array(readFileSync("input.litematic"));
 const schematic = new SchematicWrapper();
 schematic.from_litematic(bytes);
+
+// Check supported formats
+console.log(SchematicWrapper.get_supported_import_formats());
+// ["litematic", "schematic", "mcstructure"]
 ```
 
 ### Save to File
@@ -239,6 +251,21 @@ import { writeFileSync } from "fs";
 
 const bytes = schematic.to_litematic();
 writeFileSync("output.litematic", bytes);
+
+// Check export formats
+console.log(SchematicWrapper.get_supported_export_formats());
+// ["litematic", "schematic", "mcstructure"]
+
+// Check versions
+console.log(SchematicWrapper.get_format_versions("schematic"));
+// ["v1", "v2", "v3"]
+
+console.log(SchematicWrapper.get_default_format_version("schematic"));
+// "v3"
+
+// Save with specific format and version
+const schemBytes = schematic.save_as("schematic", "v2");
+writeFileSync("output.v2.schem", schemBytes);
 ```
 
 ## Block Operations

{nucleation-0.1.136 → nucleation-0.1.138}/docs/python/README.md

@@ -56,7 +56,7 @@ Main class for working with schematics.
 class Schematic:
     def __init__(self, name: str):
         """Create empty schematic"""
-        
+
     # Loading/Saving
     def load_from_bytes(self, data: bytes) -> None:
         """Load from bytes (auto-detects format)"""
@@ -68,35 +68,49 @@ class Schematic:
         """Save as litematic format"""
     def to_schematic(self) -> bytes:
         """Save as WorldEdit schematic format"""
-    
+
+    # Format Support
+    @staticmethod
+    def get_supported_import_formats() -> list[str]:
+        """List supported import formats"""
+    @staticmethod
+    def get_supported_export_formats() -> list[str]:
+        """List supported export formats"""
+    @staticmethod
+    def get_format_versions(format: str) -> list[str]:
+        """Get available versions for an export format"""
+    @staticmethod
+    def get_default_format_version(format: str) -> str | None:
+        """Get default version for an export format"""
+
     # Block operations
     def set_block(self, x: int, y: int, z: int, block_name: str) -> None:
         """Set block at position"""
-    def set_block_with_properties(self, x: int, y: int, z: int, 
+    def set_block_with_properties(self, x: int, y: int, z: int,
                                   block_name: str, properties: dict) -> None:
         """Set block with properties"""
-    def set_block_from_string(self, x: int, y: int, z: int, 
+    def set_block_from_string(self, x: int, y: int, z: int,
                              block_string: str) -> None:
         """Set block from bracket notation string"""
     def get_block(self, x: int, y: int, z: int) -> str | None:
         """Get block name at position"""
     def get_block_with_properties(self, x: int, y: int, z: int) -> dict | None:
         """Get block with properties"""
-    
+
     # Block entities
     def get_block_entity(self, x: int, y: int, z: int) -> dict | None:
         """Get block entity at position"""
     def get_all_block_entities(self) -> list[dict]:
         """Get all block entities"""
-    
+
     # Region operations
-    def copy_region(self, source_region: str, 
+    def copy_region(self, source_region: str,
                    min_x: int, min_y: int, min_z: int,
                    max_x: int, max_y: int, max_z: int,
                    target_x: int, target_y: int, target_z: int,
                    excluded_blocks: list[str]) -> None:
         """Copy region to new position"""
-    
+
     # Information
     def get_dimensions(self) -> tuple[int, int, int]:
         """Get schematic dimensions (width, height, depth)"""
@@ -110,7 +124,7 @@ class Schematic:
         """Get debug information"""
     def print_schematic(self) -> str:
         """Get ASCII representation"""
-    
+
     # Iteration
     def blocks(self) -> list[dict]:
         """Get all blocks with positions and properties"""
@@ -122,7 +136,7 @@ class Schematic:
     def get_chunk_blocks(self, offset_x: int, offset_y: int, offset_z: int,
                         width: int, height: int, length: int) -> list[dict]:
         """Get blocks in specific chunk"""
-    
+
     # Simulation (requires simulation feature)
     def create_simulation_world(self) -> SimulationWorld:
         """Create simulation world"""
@@ -138,14 +152,14 @@ Represents a block with properties.
 class BlockState:
     def __init__(self, name: str):
         """Create block state"""
-    
+
     def with_property(self, key: str, value: str) -> None:
         """Add property (mutates in place)"""
-    
+
     @property
     def name(self) -> str:
         """Get block name"""
-    
+
     @property
     def properties(self) -> dict[str, str]:
         """Get all properties"""
@@ -168,6 +182,10 @@ schematic.load_from_litematic(data)
 # Auto-detect format
 schematic.load_from_bytes(data)
 
+# Check supported formats
+print(Schematic.get_supported_import_formats())
+# ['litematic', 'schematic', 'mcstructure']
+
 print(schematic.get_dimensions())
 ```
 
@@ -181,6 +199,20 @@ with open("output.litematic", "wb") as f:
 # Save as WorldEdit schematic
 with open("output.schem", "wb") as f:
     f.write(schematic.to_schematic())
+
+# Check export formats and versions
+print(Schematic.get_supported_export_formats())
+# ['litematic', 'schematic', 'mcstructure']
+
+print(Schematic.get_format_versions("schematic"))
+# ['v1', 'v2', 'v3']
+
+print(Schematic.get_default_format_version("schematic"))
+# 'v3'
+
+# Save with specific format and version
+from nucleation import save_schematic
+save_schematic(schematic, "output.v2.schem", format="schematic", version="v2")
 ```
 
 ## Block Operations
@@ -352,7 +384,7 @@ circuit = SchematicBuilder.new() \
         # Base layer
         ccc
         ccc
-        
+
         # Logic layer
         ─→─
         │█│
@@ -560,18 +592,18 @@ from nucleation import Schematic
 
 def build_and_test_circuit():
     schematic = Schematic("test_circuit")
-    
+
     # Build AND gate
     schematic.set_block(0, 0, 0, "minecraft:stone")
     schematic.set_block_from_string(0, 1, 0, "minecraft:lever[facing=north,powered=false]")
     # ... build circuit ...
-    
+
     # Test simulation
     world = schematic.create_simulation_world()
     world.on_use_block(0, 1, 0)  # Toggle input
     world.tick(10)
     world.flush()
-    
+
     output = world.is_lit(10, 1, 0)
     assert output == True, "Test failed!"
     print("Test passed!")
@@ -588,23 +620,23 @@ from nucleation import Schematic
 def convert_all_schematics(input_dir: str, output_dir: str):
     """Convert all .schematic files to .litematic"""
     os.makedirs(output_dir, exist_ok=True)
-    
+
     for filename in os.listdir(input_dir):
         if not filename.endswith('.schematic'):
             continue
-        
+
         input_path = os.path.join(input_dir, filename)
         output_path = os.path.join(output_dir, filename.replace('.schematic', '.litematic'))
-        
+
         # Load
         with open(input_path, "rb") as f:
             schematic = Schematic(filename)
             schematic.load_from_schematic(f.read())
-        
+
         # Save
         with open(output_path, "wb") as f:
             f.write(schematic.to_litematic())
-        
+
         print(f"Converted: {filename}")
 
 convert_all_schematics("input/", "output/")
@@ -616,5 +648,3 @@ convert_all_schematics("input/", "output/")
 - [TypedCircuitExecutor Guide](../shared/guide/typed-executor.md)
 - [Unicode Palette Reference](../shared/unicode-palette.md)
 - [PyPI Package](https://pypi.org/project/nucleation)
-
-

{nucleation-0.1.136 → nucleation-0.1.138}/docs/rust/README.md

@@ -17,6 +17,19 @@ schematic.set_block(0, 0, 0, BlockState::new("minecraft:stone".to_string()));
 // Save as litematic
 let bytes = nucleation::litematic::to_litematic(&schematic)?;
 std::fs::write("output.litematic", bytes)?;
+
+// Or use the FormatManager for unified handling
+use nucleation::formats::manager::get_manager;
+let manager = get_manager().lock().unwrap();
+
+// Check support
+println!("Importers: {:?}", manager.list_importers());
+println!("Exporters: {:?}", manager.list_exporters());
+println!("Schematic versions: {:?}", manager.get_exporter_versions("schematic"));
+println!("Default version: {:?}", manager.get_exporter_default_version("schematic"));
+
+// Save
+let bytes = manager.write("schematic", &schematic, Some("v3"))?;
 ```
 
 ## Table of Contents

{nucleation-0.1.136 → nucleation-0.1.138}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "maturin"
 
 [project]
 name = "nucleation"
-version = "0.1.136"
+version = "0.1.138"
 description = "A high-performance Minecraft schematic parser and utility library"
 authors = [{ name = "Nano", email = "nano@schem.at" }]
 license = { text = "AGPL-3.0-only" }

{nucleation-0.1.136 → nucleation-0.1.138/release-artifacts}/README.md

@@ -16,7 +16,7 @@
 
 ### Core
 
-- **Multi-format support**: `.schematic`, `.litematic`, `.nbt`, and more
+- **Multi-format support**: `.schematic`, `.litematic`, `.nbt`, `.mcstructure`, and more
 - **Memory-safe Rust core** with zero-copy deserialization
 - **Cross-platform**: Linux, macOS, Windows (x86_64 + ARM64)
 - **Multi-language**: Rust, JavaScript/TypeScript (WASM), Python, C/FFI
@@ -176,6 +176,9 @@ schematic-builder -i circuit.txt -o circuit.litematic
 
 # Choose format
 schematic-builder -i circuit.txt -o circuit.schem --format schem
+
+# Export as mcstructure
+schematic-builder -i circuit.txt -o circuit.mcstructure --format mcstructure
 ```
 
 ---

nucleation-0.1.138/release-artifacts/libnucleation.d

@@ -0,0 +1 @@
+/home/runner/work/Nucleation/Nucleation/target/release/libnucleation.rlib: /home/runner/work/Nucleation/Nucleation/src/block_entity/generic.rs /home/runner/work/Nucleation/Nucleation/src/block_entity/mod.rs /home/runner/work/Nucleation/Nucleation/src/block_position.rs /home/runner/work/Nucleation/Nucleation/src/block_state.rs /home/runner/work/Nucleation/Nucleation/src/bounding_box.rs /home/runner/work/Nucleation/Nucleation/src/chunk.rs /home/runner/work/Nucleation/Nucleation/src/definition_region.rs /home/runner/work/Nucleation/Nucleation/src/entity.rs /home/runner/work/Nucleation/Nucleation/src/formats/litematic.rs /home/runner/work/Nucleation/Nucleation/src/formats/manager.rs /home/runner/work/Nucleation/Nucleation/src/formats/mcstructure.rs /home/runner/work/Nucleation/Nucleation/src/formats/mod.rs /home/runner/work/Nucleation/Nucleation/src/formats/schematic.rs /home/runner/work/Nucleation/Nucleation/src/insign.rs /home/runner/work/Nucleation/Nucleation/src/item/mod.rs /home/runner/work/Nucleation/Nucleation/src/item/stack.rs /home/runner/work/Nucleation/Nucleation/src/lib.rs /home/runner/work/Nucleation/Nucleation/src/metadata.rs /home/runner/work/Nucleation/Nucleation/src/nbt/mod.rs /home/runner/work/Nucleation/Nucleation/src/print_utils.rs /home/runner/work/Nucleation/Nucleation/src/region.rs /home/runner/work/Nucleation/Nucleation/src/schematic_builder/palettes.rs /home/runner/work/Nucleation/Nucleation/src/schematic_builder.rs /home/runner/work/Nucleation/Nucleation/src/transforms.rs /home/runner/work/Nucleation/Nucleation/src/universal_schematic.rs /home/runner/work/Nucleation/Nucleation/src/utils/block_string.rs /home/runner/work/Nucleation/Nucleation/src/utils/container_spec.rs /home/runner/work/Nucleation/Nucleation/src/utils/enhanced_nbt_parser.rs /home/runner/work/Nucleation/Nucleation/src/utils/mod.rs

{nucleation-0.1.136 → nucleation-0.1.138}/release-artifacts/nucleation-original.js

@@ -2771,6 +2771,16 @@ export class SchematicWrapper {
             throw takeFromExternrefTable0(ret[0]);
         }
     }
+    /**
+     * @param {string} format
+     * @returns {Array<any>}
+     */
+    static get_format_versions(format) {
+        const ptr0 = passStringToWasm0(format, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len0 = WASM_VECTOR_LEN;
+        const ret = wasm.schematicwrapper_get_format_versions(ptr0, len0);
+        return ret;
+    }
     /**
      * @param {number} chunk_width
      * @param {number} chunk_height
@@ -3005,6 +3015,21 @@ export class SchematicWrapper {
         const ret = wasm.schematicwrapper_create_lazy_chunk_iterator(this.__wbg_ptr, chunk_width, chunk_height, chunk_length, ptr0, len0, camera_x, camera_y, camera_z);
         return LazyChunkIterator.__wrap(ret);
     }
+    /**
+     * @param {string} format
+     * @returns {string | undefined}
+     */
+    static get_default_format_version(format) {
+        const ptr0 = passStringToWasm0(format, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len0 = WASM_VECTOR_LEN;
+        const ret = wasm.schematicwrapper_get_default_format_version(ptr0, len0);
+        let v2;
+        if (ret[0] !== 0) {
+            v2 = getStringFromWasm0(ret[0], ret[1]).slice();
+            wasm.__wbindgen_free(ret[0], ret[1] * 1, 1);
+        }
+        return v2;
+    }
     /**
      * @returns {any}
      */
@@ -3067,6 +3092,20 @@ export class SchematicWrapper {
             throw takeFromExternrefTable0(ret[0]);
         }
     }
+    /**
+     * @returns {Array<any>}
+     */
+    static get_supported_export_formats() {
+        const ret = wasm.schematicwrapper_get_supported_export_formats();
+        return ret;
+    }
+    /**
+     * @returns {Array<any>}
+     */
+    static get_supported_import_formats() {
+        const ret = wasm.schematicwrapper_get_supported_import_formats();
+        return ret;
+    }
     /**
      * @param {string} name
      * @param {string} key
@@ -3157,6 +3196,24 @@ export class SchematicWrapper {
     flip_z() {
         wasm.schematicwrapper_flip_z(this.__wbg_ptr);
     }
+    /**
+     * @param {string} format
+     * @param {string | null} [version]
+     * @returns {Uint8Array}
+     */
+    save_as(format, version) {
+        const ptr0 = passStringToWasm0(format, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len0 = WASM_VECTOR_LEN;
+        var ptr1 = isLikeNone(version) ? 0 : passStringToWasm0(version, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        var len1 = WASM_VECTOR_LEN;
+        const ret = wasm.schematicwrapper_save_as(this.__wbg_ptr, ptr0, len0, ptr1, len1);
+        if (ret[3]) {
+            throw takeFromExternrefTable0(ret[2]);
+        }
+        var v3 = getArrayU8FromWasm0(ret[0], ret[1]).slice();
+        wasm.__wbindgen_free(ret[0], ret[1] * 1, 1);
+        return v3;
+    }
     /**
      * Rotate the schematic around the X axis
      * Degrees must be 90, 180, or 270