Skip to content

chore(studio): document CSS-path position cut-over; GSAP-path deferred (§3.3)#1467

Open
vanceingalls wants to merge 1 commit into
06-15-feat_studio_route_timeline_trim_move_through_sdk_settiming_3.2_from
06-15-chore_studio_document_css-path_position_cut-over_gsap-path_intentionally_deferred_3.3_
Open

chore(studio): document CSS-path position cut-over; GSAP-path deferred (§3.3)#1467
vanceingalls wants to merge 1 commit into
06-15-feat_studio_route_timeline_trim_move_through_sdk_settiming_3.2_from
06-15-chore_studio_document_css-path_position_cut-over_gsap-path_intentionally_deferred_3.3_

Conversation

@vanceingalls

Copy link
Copy Markdown
Collaborator

Summary

Documents (via // ponytail: comment) that §3.3 is complete:

  • CSS-path position (non-GSAP elements): routes through commitPositionPatchToHtmlpersistDomEditOperationsonTrySdkPersist, already SDK-cut-over as setStyle/setAttribute. No code change needed.
  • GSAP-targeted position: handleDomPathOffsetCommit already blocks with GSAP_CSS_FALLBACK_BLOCKED_MESSAGE (no HTML patch, no script edit). Intentionally deferred — no SDK position-in-script op exists. Upgrade path noted.

Stage 7 §3.3 — GSAP-targeted position: document deferred

Changes

  • useDomGeometryCommits.ts: Add // ponytail: note on handleDomPathOffsetCommit explaining the CSS vs GSAP-targeted split and the upgrade path.

Open decisions (§7)

  • CSS-path data-x/data-y vs transform reconciliation: commitPositionPatchToHtml writes inline-style patches (transform/position) which map to setStyle in the SDK. moveElement (which writes data-x/data-y) is NOT used on this path. The two persist formats (CSS transform vs data attributes) serve different use cases. No reconciliation needed for v1.

🤖 Generated with Claude Code

…onally deferred (§3.3)

Co-authored-by: Miguel Ángel <miguel07alm@protonmail.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant