meursyphus/ssgoi v7.2.0

SSGOI 7.2.0 — Motion, router helpers, and shared-image transitions

on GitHub

SSGOI 7.2.0 promotes the tested 7.1.3 beta series and the work merged since 7.1.2. All eight @ssgoi/* packages ship together at 7.2.0.

Transition authoring and motion

• defineTransition now pairs prepare and animation for each direction, retaining the inferred data and concrete animation types in custom transitions. Route rules and history still choose direction. #411
• Presets expose typed { override } callbacks, named MultiAnimation children, and integrator/start-condition editing. Existing preset defaults and enter/exit markers are preserved. The release adds custom-transition and motion guides plus typechecked examples. #411

Router integrations

• Optional subpath helpers now include Remix 2, Solid Router, Qwik City, and Angular Router alongside the existing Next.js, React Router, TanStack Router, SvelteKit, Vue Router, Nuxt, SolidStart, and Expo Router integrations. Router dependencies remain optional and out of framework root imports. Next.js is the only router helper currently marked stable; the others remain experimental. #413
• Framework documentation is grouped by framework, with a shorter Next.js App Router quick start and guides for direct and persistent boundaries. #413

Shared images and scrolling

• Hero enter animates the actual destination visual in its page so overlapping content keeps its authored stacking order. The fade variant also fades non-shared content and ancestor background colors. Hero exit uses a separate image layer above the pages. #415, #416
• Hero and Zoom crossfade matched images when the source and destination differ, preserving responsive image selection, aspect ratios, measured crops, and rounded corners. Temporary layers and original opacity are cleaned up on completion or replacement. #416
• During a matched page transition, SSGOI suppresses wheel, single-finger touchmove, and page-scroll key input until the outgoing page is removed or hidden. It does not change CSS or scrollbar layout. The detected document or custom scroll container is used, overlapping transitions share listener ownership, and cleanup handles interruption and teardown. Set top-level scrollLock: false if the app manages transition input itself. Native scrollbar dragging, programmatic scrolling, and momentum already in progress remain outside this lock. #418

Upgrade

npm install @ssgoi/react@7.2.0

Install the matching 7.2.0 version of any other @ssgoi/* packages in use. React Native and its Expo Router helper remain experimental; the 7.2.0 package version does not make native support production ready.

Full changelog: v7.1.2...v7.2.0

Validation

• All eight package builds and the pnpm release --dry publish rehearsal passed; the dry run packed eight 7.2.0 packages for npm's latest tag.
• 249 core unit tests; 29 React, 3 Angular, 6 Svelte, and 20 React Native tests passed.
• 11 scroll-lock browser tests passed across Chromium and WebKit; the WebKit mobile touch case is intentionally skipped by the suite.
• Four public documentation examples typechecked. Router documentation, packed export targets, real Remix integration, isolated router/platform/native consumers, core and React lint, and docs and Next.js template production builds passed.

Physical iOS momentum/rubber-band behavior and native device performance have not been verified in this release pass.