nucleation 0.10.9 → 0.10.13

package/AnimationEffect.d.mts

@@ -33,7 +33,7 @@ export class AnimationEffect {
      * `x`, `y`, `z`, `rotateX`, `rotateY`, `rotateZ`, `scale`, `opacity`,
      * `tintR/G/B/A`, and `emissiveR/G/B`.
      */
-    addTween(propertyName: string, from: number, to: number, easingName: string): void;
+    addTween(propertyName: string, start: number, end: number, easingName: string): void;
 
     /**
      * Add a normalised keyframe (`at` in `0..=1`) to a property track.

package/AnimationEffect.d.ts

@@ -33,7 +33,7 @@ export class AnimationEffect {
      * `x`, `y`, `z`, `rotateX`, `rotateY`, `rotateZ`, `scale`, `opacity`,
      * `tintR/G/B/A`, and `emissiveR/G/B`.
      */
-    addTween(propertyName: string, from: number, to: number, easingName: string): void;
+    addTween(propertyName: string, start: number, end: number, easingName: string): void;
 
     /**
      * Add a normalised keyframe (`at` in `0..=1`) to a property track.

package/AnimationEffect.mjs

@@ -135,7 +135,7 @@ export class AnimationEffect {
      * `x`, `y`, `z`, `rotateX`, `rotateY`, `rotateZ`, `scale`, `opacity`,
      * `tintR/G/B/A`, and `emissiveR/G/B`.
      */
-    addTween(propertyName, from, to, easingName) {
+    addTween(propertyName, start, end, easingName) {
         let functionCleanupArena = new diplomatRuntime.CleanupArena();
 
         const propertyNameSlice = functionCleanupArena.alloc(diplomatRuntime.DiplomatBuf.sliceWrapper(wasm, diplomatRuntime.DiplomatBuf.str8(wasm, propertyName)));
@@ -143,7 +143,7 @@ export class AnimationEffect {
         const diplomatReceive = new diplomatRuntime.DiplomatReceiveBuf(wasm, 5, 4, true);
 
 
-        const result = wasm.AnimationEffect_add_tween(diplomatReceive.buffer, this.ffiValue, propertyNameSlice.ptr, from, to, easingNameSlice.ptr);
+        const result = wasm.AnimationEffect_add_tween(diplomatReceive.buffer, this.ffiValue, propertyNameSlice.ptr, start, end, easingNameSlice.ptr);
 
         try {
             if (!diplomatReceive.resultFlag) {

package/Schematic.d.mts

@@ -26,6 +26,31 @@ export class Schematic {
      */
     deepClone(): Schematic;
 
+    /**
+     * Inspect a versioned transform-plan JSON document without modifying
+     * this schematic. Writes a deterministic audit-report JSON document.
+     */
+    inspectTransformPlanJson(planJson: string): string;
+
+    /**
+     * Atomically apply a versioned transform-plan JSON document. Policy
+     * rejection is represented by `report.rejected == true` and leaves the
+     * schematic unchanged; malformed plans raise `InvalidArgument`.
+     */
+    applyTransformPlanJson(planJson: string): string;
+
+    /**
+     * Apply the bundled deterministic, lossless canonicalization preset.
+     */
+    canonicalizeJson(): string;
+
+    /**
+     * Inspect the bundled public-registry policy without modifying this
+     * schematic. Applications should review `rejected` and `quarantined`
+     * before choosing whether to call `apply_transform_plan_json`.
+     */
+    inspectRegistrySafeJson(): string;
+
     /**
      * Split spatially independent machines while keeping nearby tiny
      * detached parts with their machine. Components at least
@@ -61,6 +86,14 @@ export class Schematic {
      */
     static fromData(data: Array<number>): Schematic;
 
+    /**
+     * Decode untrusted bytes using a serialized `DecodeLimits` object.
+     * Empty JSON selects the conservative library defaults. Limits are
+     * enforced while decompressing/parsing and again before region
+     * allocations are accepted.
+     */
+    static fromDataBounded(data: Array<number>, limitsJson: string): Schematic;
+
     /**
      * Build a schematic from Litematic data.
      */
@@ -181,6 +214,32 @@ export class Schematic {
      */
     setBlocks(positions: Array<number>, blockName: string): number;
 
+    /**
+     * Sequentially hand-place the same block at many positions in one
+     * local simulated component. `positions` is flat
+     * `[x0,y0,z0, x1,y1,z1, ...]`; placements run in that order and each
+     * settles before the next. Returns the number of final cells written
+     * back, including neighbours changed by redstone or pistons.
+     *
+     * Nearby passive blocks are loaded as environmental context, but the
+     * write-back is confined to the active component's effect window. Its
+     * runtime is therefore independent of unrelated schematic volume.
+     * Use `set_blocks_simulated_full_world` to opt into global updates.
+     *
+     * This is the efficient bulk form of repeated `{simulate=true}`:
+     * structure conversion and simulator wiring happen once for the
+     * complete sequence. Propagation is not constant-time—a placement can
+     * affect an arbitrarily large circuit—but fixed setup is amortized.
+     */
+    setBlocksSimulated(positions: Array<number>, blockName: string): number;
+
+    /**
+     * Explicit full-world counterpart to `set_blocks_simulated`.
+     * Unrelated schematic volume participates in setup and any resulting
+     * changes anywhere in the loaded world are written back.
+     */
+    setBlocksSimulatedFullWorld(positions: Array<number>, blockName: string): number;
+
     /**
      * Batch-get block names at multiple positions. `positions` is flat
      * `[x0,y0,z0, ...]` (length must be a multiple of 3). Writes a JSON array,
@@ -549,6 +608,19 @@ export class Schematic {
      */
     clearProvenance(): void;
 
+    /**
+     * Content-addressed processing history as a JSON array. This audit
+     * trail is deliberately separate from immutable source provenance.
+     */
+    transformationHistoryJson(): string;
+
+    /**
+     * Clear processing history without changing source provenance or
+     * schematic content. Intended for callers constructing a new artifact
+     * lineage, not for hiding registry audit records.
+     */
+    clearTransformationHistory(): void;
+
     /**
      * Mirror the default region along the X axis (in place). Block
      * orientations, block entities, and entities are mirrored too.

package/Schematic.d.ts

@@ -26,6 +26,31 @@ export class Schematic {
      */
     deepClone(): Schematic;
 
+    /**
+     * Inspect a versioned transform-plan JSON document without modifying
+     * this schematic. Writes a deterministic audit-report JSON document.
+     */
+    inspectTransformPlanJson(planJson: string): string;
+
+    /**
+     * Atomically apply a versioned transform-plan JSON document. Policy
+     * rejection is represented by `report.rejected == true` and leaves the
+     * schematic unchanged; malformed plans raise `InvalidArgument`.
+     */
+    applyTransformPlanJson(planJson: string): string;
+
+    /**
+     * Apply the bundled deterministic, lossless canonicalization preset.
+     */
+    canonicalizeJson(): string;
+
+    /**
+     * Inspect the bundled public-registry policy without modifying this
+     * schematic. Applications should review `rejected` and `quarantined`
+     * before choosing whether to call `apply_transform_plan_json`.
+     */
+    inspectRegistrySafeJson(): string;
+
     /**
      * Split spatially independent machines while keeping nearby tiny
      * detached parts with their machine. Components at least
@@ -61,6 +86,14 @@ export class Schematic {
      */
     static fromData(data: Array<number>): Schematic;
 
+    /**
+     * Decode untrusted bytes using a serialized `DecodeLimits` object.
+     * Empty JSON selects the conservative library defaults. Limits are
+     * enforced while decompressing/parsing and again before region
+     * allocations are accepted.
+     */
+    static fromDataBounded(data: Array<number>, limitsJson: string): Schematic;
+
     /**
      * Build a schematic from Litematic data.
      */
@@ -181,6 +214,32 @@ export class Schematic {
      */
     setBlocks(positions: Array<number>, blockName: string): number;
 
+    /**
+     * Sequentially hand-place the same block at many positions in one
+     * local simulated component. `positions` is flat
+     * `[x0,y0,z0, x1,y1,z1, ...]`; placements run in that order and each
+     * settles before the next. Returns the number of final cells written
+     * back, including neighbours changed by redstone or pistons.
+     *
+     * Nearby passive blocks are loaded as environmental context, but the
+     * write-back is confined to the active component's effect window. Its
+     * runtime is therefore independent of unrelated schematic volume.
+     * Use `set_blocks_simulated_full_world` to opt into global updates.
+     *
+     * This is the efficient bulk form of repeated `{simulate=true}`:
+     * structure conversion and simulator wiring happen once for the
+     * complete sequence. Propagation is not constant-time—a placement can
+     * affect an arbitrarily large circuit—but fixed setup is amortized.
+     */
+    setBlocksSimulated(positions: Array<number>, blockName: string): number;
+
+    /**
+     * Explicit full-world counterpart to `set_blocks_simulated`.
+     * Unrelated schematic volume participates in setup and any resulting
+     * changes anywhere in the loaded world are written back.
+     */
+    setBlocksSimulatedFullWorld(positions: Array<number>, blockName: string): number;
+
     /**
      * Batch-get block names at multiple positions. `positions` is flat
      * `[x0,y0,z0, ...]` (length must be a multiple of 3). Writes a JSON array,
@@ -549,6 +608,19 @@ export class Schematic {
      */
     clearProvenance(): void;
 
+    /**
+     * Content-addressed processing history as a JSON array. This audit
+     * trail is deliberately separate from immutable source provenance.
+     */
+    transformationHistoryJson(): string;
+
+    /**
+     * Clear processing history without changing source provenance or
+     * schematic content. Intended for callers constructing a new artifact
+     * lineage, not for hiding registry audit records.
+     */
+    clearTransformationHistory(): void;
+
     /**
      * Mirror the default region along the X axis (in place). Block
      * orientations, block entities, and entities are mirrored too.

package/Schematic.mjs

@@ -78,6 +78,109 @@ export class Schematic {
         }
     }
 
+    /**
+     * Inspect a versioned transform-plan JSON document without modifying
+     * this schematic. Writes a deterministic audit-report JSON document.
+     */
+    inspectTransformPlanJson(planJson) {
+        let functionCleanupArena = new diplomatRuntime.CleanupArena();
+
+        const planJsonSlice = functionCleanupArena.alloc(diplomatRuntime.DiplomatBuf.sliceWrapper(wasm, diplomatRuntime.DiplomatBuf.str8(wasm, planJson)));
+        const diplomatReceive = new diplomatRuntime.DiplomatReceiveBuf(wasm, 5, 4, true);
+
+        const write = new diplomatRuntime.DiplomatWriteBuf(wasm);
+
+
+        const result = wasm.Schematic_inspect_transform_plan_json(diplomatReceive.buffer, this.ffiValue, planJsonSlice.ptr, write.buffer);
+
+        try {
+            if (!diplomatReceive.resultFlag) {
+                const cause = new NucleationError(diplomatRuntime.internalConstructor, diplomatRuntime.enumDiscriminant(wasm, diplomatReceive.buffer));
+                throw new globalThis.Error('NucleationError.' + cause.value, { cause });
+            }
+            return write.readString8();
+        }
+
+        finally {
+            diplomatRuntime.FUNCTION_PARAM_ALLOC.clean();
+            functionCleanupArena.free();
+
+            diplomatReceive.free();
+            write.free();
+        }
+    }
+
+    /**
+     * Atomically apply a versioned transform-plan JSON document. Policy
+     * rejection is represented by `report.rejected == true` and leaves the
+     * schematic unchanged; malformed plans raise `InvalidArgument`.
+     */
+    applyTransformPlanJson(planJson) {
+        let functionCleanupArena = new diplomatRuntime.CleanupArena();
+
+        const planJsonSlice = functionCleanupArena.alloc(diplomatRuntime.DiplomatBuf.sliceWrapper(wasm, diplomatRuntime.DiplomatBuf.str8(wasm, planJson)));
+        const diplomatReceive = new diplomatRuntime.DiplomatReceiveBuf(wasm, 5, 4, true);
+
+        const write = new diplomatRuntime.DiplomatWriteBuf(wasm);
+
+
+        const result = wasm.Schematic_apply_transform_plan_json(diplomatReceive.buffer, this.ffiValue, planJsonSlice.ptr, write.buffer);
+
+        try {
+            if (!diplomatReceive.resultFlag) {
+                const cause = new NucleationError(diplomatRuntime.internalConstructor, diplomatRuntime.enumDiscriminant(wasm, diplomatReceive.buffer));
+                throw new globalThis.Error('NucleationError.' + cause.value, { cause });
+            }
+            return write.readString8();
+        }
+
+        finally {
+            diplomatRuntime.FUNCTION_PARAM_ALLOC.clean();
+            functionCleanupArena.free();
+
+            diplomatReceive.free();
+            write.free();
+        }
+    }
+
+    /**
+     * Apply the bundled deterministic, lossless canonicalization preset.
+     */
+    canonicalizeJson() {
+        const write = new diplomatRuntime.DiplomatWriteBuf(wasm);
+
+    wasm.Schematic_canonicalize_json(this.ffiValue, write.buffer);
+
+        try {
+            return write.readString8();
+        }
+
+        finally {
+            diplomatRuntime.FUNCTION_PARAM_ALLOC.clean();
+            write.free();
+        }
+    }
+
+    /**
+     * Inspect the bundled public-registry policy without modifying this
+     * schematic. Applications should review `rejected` and `quarantined`
+     * before choosing whether to call `apply_transform_plan_json`.
+     */
+    inspectRegistrySafeJson() {
+        const write = new diplomatRuntime.DiplomatWriteBuf(wasm);
+
+    wasm.Schematic_inspect_registry_safe_json(this.ffiValue, write.buffer);
+
+        try {
+            return write.readString8();
+        }
+
+        finally {
+            diplomatRuntime.FUNCTION_PARAM_ALLOC.clean();
+            write.free();
+        }
+    }
+
     /**
      * Split spatially independent machines while keeping nearby tiny
      * detached parts with their machine. Components at least
@@ -205,6 +308,38 @@ export class Schematic {
         }
     }
 
+    /**
+     * Decode untrusted bytes using a serialized `DecodeLimits` object.
+     * Empty JSON selects the conservative library defaults. Limits are
+     * enforced while decompressing/parsing and again before region
+     * allocations are accepted.
+     */
+    static fromDataBounded(data, limitsJson) {
+        let functionCleanupArena = new diplomatRuntime.CleanupArena();
+
+        const dataSlice = functionCleanupArena.alloc(diplomatRuntime.DiplomatBuf.sliceWrapper(wasm, diplomatRuntime.DiplomatBuf.slice(wasm, data, "u8")));
+        const limitsJsonSlice = functionCleanupArena.alloc(diplomatRuntime.DiplomatBuf.sliceWrapper(wasm, diplomatRuntime.DiplomatBuf.str8(wasm, limitsJson)));
+        const diplomatReceive = new diplomatRuntime.DiplomatReceiveBuf(wasm, 5, 4, true);
+
+
+        const result = wasm.Schematic_from_data_bounded(diplomatReceive.buffer, dataSlice.ptr, limitsJsonSlice.ptr);
+
+        try {
+            if (!diplomatReceive.resultFlag) {
+                const cause = new NucleationError(diplomatRuntime.internalConstructor, diplomatRuntime.enumDiscriminant(wasm, diplomatReceive.buffer));
+                throw new globalThis.Error('NucleationError.' + cause.value, { cause });
+            }
+            return new Schematic(diplomatRuntime.internalConstructor, diplomatRuntime.ptrRead(wasm, diplomatReceive.buffer), []);
+        }
+
+        finally {
+            diplomatRuntime.FUNCTION_PARAM_ALLOC.clean();
+            functionCleanupArena.free();
+
+            diplomatReceive.free();
+        }
+    }
+
     /**
      * Build a schematic from Litematic data.
      */
@@ -823,6 +958,80 @@ export class Schematic {
         }
     }
 
+    /**
+     * Sequentially hand-place the same block at many positions in one
+     * local simulated component. `positions` is flat
+     * `[x0,y0,z0, x1,y1,z1, ...]`; placements run in that order and each
+     * settles before the next. Returns the number of final cells written
+     * back, including neighbours changed by redstone or pistons.
+     *
+     * Nearby passive blocks are loaded as environmental context, but the
+     * write-back is confined to the active component's effect window. Its
+     * runtime is therefore independent of unrelated schematic volume.
+     * Use `set_blocks_simulated_full_world` to opt into global updates.
+     *
+     * This is the efficient bulk form of repeated `{simulate=true}`:
+     * structure conversion and simulator wiring happen once for the
+     * complete sequence. Propagation is not constant-time—a placement can
+     * affect an arbitrarily large circuit—but fixed setup is amortized.
+     */
+    setBlocksSimulated(positions, blockName) {
+        let functionCleanupArena = new diplomatRuntime.CleanupArena();
+
+        const positionsSlice = functionCleanupArena.alloc(diplomatRuntime.DiplomatBuf.sliceWrapper(wasm, diplomatRuntime.DiplomatBuf.slice(wasm, positions, "i32")));
+        const blockNameSlice = functionCleanupArena.alloc(diplomatRuntime.DiplomatBuf.sliceWrapper(wasm, diplomatRuntime.DiplomatBuf.str8(wasm, blockName)));
+        const diplomatReceive = new diplomatRuntime.DiplomatReceiveBuf(wasm, 5, 4, true);
+
+
+        const result = wasm.Schematic_set_blocks_simulated(diplomatReceive.buffer, this.ffiValue, positionsSlice.ptr, blockNameSlice.ptr);
+
+        try {
+            if (!diplomatReceive.resultFlag) {
+                const cause = new NucleationError(diplomatRuntime.internalConstructor, diplomatRuntime.enumDiscriminant(wasm, diplomatReceive.buffer));
+                throw new globalThis.Error('NucleationError.' + cause.value, { cause });
+            }
+            return (new Int32Array(wasm.memory.buffer, diplomatReceive.buffer, 1))[0];
+        }
+
+        finally {
+            diplomatRuntime.FUNCTION_PARAM_ALLOC.clean();
+            functionCleanupArena.free();
+
+            diplomatReceive.free();
+        }
+    }
+
+    /**
+     * Explicit full-world counterpart to `set_blocks_simulated`.
+     * Unrelated schematic volume participates in setup and any resulting
+     * changes anywhere in the loaded world are written back.
+     */
+    setBlocksSimulatedFullWorld(positions, blockName) {
+        let functionCleanupArena = new diplomatRuntime.CleanupArena();
+
+        const positionsSlice = functionCleanupArena.alloc(diplomatRuntime.DiplomatBuf.sliceWrapper(wasm, diplomatRuntime.DiplomatBuf.slice(wasm, positions, "i32")));
+        const blockNameSlice = functionCleanupArena.alloc(diplomatRuntime.DiplomatBuf.sliceWrapper(wasm, diplomatRuntime.DiplomatBuf.str8(wasm, blockName)));
+        const diplomatReceive = new diplomatRuntime.DiplomatReceiveBuf(wasm, 5, 4, true);
+
+
+        const result = wasm.Schematic_set_blocks_simulated_full_world(diplomatReceive.buffer, this.ffiValue, positionsSlice.ptr, blockNameSlice.ptr);
+
+        try {
+            if (!diplomatReceive.resultFlag) {
+                const cause = new NucleationError(diplomatRuntime.internalConstructor, diplomatRuntime.enumDiscriminant(wasm, diplomatReceive.buffer));
+                throw new globalThis.Error('NucleationError.' + cause.value, { cause });
+            }
+            return (new Int32Array(wasm.memory.buffer, diplomatReceive.buffer, 1))[0];
+        }
+
+        finally {
+            diplomatRuntime.FUNCTION_PARAM_ALLOC.clean();
+            functionCleanupArena.free();
+
+            diplomatReceive.free();
+        }
+    }
+
     /**
      * Batch-get block names at multiple positions. `positions` is flat
      * `[x0,y0,z0, ...]` (length must be a multiple of 3). Writes a JSON array,
@@ -2193,6 +2402,40 @@ export class Schematic {
         }
     }
 
+    /**
+     * Content-addressed processing history as a JSON array. This audit
+     * trail is deliberately separate from immutable source provenance.
+     */
+    transformationHistoryJson() {
+        const write = new diplomatRuntime.DiplomatWriteBuf(wasm);
+
+    wasm.Schematic_transformation_history_json(this.ffiValue, write.buffer);
+
+        try {
+            return write.readString8();
+        }
+
+        finally {
+            diplomatRuntime.FUNCTION_PARAM_ALLOC.clean();
+            write.free();
+        }
+    }
+
+    /**
+     * Clear processing history without changing source provenance or
+     * schematic content. Intended for callers constructing a new artifact
+     * lineage, not for hiding registry audit records.
+     */
+    clearTransformationHistory() {
+    wasm.Schematic_clear_transformation_history(this.ffiValue);
+
+        try {}
+
+        finally {
+            diplomatRuntime.FUNCTION_PARAM_ALLOC.clean();
+        }
+    }
+
     /**
      * Mirror the default region along the X axis (in place). Block
      * orientations, block entities, and entities are mirrored too.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nucleation",
-  "version": "0.10.9",
+  "version": "0.10.13",
   "description": "A high-performance Minecraft schematic parser and utility library",
   "type": "module",
   "main": "index.mjs",