Experimental API for forgetting objects/sheet

[AriaMinaei]

This adds two methods to the transactionAPI that would remove an object or sheet's state from the project's state.

import {getProject} from '@theatre/core'
import studio from '@theare/studio'

const project = getProject('...')
const sheet = project.sheet('...')
const object = sheet.object('...')

// let's say you've already set up prop values for your object and created a sequence in the studio

studio.transaction((api) => {
  // calling this will make it as if you never set values for this object or put it in a sequence
  api.__experimental_forgetObject(object)
  
  // calling this will make it as if you never set values for _any_ object in this sheet, and you never created a sequence either.
  api.__experimental_forgetSheet(sheet)

  // note that if you're calling __experimental_forgetSheet(), then there is no need to call __experimental_forgetObject() in case that object belongs in that sheet.
})

// now if you export the project's state, or do that programmatically, the sheet/object won't be in the exported state:
studio.
createContentOfSaveFile(project.address.projectId) // won't have the sheet/object in it

// note that cmd/ctrl+z will still undo the above operations

[vercel]

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name	Status	Preview	Comments	Updated
theatre-playground	✅ Ready (Inspect)	Visit Preview	💬 Add your feedback	Mar 8, 2023 at 11:59AM (UTC)

[AriaMinaei]

Published an insiders' release as 0.6.1-insiders.7dde8ab

[AriaMinaei]

This might interest @tomorrowevening too.

[tomorrowevening]

I'll experiment with this later with my drag and drop prototype, that dynamically adds sheets / objects and would be a good test for this

[AD2018]

Please add some method(detachSheet()) that will hide sheet from outline menu in the top left so people can also hide it from UI after deleting sheet

[AriaMinaei]

/release insiders

[github-actions]

🎉 Released an insiders' build to npm. Here is how to upgrade:

• 🚧 This is an insiders' build. It possibly is not stable and may corrupt your data. Always backup your work before upgrading.
• If you do try this build, welcome aboard, insider 😉. If you're feeling generous, share some feedback here or on #contributing at Discord.
• 🔼 To upgrade, edit package.json and replace the versions of all @theatre or theatric packages with their new versions:

--- @theatre/core: "old-version",
+++ @theatre/core: "0.6.1-insiders.72222e5",
--- @theatre/studio: "old-version",
+++ @theatre/studio: "0.6.1-insiders.72222e5",
--- @theatre/dataverse: "old-version",
+++ @theatre/dataverse: "0.6.1-insiders.72222e5",
--- @theatre/react: "old-version",
+++ @theatre/react: "0.6.1-insiders.72222e5",
--- @theatre/browser-bundles: "old-version",
+++ @theatre/browser-bundles: "0.6.1-insiders.72222e5",
--- @theatre/r3f: "old-version",
+++ @theatre/r3f: "0.6.1-insiders.72222e5",
--- theatric: "old-version",
+++ theatric: "0.6.1-insiders.72222e5",

All published packages are on npm:

• @theatre/core@0.6.1-insiders.72222e5

• @theatre/studio@0.6.1-insiders.72222e5

• @theatre/dataverse@0.6.1-insiders.72222e5

• @theatre/react@0.6.1-insiders.72222e5

• @theatre/browser-bundles@0.6.1-insiders.72222e5

• @theatre/r3f@0.6.1-insiders.72222e5

• theatric@0.6.1-insiders.72222e5

  Published at the request of @AriaMinaei, on commit 852f12f. Workflow log here to debug.

[AriaMinaei]

@AD2018 sure, will do

[f0nar]

@AriaMinaei do you have any updates for removing of sheets from project tree?

[AriaMinaei]

@f0nar This was merged in 0.6.1. Upgrade to that version (well, better latest, so 0.7.0) and you'll have the API described in the top comment.

[f0nar]

@AriaMinaei I was asking about functionality like 'detachSheet'

[AriaMinaei]

@f0nar detachSheet() hasn't been implemented yet, but detachObject() is: https://www.theatrejs.com/docs/latest/manual/objects#detaching-objects

Do you specifically need to detach sheets from a project?

[f0nar]

Yep. I really need it.