real_page_flip 1.4.2

A high-fidelity 3D-like page flip engine for Flutter. Features physics-based paper fold effects with realistic shadows, sound, and haptic feedback for ultra-smooth performance.

Changelog

All notable changes to this project will be documented in this file.

1.4.2 - 2026-06-04

Added

• Updated documentation to clarify that the engine is optimized for vertical mobile devices and does not support horizontal two-page view.

1.4.1 - 2026-06-04

Changed

• Relicensed the package under the MIT License, making it completely free for commercial and non-commercial use.

1.4.0 - 2026-05-14

Added

• Direction-aware flip thresholds: cutoffForward and cutoffPrevious independently control drag-release completion (both default to 0.4).
• 12 new test files covering PageFlipConfig, PageFlipGeometry, PageFlipPainter, PaperPhysicsConfig, PaperPhysicsFrame, PaperResistanceModel, PaperTextureNoise, StickSlipController, PageFlipStateController, PreRenderManager, and EdgeTapFeedback.
• Named geometry constants: 6 rendering constants extracted from inline magic numbers.

Changed

• PageFlipStateController accepts cutoffForward/cutoffPrevious from PageFlipConfig instead of a hardcoded threshold.
• PageFlipPainter constructor is now const.
• cutoffForward default: 0.8 → 0.4.
• cutoffPrevious default: 0.1 → 0.4.

Fixed

• PageFlipConfig equality: ==/hashCode now include enableHaptics, enableSound, and effectHandler.
• PaperPhysicsConfig and PaperPhysicsFrame added ==/hashCode overrides.

1.3.0 - 2026-05-09

Added

• Dark Mode Support: PageFlipConfig.backgroundColor now defaults to null instead of Colors.white. When null, the engine reads Theme.of(context).scaffoldBackgroundColor at render time, so dark mode works automatically without any extra configuration.
• Adaptive shadow intensity in PageFlipPainter: backgrounds with luminance below 0.20 (dark mode) receive softer inner shadows (35 % → 20 %) and stronger fold highlights (12 % → 18 %) for a more natural flip appearance.
• New Dark Mode Support section in README.md with zero-config and custom-color examples.

Changed

• PageFlipConfig.backgroundColor type changed from Color to Color?. Existing callers that explicitly pass a colour are unaffected; callers that relied on the Colors.white default now automatically inherit the host app's scaffold background colour.

1.2.4 - 2026-05-02

Fixed

• Fixed a 404 error on the legacy interaction demo video URL which caused it to render as a plain link instead of embedding as a video player.

1.2.3 - 2026-05-02

Fixed

• Replaced WebP and [] tags with raw markdown video links to allow native video embedding on GitHub and clean fallback links on pub.dev.
• Removed legacy realpageflip_sample.webp to prevent display of inaccurate static recordings.

1.2.2 - 2026-05-02

Fixed

• Fixed broken video tags on pub.dev by replacing them with clickable animated WebP thumbnails and Markdown text links.
• Removed redundant demo sections to ensure exactly two primary demo links are prominently displayed.

1.2.1 - 2026-05-02

Added

• Replaced main demo with a high-fidelity, extended interaction recording.
• Added "Legacy Interaction Demo" section to showcase core physics and gesture arbitration.
• Integrated direct GitHub user-attachment URLs for robust documentation rendering.

1.2.0 - 2026-05-02

Added

• Replaced demo assets with high-fidelity production sample (realpageflip_sample.webp).
• Optimized README for pub.dev compatibility with clickable high-resolution previews.
• Increased image width in documentation for better technical visualization.

1.1.3 - 2026-05-02

Added

• Replaced static placeholder with a high-fidelity interaction recording of the actual engine.
• Fixed rendering issues in the documentation preview assets.

1.1.2 - 2026-05-02

Added

• Improved snappy demo video with immediate interaction start (zero delay).
• Switched to absolute asset URLs in documentation for better rendering on pub.dev and other platforms.

1.1.1 - 2026-05-02

Added

• Professional high-fidelity teaser video (demo.webp) for documentation.
• Comprehensive technical differentiation and GPU optimization guides in README.
• Standardized high-efficiency Opus audio assets for better performance.
• Enhanced example application with unique page content and heavy-load stress tests.
• GitHub repository SEO optimization (topics, description).

Fixed

• Sync issues between internal package and public repository.

1.1.0 - 2026-05-01

Added

• Physics-based interaction logic for realistic paper friction.
• Dynamic geometry rendering with hardware-accelerated clipping.
• Integrated haptic feedback system.
• Sound effect integration with audioplayers.
• Semantics support for accessibility.
• Strict linting and code formatting.

Changed

• Refactored PageFlipWidget to use a more robust PageFlipStateController.
• Improved snapshot capturing logic in PreRenderManager.

Fixed

• Layout boundary issues in certain Stack configurations.
• Memory leak in PreRenderManager snapshots.