Releases

#v0.7.0

This is the latest version of Theatre.js. Upgrade by running npm install @theatre/core@latest @theatre/studio@latest @theatre/r3f@latest in your project.

August 10th 2023

• New features

  • @theatre/r3f now supports THREE.js r155.
  • Assets now support the file type, so any file can be used as an asset, by João Leite.
  • @theatre/dataverse and @theatre/react are now marked as stable and can be used outside of Theatre.js.
  • Extensions are now hot-reloadable.

• Breaking changes

  • @theatre/r3f: The r3f extension now requires three at >=0.155.0 and @react-three/fiber at >=8.13.6.
  • @theatre/react: The usePrismWithoutReRender() and usePrismInstanceWithoutReRender() have been removed.

• Bug fixes

  • @theatre/react is now hot-reloadable.

• Internal changes

  • Theatre.js now uses React 18 under the hood.
  • The playground is now hot-reloadable.
  • New visual regression tests.
  • Compat fixtures now test Theatre.js with Vite, Next.js, React 18, React 17, and other popular JS tools.

#v0.6.2

July 24th 2023

• This update includes:
  • A fix for the compatibility issue with THREE.js r154, by Colin Duffy.
  • You can now read the keyframes of a prop by calling sequence.__experimental_getKeyframes(), implemented by Adam Krebs.
  • It is now easier to sequence props by just clicking on their control indicator.

#v0.6.1

May 12th 2023

• This update includes:
  • Added support for typescript's bundle mode to @theatre/r3f.
  • Implemented the experimental createContentOfSaveFileTyped(), by Adam Krebs.
  • A small UX improvement for PlayheadPositionPopover.
  • An experimental API for forgetting sheets and objects.
  • Implemented a method to clear the persistent storage.
  • A substantial perf improvement for @theatre/studio.
  • The default and static overrides are now distinguisable in the UI.
  • A temporary API for enabling/disabling triggering playback via the spacebar.
  • And several UX improvements.

#v0.6.0

Jan 25th 2023

• New features

  • Theatric is a new controller library bulit on Theatre.js for tweaking and fine-tuning variables in your app.
  • Assets allow you to use files as values for props and even keyframes.
  • rafDrivers allow you to control when and how often computations in Theatre tick forward, based on work by Pete Feltham.
  • Items in the outline menu are now collapsible, based on work by Clément Roche.
  • A new easing option called "Hold", courtesy of Colin Duffy.
  • Number props have a more predictable nudging behavior.
  • Compound props that represent vectors (such as {x, y, z}) now take up less space by collapsing into a single row.
  • Markers in the sequence editor can now have their own labels, by Colin Duffy.
  • Extensions can now contribute flyout menus to the studio, by Colin Duffy.

• Other notable changes

  • Much simpler dataflow and faster internals via major changes to dataverse.
  • Components in an object key can now be 64 characters long, by AD2018.
  • Dynamic object properties are reflected in the UI more efficiently, thanks to @mmiinnovations.

#v0.5.1

December 31st 2022

• New features

  • A new Camera implementation with a convenient lookAt target.
  • You can now dynamically remove objects via Sheet.detatchObject().
  • Objects can now be reconfigured on the fly via the reconfigure option.
  • @theatre/r3f now supports hot reloading.
  • A new in-app guide helps you avoid common mistakes.
  • Out-of-the-box support for all THREE.js light types.
  • Support for server-side rendering in Next.js and other SSR frameworks.

• Bug fixes

  • Fixed a bug that caused only a single project to be export-able per reload.
  • Fixed an edge-case where inline keyframe values might remain stale after an edit.
  • Fixed an edge-case where some panes would get dragged out of the browser window.
  • Fixed a bug that prevented audio playback in the studio.

#v0.5

September 14th 2022

Theatre.js v0.5 · Introduces a 3D editor for React Three Fiber, complex keyframing tools, and an extensions API. More in the blog post.

• Prop types
  • All prop types are now sequenceable
  • Prop types can optionally have custom linear interpolators
  • Added color prop
  • Numeric props can now be dragged with a pointer lock
• Sequence editor
  • Keyframe values can now be edited inline
  • Single easing editor, with easing presets and fuzzy search
  • Aggregate keyframe tracks
  • Markers
  • Focus range
  • Several UX improvements with the scroll/pinch gestures (Keyboard controls)
  • Selections
  • Copy/paste
• Workspaces
  • An update checker that shows a badge if there is a new version of Theatre.js available
  • It is possible now to nest/namespace objects
  • The outline menu's items are now sorted alphabetically
  • The left/right panels can now auto-hide or be pinned
  • Better support for windows
  • Fixed compatibility with the rest of the JS ecosystem - now bundles all of its dependencies, allowing you to use it with any version of React, Vue.js, Svelte, and of course, vanilla JS.
  • Performance improvements
  • New helpful warnings in the API
• @theatre/core
  • Audio playback
  • Added an API for reading/observing the position of the seeker in the sequence, its length, and its playback state
  • You can now export the state of each project programmatically
• First release of @theatre/r3f (read the "Getting started with React Three Fiber" guide for an introduction to the library, or check the API docs to dive deeper)

---