From 48821f5d512813d880a6d775d5a742252a14d92a Mon Sep 17 00:00:00 2001
From: Nettika <git@nettika.cat>
Date: Wed, 28 Jan 2026 23:47:13 -0800
Subject: [PATCH] Add grid visibility toggle prop

---
 TODO.md                     |  2 +-
 src/components/Viewport.vue | 22 ++++++++++++++++++++--
 2 files changed, 21 insertions(+), 3 deletions(-)

diff --git a/TODO.md b/TODO.md
index 17dfe2ffa..6cbe96d7c 100644
--- a/TODO.md
+++ b/TODO.md
@@ -38,7 +38,7 @@ A step-by-step checklist for porting MatterControl's design features to a Vue +
 ### Scene Helpers
 - [x] Add ground grid helper (XZ plane)
 - [x] Add axis helper (RGB arrows for X/Y/Z)
-- [ ] Add option to toggle grid visibility
+- [x] Add option to toggle grid visibility
 - [ ] Add option to toggle axis visibility
 
 ### Camera Controls
diff --git a/src/components/Viewport.vue b/src/components/Viewport.vue
index dda7c85e5..4d27fb3fe 100644
--- a/src/components/Viewport.vue
+++ b/src/components/Viewport.vue
@@ -1,7 +1,16 @@
 <script setup lang="ts">
-import { ref, onMounted, onBeforeUnmount } from 'vue'
+import { ref, watch, onMounted, onBeforeUnmount } from 'vue'
 import * as THREE from 'three'
 
+const props = withDefaults(
+  defineProps<{
+    showGrid?: boolean
+  }>(),
+  {
+    showGrid: true,
+  }
+)
+
 const containerRef = ref<HTMLDivElement | null>(null)
 
 let scene: THREE.Scene
@@ -9,6 +18,7 @@ let camera: THREE.PerspectiveCamera
 let renderer: THREE.WebGLRenderer
 let animationFrameId: number
 let resizeObserver: ResizeObserver
+let gridHelper: THREE.GridHelper
 
 function initScene() {
   if (!containerRef.value) return
@@ -49,10 +59,18 @@ function initScene() {
 }
 
 function addGridHelper() {
-  const gridHelper = new THREE.GridHelper(10, 10, 0x444444, 0x333333)
+  gridHelper = new THREE.GridHelper(10, 10, 0x444444, 0x333333)
+  gridHelper.visible = props.showGrid
   scene.add(gridHelper)
 }
 
+watch(
+  () => props.showGrid,
+  (visible) => {
+    if (gridHelper) gridHelper.visible = visible
+  }
+)
+
 function addAxisHelper() {
   const axisHelper = new THREE.AxesHelper(5)
   scene.add(axisHelper)