Implement Sheet.deleteObject()

Co-authored-by: Elliot <key.draw@gmail.com>

theatre/core/src/sheets/Sheet.ts

@@ -73,6 +73,14 @@ export default class Sheet {
     return this._objects.getState()[key]
   }
 
+  deleteObject(objectKey: ObjectAddressKey) {
+    this._objects.reduceState([], (state) => {
+      const newState = {...state}
+      delete newState[objectKey]
+      return newState
+    })
+  }
+
   getSequence(): Sequence {
     if (!this._sequence) {
       const lengthD = valueDerivation(

theatre/core/src/sheets/TheatreSheet.ts

@@ -72,6 +72,13 @@ export interface ISheet {
     options?: {override?: boolean},
   ): ISheetObject<Props>
 
+  /**
+   * Deletes a previously created child object for the sheet
+   *
+   * @param key - Delete the child object created with this key
+   */
+  deleteObject(key: string): void
+
   /**
    * The Sequence of this Sheet
    */
@@ -164,6 +171,22 @@ export default class TheatreSheet implements ISheet {
   get address(): SheetAddress {
     return {...privateAPI(this).address}
   }
+
+  deleteObject(key: string) {
+    const internal = privateAPI(this)
+    const sanitizedPath = validateAndSanitiseSlashedPathOrThrow(
+      key,
+      `sheet.deleteObject("${key}")`,
+    ) as ObjectAddressKey
+
+    const obj = internal.getObject(sanitizedPath)
+    if (!obj) {
+      console.warn(`Object key "${sanitizedPath}" does not exist.`)
+      return
+    }
+
+    internal.deleteObject(sanitizedPath as ObjectAddressKey)
+  }
 }
 
 const validateSequenceNameOrThrow = (value: string) => {