Loomlet for Scene Sync

A minimal VS Code extension for writing .loom scene behavior scripts used with Scene Sync.

The extension depends on the @afjk/loomlet npm package.

Features

• .loom language association
• basic syntax highlighting
• diagnostics for parse and compile errors
• import completion
• time., math., and scene. completions
• named argument completion
• Loomlet: Run Current File
• Loomlet: Scene Sync Dev Current File
• Loomlet: Compile Scene Sync Behavior Graph
• Loomlet: Set Scene Sync Object Behavior Graph
• Loomlet: Clear Scene Sync Object Behavior Graph
• Loomlet: Set Scene Sync Scene Behavior Graph
• Loomlet: Clear Scene Sync Scene Behavior Graph

Development

Open this folder in VS Code and press F5 to launch an Extension Development Host.

Commands

Loomlet: Run Current File

Runs:

loomlet run

Loomlet: Scene Sync Dev Current File

Runs:

loomlet scenesync dev

This uses the existing Loomlet CLI Scene Sync session configuration. It watches the current file and repeatedly compiles/sends during development.

Loomlet: Compile Scene Sync Behavior Graph

Compiles the current .loom file to a Scene Sync Behavior Graph payload and displays it in the output channel.

Select either "Object Behavior Graph" or "Scene Behavior Graph":

• Object Behavior Graph: Requires a Scene Sync object id (e.g., sample-cube)
• Scene Behavior Graph: No additional input required

Loomlet: Set Scene Sync Object Behavior Graph

Sends the current .loom file as an Object Behavior Graph to Scene Sync.

Prompts for a Scene Sync object id (e.g., sample-cube).

Loomlet: Clear Scene Sync Object Behavior Graph

Clears the Object Behavior Graph for a given Scene Sync object id.

Loomlet: Set Scene Sync Scene Behavior Graph

Sends the current .loom file as a Scene Behavior Graph to Scene Sync.

Loomlet: Clear Scene Sync Scene Behavior Graph

Clears the Scene Behavior Graph for the current Scene Sync scene.

Scene Sync Workflow

1. Open a .loom file in VS Code.
2. Edit the file and preview with Loomlet: Open Node Preview to the Side.
3. Once satisfied, use one of the Scene Sync Behavior Graph commands:
   • Run Loomlet: Compile Scene Sync Behavior Graph to preview the payload.
   • Run Loomlet: Set Scene Sync Object Behavior Graph to send it to a specific object.
   • Run Loomlet: Set Scene Sync Scene Behavior Graph to send it to the scene.
4. The object or scene will receive the Behavior Graph through scene-graph-set.

A Behavior Graph is persistent continuous behavior, different from one-shot Scene Commands such as scene-delta.

Limitations

This MVP does not include:

• full Language Server Protocol
• formatter
• hover documentation from compiler metadata
• graph preview (experimental / not fully implemented)

VS Code completions are generated from Loomlet library metadata. Run npm run generate:vscode-metadata after changing library metadata.