Fix Object Vector Studio state counts shape ordering grouping and state shape behavior - PR_26133_050-object-state-shape-grouping-and-order-controls

Author: DavidQ

docs/dev/reports/object_state_shape_behavior_report.md

@@ -0,0 +1,32 @@
+# PR_26133_050 Object State Shape Behavior Report
+
+Task: PR_26133_050-object-state-shape-grouping-and-order-controls
+Date: 2026-05-15
+
+## Shape Membership
+
+- Object shapes remain base object geometry: `objects[*].shapes[*]` is the canonical shape list for the object.
+- States own frame timelines: `objects[*].states[*].frames[*]` selects state-specific animation and visibility/transform overrides.
+- Frames reference base shapes by local `shapeIndex` through `shapeOverrides`.
+- Base shapes are not duplicated per state.
+
+## Delete Behavior
+
+- The shape tile delete button is an explicit base-shape delete.
+- Base-shape delete removes that shape from the object for every state, then cleans or remaps all frame `shapeOverrides` that referenced later shape indexes.
+- State/frame visibility changes do not delete the base shape.
+- When an active state/frame exists, the shape visibility eye writes `shapeOverrides[*].visible` for that selected frame.
+- When no active state/frame exists, visibility falls back to base shape `visible` because there is no state-specific frame to own the override.
+
+## Group Behavior
+
+- The schema/editor contract supports one `groupId` per shape.
+- This PR enforces one group per shape; grouping selected shapes assigns a new single `groupId`.
+- Selecting any member of a group selects every shape with the same `groupId`.
+- Grouped shape tiles render a group icon with a deterministic color derived from the group id.
+- Ungroup removes `groupId` from the selected shapes and immediately removes the tile group icons.
+
+## Validation Evidence
+
+- `npm run test:workspace-v2` passed with 51 tests.
+- Playwright verified grouped shape selection, group indicators, ungroup behavior, state/frame visibility override behavior, and base-shape delete cleanup.

docs/dev/reports/playwright_v8_coverage_report.md

@@ -1,6 +1,6 @@
-# PR_26133_049 Playwright V8 Coverage Report
+# PR_26133_050 Playwright V8 Coverage Report
 
-Task: PR_26133_049-state-selector-and-object-shape-action-placement
+Task: PR_26133_050-object-state-shape-grouping-and-order-controls
 Date: 2026-05-15
 
 ## Result
@@ -25,7 +25,7 @@ PASS - Coverage reporting was generated during `npm run test:workspace-v2`.
 
 ```text
 (83%) tools/object-vector-studio-v2/js/bootstrap.js - executed lines 105/105; executed functions 5/6
-(95%) tools/object-vector-studio-v2/js/ToolStarterApp.js - executed lines 5014/5014; executed functions 518/548
+(94%) tools/object-vector-studio-v2/js/ToolStarterApp.js - executed lines 5070/5070; executed functions 532/563
 ```
 
 ## Guardrail
@@ -36,4 +36,4 @@ PASS - Coverage reporting was generated during `npm run test:workspace-v2`.
 
 ## PR-Specific Note
 
-The Workspace V2 run exercised Object Vector Studio V2 state selection from object tiles, selected-state frame timelines, selected-shape action placement, palette Width layout, Object Vector schema validation, and Asteroids runtime object-vector rendering.
+The Workspace V2 run exercised Object Vector Studio V2 object header counts, state help text, shape grouping selection, group indicators, z-order controls, state/frame visibility overrides, base shape deletion cleanup, Object Vector schema validation, and Asteroids runtime object-vector rendering.

docs/dev/reports/playwright_workspace_v2_results.md

@@ -1,6 +1,6 @@
-# PR_26133_049 Workspace V2 Playwright Results
+# PR_26133_050 Workspace V2 Playwright Results
 
-Task: PR_26133_049-state-selector-and-object-shape-action-placement
+Task: PR_26133_050-object-state-shape-grouping-and-order-controls
 Date: 2026-05-15
 
 ## Result
@@ -14,12 +14,15 @@ PASS - `npm run test:workspace-v2` completed successfully.
 
 ## PR-Specific Coverage
 
-- Verified state dropdown/help controls render under the selected object tile, not inside frame tiles.
-- Verified state tiles select the current object state while frames remain scoped to the selected state timeline.
-- Verified selected shape move/order/group controls render as icon-only buttons under `object-vector-studio-v2__object-tile-shapes`.
-- Verified moved shape actions still update z-order and grouping behavior.
-- Verified Palette Width input has enough visible width for `xx.x` values while Paint, Stroke, and Width remain on one line.
+- Verified Objects header includes object count, selected object state count, and selected object shape count.
+- Verified state `?` help lists the descriptions for every state available in the dropdown.
+- Verified selected shape order controls use the restored z-order glyphs and perform forward/back/front/back order changes.
+- Verified grouped shapes select together, render group indicators, use a deterministic group color, and ungroup cleanly.
+- Verified state/frame visibility toggles write frame overrides without deleting the base object shape.
+- Verified explicit shape delete remains a base-shape delete and cleans dependent frame override indexes.
 
 ## Additional Validation
 
+- Focused Object Vector slices passed before the full run:
+  `shows Object Vector Studio V2 layout shell`, `edits Object Vector Studio V2 preview shapes`, and `supports Object Vector Studio V2 animation states`.
 - `git diff --check` passed.