feat(voxel-renderer): implement moveLayer to VoxelRenderer and expose markAllChunksDirty() (#230)

Author: fraxken

.changeset/five-boxes-melt.md

@@ -0,0 +1,5 @@
+---
+"@jolly-pixel/voxel.renderer": minor
+---
+
+Implement moveLayer() in VoxelRenderer and expose markAllChunksDirty()

packages/voxel-renderer/docs/Hooks.md

@@ -31,7 +31,8 @@ export type VoxelLayerHookAction =
   | "updated"
   | "offset-updated"
   | "voxel-set"
-  | "voxel-removed";
+  | "voxel-removed"
+  | "reordered";
 
 // Describes a change related to a layer.
 export interface VoxelLayerHookEvent {

packages/voxel-renderer/docs/VoxelRenderer.md

@@ -186,6 +186,10 @@ is re-evaluated on the next frame. No-op if the layer is not found.
 Adds `delta` to the layer's current offset. Equivalent to `setLayerOffset` with
 `layer.offset + delta`. No-op if the layer is not found.
 
+#### `moveLayer(name: string, direction: "up" | "down"): void`
+
+Swaps `order` with the neighbouring layer in the given direction.
+
 #### `setVoxel(layerName: string, options: VoxelSetOptions): void`
 
 Places a voxel at a world-space position.
@@ -259,6 +263,10 @@ Serialises the full world state (layers, voxels, tileset metadata) to a plain JS
 Clears the current world, restores state from a JSON snapshot, and reloads any
 referenced tilesets that are not already loaded.
 
+#### `markAllChunksDirty(source?: string): void`
+
+Mark all the chunks as dirty and rebuild them in the next frame
+
 ### Hooks
 
 See [Hooks](./Hooks.md) for more information

packages/voxel-renderer/src/VoxelRenderer.ts

@@ -453,6 +453,19 @@ export class VoxelRenderer extends ActorComponent {
     });
   }
 
+  moveLayer(
+    name: string,
+    direction: "up" | "down"
+  ): void {
+    this.world.moveLayer(name, direction);
+    this.markAllChunksDirty("moveLayer");
+    this.#onLayerUpdated?.({
+      action: "reordered",
+      layerName: name,
+      metadata: { direction }
+    });
+  }
+
   async loadTileset(
     def: TilesetDefinition
   ): Promise<void> {
@@ -473,7 +486,7 @@ export class VoxelRenderer extends ActorComponent {
     this.#materials.delete(def.id);
 
     // Force all chunks to rebuild geometry (UV offsets may have changed).
-    this.#markAllChunksDirty("loadTileset");
+    this.markAllChunksDirty("loadTileset");
   }
 
   // --- Serialization --- //
@@ -705,7 +718,7 @@ export class VoxelRenderer extends ActorComponent {
     }
   }
 
-  #markAllChunksDirty(
+  markAllChunksDirty(
     source?: string
   ): void {
     this.#logger.debug("Marking all chunks dirty...", { source });

packages/voxel-renderer/src/hooks.ts

@@ -4,7 +4,8 @@ export type VoxelLayerHookAction =
   | "updated"
   | "offset-updated"
   | "voxel-set"
-  | "voxel-removed";
+  | "voxel-removed"
+  | "reordered";
 
 export interface VoxelLayerHookEvent {
   layerName: string;