Triplex for VS Code

[itsdouges]

Note

Triplex for VS Code is coming! Want to be an early adopter? Fill this in: https://forms.gle/sNSjuZca8QjBJf5WA.

---

Keeping track of what needs to be completed to get mostly feature parity with Triplex app. Complete parity isn't the goal as there is a code-first focus for the extension.

MVP release

• Triplex scene
• Triplex backend
• Element panel
• Selected element controls
• Undo/redo/save
• Jump to
• Play/pause/edit
• Union input toggle
• Basic error handling for userland errors
• Element / prop filters

Announcement release

• Duplicate selected element
• Component switcher in the editor
• Select mode (turn off transform controls)
• Delete selected element
• Element actions menu
• Color input
• Resize panel
• Link to code for controlled in code input
• Provider controls
• Component controls
• Prop input tags (basic + union)
• Toggle default lights shown when no lights are in the component
• Upgrade core dependencies (Vite, TSC, ...)
• Create debugging output channel "createOutputChannel"
• Sentry
• Telemetry
• View through camera
• Documentation
• Blog post
• Branding
• Short form videos
• Long form videos

Bugs

• Saving errors for CJS import of ESM prettier-plugin-jsdoc
• Need to wait when re-trying vscode
• (Windows) Saving hotkey triggers scale hotkey
• (Windows) Can't open another component in the file in Triplex, just noops
• Save / save as commands inactive in VSCode File menu save commands get unexpectedly disabled when using a custom editor microsoft/vscode#219807
• Save hotkey not working in Windows
• Starting Triplex really quickly results in errors (Can't replicate)
• Resolve layout bugs in panel
• Inputs unable to be undo/redo/escape/enter
• Undo/redo after saving is a bit janky
• Playing through default camera doesn't hide controls
• Prop type switcher misaligned for light args/color args/...
• Union input descriptions missing
• Open a scene in triplex, Quickly close it, Open it again, can't open triplex anymore
• Fix x-file modification (e.g. child of a component) not being able to be saved (but being counted as modifying the current open file instead of the actual file)
• Undo/redo can get into invalid state where VS Code raises an error saying an undo is already in progress (no replicate)
• Re-opening a quit vscode session opens the scene but not the component
• Updating element visibility in materials results in the selection being lost
• Can't undo/redo changed performed in code editor through Triplex editor
• When waking from sleep the Vite never reconnects
• Sentry might be broken in prod
• Forward glsl/console errors to vsce output/error notification
• Resetting loses track of the selected scene object (but remains "selected")
• Undo/redo memory/perf intensive over long sessions
• When focused in editor pressing camera modifiers don't get set
• When in "double click" tab mode, clicking into the Triplex webview makes the camera rotate bonkers for a sec
• Long running sessions have a tendency to lose track of elements resulting in an invariant thrown

Questions from Ecosystem

These should be documented and/or written into blogs.

• How to zoom to selected element?
• Projects that have a parent package json somewhere affecting things
• How to disable Triplex for non-3d/Triplex projects?
• Simpler examples (no pnpm / tsx)
• How to use with framer motion
• How to use with theatre js
• How to get logs
• How to view VSCE developer tools

Feature follow up

• Name prop on custom components being honored by the element panel
• Click through already selected mesh to select another inside it
• Unbounded transform control
• Fps/gpu meter
• See edges of a mesh / wireframe when shaded

Out of scope

These features won't be added to the extension.

• Reorder elements
• Add element panel
• Enter element
• Installing / managing node module dependencies
• Custom names for custom editor tabs in vs code (not possible)