[git-chad]

Designers can now organize layers into isolated groups in the editor and keep those groups when saving, reopening, undoing changes, or exporting a runtime config. An effect inside a group affects that group's children; group opacity, blend, and visibility apply to the composed result.

Stacked on #154 (git-chad/v3-isolated-group-rendering), within the V3 integration stack #150. Do not merge to main until the roadmap is complete.

Changes

• Add group/ungroup, rename, collapse, nested ordering, and a Properties selector for moving layers between groups. Group actions operate on complete subtrees; keyboard shortcuts and menu reordering work on desktop, and controls are available on mobile.
• Persist a validated, contiguous hierarchy in project version 7 and exported ShaderLabConfig. Older flat projects/configs remain supported. Enforce unique IDs, valid parents, and eight nesting levels before editor hydration.
• Restore multi-selection through history. Duplicate descendant animation tracks/audio links, and prune dependencies when deleting or ungrouping layers.
• Connect evaluated editor/runtime layers to the isolated render tree, including animated parent visibility and opacity. Collapsing a group only affects the layer list.
• Correct the desktop Properties panel measurement so group controls fit beneath its header.

Validation

• bun run check — passed (two existing source lint warnings; one warning in a gitignored local fixture script).
• Runtime and MCP package typechecks — passed.
• bun run test:composition — passed: frozen legacy fixtures, 136 blend/mask samples, 34 media-bound samples, 100 alpha samples, 52 group checks, plus the new editor-group integration suite.
• New integration checks exercise real stores/history and applyLabProjectFile, malformed-hierarchy rejection without mutation, animation/audio duplication and cleanup, runtime config rendering, and saved/reopened preview/PNG pixel equality. Baselines were not regenerated.
• Playwright desktop interaction checks cover group creation, rename, collapse, undo/redo, subtree drag, move membership, duplicate/delete, and ungroup. Mobile collapse/expand checked at 390px.

Manual review

Follow the group checklist: group a photo and effect over a separate background, adjust group opacity/blend, move and duplicate it, undo changes, then save/reopen and compare PNG export. Confirm desktop and mobile controls before continuing to masks.

Coverage masks and transparent scene/export backgrounds are separate slices. New version-7 saves require this V3 build to reopen. Ungroup removes the group's opacity/blend/visibility contribution, so appearance can change.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated
shader-lab	Ready	Preview	Oct 1, 2026 7:05am UTC

[greptile-apps]

Confidence Score: 4/5

The PR should not merge until publishing hidden groups preserves a valid hierarchy.

Summary

This PR adds isolated editor groups across editing, persistence, history, rendering, and runtime export.

• Adds nested group creation, movement, reordering, renaming, collapsing, duplication, and deletion.
• Introduces version-7 hierarchy persistence and runtime parentId support.
• Evaluates group visibility and opacity before constructing isolated render trees.
• Adds composition and editor integration coverage.

_{Reviews (1) · Last reviewed commit: "feat: add editor groups with persistence..."}