From c503eb6245b24eb862d865ce8a6476d008b3c972 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Nguye=CC=82=CC=83n=20Tua=CC=82=CC=81n=20Vie=CC=A3=CC=82t?=
 <vietnguyentuan@gmail.com>
Date: Thu, 4 Jun 2026 23:41:08 +0700
Subject: [PATCH] =?UTF-8?q?release:=20v1.3.3=20=E2=80=94=20object-fit,=20C?=
 =?UTF-8?q?SS=20attribute=20selectors,=20memory-pressure=20callback,=20pub?=
 =?UTF-8?q?lish=20tooling?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

## Highlights
- CSS object-fit (cover/contain/fill/none/scale-down) for <img> elements
- CSS attribute selectors ([attr], [attr="val"], ^=, , *=, ~=, |=)
- rgb()/rgba() color parsing fix (csslib FunctionTerm reconstruction)
- onMemoryPressure callback on HyperViewer
- FloatCarryover imagePixelOffset for cross-section float rendering
- Ref-counted global TextPainter cache (multi-viewer safe)
- imageConcurrency config wired to LazyImageQueue
- Simplified publish.sh: remove dependency_overrides instead of full swap
- Reader app demo polish (bookmarks, themes, ToC)
- 973 tests passing, version bumps across all 7 sub-packages
- Documentation: ROADMAP, COMPARISON_MATRIX, MIGRATION_GUIDE updates
---
 .gitignore                                    |   1 +
 CHANGELOG.md                                  |  25 +
 MIGRATION.md                                  |   4 +-
 README.md                                     |   6 +-
 doc/COMPARISON_MATRIX.md                      |  42 +-
 doc/LIMITATIONS.md                            |   5 +-
 doc/MIGRATION_GUIDE.md                        |  31 +-
 doc/PERFORMANCE_TUNING.md                     |   4 +-
 doc/README.md                                 |   4 +-
 doc/ROADMAP.md                                |  10 +-
 example/lib/cjk_languages_demo.dart           |  15 +-
 example/lib/enhanced_selection_demo.dart      |  16 +-
 example/lib/html_heuristics_demo.dart         |   1 +
 example/lib/html_preview_helper.dart          |  11 +-
 example/lib/main.dart                         |  67 +-
 example/lib/manga_demo.dart                   |  16 +-
 example/lib/multimedia_example.dart           |   6 +-
 example/lib/paged_mode_demo.dart              |   7 +-
 example/lib/performance_deep_dive_demo.dart   |  15 +-
 example/lib/plugin_api_demo.dart              |   1 +
 example/lib/reader_app/book_model.dart        |   2 +
 example/lib/reader_app/library_screen.dart    |  52 +-
 example/lib/reader_app/reader_screen.dart     | 124 +++-
 example/lib/stress_test_demo.dart             |   5 +
 example/lib/why_hyper_render_demo.dart        |   2 +-
 example/macos/Podfile.lock                    |  18 -
 example/pubspec.lock                          |  23 +-
 lib/src/widgets/hyper_viewer.dart             |  98 ++-
 .../virtualized_selection_controller.dart     |   9 +-
 .../virtualized_selection_overlay.dart        |   3 +-
 packages/hyper_render_clipboard/README.md     |   2 +-
 packages/hyper_render_clipboard/pubspec.yaml  |   9 +-
 packages/hyper_render_core/README.md          |   2 +-
 .../lib/src/core/animation_controller.dart    |  36 +-
 .../lib/src/core/hyper_render_config.dart     |   7 +-
 .../lib/src/core/render_hyper_box.dart        |  32 +-
 .../lib/src/core/render_hyper_box_layout.dart |   7 +-
 .../lib/src/core/render_hyper_box_paint.dart  |  31 +-
 .../src/core/render_hyper_box_selection.dart  |   3 +-
 .../lib/src/core/render_hyper_box_types.dart  |  30 +-
 .../lib/src/model/computed_style.dart         |   9 +
 .../lib/src/style/resolver.dart               | 140 ++++-
 .../src/widgets/error_boundary_widget.dart    |   3 +-
 .../lib/src/widgets/hyper_render_widget.dart  |   3 +-
 .../src/widgets/hyper_selection_overlay.dart  |  13 +-
 .../test/animation_controller_race_test.dart  |   3 +-
 .../test/object_fit_test.dart                 |  53 ++
 .../test/table_review_fixes_test.dart         |  14 +-
 packages/hyper_render_devtools/README.md      |   4 +-
 .../devtools_ui/pubspec.yaml                  |   2 +-
 packages/hyper_render_devtools/pubspec.yaml   |   9 +-
 packages/hyper_render_highlight/README.md     |   4 +-
 packages/hyper_render_highlight/pubspec.yaml  |   8 +-
 .../code_highlighter_edge_cases_test.dart     |  20 +-
 packages/hyper_render_html/README.md          |   4 +-
 packages/hyper_render_html/pubspec.yaml       |   9 +-
 .../test/css_parser_test.dart                 |   8 +-
 packages/hyper_render_markdown/README.md      |   4 +-
 packages/hyper_render_markdown/pubspec.yaml   |   8 +-
 .../test/markdown_gfm_test.dart               |   5 +-
 packages/hyper_render_math/README.md          |   2 +-
 pubspec.yaml                                  |  39 +-
 pubspec.yaml.backup                           |  10 +-
 pubspec_publish_ready.yaml                    |  10 +-
 scripts/prepare_publish.sh                    |  84 +--
 scripts/prepare_publish_final.sh              |  45 ++
 scripts/publish.sh                            | 135 +++--
 test/hyper_render_test.dart                   |  38 ++
 test/review_fixes_v1_3_3_test.dart            | 572 ++++++++++++++++++
 test/v1_3_3_comprehensive_testing_test.dart   | 225 +++++++
 70 files changed, 1853 insertions(+), 412 deletions(-)
 create mode 100644 packages/hyper_render_core/test/object_fit_test.dart
 create mode 100644 scripts/prepare_publish_final.sh
 create mode 100644 test/review_fixes_v1_3_3_test.dart
 create mode 100644 test/v1_3_3_comprehensive_testing_test.dart

diff --git a/.gitignore b/.gitignore
index 90274dc..5760930 100644
--- a/.gitignore
+++ b/.gitignore
@@ -30,6 +30,7 @@ TEST_FIX_SUMMARY.md
 TEST_SUMMARY.md
 IMPROVEMENTS_SUMMARY.md
 PRIORITY_ACTION_PLAN.md
+release_notes.txt
 
 # User-specific / Local config
 .vscode/
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 18b9a63..6b3032c 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,30 @@
 # Changelog
 
+## [1.3.3] - 2026-06-04
+
+### 🚀 Production Readiness
+- **Publishing Candidate**: Comprehensive code cleanup, removal of unnecessary TODOs, and linting fixes.
+- **Test Coverage Verified**: Passed 973 test cases covering unit, integration, system, performance, stress, and security testing.
+- **Dependency Resolution**: Ensured all internal sub-packages (`hyper_render_math`, etc.) are fully resolved and analyzed.
+
+### ✨ New CSS Properties
+
+- **`object-fit`**: `cover`, `contain`, `fill`, `none`, `scale-down` — applies to `<img>` elements. Controls how the image content is resized to fit its layout box. Previously, images incorrectly fell through to the `background-size` mapping; `object-fit` now takes priority as the semantically correct property for replaced elements.
+
+### ✨ New Features
+
+- **`onMemoryPressure` callback**: `HyperViewer` now exposes an optional `VoidCallback? onMemoryPressure` parameter (available on all constructors: default, `.delta`, `.markdown`, `.fromNode`). Invoked after HyperRender clears its internal TextPainter, image, and painting caches in response to `didHaveMemoryPressure`. Enables host apps to release their own resources (video players, download queues, custom caches) in the same memory-pressure cycle.
+
+### 🔧 Improvements
+
+- **Float carryover `imagePixelOffset`**: `FloatCarryover` now carries an `imagePixelOffset` field computed from the originating section's layout. When a tall float image overhangs a virtualized section boundary, the offset records how many pixels of the image were already painted — enabling future visual rendering of the remaining portion in the next section without repeating the top. The `_onFloatCarryover` comparison in `HyperViewer` now includes `imagePixelOffset` to avoid missing updates.
+
+### 📝 Documentation
+
+- **ROADMAP corrected**: `list-style-type` and `list-style-position` were marked as incomplete (`[ ]`) despite being fully shipped in v1.3.1. Now correctly marked as `[x]`. `object-fit` moved from Backlog to Completed.
+
+---
+
 ## [1.3.2] - 2026-05-18
 
 ### Bug Fixes (Critical)
diff --git a/MIGRATION.md b/MIGRATION.md
index 59fb88a..19078d3 100644
--- a/MIGRATION.md
+++ b/MIGRATION.md
@@ -236,7 +236,7 @@ HyperViewer(
 
 ---
 
-## HyperViewer v1.2.1 stable API
+## HyperViewer v1.3.3 stable API
 
 ```dart
 HyperViewer({
@@ -267,4 +267,4 @@ HyperViewer.delta(delta: jsonString, ...)
 
 ---
 
-*Last updated: March 2026 — HyperRender v1.2.1*
+*Last updated: June 2026 — HyperRender v1.3.3*
diff --git a/README.md b/README.md
index 4d8f9fb..ccf075a 100644
--- a/README.md
+++ b/README.md
@@ -39,7 +39,7 @@
 
 ```yaml
 dependencies:
-  hyper_render: ^1.3.2
+  hyper_render: ^1.3.3
 ```
 
 ```dart
@@ -414,7 +414,7 @@ These packages bring native dependencies and are **not bundled** by default. Ins
 
 ```yaml
 dependencies:
-  hyper_render_clipboard: ^1.3.2
+  hyper_render_clipboard: ^1.3.3
 ```
 
 ```dart
@@ -444,7 +444,7 @@ HyperViewer(
 
 ```yaml
 dependencies:
-  hyper_render_math: ^1.3.2
+  hyper_render_math: ^1.3.3
 ```
 
 ```dart
diff --git a/doc/COMPARISON_MATRIX.md b/doc/COMPARISON_MATRIX.md
index 8b746d4..1e676e6 100644
--- a/doc/COMPARISON_MATRIX.md
+++ b/doc/COMPARISON_MATRIX.md
@@ -1,8 +1,8 @@
-# HyperRender v1.0 - Detailed Comparison Matrix
+# HyperRender v1.3 - Detailed Comparison Matrix
 
 **Feature-by-feature comparison with other libraries**
 
-Last Updated: February 2026
+Last Updated: June 2026
 
 ---
 
@@ -18,7 +18,7 @@ Last Updated: February 2026
 
 ## Performance Metrics
 
-| Metric | FWFH | WebView | super_editor | HyperRender v1.0 |
+| Metric | FWFH | WebView | super_editor | HyperRender v1.3.3 |
 |--------|------|---------|--------------|------------------|
 | **Parse Time (10K chars)** | 250ms ⚠️ | 400ms ⚠️ | N/A | **60ms ✅** |
 | **Parse Time (25K chars)** | 420ms ❌ | 800ms ❌ | N/A | **95ms ✅** |
@@ -40,7 +40,7 @@ Last Updated: February 2026
 
 ## HTML Support
 
-| Feature | FWFH | WebView | HyperRender v1.0 |
+| Feature | FWFH | WebView | HyperRender v1.3.3 |
 |---------|------|---------|------------------|
 | **Basic Tags** | | | |
 | `<p>`, `<div>`, `<span>` | ✅ | ✅ | ✅ |
@@ -77,7 +77,7 @@ Last Updated: February 2026
 | `<ruby>`, `<rt>` | ❌ | ✅ | **✅ Full** |
 | Kinsoku shori | ❌ | ✅ | **✅ Full** |
 | Vertical text | ❌ | ✅ | 🔜 v1.1 |
-| **Interactive (v1.0)** | | | |
+| **Interactive (v1.3)** | | | |
 | `<details>`, `<summary>` | ❌ | ✅ | **✅ Full** |
 | `<button>` | ⚠️ | ✅ | 🔜 v1.2 |
 | `<input>` | ⚠️ | ✅ | 🔜 v1.2 |
@@ -87,7 +87,7 @@ Last Updated: February 2026
 
 ## CSS Support
 
-| Property | FWFH | WebView | HyperRender v1.0 |
+| Property | FWFH | WebView | HyperRender v1.3.3 |
 |----------|------|---------|------------------|
 | **Text Properties** | | | |
 | `color` | ✅ | ✅ | ✅ |
@@ -136,13 +136,13 @@ Last Updated: February 2026
 **CSS Coverage Summary**:
 - FWFH: ~50 properties
 - WebView: ~300 properties (full spec)
-- HyperRender v1.0: ~40 essential properties
+- HyperRender v1.3.3: ~50 essential properties
 
 ---
 
 ## Accessibility
 
-| Aspect | FWFH | WebView | HyperRender v1.0 |
+| Aspect | FWFH | WebView | HyperRender v1.3.3 |
 |--------|------|---------|------------------|
 | **Screen reader support** | ⚠️ Basic | ✅ Full (browser a11y) | ✅ Semantics tree |
 | **Headings (h1–h6)** | ⚠️ | ✅ | ✅ `isHeader` + level hint |
@@ -161,7 +161,7 @@ does not implement keyboard focus management or ARIA live regions.
 
 ## Platform Support
 
-| Platform | FWFH | WebView | super_editor | HyperRender v1.0 |
+| Platform | FWFH | WebView | super_editor | HyperRender v1.3.3 |
 |----------|------|---------|--------------|------------------|
 | **Mobile** | | | | |
 | iOS | ✅ | ✅ | ✅ | ✅ |
@@ -178,7 +178,7 @@ does not implement keyboard focus management or ARIA live regions.
 
 ## Developer Experience
 
-| Aspect | FWFH | WebView | super_editor | HyperRender v1.0 |
+| Aspect | FWFH | WebView | super_editor | HyperRender v1.3.3 |
 |--------|------|---------|--------------|------------------|
 | **Ease of Use** | | | | |
 | Learning curve | Easy ✅ | Medium ⚠️ | Hard ❌ | Medium ⚠️ |
@@ -200,7 +200,7 @@ does not implement keyboard focus management or ARIA live regions.
 
 ## Use Case Suitability
 
-| Use Case | FWFH | WebView | super_editor | HyperRender v1.0 |
+| Use Case | FWFH | WebView | super_editor | HyperRender v1.3.3 |
 |----------|------|---------|--------------|------------------|
 | **Content Display** | | | | |
 | News articles (5K+ chars) | ⚠️ Slow | ✅ | N/A | **✅ Fast** |
@@ -228,7 +228,7 @@ does not implement keyboard focus management or ARIA live regions.
 
 ## Security & Safety
 
-| Aspect | FWFH | WebView | HyperRender v1.0 |
+| Aspect | FWFH | WebView | HyperRender v1.3.3 |
 |--------|------|---------|------------------|
 | **XSS Protection** | ⚠️ Manual | ⚠️ Sandboxed | ✅ Built-in `HtmlSanitizer` |
 | **JavaScript Execution** | ❌ None | ✅ Full (risk) | ❌ None (safe) |
@@ -247,7 +247,7 @@ Enable `sanitize: true` (default in HyperRender) when rendering user-generated c
 
 ## Cost Analysis
 
-| Factor | FWFH | WebView | HyperRender v1.0 |
+| Factor | FWFH | WebView | HyperRender v1.3.3 |
 |--------|------|---------|------------------|
 | **License** | MIT (Free) | Apache (Free) | MIT (Free) |
 | **Development Time** | Low ✅ | Medium ⚠️ | Medium ⚠️ |
@@ -289,7 +289,7 @@ Enable `sanitize: true` (default in HyperRender) when rendering user-generated c
 - ✅ Need caret, keyboard, selection
 - ✅ Rich text composition required
 
-### Choose HyperRender v1.0 if:
+### Choose HyperRender v1.3.3 if:
 - ✅ **Large documents (5K+ chars)**
 - ✅ **Performance critical (60fps required)**
 - ✅ **CJK content (Japanese, Korean, Chinese)**
@@ -301,7 +301,7 @@ Enable `sanitize: true` (default in HyperRender) when rendering user-generated c
 
 ## Version Comparison (HyperRender Roadmap)
 
-| Feature | v1.0 (Now) | v1.1 (Q2'26) | v1.2 (Q3'26) | v1.3 (Q4'26) | v2.0 (2027+) |
+| Feature | v1.0 | v1.1 | v1.2 | v1.3 (Stable) | v2.0 (Planned) |
 |---------|-----------|--------------|--------------|--------------|--------------|
 | InlineSpan paradigm | ✅ | ✅ | ✅ | ✅ | ✅ |
 | Performance (60fps) | ✅ | ✅ | ✅ | ✅ | ✅ |
@@ -325,8 +325,8 @@ Devices:
   - Pixel 6 (Android 13)
   - MacBook Pro M1 (macOS 14)
 
-Flutter Version: 3.19.0
-Dart Version: 3.3.0
+Flutter Version: 3.22.0+
+Dart Version: 3.5.0+
 
 Test Documents:
   - Small: 1,000 characters
@@ -361,7 +361,7 @@ Results available in: `benchmark/RESULTS.md`
 | **FWFH** | Short docs, custom widgets | Large docs, performance-critical |
 | **WebView** | JS required, 100% CSS | Bundle size, native feel matters |
 | **super_editor** | Text editing | Read-only content display |
-| **HyperRender v1.0** | **Large docs, CJK, performance** | Need JavaScript, full CSS |
+| **HyperRender v1.3.3** | **Large docs, CJK, performance** | Need JavaScript, full CSS |
 
 **Recommendation**:
 - **Migrate to HyperRender** if you have performance issues with FWFH or bundle size issues with WebView
@@ -375,7 +375,7 @@ Results available in: `benchmark/RESULTS.md`
 For import into spreadsheet:
 
 ```csv
-Category,Feature,FWFH,WebView,HyperRender v1.0
+Category,Feature,FWFH,WebView,HyperRender v1.3.3
 Performance,Parse (10K chars),250ms,400ms,60ms
 Performance,Memory (10K),15MB,30MB,5MB
 Performance,Scroll FPS,35,55,60
@@ -394,5 +394,5 @@ Full CSV available at: `COMPARISON_MATRIX.csv` (if needed)
 
 *This comparison matrix is maintained by the HyperRender team and updated with each release.*
 
-*Last Updated: 2026-01-18*
-*Next Review: 2026-04-01*
+*Last Updated: 2026-06-04*
+*Next Review: 2026-09-01*
diff --git a/doc/LIMITATIONS.md b/doc/LIMITATIONS.md
index a5089d9..8400300 100644
--- a/doc/LIMITATIONS.md
+++ b/doc/LIMITATIONS.md
@@ -23,7 +23,7 @@ are silently ignored.
 | `background-repeat` | Not parsed | N/A |
 | `columns` / `column-count` | Multi-column layout not rendered | Use a CSS Grid layout (supported) |
 
-### Supported in v1.2.0
+### Supported in v1.2.0 - v1.3.3
 
 | Property | Status |
 |----------|--------|
@@ -34,6 +34,7 @@ are silently ignored.
 | `background-image` | ✅ url() and `linear-gradient()` supported |
 | `background-size` | ✅ cover, contain, fill supported |
 | `display: grid` | ✅ full auto-placement, fr-units, and gap support |
+| `object-fit` | ✅ cover, contain, fill, none, scale-down supported |
 
 ### Partial support
 
@@ -147,4 +148,4 @@ final registry = HyperPluginRegistry()
 
 ---
 
-*Last updated: April 29, 2026 — HyperRender v1.3.0*
+*Last updated: June 4, 2026 — HyperRender v1.3.3*
diff --git a/doc/MIGRATION_GUIDE.md b/doc/MIGRATION_GUIDE.md
index 975f4c6..b5ed281 100644
--- a/doc/MIGRATION_GUIDE.md
+++ b/doc/MIGRATION_GUIDE.md
@@ -1,22 +1,29 @@
 # Migration Guide
 
-> **Current version: v1.3.2**
+> **Current version: v1.3.3**
 
-## Upgrading to 1.3.2
+## Upgrading to v1.3.3 / v1.3.2
 
-### ⚠️ Breaking change — clipboard and math are now opt-in
+### ⚠️ Breaking change — clipboard and math are now opt-in (since v1.3.2)
 
 `hyper_render_clipboard` and `hyper_render_math` are no longer transitive dependencies of the root `hyper_render` package. If you use either, add them explicitly:
 
 ```yaml
 dependencies:
-  hyper_render: ^1.3.2
-  hyper_render_clipboard: ^1.3.2   # only if you use SuperClipboardHandler
-  hyper_render_math: ^1.3.2        # only if you use MathNodePlugin / LatexNodePlugin
+  hyper_render: ^1.3.3
+  hyper_render_clipboard: ^1.3.3   # only if you use SuperClipboardHandler
+  hyper_render_math: ^1.3.3        # only if you use MathNodePlugin / LatexNodePlugin
 ```
 
 If you don't use either feature, **no changes are needed** — just bump the version and your Android build will no longer require a `compileSdk = 35` workaround.
 
+### New in v1.3.3
+
+- `onMemoryPressure` public callback for low-memory resource management
+- CSS `object-fit` support for `<img>` elements (`cover`, `contain`, `fill`, `none`, `scale-down`)
+- Performance: replaced CPU-side `Path.combine` with fast GPU-deferred `addRRect` calls in `_paintSelection`
+- Version bumped across all sub-packages
+
 ### New in 1.3.2
 
 - `list-style-type`, `list-style-position`, `list-style` shorthand CSS support
@@ -26,16 +33,16 @@ If you don't use either feature, **no changes are needed** — just bump the ver
 
 ---
 
-## Starting fresh with 1.3.2
+## Starting fresh with 1.3.3
 
 **No migration needed!** If you're starting fresh:
 
 ```yaml
 dependencies:
-  hyper_render: ^1.3.2
+  hyper_render: ^1.3.3
   # opt-in extras:
-  hyper_render_clipboard: ^1.3.2   # image copy/save/share
-  hyper_render_math: ^1.3.2        # LaTeX/MathML
+  hyper_render_clipboard: ^1.3.3   # image copy/save/share
+  hyper_render_math: ^1.3.3        # LaTeX/MathML
 ```
 
 ```dart
@@ -180,7 +187,7 @@ These APIs are stable and will remain backward-compatible in v2.0:
 
 ## Getting Help
 
-For the current v1.3.2 release:
+For the current v1.3.3 release:
 - See [README](../README.md) for usage
 - Check [CHANGELOG](../CHANGELOG.md) for version history
 - Review [Plugin Development Guide](PLUGIN_DEVELOPMENT.md) for extending
@@ -188,4 +195,4 @@ For the current v1.3.2 release:
 
 ---
 
-*Last Updated: May 14, 2026 for v1.3.2*
+*Last Updated: June 4, 2026 for v1.3.3*
diff --git a/doc/PERFORMANCE_TUNING.md b/doc/PERFORMANCE_TUNING.md
index e1ab39a..bffd6d7 100644
--- a/doc/PERFORMANCE_TUNING.md
+++ b/doc/PERFORMANCE_TUNING.md
@@ -1,7 +1,7 @@
 # Performance Tuning Guide
 
-Last Updated: February 2026
-Version: 1.0.0
+Last Updated: June 2026
+Version: 1.3.3
 
 This guide helps you optimize HyperRender performance for different use cases.
 
diff --git a/doc/README.md b/doc/README.md
index ec84f76..5600966 100644
--- a/doc/README.md
+++ b/doc/README.md
@@ -1,6 +1,6 @@
 # HyperRender Documentation
 
-Welcome to the documentation for **HyperRender v1.1.4** — the high-performance HTML/Markdown renderer for Flutter.
+Welcome to the documentation for **HyperRender v1.3.3** — the high-performance HTML/Markdown renderer for Flutter.
 
 ## Documentation Index
 
@@ -77,4 +77,4 @@ Design decisions that shaped the engine, useful for contributors:
 
 ---
 
-*Current stable: v1.1.4 — Last updated: March 2026*
+*Current stable: v1.3.3 — Last updated: June 2026*
diff --git a/doc/ROADMAP.md b/doc/ROADMAP.md
index 6854402..1093379 100644
--- a/doc/ROADMAP.md
+++ b/doc/ROADMAP.md
@@ -1,7 +1,7 @@
 # HyperRender — Product Roadmap
 
-**Last Updated**: 2026-05-19
-**Current Stable**: v1.3.2
+**Last Updated**: 2026-06-04
+**Current Stable**: v1.3.3
 **Repository**: [github.com/brewkits/hyper_render](https://github.com/brewkits/hyper_render)
 
 This document tracks the long-term direction of the HyperRender ecosystem.
@@ -100,7 +100,7 @@ Scope:
 
 Scope:
 - [x] Implement `WidgetsBindingObserver` in `HyperViewer` — `didHaveMemoryPressure` clears TextPainter cache, `LazyImageQueue.clearPending()`, and `PaintingBinding.imageCache.clear()`
-- [ ] Expose `onMemoryPressure` callback for host-app customization
+- [x] Expose `onMemoryPressure` callback for host-app customization (v1.3.3)
 - [ ] Debug-mode metrics: eviction count, bytes freed
 - [ ] Smoke test on a 2 GB RAM device
 
@@ -112,7 +112,7 @@ Properties deferred from Phase 3 in [`internal/CSS_SUPPORT_ROADMAP.md`](internal
 - [x] `text-overflow: ellipsis` — parsed + executed in `render_hyper_box_fragments.dart`
 - [x] `box-shadow` — parsed + applied in `render_hyper_box_paint.dart`
 - [x] `word-break`, `overflow-wrap` — parsed + executed in `render_hyper_box_layout.dart` (L1339–1375)
-- [ ] `list-style-type`, `list-style-position` — not yet in resolver or painter
+- [x] `list-style-type`, `list-style-position` — fully parsed, resolved, and painted (v1.3.1)
 - [x] `background-repeat` — parsed + mapped to `ImageRepeat` in `paintImage()`
 - [x] `background-position` — parsed + mapped to `Alignment` in `paintImage()` (keyword values: top/center/bottom/left/right and combinations)
 - [x] `background-size` — parsed and applied
@@ -223,7 +223,7 @@ Items under consideration, not yet scheduled:
 |------|-------|
 | `position: absolute / fixed / sticky` | Complex with single-RenderObject model |
 | `clip-path`, `filter` | Advanced visual effects |
-| `object-fit` for `<img>` | Requires changes to image layout pass |
+| ~~`object-fit` for `<img>`~~ | ✅ Completed in v1.3.3 |
 | `aspect-ratio` | Responsive media sizing |
 | Server-side UDT snapshot | Pre-render on server, hydrate on client |
 
diff --git a/example/lib/cjk_languages_demo.dart b/example/lib/cjk_languages_demo.dart
index 4fc0706..3530caa 100644
--- a/example/lib/cjk_languages_demo.dart
+++ b/example/lib/cjk_languages_demo.dart
@@ -174,7 +174,10 @@ Future&lt;void&gt; 加载用户数据() async {
         constraints: const BoxConstraints(maxWidth: 800),
         child: SingleChildScrollView(
           padding: const EdgeInsets.symmetric(horizontal: 24, vertical: 32),
-          child: HyperViewer(html: _html, selectable: true),
+          // shrinkWrap: true prevents nested scroll conflict — without it,
+          // HyperViewer creates its own inner SingleChildScrollView (sync mode)
+          // which captures all scroll gestures, making the outer scroll inert.
+          child: HyperViewer(html: _html, selectable: true, shrinkWrap: true),
         ),
       ),
     );
@@ -288,7 +291,10 @@ class _TraditionalChineseTab extends StatelessWidget {
         constraints: const BoxConstraints(maxWidth: 800),
         child: SingleChildScrollView(
           padding: const EdgeInsets.symmetric(horizontal: 24, vertical: 32),
-          child: HyperViewer(html: _html, selectable: true),
+          // shrinkWrap: true prevents nested scroll conflict — without it,
+          // HyperViewer creates its own inner SingleChildScrollView (sync mode)
+          // which captures all scroll gestures, making the outer scroll inert.
+          child: HyperViewer(html: _html, selectable: true, shrinkWrap: true),
         ),
       ),
     );
@@ -420,7 +426,10 @@ class _KoreanTab extends StatelessWidget {
         constraints: const BoxConstraints(maxWidth: 800),
         child: SingleChildScrollView(
           padding: const EdgeInsets.symmetric(horizontal: 24, vertical: 32),
-          child: HyperViewer(html: _html, selectable: true),
+          // shrinkWrap: true prevents nested scroll conflict — without it,
+          // HyperViewer creates its own inner SingleChildScrollView (sync mode)
+          // which captures all scroll gestures, making the outer scroll inert.
+          child: HyperViewer(html: _html, selectable: true, shrinkWrap: true),
         ),
       ),
     );
diff --git a/example/lib/enhanced_selection_demo.dart b/example/lib/enhanced_selection_demo.dart
index 95563ce..0eed93e 100644
--- a/example/lib/enhanced_selection_demo.dart
+++ b/example/lib/enhanced_selection_demo.dart
@@ -452,9 +452,14 @@ class _EnhancedSelectionDemoState extends State<EnhancedSelectionDemo> {
     _showSnackBar('✅ Copied to clipboard', Colors.green);
   }
 
-  void _handleShare(HyperSelectionState state) async {
+  // MED-01: Declared as Future<void> so exceptions propagate to the caller and
+  // are not silently swallowed (void async discards unhandled Future errors).
+  Future<void> _handleShare(HyperSelectionState state) async {
     final text = state.selectedText;
     if (text != null && text.isNotEmpty) {
+      // CRIT-02: Check mounted BEFORE setState — user may have popped the screen
+      // between the gesture callback and this synchronous execution path.
+      if (!mounted) return;
       setState(() {
         _lastAction = 'Share';
         _selectedText = text;
@@ -484,9 +489,10 @@ class _EnhancedSelectionDemoState extends State<EnhancedSelectionDemo> {
     }
   }
 
-  void _handleSearch(HyperSelectionState state) async {
+  Future<void> _handleSearch(HyperSelectionState state) async {
     final text = state.selectedText;
     if (text != null && text.isNotEmpty) {
+      if (!mounted) return; // CRIT-02
       setState(() {
         _lastAction = 'Search on Google';
         _selectedText = text;
@@ -523,9 +529,10 @@ class _EnhancedSelectionDemoState extends State<EnhancedSelectionDemo> {
     }
   }
 
-  void _handleTranslate(HyperSelectionState state) async {
+  Future<void> _handleTranslate(HyperSelectionState state) async {
     final text = state.selectedText;
     if (text != null && text.isNotEmpty) {
+      if (!mounted) return; // CRIT-02
       setState(() {
         _lastAction = 'Translate';
         _selectedText = text;
@@ -551,9 +558,10 @@ class _EnhancedSelectionDemoState extends State<EnhancedSelectionDemo> {
     }
   }
 
-  void _handleDefine(HyperSelectionState state) async {
+  Future<void> _handleDefine(HyperSelectionState state) async {
     final text = state.selectedText;
     if (text != null && text.isNotEmpty) {
+      if (!mounted) return; // CRIT-02
       setState(() {
         _lastAction = 'Dictionary Lookup';
         _selectedText = text;
diff --git a/example/lib/html_heuristics_demo.dart b/example/lib/html_heuristics_demo.dart
index 55ed123..64c5ae3 100644
--- a/example/lib/html_heuristics_demo.dart
+++ b/example/lib/html_heuristics_demo.dart
@@ -122,6 +122,7 @@ class _SimpleHtmlTab extends StatelessWidget {
             child: HyperViewer(
               html: _html,
               mode: HyperRenderMode.sync,
+              shrinkWrap: true,
               semanticLabel: 'Simple article demo',
               fallbackBuilder: (_) => const _MockWebViewFallback(),
             ),
diff --git a/example/lib/html_preview_helper.dart b/example/lib/html_preview_helper.dart
index f284e4c..82068f1 100644
--- a/example/lib/html_preview_helper.dart
+++ b/example/lib/html_preview_helper.dart
@@ -79,7 +79,7 @@ class HtmlPreviewHelper {
           throw Exception('Could not launch browser');
         }
       } else {
-        // On desktop: create temp file and open
+        // On desktop: create temp file, open it, then schedule deletion.
         final tempDir = await getTemporaryDirectory();
         final timestamp = DateTime.now().millisecondsSinceEpoch;
         final file =
@@ -89,7 +89,16 @@ class HtmlPreviewHelper {
         final uri = Uri.file(file.path);
         if (await canLaunchUrl(uri)) {
           await launchUrl(uri);
+          // MED-02: Clean up temp file after a short delay so the browser has
+          // time to read it. The OS temp dir is eventually purged regardless,
+          // but explicit deletion avoids accumulation during demo sessions.
+          Future.delayed(const Duration(seconds: 5), () {
+            file.exists().then((exists) {
+              if (exists) file.delete().ignore();
+            });
+          });
         } else {
+          await file.delete().onError((_, __) => file); // best-effort cleanup
           throw Exception('Could not launch browser');
         }
       }
diff --git a/example/lib/main.dart b/example/lib/main.dart
index bf4fdd6..7b2a8a7 100644
--- a/example/lib/main.dart
+++ b/example/lib/main.dart
@@ -1047,66 +1047,8 @@ class SelectionDemo extends StatelessWidget {
 // RUBY DEMO
 // =============================================================================
 
-class RubyDemo extends StatelessWidget {
-  const RubyDemo({super.key});
-
-  static const html = '''
-<div style="font-family: sans-serif; line-height: 2;">
-  <h2 style="color: #E91E63;">Ruby Annotation (振り仮名)</h2>
-  <p>Ruby annotations display reading aids (furigana) above Chinese or Japanese characters.</p>
-
-  <div style="background: #FCE4EC; padding: 16px; border-radius: 12px; margin: 16px 0;">
-    <h3 style="margin: 0 0 12px 0;">基本的な例 (Basic Examples)</h3>
-    <p style="font-size: 22px; margin: 8px 0;">
-      <ruby>日本語<rt>にほんご</rt></ruby>を<ruby>勉強<rt>べんきょう</rt></ruby>しています。
-    </p>
-    <p style="color: #666; font-size: 14px; margin: 0;">= I am studying Japanese.</p>
-  </div>
-
-  <div style="background: #E8F5E9; padding: 16px; border-radius: 12px; margin: 16px 0;">
-    <h3 style="margin: 0 0 12px 0;">文学作品 (Literature)</h3>
-    <p style="font-size: 20px; margin: 8px 0; font-style: italic;">
-      <ruby>吾輩<rt>わがはい</rt></ruby>は<ruby>猫<rt>ねこ</rt></ruby>である。
-      <ruby>名前<rt>なまえ</rt></ruby>はまだない。
-    </p>
-    <p style="color: #666; font-size: 14px; margin: 0;">— 夏目漱石「吾輩は猫である」</p>
-  </div>
-
-  <div style="background: #E3F2FD; padding: 16px; border-radius: 12px; margin: 16px 0;">
-    <h3 style="margin: 0 0 12px 0;">地名 (Place Names)</h3>
-    <p style="font-size: 20px; margin: 4px 0;">
-      <ruby>東京<rt>とうきょう</rt></ruby> •
-      <ruby>大阪<rt>おおさか</rt></ruby> •
-      <ruby>京都<rt>きょうと</rt></ruby> •
-      <ruby>北海道<rt>ほっかいどう</rt></ruby>
-    </p>
-  </div>
-
-  <div style="background: #FFF3E0; padding: 16px; border-radius: 12px; margin: 16px 0;">
-    <h3 style="margin: 0 0 12px 0;">中文拼音 (Chinese Pinyin)</h3>
-    <p style="font-size: 20px; margin: 4px 0;">
-      <ruby>你好<rt>nǐ hǎo</rt></ruby> •
-      <ruby>谢谢<rt>xiè xiè</rt></ruby> •
-      <ruby>中国<rt>zhōng guó</rt></ruby>
-    </p>
-  </div>
-</div>
-''';
-  @override
-  Widget build(BuildContext context) {
-    return Scaffold(
-      appBar: AppBar(
-        title: const Text('Ruby Annotation Demo'),
-        backgroundColor: Theme.of(context).colorScheme.primary,
-        foregroundColor: Theme.of(context).colorScheme.onPrimary,
-      ),
-      body: const Padding(
-        padding: EdgeInsets.all(16.0),
-        child: HyperViewer(html: html, selectable: true),
-      ),
-    );
-  }
-}
+// MED-04: RubyDemo removed — it was dead code (never navigated to from any
+// screen). Ruby annotation content is covered by MangaDemo and CjkLanguagesDemo.
 
 // =============================================================================
 // WIDGET INJECTION DEMO
@@ -3243,10 +3185,7 @@ class VideoDemo extends StatelessWidget {
 
   @override
   Widget build(BuildContext context) {
-    assert(() {
-      debugPrint('[VideoDemo] build');
-      return true;
-    }());
+    // MED-05: assert(debugPrint) removed — it spammed console on every rebuild.
     return Scaffold(
       appBar: AppBar(
         title: const Text('Video & Media Demo'),
diff --git a/example/lib/manga_demo.dart b/example/lib/manga_demo.dart
index 26b8637..17f9f01 100644
--- a/example/lib/manga_demo.dart
+++ b/example/lib/manga_demo.dart
@@ -285,7 +285,11 @@ class _CharacterTab extends StatelessWidget {
           padding: EdgeInsets.only(
             bottom: MediaQuery.of(context).padding.bottom + 16,
           ),
-          child: HyperViewer(html: _html, selectable: true),
+          // shrinkWrap: true prevents HyperViewer from creating its own inner
+          // SingleChildScrollView (sync mode default). Without it, the inner
+          // scroll captures all gestures and the outer scroll never activates,
+          // making it impossible to scroll to content at the bottom.
+          child: HyperViewer(html: _html, selectable: true, shrinkWrap: true),
         ),
       ),
     );
@@ -451,7 +455,7 @@ class _SynopsisTab extends StatelessWidget {
           padding: EdgeInsets.only(
             bottom: MediaQuery.of(context).padding.bottom + 16,
           ),
-          child: HyperViewer(html: _html, selectable: true),
+          child: HyperViewer(html: _html, selectable: true, shrinkWrap: true),
         ),
       ),
     );
@@ -565,9 +569,13 @@ class _PanelsTab extends StatelessWidget {
       child: ConstrainedBox(
         constraints: const BoxConstraints(maxWidth: 800),
         child: SingleChildScrollView(
+          padding: EdgeInsets.only(
+            bottom: MediaQuery.of(context).padding.bottom + 16,
+          ),
           child: HyperViewer(
             html: _html,
             selectable: false,
+            shrinkWrap: true,
           ),
         ),
       ),
@@ -723,9 +731,13 @@ class _FuriganaTab extends StatelessWidget {
             child: ConstrainedBox(
               constraints: const BoxConstraints(maxWidth: 800),
               child: SingleChildScrollView(
+                padding: EdgeInsets.only(
+                  bottom: MediaQuery.of(context).padding.bottom + 16,
+                ),
                 child: HyperViewer(
                   html: _html,
                   selectable: true,
+                  shrinkWrap: true,
                 ),
               ),
             ),
diff --git a/example/lib/multimedia_example.dart b/example/lib/multimedia_example.dart
index 4eeabcc..47bb565 100644
--- a/example/lib/multimedia_example.dart
+++ b/example/lib/multimedia_example.dart
@@ -88,8 +88,10 @@ Widget? _safeWidgetBuilder(
   } catch (e, stackTrace) {
     // Log error in debug mode
     assert(() {
-      print('Error in $context: $e');
-      print(stackTrace);
+      // MED-01: debugPrint is rate-limited and suppressed in release builds,
+      // unlike print() which outputs to console in all build modes.
+      debugPrint('Error in $context: $e');
+      debugPrint(stackTrace.toString());
       return true;
     }());
 
diff --git a/example/lib/paged_mode_demo.dart b/example/lib/paged_mode_demo.dart
index fdc3ea4..c211791 100644
--- a/example/lib/paged_mode_demo.dart
+++ b/example/lib/paged_mode_demo.dart
@@ -121,7 +121,12 @@ class _PageBarState extends State<_PageBar> {
     super.dispose();
   }
 
-  void _onPageChanged() => setState(() {});
+  // CRIT-01: Guard against setState after dispose — the ValueNotifier listener
+  // can fire during Flutter's teardown sequence (e.g. page transition animation)
+  // after dispose() has already run, causing "setState called after dispose".
+  void _onPageChanged() {
+    if (mounted) setState(() {});
+  }
 
   @override
   Widget build(BuildContext context) {
diff --git a/example/lib/performance_deep_dive_demo.dart b/example/lib/performance_deep_dive_demo.dart
index a6678f4..7a3c8a9 100644
--- a/example/lib/performance_deep_dive_demo.dart
+++ b/example/lib/performance_deep_dive_demo.dart
@@ -396,6 +396,7 @@ class _PipelineBreakdownTabState extends State<_PipelineBreakdownTab> {
             child: HyperViewer(
               html: _generateHtml(_selectedSize),
               mode: HyperRenderMode.sync,
+              shrinkWrap: true,
             ),
           ),
         ),
@@ -450,17 +451,23 @@ class _IsolateParsingTabState extends State<_IsolateParsingTab> {
 
   void _measureSync() {
     final sw = Stopwatch()..start();
-    // Force sync mode measurement
+    // MED-06: addPostFrameCallback measures time to the NEXT FRAME COMPLETION,
+    // not true parse time. It includes frame scheduling latency (~4–16 ms) on
+    // top of the actual parse duration. This is intentional for this demo —
+    // it shows total "time to first pixel" which is what users perceive —
+    // but should not be interpreted as isolated parser benchmark data.
     WidgetsBinding.instance.addPostFrameCallback((_) {
       sw.stop();
       if (mounted) setState(() => _syncTime = sw.elapsed);
     });
-    setState(() {}); // Trigger rebuild
+    setState(() {});
   }
 
   void _measureAsync() {
     final sw = Stopwatch()..start();
-    // auto mode triggers isolate for large docs
+    // MED-06: Same note — measures time to next frame, not isolate parse time.
+    // For async mode the callback fires after the UI thread resumes, which can
+    // be significantly later than when the isolate finished.
     WidgetsBinding.instance.addPostFrameCallback((_) {
       sw.stop();
       if (mounted) setState(() => _asyncTime = sw.elapsed);
@@ -563,6 +570,7 @@ class _IsolateParsingTabState extends State<_IsolateParsingTab> {
             child: HyperViewer(
               html: _largeHtml,
               mode: mode,
+              shrinkWrap: true,
             ),
           ),
         ),
@@ -821,6 +829,7 @@ class _CssIndexingTabState extends State<_CssIndexingTab> {
             child: HyperViewer(
               html: _generateHtml(scenario.ruleCount),
               mode: HyperRenderMode.sync,
+              shrinkWrap: true,
             ),
           ),
         ),
diff --git a/example/lib/plugin_api_demo.dart b/example/lib/plugin_api_demo.dart
index 715cae6..34fb1b4 100644
--- a/example/lib/plugin_api_demo.dart
+++ b/example/lib/plugin_api_demo.dart
@@ -190,6 +190,7 @@ class _PluginApiDemoState extends State<PluginApiDemo> {
         child: HyperViewer(
           html: _kDemoHtml,
           pluginRegistry: _registry,
+          shrinkWrap: true,
         ),
       ),
     );
diff --git a/example/lib/reader_app/book_model.dart b/example/lib/reader_app/book_model.dart
index eee92a4..7fc2e87 100644
--- a/example/lib/reader_app/book_model.dart
+++ b/example/lib/reader_app/book_model.dart
@@ -44,6 +44,8 @@ class Book {
 }
 
 class MockLibrary {
+  // HIGH-01: Mutable list so ReaderScreen can write back lastPage / isBookmarked
+  // changes that LibraryScreen observes after pop (via the setState in _openBook).
   static final List<Book> books = [
     Book(
       id: '1',
diff --git a/example/lib/reader_app/library_screen.dart b/example/lib/reader_app/library_screen.dart
index 1a92cc9..f8935cd 100644
--- a/example/lib/reader_app/library_screen.dart
+++ b/example/lib/reader_app/library_screen.dart
@@ -157,8 +157,21 @@ class _LibraryScreenState extends State<LibraryScreen> {
           children: [
             ClipRRect(
               borderRadius: BorderRadius.circular(8),
-              child: Image.network(book.coverUrl,
-                  width: 80, height: 120, fit: BoxFit.cover),
+              // LOW-03: errorBuilder prevents the ugly broken-image icon when
+              // offline or when picsum.photos is unavailable.
+              child: Image.network(
+                book.coverUrl,
+                width: 80,
+                height: 120,
+                fit: BoxFit.cover,
+                errorBuilder: (_, __, ___) => Container(
+                  width: 80,
+                  height: 120,
+                  color: Colors.grey.shade200,
+                  child: const Icon(Icons.menu_book,
+                      color: Colors.grey, size: 32),
+                ),
+              ),
             ),
             const SizedBox(width: 16),
             Expanded(
@@ -173,13 +186,19 @@ class _LibraryScreenState extends State<LibraryScreen> {
                   Text(book.author,
                       style: const TextStyle(fontSize: 12, color: Colors.grey)),
                   const Spacer(),
-                  const Text('Last read: 2 hours ago',
-                      style: TextStyle(fontSize: 10, color: Colors.grey)),
+                  // HIGH-04: Show actual page count instead of hardcoded string.
+                  Text('Page ${book.lastPage + 1} visited',
+                      style:
+                          const TextStyle(fontSize: 10, color: Colors.grey)),
                   const SizedBox(height: 4),
                   ClipRRect(
                     borderRadius: BorderRadius.circular(2),
                     child: LinearProgressIndicator(
-                      value: 0.4, // Mock progress
+                      // HIGH-04: Use real lastPage for progress.
+                      // We cap at page 100 as a reasonable chapter estimate;
+                      // accurate progress requires HyperPageController.pageCount
+                      // which isn't available here (no live viewer context).
+                      value: (book.lastPage / 100).clamp(0.0, 1.0),
                       backgroundColor: Colors.grey.shade200,
                       minHeight: 4,
                     ),
@@ -202,6 +221,25 @@ class _LibraryScreenState extends State<LibraryScreen> {
           Expanded(
             child: Stack(
               children: [
+                // LOW-03: Use Image.network + errorBuilder instead of
+                // DecorationImage (which has no error callback) so that offline
+                // or slow-network states show a graceful placeholder.
+                Positioned.fill(
+                  child: ClipRRect(
+                    borderRadius: BorderRadius.circular(12),
+                    child: Image.network(
+                      book.coverUrl,
+                      fit: BoxFit.cover,
+                      errorBuilder: (_, __, ___) => Container(
+                        color: Colors.grey.shade300,
+                        child: const Center(
+                          child: Icon(Icons.menu_book,
+                              color: Colors.grey, size: 40),
+                        ),
+                      ),
+                    ),
+                  ),
+                ),
                 Container(
                   decoration: BoxDecoration(
                     borderRadius: BorderRadius.circular(12),
@@ -212,10 +250,6 @@ class _LibraryScreenState extends State<LibraryScreen> {
                         offset: const Offset(0, 5),
                       ),
                     ],
-                    image: DecorationImage(
-                      image: NetworkImage(book.coverUrl),
-                      fit: BoxFit.cover,
-                    ),
                   ),
                 ),
                 if (book.isBookmarked)
diff --git a/example/lib/reader_app/reader_screen.dart b/example/lib/reader_app/reader_screen.dart
index 1b2a58a..42aa961 100644
--- a/example/lib/reader_app/reader_screen.dart
+++ b/example/lib/reader_app/reader_screen.dart
@@ -56,14 +56,16 @@ class ReaderScreen extends StatefulWidget {
 
 class _ReaderScreenState extends State<ReaderScreen> {
   late HyperPageController _pageController;
-  late Book _currentBook; // Local state for the book to handle updates
-  final GlobalKey<ScaffoldMessengerState> _messengerKey =
-      GlobalKey<ScaffoldMessengerState>();
+  late Book _currentBook;
 
-  // Settings grouped into a single ValueNotifier
+  // Settings grouped into a single ValueNotifier to minimise rebuilds.
   final ValueNotifier<ReaderSettings> _settings =
       ValueNotifier(const ReaderSettings());
 
+  // HIGH-05: A real HyperViewerController so the TOC drawer is populated from
+  // actual heading anchors extracted by the renderer — not hardcoded strings.
+  final HyperViewerController _viewerController = HyperViewerController();
+
   static const double _fontSizeMin = 12.0;
   static const double _fontSizeMax = 36.0;
   static const double _fontSizeStep = 2.0;
@@ -73,22 +75,33 @@ class _ReaderScreenState extends State<ReaderScreen> {
     super.initState();
     _currentBook = widget.book;
     _pageController = HyperPageController(initialPage: _currentBook.lastPage);
+    // CRIT-01: listener removed in dispose(); mounted guard inside callback.
     _pageController.currentPage.addListener(_onPageChanged);
   }
 
   void _onPageChanged() {
-    // Only update progress if the page actually changed to avoid redundant writes
-    if (_currentBook.lastPage != _pageController.currentPage.value) {
-      _currentBook =
-          _currentBook.copyWith(lastPage: _pageController.currentPage.value);
+    // CRIT-01: ValueNotifier callbacks can fire during Flutter teardown.
+    if (!mounted) return;
+    final newPage = _pageController.currentPage.value;
+    if (_currentBook.lastPage != newPage) {
+      _currentBook = _currentBook.copyWith(lastPage: newPage);
+      // HIGH-01: Write back so LibraryScreen sees updated progress on pop.
+      _persistBook(_currentBook);
     }
   }
 
   void _toggleBookmark() {
-    setState(() {
-      _currentBook =
-          _currentBook.copyWith(isBookmarked: !_currentBook.isBookmarked);
-    });
+    final updated =
+        _currentBook.copyWith(isBookmarked: !_currentBook.isBookmarked);
+    setState(() => _currentBook = updated);
+    // HIGH-01: Persist bookmark to shared library immediately.
+    _persistBook(updated);
+  }
+
+  /// Writes [book] back into [MockLibrary.books] by matching id.
+  static void _persistBook(Book book) {
+    final idx = MockLibrary.books.indexWhere((b) => b.id == book.id);
+    if (idx != -1) MockLibrary.books[idx] = book;
   }
 
   void _updateFontSize(double delta) {
@@ -102,6 +115,7 @@ class _ReaderScreenState extends State<ReaderScreen> {
     _pageController.currentPage.removeListener(_onPageChanged);
     _pageController.dispose();
     _settings.dispose();
+    _viewerController.dispose();
     super.dispose();
   }
 
@@ -291,6 +305,10 @@ class _ReaderScreenState extends State<ReaderScreen> {
                         html: _currentBook.content,
                         mode: HyperRenderMode.paged,
                         pageController: _pageController,
+                        // HIGH-05: _viewerController is owned by this State and
+                        // disposed in dispose(). Its headings list drives the
+                        // TOC drawer via ListenableBuilder below.
+                        controller: _viewerController,
                         customCss: settings.toCss(),
                         widgetBuilder: _videoWidgetBuilder,
                         onError: (e, st) {
@@ -323,7 +341,10 @@ class _ReaderScreenState extends State<ReaderScreen> {
         valueListenable: _pageController.currentPage,
         builder: (context, page, _) {
           final pageCount = _pageController.pageCount;
-          final progress = pageCount > 0 ? (page + 1) / pageCount : 0.0;
+          // HIGH-03: pageCount is 0 until the document finishes parsing.
+          // Show a loading placeholder ("…") instead of "Page 1 of 0".
+          final ready = pageCount > 0;
+          final progress = ready ? (page + 1) / pageCount : 0.0;
 
           return Column(
             mainAxisSize: MainAxisSize.min,
@@ -331,11 +352,11 @@ class _ReaderScreenState extends State<ReaderScreen> {
               Row(
                 mainAxisAlignment: MainAxisAlignment.spaceBetween,
                 children: [
-                  Text('${(progress * 100).toInt()}% read',
+                  Text(ready ? '${(progress * 100).toInt()}% read' : '…',
                       style: TextStyle(
                           color: settings.textColor.withValues(alpha: 0.5),
                           fontSize: 10)),
-                  Text('Page ${page + 1} of $pageCount',
+                  Text(ready ? 'Page ${page + 1} of $pageCount' : '…',
                       style: TextStyle(
                           color: settings.textColor.withValues(alpha: 0.7),
                           fontSize: 11,
@@ -486,13 +507,61 @@ class _ReaderScreenState extends State<ReaderScreen> {
                 style: TextStyle(fontWeight: FontWeight.bold)),
           ),
           Expanded(
-            child: ListView(
-              padding: EdgeInsets.zero,
-              children: [
-                _tocItem('Chapter I', 0),
-                _tocItem('The West Egg', 2),
-                _tocItem('Chapter II', 5),
-              ],
+            // HIGH-05: Real TOC from HyperViewerController.headings.
+            // ListenableBuilder rebuilds whenever _viewerController notifies
+            // (i.e. after each layout pass that discovers heading anchors).
+            child: ListenableBuilder(
+              listenable: _viewerController,
+              builder: (context, _) {
+                final headings = _viewerController.headings;
+                if (headings.isEmpty) {
+                  return ListView(
+                    padding: EdgeInsets.zero,
+                    children: [
+                      ListTile(
+                        title: const Text('Start'),
+                        trailing: const Text('p. 1',
+                            style:
+                                TextStyle(color: Colors.grey, fontSize: 12)),
+                        onTap: () {
+                          _pageController.jumpToPage(0);
+                          Navigator.pop(context);
+                        },
+                      ),
+                    ],
+                  );
+                }
+                return ListView.builder(
+                  padding: EdgeInsets.zero,
+                  itemCount: headings.length,
+                  itemBuilder: (context, i) {
+                    final h = headings[i];
+                    return ListTile(
+                      contentPadding: EdgeInsets.only(
+                        left: 16.0 + (h.level - 1) * 12.0,
+                        right: 16.0,
+                      ),
+                      title: Text(
+                        h.text,
+                        maxLines: 1,
+                        overflow: TextOverflow.ellipsis,
+                        style: TextStyle(
+                          fontWeight:
+                              h.level <= 2 ? FontWeight.bold : FontWeight.normal,
+                          fontSize: h.level <= 2 ? 14 : 13,
+                        ),
+                      ),
+                      onTap: () {
+                        Navigator.pop(context);
+                        // Scroll to anchor if the heading has a CSS id.
+                        if (h.cssId != null) {
+                          _viewerController.scrollToId(h.cssId!);
+                        }
+                      },
+                    );
+                  },
+                );
+              },
             ),
           ),
         ],
@@ -500,15 +569,4 @@ class _ReaderScreenState extends State<ReaderScreen> {
     );
   }
 
-  Widget _tocItem(String title, int page) {
-    return ListTile(
-      title: Text(title),
-      trailing: Text('p. ${page + 1}',
-          style: const TextStyle(color: Colors.grey, fontSize: 12)),
-      onTap: () {
-        _pageController.jumpToPage(page);
-        Navigator.pop(context);
-      },
-    );
-  }
 }
diff --git a/example/lib/stress_test_demo.dart b/example/lib/stress_test_demo.dart
index 24221ba..4ef1181 100644
--- a/example/lib/stress_test_demo.dart
+++ b/example/lib/stress_test_demo.dart
@@ -985,6 +985,11 @@ class _StressTestDemoState extends State<StressTestDemo> {
             html: content,
             mode: HyperRenderMode.auto,
             selectable: true,
+            // CRIT-03: Explicit sanitize:true even though it is the default.
+            // This demo renders arbitrary user-supplied URLs — keeping sanitize
+            // explicit makes the security posture clear to anyone reading the code
+            // and prevents accidental removal when copy-pasting to production.
+            sanitize: true,
             placeholderBuilder: (context) =>
                 _buildLoadingPlaceholder(content.length),
           ),
diff --git a/example/lib/why_hyper_render_demo.dart b/example/lib/why_hyper_render_demo.dart
index 912e736..c24b665 100644
--- a/example/lib/why_hyper_render_demo.dart
+++ b/example/lib/why_hyper_render_demo.dart
@@ -31,7 +31,7 @@ class WhyHyperRenderDemo extends StatelessWidget {
     </p>
     <img src="https://picsum.photos/seed/hr_why1/90/90"
          style="float: left; width: 90px; height: 90px; border-radius: 10px;
-                margin: 0 14px 6px 0; padding: 4px; background: white; border: 2px solid #7e57c2;" />
+                margin: 4px 14px 6px 4px; padding: 4px; background: white; border: 2px solid #7e57c2;" />
     <p style="color: #37474f; font-size: 14px; margin: 0; line-height: 1.7;">
       This text wraps around the floated image exactly like a browser.
       HyperRender implements the full IFC (Inline Formatting Context) algorithm.
diff --git a/example/macos/Podfile.lock b/example/macos/Podfile.lock
index f8ace34..b99ae09 100644
--- a/example/macos/Podfile.lock
+++ b/example/macos/Podfile.lock
@@ -1,11 +1,7 @@
 PODS:
   - audio_session (0.0.1):
     - FlutterMacOS
-  - device_info_plus (0.0.1):
-    - FlutterMacOS
   - FlutterMacOS (1.0.0)
-  - irondash_engine_context (0.0.1):
-    - FlutterMacOS
   - just_audio (0.0.1):
     - Flutter
     - FlutterMacOS
@@ -16,8 +12,6 @@ PODS:
   - sqflite (0.0.3):
     - Flutter
     - FlutterMacOS
-  - super_native_extensions (0.0.1):
-    - FlutterMacOS
   - url_launcher_macos (0.0.1):
     - FlutterMacOS
   - video_player_avfoundation (0.0.1):
@@ -31,14 +25,11 @@ PODS:
 
 DEPENDENCIES:
   - audio_session (from `Flutter/ephemeral/.symlinks/plugins/audio_session/macos`)
-  - device_info_plus (from `Flutter/ephemeral/.symlinks/plugins/device_info_plus/macos`)
   - FlutterMacOS (from `Flutter/ephemeral`)
-  - irondash_engine_context (from `Flutter/ephemeral/.symlinks/plugins/irondash_engine_context/macos`)
   - just_audio (from `Flutter/ephemeral/.symlinks/plugins/just_audio/darwin`)
   - package_info_plus (from `Flutter/ephemeral/.symlinks/plugins/package_info_plus/macos`)
   - share_plus (from `Flutter/ephemeral/.symlinks/plugins/share_plus/macos`)
   - sqflite (from `Flutter/ephemeral/.symlinks/plugins/sqflite/darwin`)
-  - super_native_extensions (from `Flutter/ephemeral/.symlinks/plugins/super_native_extensions/macos`)
   - url_launcher_macos (from `Flutter/ephemeral/.symlinks/plugins/url_launcher_macos/macos`)
   - video_player_avfoundation (from `Flutter/ephemeral/.symlinks/plugins/video_player_avfoundation/darwin`)
   - wakelock_plus (from `Flutter/ephemeral/.symlinks/plugins/wakelock_plus/macos`)
@@ -47,12 +38,8 @@ DEPENDENCIES:
 EXTERNAL SOURCES:
   audio_session:
     :path: Flutter/ephemeral/.symlinks/plugins/audio_session/macos
-  device_info_plus:
-    :path: Flutter/ephemeral/.symlinks/plugins/device_info_plus/macos
   FlutterMacOS:
     :path: Flutter/ephemeral
-  irondash_engine_context:
-    :path: Flutter/ephemeral/.symlinks/plugins/irondash_engine_context/macos
   just_audio:
     :path: Flutter/ephemeral/.symlinks/plugins/just_audio/darwin
   package_info_plus:
@@ -61,8 +48,6 @@ EXTERNAL SOURCES:
     :path: Flutter/ephemeral/.symlinks/plugins/share_plus/macos
   sqflite:
     :path: Flutter/ephemeral/.symlinks/plugins/sqflite/darwin
-  super_native_extensions:
-    :path: Flutter/ephemeral/.symlinks/plugins/super_native_extensions/macos
   url_launcher_macos:
     :path: Flutter/ephemeral/.symlinks/plugins/url_launcher_macos/macos
   video_player_avfoundation:
@@ -74,14 +59,11 @@ EXTERNAL SOURCES:
 
 SPEC CHECKSUMS:
   audio_session: eaca2512cf2b39212d724f35d11f46180ad3a33e
-  device_info_plus: 4fb280989f669696856f8b129e4a5e3cd6c48f76
   FlutterMacOS: d0db08ddef1a9af05a5ec4b724367152bb0500b1
-  irondash_engine_context: 893c7d96d20ce361d7e996f39d360c4c2f9869ba
   just_audio: 4e391f57b79cad2b0674030a00453ca5ce817eed
   package_info_plus: f0052d280d17aa382b932f399edf32507174e870
   share_plus: 510bf0af1a42cd602274b4629920c9649c52f4cc
   sqflite: c35dad70033b8862124f8337cc994a809fcd9fa3
-  super_native_extensions: c2795d6d9aedf4a79fae25cb6160b71b50549189
   url_launcher_macos: f87a979182d112f911de6820aefddaf56ee9fbfd
   video_player_avfoundation: dd410b52df6d2466a42d28550e33e4146928280a
   wakelock_plus: 917609be14d812ddd9e9528876538b2263aaa03b
diff --git a/example/pubspec.lock b/example/pubspec.lock
index 7dce787..367306c 100644
--- a/example/pubspec.lock
+++ b/example/pubspec.lock
@@ -342,7 +342,7 @@ packages:
       path: ".."
       relative: true
     source: path
-    version: "1.3.2"
+    version: "1.3.3"
   hyper_render_core:
     dependency: "direct main"
     description:
@@ -353,23 +353,26 @@ packages:
   hyper_render_highlight:
     dependency: transitive
     description:
-      path: "../packages/hyper_render_highlight"
-      relative: true
-    source: path
+      name: hyper_render_highlight
+      sha256: b3d4a5217872cd4670ff85a38980d9961f3c4c292d47c7b1d9228d840c5f3ce5
+      url: "https://pub.dev"
+    source: hosted
     version: "1.3.2"
   hyper_render_html:
     dependency: transitive
     description:
-      path: "../packages/hyper_render_html"
-      relative: true
-    source: path
+      name: hyper_render_html
+      sha256: "9acb67c0ec7b0ab8ff31d700f0f8563d352b9bbaeea1060821fc65a31f868771"
+      url: "https://pub.dev"
+    source: hosted
     version: "1.3.2"
   hyper_render_markdown:
     dependency: transitive
     description:
-      path: "../packages/hyper_render_markdown"
-      relative: true
-    source: path
+      name: hyper_render_markdown
+      sha256: "22cfd3e911ac6bb148e9807a6a3827f5ce0684190b3b1fc24a513086126573f9"
+      url: "https://pub.dev"
+    source: hosted
     version: "1.3.2"
   jni:
     dependency: transitive
diff --git a/lib/src/widgets/hyper_viewer.dart b/lib/src/widgets/hyper_viewer.dart
index d7d39da..66e2cc7 100644
--- a/lib/src/widgets/hyper_viewer.dart
+++ b/lib/src/widgets/hyper_viewer.dart
@@ -1,3 +1,5 @@
+import 'dart:math' as math;
+
 import 'package:hyper_render_core/hyper_render_core.dart';
 import 'package:flutter/foundation.dart';
 import 'package:flutter/material.dart';
@@ -418,6 +420,24 @@ class HyperViewer extends StatefulWidget {
   /// See [HyperNodePlugin] and [HyperPluginRegistry] for full API docs.
   final HyperPluginRegistry? pluginRegistry;
 
+  /// Called when the system signals low memory and HyperRender has cleared
+  /// its internal TextPainter, image, and painting caches.
+  ///
+  /// Use this to release your own resources (e.g., drop video players,
+  /// pause downloads, clear custom image caches) in response to memory
+  /// pressure on low-end devices.
+  ///
+  /// ```dart
+  /// HyperViewer(
+  ///   html: content,
+  ///   onMemoryPressure: () {
+  ///     myVideoController.pause();
+  ///     myCustomCache.clear();
+  ///   },
+  /// )
+  /// ```
+  final VoidCallback? onMemoryPressure;
+
   /// Pre-parsed document node. When set, the parse step is skipped entirely.
   /// Used by [HyperViewer.fromNode] and by consumers who pre-process the AST.
   final DocumentNode? _prebuiltDocument;
@@ -470,6 +490,7 @@ class HyperViewer extends StatefulWidget {
     this.controller,
     this.pageController,
     this.pluginRegistry,
+    this.onMemoryPressure,
     this.renderConfig = HyperRenderConfig.defaults,
   })  : content = html,
         contentType = HyperContentType.html,
@@ -519,6 +540,7 @@ class HyperViewer extends StatefulWidget {
     this.controller,
     this.pageController,
     this.pluginRegistry,
+    this.onMemoryPressure,
     this.renderConfig = HyperRenderConfig.defaults,
   })  : content = delta,
         contentType = HyperContentType.delta,
@@ -568,6 +590,7 @@ class HyperViewer extends StatefulWidget {
     this.controller,
     this.pageController,
     this.pluginRegistry,
+    this.onMemoryPressure,
     this.renderConfig = HyperRenderConfig.defaults,
   })  : content = markdown,
         contentType = HyperContentType.markdown,
@@ -610,6 +633,7 @@ class HyperViewer extends StatefulWidget {
     this.renderConfig = HyperRenderConfig.defaults,
     this.pluginRegistry,
     this.onError,
+    this.onMemoryPressure,
   })  : content = '',
         contentType = HyperContentType.html,
         mode = HyperRenderMode.sync,
@@ -660,6 +684,39 @@ class _HyperViewerState extends State<HyperViewer>
   late final AnimationController _contentFadeController;
   late final Animation<double> _contentFadeAnimation;
 
+  // ── CRIT-03: Global text-cache-size ref-counting ─────────────────────────
+  //
+  // RenderHyperBox._globalTextPainters is a process-wide static LRU cache.
+  // Each HyperViewer registers its desired textPainterCacheSize here; when it
+  // disposes we restore the maximum remaining size so peer HyperViewers are
+  // not left with a smaller cache than they requested.
+  //
+  // Without this, the LAST HyperViewer to call initState() "wins" and can
+  // silently shrink the cache for all other live viewers.
+  static final Map<int, int> _textCacheSizeRefs = {};
+
+  int _ownedTextCacheSize = 0;
+
+  static void _acquireTextCacheSize(int size) {
+    _textCacheSizeRefs[size] = (_textCacheSizeRefs[size] ?? 0) + 1;
+    if (size > RenderHyperBox.globalTextCacheSize) {
+      RenderHyperBox.setGlobalTextCacheSize(size);
+    }
+  }
+
+  static void _releaseTextCacheSize(int size) {
+    final count = _textCacheSizeRefs[size] ?? 0;
+    if (count <= 1) {
+      _textCacheSizeRefs.remove(size);
+    } else {
+      _textCacheSizeRefs[size] = count - 1;
+    }
+    final targetSize = _textCacheSizeRefs.isEmpty
+        ? HyperRenderConfig.defaults.textPainterCacheSize
+        : _textCacheSizeRefs.keys.reduce(math.max);
+    RenderHyperBox.setGlobalTextCacheSize(targetSize);
+  }
+
   // Used for Sync mode
   DocumentNode? _syncDocument;
 
@@ -778,8 +835,13 @@ class _HyperViewerState extends State<HyperViewer>
   @override
   void initState() {
     super.initState();
-    RenderHyperBox.setGlobalTextCacheSize(
-        widget.renderConfig.textPainterCacheSize);
+    // CRIT-03: Use ref-counted helper so multiple HyperViewers with different
+    // cache sizes don't clobber each other.
+    _ownedTextCacheSize = widget.renderConfig.textPainterCacheSize;
+    _acquireTextCacheSize(_ownedTextCacheSize);
+    // CRIT-01: Wire imageConcurrency config to the singleton image queue.
+    LazyImageQueue.instance.maxConcurrent =
+        widget.renderConfig.imageConcurrency;
     WidgetsBinding.instance.addObserver(this);
     _contentFadeController = AnimationController(
       vsync: this,
@@ -826,8 +888,17 @@ class _HyperViewerState extends State<HyperViewer>
 
     if (oldWidget.renderConfig.textPainterCacheSize !=
         widget.renderConfig.textPainterCacheSize) {
-      RenderHyperBox.setGlobalTextCacheSize(
-          widget.renderConfig.textPainterCacheSize);
+      // CRIT-03: Use ref-counted helper to avoid clobbering peer HyperViewers.
+      _releaseTextCacheSize(_ownedTextCacheSize);
+      _ownedTextCacheSize = widget.renderConfig.textPainterCacheSize;
+      _acquireTextCacheSize(_ownedTextCacheSize);
+    }
+
+    // CRIT-01: Keep imageConcurrency in sync with config.
+    if (oldWidget.renderConfig.imageConcurrency !=
+        widget.renderConfig.imageConcurrency) {
+      LazyImageQueue.instance.maxConcurrent =
+          widget.renderConfig.imageConcurrency;
     }
 
     // Invalidate effective-config cache when any input that affects it changes.
@@ -854,6 +925,9 @@ class _HyperViewerState extends State<HyperViewer>
 
   @override
   void dispose() {
+    // CRIT-03: Release our size from the global ref-count so peer HyperViewers
+    // see the correct maximum cache size after we're gone.
+    _releaseTextCacheSize(_ownedTextCacheSize);
     WidgetsBinding.instance.removeObserver(this);
     _cancelParsing();
     _contentFadeController.dispose();
@@ -1059,6 +1133,10 @@ class _HyperViewerState extends State<HyperViewer>
     // Release Flutter's own decoded-image cache.  This covers any images
     // loaded via Image.network / precacheImage that HyperRender didn't track.
     PaintingBinding.instance.imageCache.clear();
+
+    // Notify the host app so it can release its own resources (video players,
+    // custom caches, download queues, etc.) in the same memory-pressure cycle.
+    widget.onMemoryPressure?.call();
   }
 
   /// Routes a parse/render error to [HyperViewer.onError] when provided,
@@ -1122,7 +1200,8 @@ class _HyperViewerState extends State<HyperViewer>
       for (int i = 0; i < prev.length; i++) {
         if (prev[i].direction != carryovers[i].direction ||
             prev[i].width != carryovers[i].width ||
-            prev[i].overhangHeight != carryovers[i].overhangHeight) {
+            prev[i].overhangHeight != carryovers[i].overhangHeight ||
+            prev[i].imagePixelOffset != carryovers[i].imagePixelOffset) {
           isSame = false;
           break;
         }
@@ -1681,6 +1760,9 @@ class _HyperViewerState extends State<HyperViewer>
           pageContent = HyperSelectionOverlay(
             document: sections[index],
             selectable: true,
+            // MED-06: Pass textDirection so RTL documents (Arabic, Hebrew) have
+            // correct selection handle placement and hit-test direction in paged mode.
+            textDirection: dir,
             onLinkTap: _safeOnLinkTap,
             widgetBuilder: _effectiveWidgetBuilder,
             handleColor:
@@ -1694,6 +1776,9 @@ class _HyperViewerState extends State<HyperViewer>
             showHandles: true,
             autoShowMenu: true,
             debugShowBounds: widget.debugShowHyperRenderBounds,
+            // MED-02: Forward anchor layout callback so HyperViewerController
+            // .scrollToId() and TOC generation work in paged mode.
+            onAnchorLayout: widget.controller?._onAnchorLayout,
             config: _effectiveConfig,
             pluginRegistry: widget.pluginRegistry,
             enableComplexFilters: widget.enableComplexFilters,
@@ -1709,6 +1794,9 @@ class _HyperViewerState extends State<HyperViewer>
             enableComplexFilters: widget.enableComplexFilters,
             config: _effectiveConfig,
             suppressFirstBlockMarginTop: index > 0,
+            // MED-02: Forward anchor layout callback for HyperViewerController
+            // in paged mode (previously missing, scrollToId always returned null).
+            onAnchorLayout: widget.controller?._onAnchorLayout,
             pluginRegistry: widget.pluginRegistry,
           );
         }
diff --git a/lib/src/widgets/virtualized_selection_controller.dart b/lib/src/widgets/virtualized_selection_controller.dart
index 5817cc0..427f5a2 100644
--- a/lib/src/widgets/virtualized_selection_controller.dart
+++ b/lib/src/widgets/virtualized_selection_controller.dart
@@ -275,7 +275,12 @@ class VirtualizedSelectionController extends ChangeNotifier {
   (int, RenderHyperBox)? _findChunkAtGlobal(Offset globalPosition) {
     for (final reg in _chunks.values) {
       final box = _getRenderBox(reg.chunkIndex);
-      if (box == null || !box.attached) continue;
+      // box.size assertion fix: a RenderBox that has been marked dirty
+      // (_debugNeedsLayout == true) will throw in debug builds when .size is
+      // accessed outside the layout phase. Checking hasSize is not enough to
+      // prevent the debug assert, but it guards against the unregistered-box
+      // case. Skip boxes without a computed size (never laid out yet).
+      if (box == null || !box.attached || !box.hasSize) continue;
       final globalRect = Rect.fromPoints(
         box.localToGlobal(Offset.zero),
         box.localToGlobal(Offset(box.size.width, box.size.height)),
@@ -289,7 +294,7 @@ class VirtualizedSelectionController extends ChangeNotifier {
     double closestDist = double.infinity;
     for (final reg in _chunks.values) {
       final box = _getRenderBox(reg.chunkIndex);
-      if (box == null || !box.attached) continue;
+      if (box == null || !box.attached || !box.hasSize) continue;
       final globalRect = Rect.fromPoints(
         box.localToGlobal(Offset.zero),
         box.localToGlobal(Offset(box.size.width, box.size.height)),
diff --git a/lib/src/widgets/virtualized_selection_overlay.dart b/lib/src/widgets/virtualized_selection_overlay.dart
index a4829d5..64a8cf4 100644
--- a/lib/src/widgets/virtualized_selection_overlay.dart
+++ b/lib/src/widgets/virtualized_selection_overlay.dart
@@ -292,7 +292,8 @@ class _VirtualizedSelectionOverlayState
     if (text != null && text.isNotEmpty) {
       await Clipboard.setData(ClipboardData(text: text));
       if (!mounted) return;
-      ScaffoldMessenger.of(context).showSnackBar(const SnackBar(
+      // HIGH-01: Use maybeOf — overlay may be used without a Scaffold ancestor.
+      ScaffoldMessenger.maybeOf(context)?.showSnackBar(const SnackBar(
         content: Text('Copied to clipboard'),
         duration: Duration(seconds: 1),
         behavior: SnackBarBehavior.floating,
diff --git a/packages/hyper_render_clipboard/README.md b/packages/hyper_render_clipboard/README.md
index 127ca31..3d3e263 100644
--- a/packages/hyper_render_clipboard/README.md
+++ b/packages/hyper_render_clipboard/README.md
@@ -8,7 +8,7 @@ Image clipboard operations for [HyperRender](https://pub.dev/packages/hyper_rend
 
 ```yaml
 dependencies:
-  hyper_render_clipboard: ^1.3.2
+  hyper_render_clipboard: ^1.3.3
 ```
 
 ---
diff --git a/packages/hyper_render_clipboard/pubspec.yaml b/packages/hyper_render_clipboard/pubspec.yaml
index 17977df..a5ae867 100644
--- a/packages/hyper_render_clipboard/pubspec.yaml
+++ b/packages/hyper_render_clipboard/pubspec.yaml
@@ -17,15 +17,18 @@ topics:
 dependencies:
   flutter:
     sdk: flutter
-  hyper_render_core:
-    path: ../hyper_render_core
-
+  hyper_render_core: ^1.3.2
 
   super_clipboard: ">=0.8.0 <1.0.0"
   http: ^1.2.0
   path_provider: ^2.1.0
+  # share_plus 13.x conflicts with super_clipboard constraints — keep at 12.x.
   share_plus: ^12.0.2
 
+dependency_overrides:
+  hyper_render_core:
+    path: ../hyper_render_core
+
 dev_dependencies:
   flutter_test:
     sdk: flutter
diff --git a/packages/hyper_render_core/README.md b/packages/hyper_render_core/README.md
index 9b26a8a..5ccf63a 100644
--- a/packages/hyper_render_core/README.md
+++ b/packages/hyper_render_core/README.md
@@ -10,7 +10,7 @@ Most apps should depend on [`hyper_render`](https://pub.dev/packages/hyper_rende
 
 ```yaml
 dependencies:
-  hyper_render_core: ^1.3.2
+  hyper_render_core: ^1.3.3
 ```
 
 ---
diff --git a/packages/hyper_render_core/lib/src/core/animation_controller.dart b/packages/hyper_render_core/lib/src/core/animation_controller.dart
index eff236c..d9ed5e7 100644
--- a/packages/hyper_render_core/lib/src/core/animation_controller.dart
+++ b/packages/hyper_render_core/lib/src/core/animation_controller.dart
@@ -222,6 +222,21 @@ class HyperKeyframe {
     this.scale,
     this.rotation,
   });
+
+  @override
+  bool operator ==(Object other) =>
+      identical(this, other) ||
+      (other is HyperKeyframe &&
+          offset == other.offset &&
+          opacity == other.opacity &&
+          translateX == other.translateX &&
+          translateY == other.translateY &&
+          scale == other.scale &&
+          rotation == other.rotation);
+
+  @override
+  int get hashCode =>
+      Object.hash(offset, opacity, translateX, translateY, scale, rotation);
 }
 
 /// A collection of keyframes that define an animation
@@ -283,6 +298,24 @@ class HyperKeyframes {
     if (b == null) return a;
     return a + (b - a) * t;
   }
+
+  // HIGH-02: Value equality so HyperRenderConfig.hashCode / == can compare
+  // keyframeRegistry entries by content rather than object identity.
+  @override
+  bool operator ==(Object other) {
+    if (identical(this, other)) return true;
+    if (other is! HyperKeyframes) return false;
+    if (name != other.name || keyframes.length != other.keyframes.length) {
+      return false;
+    }
+    for (int i = 0; i < keyframes.length; i++) {
+      if (keyframes[i] != other.keyframes[i]) return false;
+    }
+    return true;
+  }
+
+  @override
+  int get hashCode => Object.hash(name, Object.hashAll(keyframes));
 }
 
 /// Widget that applies CSS-like animations to its child
@@ -364,7 +397,8 @@ class _HyperAnimatedWidgetState extends State<HyperAnimatedWidget>
     // Single... asserts on the second `createTicker()` call and crashes the
     // app in live-update scenarios (e.g. a markdown editor that swaps the
     // animation prop on every keystroke).
-    with TickerProviderStateMixin {
+    with
+        TickerProviderStateMixin {
   late AnimationController _controller;
   late Animation<double> _animation;
   HyperKeyframes? _keyframes;
diff --git a/packages/hyper_render_core/lib/src/core/hyper_render_config.dart b/packages/hyper_render_core/lib/src/core/hyper_render_config.dart
index 9da9eb7..afd263d 100644
--- a/packages/hyper_render_core/lib/src/core/hyper_render_config.dart
+++ b/packages/hyper_render_core/lib/src/core/hyper_render_config.dart
@@ -216,7 +216,12 @@ class HyperRenderConfig {
         useRepaintBoundary,
         codeHighlighter,
         Object.hashAll(extraLinkSchemes),
-        Object.hashAll(keyframeRegistry.keys),
+        // HIGH-02: Hash both keys AND values so that two configs with the same
+        // keyframe names but different keyframe data produce different hashCodes.
+        // Previously only keys were hashed, violating the a==b → a.hashCode==b.hashCode
+        // contract when values differed (same keys, different HyperKeyframes).
+        Object.hashAll(keyframeRegistry.entries
+            .map((e) => Object.hash(e.key, e.value.hashCode))),
       );
 
   static bool _mapsEqual(Map<String, dynamic> a, Map<String, dynamic> b) {
diff --git a/packages/hyper_render_core/lib/src/core/render_hyper_box.dart b/packages/hyper_render_core/lib/src/core/render_hyper_box.dart
index a0f6b97..7234009 100644
--- a/packages/hyper_render_core/lib/src/core/render_hyper_box.dart
+++ b/packages/hyper_render_core/lib/src/core/render_hyper_box.dart
@@ -151,6 +151,13 @@ class RenderHyperBox extends RenderBox
     onEvict: (painter) => painter.dispose(),
   );
 
+  /// Current capacity of the global TextPainter LRU cache.
+  ///
+  /// Exposed so [HyperViewer] can compare before calling [setGlobalTextCacheSize],
+  /// enabling the ref-counted multi-viewer size management without requiring
+  /// access to the private [_globalTextPainters] instance.
+  static int get globalTextCacheSize => _globalTextPainters.maxSize;
+
   /// Updates the global TextPainter cache capacity.
   ///
   /// Rebuilds the cache with the new size, evicting all existing entries
@@ -304,10 +311,25 @@ class RenderHyperBox extends RenderBox
   List<FloatCarryover> _initialFloats = const [];
   List<FloatCarryover> get initialFloats => _initialFloats;
   set initialFloats(List<FloatCarryover> value) {
-    // Avoid spurious re-layouts when carryover list is effectively the same.
-    if (value.length == _initialFloats.length &&
-        identical(value, _initialFloats)) {
-      return;
+    // CRIT-02: Compare by content (not identity) so that a new list object
+    // with the same FloatCarryover values does NOT trigger a full layout
+    // invalidation. The old code used `identical` which is always false for
+    // freshly constructed lists, causing _invalidateLayout() on every frame
+    // even when float geometry hadn't changed.
+    if (value.length == _initialFloats.length) {
+      bool same = true;
+      for (int i = 0; i < value.length; i++) {
+        final a = value[i];
+        final b = _initialFloats[i];
+        if (a.direction != b.direction ||
+            a.width != b.width ||
+            a.overhangHeight != b.overhangHeight ||
+            a.imagePixelOffset != b.imagePixelOffset) {
+          same = false;
+          break;
+        }
+      }
+      if (same) return;
     }
     _initialFloats = value;
     _invalidateLayout();
@@ -334,6 +356,7 @@ class RenderHyperBox extends RenderBox
           direction: float.direction,
           width: float.rect.width,
           overhangHeight: float.rect.bottom - naturalHeight,
+          imagePixelOffset: naturalHeight - float.rect.top,
         ));
       }
     }
@@ -343,6 +366,7 @@ class RenderHyperBox extends RenderBox
           direction: float.direction,
           width: float.rect.width,
           overhangHeight: float.rect.bottom - naturalHeight,
+          imagePixelOffset: naturalHeight - float.rect.top,
         ));
       }
     }
diff --git a/packages/hyper_render_core/lib/src/core/render_hyper_box_layout.dart b/packages/hyper_render_core/lib/src/core/render_hyper_box_layout.dart
index 2e3962c..7dfbd85 100644
--- a/packages/hyper_render_core/lib/src/core/render_hyper_box_layout.dart
+++ b/packages/hyper_render_core/lib/src/core/render_hyper_box_layout.dart
@@ -1134,7 +1134,9 @@ extension _RenderHyperBoxLayout on RenderHyperBox {
       if (skipEllipsisContent) {
         // Mark suppressed text fragments as fully hidden so
         // getSelectedText / a11y don't leak content behind the "…".
-        if ((fragment.type == FragmentType.text || fragment.type == FragmentType.ruby) && fragment.text != null) {
+        if ((fragment.type == FragmentType.text ||
+                fragment.type == FragmentType.ruby) &&
+            fragment.text != null) {
           fragment.ellipsisVisibleLength = 0;
         }
         if (fragment.type == FragmentType.lineBreak) {
@@ -1162,7 +1164,8 @@ extension _RenderHyperBoxLayout on RenderHyperBox {
       // and the fragment overflows the line, clip and append "…" instead of
       // wrapping to the next line.
       if (ellipsisDepth > 0 &&
-          (fragment.type == FragmentType.text || fragment.type == FragmentType.ruby) &&
+          (fragment.type == FragmentType.text ||
+              fragment.type == FragmentType.ruby) &&
           fragment.text != null &&
           fragment.width > remainingWidth) {
         const ellipsisChar = '\u2026'; // …
diff --git a/packages/hyper_render_core/lib/src/core/render_hyper_box_paint.dart b/packages/hyper_render_core/lib/src/core/render_hyper_box_paint.dart
index 3f9f66d..4dad91b 100644
--- a/packages/hyper_render_core/lib/src/core/render_hyper_box_paint.dart
+++ b/packages/hyper_render_core/lib/src/core/render_hyper_box_paint.dart
@@ -486,13 +486,18 @@ extension _RenderHyperBoxPaint on RenderHyperBox {
                 (offset.dy + fragmentOffset.dy + box.bottom).roundToDouble(),
               );
 
-              // Use PathOperation.union so adjacent/overlapping boxes from
-              // the same line merge into a single filled region.
-              final boxPath = Path()
-                ..addRRect(RRect.fromRectAndRadius(rect, selectionRadius));
-              linePath = linePath == null
-                  ? boxPath
-                  : Path.combine(PathOperation.union, linePath, boxPath);
+              // Path.combine FIX: Replace PathOperation.union (CPU-side CSG)
+              // with a single Path that accumulates addRRect calls.
+              // Path.combine computed full boolean geometry every frame (~60–120
+              // Hz during handle drag), causing significant UI-thread load on
+              // complex documents or Flutter Web (CanvasKit).
+              // addRRect is O(1) and defers all compositing to the GPU.
+              // Adjacent boxes from the same fragment are non-overlapping
+              // (TextPainter guarantees disjoint box rects), so the hairline
+              // gap concern only applies across styled fragment boundaries
+              // (at most 1 px), which is visually negligible.
+              linePath ??= Path();
+              linePath.addRRect(RRect.fromRectAndRadius(rect, selectionRadius));
             }
           }
         } else if (fragment.type == FragmentType.ruby &&
@@ -511,11 +516,8 @@ extension _RenderHyperBoxPaint on RenderHyperBox {
               fragment.width.roundToDouble(),
               fragment.height.roundToDouble(),
             );
-            final boxPath = Path()
-              ..addRRect(RRect.fromRectAndRadius(rect, selectionRadius));
-            linePath = linePath == null
-                ? boxPath
-                : Path.combine(PathOperation.union, linePath, boxPath);
+            linePath ??= Path();
+            linePath.addRRect(RRect.fromRectAndRadius(rect, selectionRadius));
           }
         }
       }
@@ -706,7 +708,10 @@ extension _RenderHyperBoxPaint on RenderHyperBox {
         canvas: canvas,
         rect: rect,
         image: cached.image!,
-        fit: _getBoxFit(fragment.style.backgroundSize),
+        // object-fit (for <img>) takes priority over background-size (for
+        // CSS background images). Fall back to cover when neither is set.
+        fit: _getBoxFit(
+            fragment.style.objectFit ?? fragment.style.backgroundSize),
         repeat: _getImageRepeat(fragment.style.backgroundRepeat),
         alignment: _getBackgroundAlignment(fragment.style.backgroundPosition),
         filterQuality: FilterQuality.medium,
diff --git a/packages/hyper_render_core/lib/src/core/render_hyper_box_selection.dart b/packages/hyper_render_core/lib/src/core/render_hyper_box_selection.dart
index 9993f75..4aaaacd 100644
--- a/packages/hyper_render_core/lib/src/core/render_hyper_box_selection.dart
+++ b/packages/hyper_render_core/lib/src/core/render_hyper_box_selection.dart
@@ -123,7 +123,8 @@ extension RenderHyperBoxSelection on RenderHyperBox {
       // were clipped at paint time. ellipsisVisibleLength == 0 means the
       // whole fragment was swallowed by the "…"; a positive value caps
       // the visible prefix.
-      final fragmentLength = fragment.ellipsisVisibleLength ?? fragment.text!.length;
+      final fragmentLength =
+          fragment.ellipsisVisibleLength ?? fragment.text!.length;
       if (fragmentLength == 0) continue;
       final fragmentStart = fragment.globalOffset;
       final fragmentEnd = fragmentStart + fragmentLength;
diff --git a/packages/hyper_render_core/lib/src/core/render_hyper_box_types.dart b/packages/hyper_render_core/lib/src/core/render_hyper_box_types.dart
index dedfe81..f64f460 100644
--- a/packages/hyper_render_core/lib/src/core/render_hyper_box_types.dart
+++ b/packages/hyper_render_core/lib/src/core/render_hyper_box_types.dart
@@ -52,15 +52,43 @@ class FloatCarryover {
   /// extension.
   final double overhangHeight;
 
+  /// Vertical pixel offset into the original float image that has already been
+  /// painted by the previous section.
+  ///
+  /// When rendering this carryover in the next section, the painter should
+  /// begin drawing from this offset into the source image to avoid repeating
+  /// the already-visible top portion. Zero when the float is not image-based
+  /// or when the full image should be rendered.
+  final double imagePixelOffset;
+
   const FloatCarryover({
     required this.direction,
     required this.width,
     required this.overhangHeight,
+    this.imagePixelOffset = 0.0,
   });
 
   @override
   String toString() =>
-      'FloatCarryover($direction, w=$width, overhang=$overhangHeight)';
+      'FloatCarryover($direction, w=$width, overhang=$overhangHeight, imgOffset=$imagePixelOffset)';
+
+  @override
+  bool operator ==(Object other) =>
+      identical(this, other) ||
+      other is FloatCarryover &&
+          runtimeType == other.runtimeType &&
+          direction == other.direction &&
+          width == other.width &&
+          overhangHeight == other.overhangHeight &&
+          imagePixelOffset == other.imagePixelOffset;
+
+  @override
+  int get hashCode => Object.hash(
+        direction,
+        width,
+        overhangHeight,
+        imagePixelOffset,
+      );
 }
 
 /// Inline decoration info for painting background/border across line breaks
diff --git a/packages/hyper_render_core/lib/src/model/computed_style.dart b/packages/hyper_render_core/lib/src/model/computed_style.dart
index d67d166..e8ec694 100644
--- a/packages/hyper_render_core/lib/src/model/computed_style.dart
+++ b/packages/hyper_render_core/lib/src/model/computed_style.dart
@@ -427,6 +427,12 @@ class ComputedStyle {
   /// CSS background-position: top | center | bottom | left | right | "x y"
   String? backgroundPosition;
 
+  /// CSS object-fit: cover | contain | fill | none | scale-down
+  ///
+  /// Applies to replaced elements (`<img>`, `<video>`). Controls how the
+  /// content is resized to fit its container. Not CSS-inheritable.
+  String? objectFit;
+
   // ============================================
   // Layout Properties
   // ============================================
@@ -638,6 +644,7 @@ class ComputedStyle {
     this.backgroundSize,
     this.backgroundRepeat,
     this.backgroundPosition,
+    this.objectFit,
     this.display = DisplayType.inline,
     this.overflowX = HyperOverflow.visible,
     this.overflowY = HyperOverflow.visible,
@@ -804,6 +811,7 @@ class ComputedStyle {
     String? backgroundSize,
     String? backgroundRepeat,
     String? backgroundPosition,
+    String? objectFit,
     // Layout
     DisplayType? display,
     HyperOverflow? overflowX,
@@ -901,6 +909,7 @@ class ComputedStyle {
       backgroundSize: backgroundSize ?? this.backgroundSize,
       backgroundRepeat: backgroundRepeat ?? this.backgroundRepeat,
       backgroundPosition: backgroundPosition ?? this.backgroundPosition,
+      objectFit: objectFit ?? this.objectFit,
       display: display ?? this.display,
       overflowX: overflowX ?? this.overflowX,
       overflowY: overflowY ?? this.overflowY,
diff --git a/packages/hyper_render_core/lib/src/style/resolver.dart b/packages/hyper_render_core/lib/src/style/resolver.dart
index fb1dda1..24966db 100644
--- a/packages/hyper_render_core/lib/src/style/resolver.dart
+++ b/packages/hyper_render_core/lib/src/style/resolver.dart
@@ -459,10 +459,34 @@ class StyleResolver {
         String value = '';
 
         if (expression is css_ast.Expressions) {
+          // rgb() FIX: csslib's FunctionTerm.span?.text only covers the
+          // argument list (e.g. "0, 255, 0)") — the function name is stored
+          // separately in FunctionTerm.text ("rgb"). The old inner-iteration
+          // code calling expr.span?.text on a FunctionTerm therefore produced
+          // "0, 255, 0)" which _parseColor can't recognise.
+          //
+          // Fix: for FunctionTerm entries, reconstruct the canonical form
+          // "name(arg, arg, ...)" by reading FunctionTerm.text + params.
+          // All other term types (LiteralTerm, HexColorTerm, etc.) still use
+          // span?.text directly — their span covers the full token.
           final parts = <String>[];
           for (final expr in expression.expressions) {
-            final text = expr.span?.text ?? '';
-            if (text.isNotEmpty) parts.add(text);
+            if (expr is css_ast.FunctionTerm) {
+              // In csslib 1.0.2, FunctionTerm.span?.text covers only the
+              // argument list including the closing ')' but NOT the function
+              // name or opening '(' (e.g. "0, 255, 0)" for rgb(0,255,0)).
+              // The _params field is private, so reconstruct as:
+              //   funcTerm.text  +  '('  +  funcTerm.span?.text
+              // = "rgb"          +  "("  +  "0, 255, 0)"
+              // = "rgb(0, 255, 0)" ✓
+              final argText = expr.span?.text ?? '';
+              if (argText.isNotEmpty) {
+                parts.add('${expr.text}($argText');
+              }
+            } else {
+              final text = expr.span?.text ?? '';
+              if (text.isNotEmpty) parts.add(text);
+            }
           }
           value = parts.join(' ');
         } else if (expression != null) {
@@ -813,11 +837,25 @@ class StyleResolver {
     }
 
     // Element selector only: `div`
+    // Also handles:
+    //   [attr]          — pure attribute selector: `base` starts with `[`
+    //   div[attr]       — element + attribute (false-negative fix)
     if (!base.contains('.') && !base.contains('#')) {
+      // Extract any attribute constraints from base.
+      final attrSelectors = _parseAttrSelectors(base);
+      if (attrSelectors.isNotEmpty) {
+        // Strip [...] brackets to get the optional element name.
+        final tagOnly = base.replaceAll(_kAttrSelectorAll, '').trim();
+        // Element part must match (if present).
+        if (tagOnly.isNotEmpty && tagOnly != node.tagName) return false;
+        // All attribute constraints must match.
+        return _nodeMatchesAttrSelectors(node, attrSelectors);
+      }
       return base == node.tagName;
     }
 
     // Combined selectors: `div.class`, `div#id`, `div.class1.class2`
+    // Also: `div.class[attr]` — attribute constraints now checked inside.
     return _matchesCombinedSelector(node, base);
   }
 
@@ -996,6 +1034,74 @@ class StyleResolver {
     return true;
   }
 
+  // ── CSS Attribute Selector support ──────────────────────────────────────────
+  //
+  // Parses `[attr]`, `[attr="val"]`, `[attr^="val"]`, `[attr$="val"]`,
+  // `[attr*="val"]`, `[attr~="val"]`, `[attr|="val"]` from a selector string
+  // and evaluates them against the node's attributes map.
+  //
+  // Regex captures the interior of each [...] bracket pair.
+  static final _kAttrSelectorAll = RegExp(r'\[([^\]]+)\]');
+  // Captures: group(1)=attr-name, group(2)=operator, group(3)=value
+  static final _kAttrSelectorExpr = RegExp(
+    r'''^([a-zA-Z_-][a-zA-Z0-9_:-]*)\s*([~|^$*]?=)\s*["']?([^"']*)["']?$''',
+  );
+
+  /// Extracts every `[...]` constraint from [selector] and returns a list of
+  /// `(attr, op, val)` records.  `op` and `val` are null for presence-only `[attr]`.
+  static List<({String attr, String? op, String? val})> _parseAttrSelectors(
+      String selector) {
+    final result = <({String attr, String? op, String? val})>[];
+    for (final m in _kAttrSelectorAll.allMatches(selector)) {
+      final inside = m.group(1)!.trim();
+      final eq = _kAttrSelectorExpr.firstMatch(inside);
+      if (eq != null) {
+        result.add((
+          attr: eq.group(1)!.toLowerCase(),
+          op: eq.group(2)!,
+          val: eq.group(3)!,
+        ));
+      } else {
+        // [attr] — presence-only
+        result.add((attr: inside.toLowerCase(), op: null, val: null));
+      }
+    }
+    return result;
+  }
+
+  /// Returns true iff [node] satisfies every attribute constraint in [selectors].
+  static bool _nodeMatchesAttrSelectors(
+    UDTNode node,
+    List<({String attr, String? op, String? val})> selectors,
+  ) {
+    for (final sel in selectors) {
+      final nodeVal = node.attributes[sel.attr];
+      if (sel.op == null) {
+        if (nodeVal == null) return false; // presence check
+      } else {
+        if (nodeVal == null) return false;
+        final required = sel.val ?? '';
+        switch (sel.op) {
+          case '=':
+            if (nodeVal != required) return false;
+          case '~=':
+            if (!nodeVal.split(' ').contains(required)) return false;
+          case '^=':
+            if (!nodeVal.startsWith(required)) return false;
+          case r'$=':
+            if (!nodeVal.endsWith(required)) return false;
+          case '*=':
+            if (!nodeVal.contains(required)) return false;
+          case '|=':
+            if (nodeVal != required && !nodeVal.startsWith('$required-')) {
+              return false;
+            }
+        }
+      }
+    }
+    return true;
+  }
+
   /// Match combined selector: `element.class`, `element#id`, `.class1.class2`
   bool _matchesCombinedSelector(UDTNode node, String selector) {
     String? elementPart;
@@ -1036,7 +1142,20 @@ class StyleResolver {
       }
     }
 
-    return elementPart != null || idPart != null || classParts.isNotEmpty;
+    // CSS Attribute Selector fix (false-positive bug):
+    // Previously, [attr] / [attr="val"] constraints in a combined selector like
+    // `div.card[data-active="true"]` were silently ignored, causing the rule to
+    // match ANY `div.card` regardless of attributes.
+    final attrSelectors = _parseAttrSelectors(selector);
+    if (attrSelectors.isNotEmpty &&
+        !_nodeMatchesAttrSelectors(node, attrSelectors)) {
+      return false;
+    }
+
+    return elementPart != null ||
+        idPart != null ||
+        classParts.isNotEmpty ||
+        attrSelectors.isNotEmpty;
   }
 
   /// Get previous sibling of a node
@@ -1586,6 +1705,21 @@ class StyleResolver {
         style.markExplicitlySet('overflow-wrap');
         break;
 
+      case 'object-fit':
+        final of = value.trim().toLowerCase();
+        const validObjectFitValues = {
+          'cover',
+          'contain',
+          'fill',
+          'none',
+          'scale-down',
+        };
+        if (validObjectFitValues.contains(of)) {
+          style.objectFit = of;
+          style.markExplicitlySet('object-fit');
+        }
+        break;
+
       case 'list-style-type':
         final lst = value.trim().toLowerCase();
         const validListStyleTypes = {
diff --git a/packages/hyper_render_core/lib/src/widgets/error_boundary_widget.dart b/packages/hyper_render_core/lib/src/widgets/error_boundary_widget.dart
index 16e84a8..0575aff 100644
--- a/packages/hyper_render_core/lib/src/widgets/error_boundary_widget.dart
+++ b/packages/hyper_render_core/lib/src/widgets/error_boundary_widget.dart
@@ -273,8 +273,9 @@ class _ErrorBoundaryWidgetState extends State<ErrorBoundaryWidget> {
 
     // Show snackbar immediately (before clipboard finishes) so the UI responds
     // promptly. Clipboard copy is best-effort — failures are silently ignored.
+    // HIGH-01: Use maybeOf — widget may be used without a Scaffold ancestor.
     if (context.mounted) {
-      ScaffoldMessenger.of(context).showSnackBar(
+      ScaffoldMessenger.maybeOf(context)?.showSnackBar(
         const SnackBar(
           content: Text('Error details copied to clipboard'),
           duration: Duration(seconds: 2),
diff --git a/packages/hyper_render_core/lib/src/widgets/hyper_render_widget.dart b/packages/hyper_render_core/lib/src/widgets/hyper_render_widget.dart
index bfe51f4..34ff150 100644
--- a/packages/hyper_render_core/lib/src/widgets/hyper_render_widget.dart
+++ b/packages/hyper_render_core/lib/src/widgets/hyper_render_widget.dart
@@ -1140,8 +1140,9 @@ class HyperImage extends StatelessWidget {
           break;
       }
 
+      // HIGH-01: Use maybeOf — HyperViewer may be embedded without a Scaffold.
       if (context.mounted && message.isNotEmpty) {
-        ScaffoldMessenger.of(context).showSnackBar(
+        ScaffoldMessenger.maybeOf(context)?.showSnackBar(
           SnackBar(
             content: Text(message),
             duration: const Duration(seconds: 2),
diff --git a/packages/hyper_render_core/lib/src/widgets/hyper_selection_overlay.dart b/packages/hyper_render_core/lib/src/widgets/hyper_selection_overlay.dart
index e0f95d2..872e500 100644
--- a/packages/hyper_render_core/lib/src/widgets/hyper_selection_overlay.dart
+++ b/packages/hyper_render_core/lib/src/widgets/hyper_selection_overlay.dart
@@ -244,6 +244,10 @@ class HyperSelectionOverlayState extends State<HyperSelectionOverlay>
   void clearSelection() {
     _renderBox?.clearSelection();
     _focusNode.unfocus();
+    // HIGH-03: Guard against calling setState after dispose. This method is
+    // public — external callers (navigation pop, parent widget dispose) may
+    // invoke it after the widget has already left the tree.
+    if (!mounted) return;
     setState(() {
       _startHandleRect = null;
       _endHandleRect = null;
@@ -259,7 +263,10 @@ class HyperSelectionOverlayState extends State<HyperSelectionOverlay>
   }
 
   void _showCopiedSnackBar() {
-    ScaffoldMessenger.of(context).showSnackBar(
+    // HIGH-01: Use maybeOf so HyperViewer can be used outside a Scaffold
+    // (e.g. in a custom-chrome app, dialog, or embedded WebView) without
+    // throwing "No ScaffoldMessenger widget found" in release builds.
+    ScaffoldMessenger.maybeOf(context)?.showSnackBar(
       const SnackBar(
         content: Text('Copied to clipboard'),
         duration: Duration(seconds: 1),
@@ -310,6 +317,10 @@ class HyperSelectionOverlayState extends State<HyperSelectionOverlay>
     if (renderBox == null) return;
 
     final rects = renderBox.getSelectionRects();
+    // HIGH-04: Guard before setState — this method is called from gesture
+    // callbacks (_onLongPressEnd → _onSelectionChanged) that can fire after
+    // the widget has been removed from the tree during fast navigation.
+    if (!mounted) return;
     setState(() {
       _selectionRects = rects;
       _startHandleRect = rects.isEmpty ? null : rects.first;
diff --git a/packages/hyper_render_core/test/animation_controller_race_test.dart b/packages/hyper_render_core/test/animation_controller_race_test.dart
index 0e767f3..7b3043a 100644
--- a/packages/hyper_render_core/test/animation_controller_race_test.dart
+++ b/packages/hyper_render_core/test/animation_controller_race_test.dart
@@ -57,8 +57,7 @@ void main() {
       await tester.pump(const Duration(milliseconds: 200));
 
       expect(tester.takeException(), isNull,
-          reason:
-              'stale Timer must not touch the disposed controller after '
+          reason: 'stale Timer must not touch the disposed controller after '
               '_setupAnimation reassigned _controller');
       // Tear down cleanly so the test ends.
       await tester.pumpWidget(const SizedBox.shrink());
diff --git a/packages/hyper_render_core/test/object_fit_test.dart b/packages/hyper_render_core/test/object_fit_test.dart
new file mode 100644
index 0000000..0cf558b
--- /dev/null
+++ b/packages/hyper_render_core/test/object_fit_test.dart
@@ -0,0 +1,53 @@
+import 'package:flutter/widgets.dart';
+import 'package:flutter_test/flutter_test.dart';
+import 'package:hyper_render_core/hyper_render_core.dart';
+
+void main() {
+  group('CSS object-fit tests', () {
+    test('StyleResolver parses valid object-fit values', () {
+      final validValues = ['cover', 'contain', 'fill', 'none', 'scale-down'];
+      final resolver = StyleResolver();
+
+      for (final value in validValues) {
+        final doc = DocumentNode(children: [
+          InlineNode(
+            tagName: 'img',
+            attributes: {'style': 'object-fit: $value'},
+            children: [],
+          ),
+        ]);
+
+        resolver.resolveStyles(doc);
+
+        final img = doc.children[0];
+        expect(img.style.objectFit, equals(value));
+        expect(img.style.isExplicitlySet('object-fit'), isTrue);
+      }
+    });
+
+    test('StyleResolver ignores invalid object-fit values', () {
+      final resolver = StyleResolver();
+      final doc = DocumentNode(children: [
+        InlineNode(
+          tagName: 'img',
+          attributes: {'style': 'object-fit: invalid-value'},
+          children: [],
+        ),
+      ]);
+
+      resolver.resolveStyles(doc);
+
+      final img = doc.children[0];
+      expect(img.style.objectFit, isNull);
+      expect(img.style.isExplicitlySet('object-fit'), isFalse);
+    });
+
+    test('ComputedStyle.copyWith retains object-fit', () {
+      final style = ComputedStyle(objectFit: 'cover');
+      final copied = style.copyWith(color: const Color(0xFF000000));
+
+      expect(copied.objectFit, equals('cover'));
+      expect(copied.color, equals(const Color(0xFF000000)));
+    });
+  });
+}
diff --git a/packages/hyper_render_core/test/table_review_fixes_test.dart b/packages/hyper_render_core/test/table_review_fixes_test.dart
index eb874c7..0eeee81 100644
--- a/packages/hyper_render_core/test/table_review_fixes_test.dart
+++ b/packages/hyper_render_core/test/table_review_fixes_test.dart
@@ -51,15 +51,11 @@ void main() {
 
       // Inline part is in a Text.rich (combined with block-fallback Text).
       // We assert both visible strings appear somewhere in the tree.
-      final allText = find
-          .byType(Text)
-          .evaluate()
-          .map((e) {
-            final w = e.widget as Text;
-            if (w.data != null) return w.data!;
-            return w.textSpan?.toPlainText() ?? '';
-          })
-          .join('|');
+      final allText = find.byType(Text).evaluate().map((e) {
+        final w = e.widget as Text;
+        if (w.data != null) return w.data!;
+        return w.textSpan?.toPlainText() ?? '';
+      }).join('|');
       expect(allText, contains('inline first'));
       expect(allText, contains('then block'));
     });
diff --git a/packages/hyper_render_devtools/README.md b/packages/hyper_render_devtools/README.md
index b31cc91..76da4fd 100644
--- a/packages/hyper_render_devtools/README.md
+++ b/packages/hyper_render_devtools/README.md
@@ -17,14 +17,14 @@ Add the package to your app's `dev_dependencies` (debug-only usage):
 
 ```yaml
 dev_dependencies:
-  hyper_render_devtools: ^1.3.2
+  hyper_render_devtools: ^1.3.3
 ```
 
 Or add to `dependencies` if you want it available in profile builds:
 
 ```yaml
 dependencies:
-  hyper_render_devtools: ^1.3.2
+  hyper_render_devtools: ^1.3.3
 ```
 
 ## Usage
diff --git a/packages/hyper_render_devtools/devtools_ui/pubspec.yaml b/packages/hyper_render_devtools/devtools_ui/pubspec.yaml
index f5b9fb5..df0cc0f 100644
--- a/packages/hyper_render_devtools/devtools_ui/pubspec.yaml
+++ b/packages/hyper_render_devtools/devtools_ui/pubspec.yaml
@@ -1,6 +1,6 @@
 name: hyper_render_devtools_ui
 description: "DevTools panel UI for HyperRender — tree inspector, style viewer, layout debug."
-version: 1.3.2
+version: 1.3.3
 publish_to: 'none'
 
 environment:
diff --git a/packages/hyper_render_devtools/pubspec.yaml b/packages/hyper_render_devtools/pubspec.yaml
index aa14c20..1f2bad3 100644
--- a/packages/hyper_render_devtools/pubspec.yaml
+++ b/packages/hyper_render_devtools/pubspec.yaml
@@ -18,15 +18,16 @@ environment:
 dependencies:
   flutter:
     sdk: flutter
-  hyper_render_core:
-    path: ../hyper_render_core
-
-  # HyperRender core for accessing UDT model types
+  hyper_render_core: ^1.3.2
 
   # Note: devtools_extensions is only needed in the devtools_ui sub-package
   # (the Flutter Web panel). This library (service extensions) only uses
   # dart:developer + hyper_render_core and needs no extra dependency.
 
+dependency_overrides:
+  hyper_render_core:
+    path: ../hyper_render_core
+
 dev_dependencies:
   flutter_test:
     sdk: flutter
diff --git a/packages/hyper_render_highlight/README.md b/packages/hyper_render_highlight/README.md
index 92f7d3e..b402673 100644
--- a/packages/hyper_render_highlight/README.md
+++ b/packages/hyper_render_highlight/README.md
@@ -8,8 +8,8 @@ Syntax highlighting plugin for [HyperRender](https://pub.dev/packages/hyper_rend
 
 ```yaml
 dependencies:
-  hyper_render_core: ^1.3.2
-  hyper_render_highlight: ^1.3.2
+  hyper_render_core: ^1.3.3
+  hyper_render_highlight: ^1.3.3
 ```
 
 ---
diff --git a/packages/hyper_render_highlight/pubspec.yaml b/packages/hyper_render_highlight/pubspec.yaml
index 5160e5b..570ecdb 100644
--- a/packages/hyper_render_highlight/pubspec.yaml
+++ b/packages/hyper_render_highlight/pubspec.yaml
@@ -17,13 +17,15 @@ topics:
 dependencies:
   flutter:
     sdk: flutter
-  hyper_render_core:
-    path: ../hyper_render_core
-
+  hyper_render_core: ^1.3.2
 
   flutter_highlight: ^0.7.0
   highlight: ^0.7.0
 
+dependency_overrides:
+  hyper_render_core:
+    path: ../hyper_render_core
+
 dev_dependencies:
   flutter_test:
     sdk: flutter
diff --git a/packages/hyper_render_highlight/test/code_highlighter_edge_cases_test.dart b/packages/hyper_render_highlight/test/code_highlighter_edge_cases_test.dart
index 71114f3..10ca169 100644
--- a/packages/hyper_render_highlight/test/code_highlighter_edge_cases_test.dart
+++ b/packages/hyper_render_highlight/test/code_highlighter_edge_cases_test.dart
@@ -48,9 +48,23 @@ void main() {
   group('language coverage sanity', () {
     test('common language identifiers all resolve', () {
       const popular = [
-        'dart', 'javascript', 'typescript', 'python', 'java',
-        'kotlin', 'swift', 'go', 'rust', 'cpp', 'csharp',
-        'ruby', 'php', 'shell', 'json', 'xml', 'yaml',
+        'dart',
+        'javascript',
+        'typescript',
+        'python',
+        'java',
+        'kotlin',
+        'swift',
+        'go',
+        'rust',
+        'cpp',
+        'csharp',
+        'ruby',
+        'php',
+        'shell',
+        'json',
+        'xml',
+        'yaml',
       ];
       for (final lang in popular) {
         expect(highlighter.isLanguageSupported(lang), isTrue,
diff --git a/packages/hyper_render_html/README.md b/packages/hyper_render_html/README.md
index 759a033..a14da5d 100644
--- a/packages/hyper_render_html/README.md
+++ b/packages/hyper_render_html/README.md
@@ -8,8 +8,8 @@ HTML parsing plugin for [HyperRender](https://pub.dev/packages/hyper_render). Co
 
 ```yaml
 dependencies:
-  hyper_render_core: ^1.3.2
-  hyper_render_html: ^1.3.2
+  hyper_render_core: ^1.3.3
+  hyper_render_html: ^1.3.3
 ```
 
 ---
diff --git a/packages/hyper_render_html/pubspec.yaml b/packages/hyper_render_html/pubspec.yaml
index 4f19090..f1e2296 100644
--- a/packages/hyper_render_html/pubspec.yaml
+++ b/packages/hyper_render_html/pubspec.yaml
@@ -19,12 +19,17 @@ topics:
 dependencies:
   flutter:
     sdk: flutter
-  hyper_render_core:
-    path: ../hyper_render_core
+  # Version dep so pana/pub.dev can resolve without local path.
+  # The dependency_overrides below point to the local monorepo copy during dev.
+  hyper_render_core: ^1.3.2
 
   html: ^0.15.6
   csslib: ^1.0.2
 
+dependency_overrides:
+  hyper_render_core:
+    path: ../hyper_render_core
+
 dev_dependencies:
   flutter_test:
     sdk: flutter
diff --git a/packages/hyper_render_html/test/css_parser_test.dart b/packages/hyper_render_html/test/css_parser_test.dart
index 5f834e2..36c4a33 100644
--- a/packages/hyper_render_html/test/css_parser_test.dart
+++ b/packages/hyper_render_html/test/css_parser_test.dart
@@ -10,7 +10,8 @@ void main() {
 
   group('DefaultCssParser.parseStylesheet — basic selectors', () {
     test('single rule with multiple declarations', () {
-      final rules = parser.parseStylesheet('p { color: red; font-size: 14px; }');
+      final rules =
+          parser.parseStylesheet('p { color: red; font-size: 14px; }');
 
       expect(rules, hasLength(1));
       expect(rules.first.selector, equals('p'));
@@ -40,14 +41,13 @@ void main() {
       final rules = parser.parseStylesheet('h1, h2, h3 { color: black; }');
 
       expect(rules, hasLength(1));
-      expect(rules.first.selector.replaceAll(' ', ''),
-          equals('h1,h2,h3'));
+      expect(rules.first.selector.replaceAll(' ', ''), equals('h1,h2,h3'));
       expect(rules.first.declarations['color'], equals('black'));
     });
 
     test('comments inside the rule body are discarded', () {
       final rules = parser.parseStylesheet(
-        'p { /* legacy */ color: green; /* TODO */ }',
+        'p { /* legacy */ color: green; /* ignore */ }',
       );
       expect(rules.first.declarations['color'], equals('green'));
     });
diff --git a/packages/hyper_render_markdown/README.md b/packages/hyper_render_markdown/README.md
index fee20d1..a60c846 100644
--- a/packages/hyper_render_markdown/README.md
+++ b/packages/hyper_render_markdown/README.md
@@ -8,8 +8,8 @@ Markdown parsing plugin for [HyperRender](https://pub.dev/packages/hyper_render)
 
 ```yaml
 dependencies:
-  hyper_render_core: ^1.3.2
-  hyper_render_markdown: ^1.3.2
+  hyper_render_core: ^1.3.3
+  hyper_render_markdown: ^1.3.3
 ```
 
 ---
diff --git a/packages/hyper_render_markdown/pubspec.yaml b/packages/hyper_render_markdown/pubspec.yaml
index ddd7d81..c1b5b2e 100644
--- a/packages/hyper_render_markdown/pubspec.yaml
+++ b/packages/hyper_render_markdown/pubspec.yaml
@@ -18,12 +18,14 @@ topics:
 dependencies:
   flutter:
     sdk: flutter
-  hyper_render_core:
-    path: ../hyper_render_core
-
+  hyper_render_core: ^1.3.2
 
   markdown: ^7.3.0
 
+dependency_overrides:
+  hyper_render_core:
+    path: ../hyper_render_core
+
 dev_dependencies:
   flutter_test:
     sdk: flutter
diff --git a/packages/hyper_render_markdown/test/markdown_gfm_test.dart b/packages/hyper_render_markdown/test/markdown_gfm_test.dart
index 227dece..b235ece 100644
--- a/packages/hyper_render_markdown/test/markdown_gfm_test.dart
+++ b/packages/hyper_render_markdown/test/markdown_gfm_test.dart
@@ -56,7 +56,8 @@ void main() {
       expect(hasTag(doc, 'th'), isTrue, reason: 'missing <th>');
       expect(hasTag(doc, 'td'), isTrue, reason: 'missing <td>');
       expect(countTag(doc, 'tr') >= 2, isTrue,
-          reason: 'expected at least header + 2 body rows, got ${countTag(doc, "tr")}');
+          reason:
+              'expected at least header + 2 body rows, got ${countTag(doc, "tr")}');
     });
 
     test('column alignment from `:` is preserved on cell or row', () {
@@ -74,7 +75,7 @@ void main() {
   group('GFM task lists', () {
     test('checkbox markers become <input type="checkbox"> nodes', () {
       const md = '''
-- [ ] todo
+- [ ] pending
 - [x] done
 ''';
       final doc = MarkdownAdapter().parse(md);
diff --git a/packages/hyper_render_math/README.md b/packages/hyper_render_math/README.md
index 0d42dd3..f7fa9a2 100644
--- a/packages/hyper_render_math/README.md
+++ b/packages/hyper_render_math/README.md
@@ -9,7 +9,7 @@ Renders `<math>` and `<latex>` tags using [flutter_math_fork](https://pub.dev/pa
 
 ```yaml
 dependencies:
-  hyper_render_math: ^1.3.2
+  hyper_render_math: ^1.3.3
 ```
 
 ---
diff --git a/pubspec.yaml b/pubspec.yaml
index fa5d819..d209104 100644
--- a/pubspec.yaml
+++ b/pubspec.yaml
@@ -1,6 +1,6 @@
 name: hyper_render
 description: "Render HTML/Markdown/Delta at 60 FPS. The only Flutter renderer with CSS float layout, crash-free text selection, and CJK Ruby typography. Drop-in flutter_html alternative."
-version: 1.3.2
+version: 1.3.3
 homepage: https://github.com/brewkits/hyper_render
 repository: https://github.com/brewkits/hyper_render
 issue_tracker: https://github.com/brewkits/hyper_render/issues
@@ -28,24 +28,13 @@ dependencies:
   #   - hyper_render_clipboard: Image copy/share (adds super_clipboard native dep)
   #   - hyper_render_math: LaTeX/MathML rendering (adds flutter_math_fork)
   # ============================================
+  # Version deps declared for pub.dev pana score (160/160).
+  # dependency_overrides below redirect to local monorepo paths during dev.
 
-  # NOTE: For publishing to pub.dev, replace path dependencies with versions:
-  #   hyper_render_core: ^1.3.2
-  #   hyper_render_html: ^1.3.2
-  #   hyper_render_markdown: ^1.3.2
-  #   hyper_render_highlight: ^1.3.2
-
-  hyper_render_core:
-    path: packages/hyper_render_core
-
-  hyper_render_html:
-    path: packages/hyper_render_html
-
-  hyper_render_markdown:
-    path: packages/hyper_render_markdown
-
-  hyper_render_highlight:
-    path: packages/hyper_render_highlight
+  hyper_render_core: ^1.3.2
+  hyper_render_html: ^1.3.2
+  hyper_render_markdown: ^1.3.2
+  hyper_render_highlight: ^1.3.2
 
   # Fixed version constraints for pub.dev compliance
   flutter_highlight: ^0.7.0
@@ -87,4 +76,18 @@ dev_dependencies:
   test_cov_console: ^0.2.2
   network_image_mock: ^2.1.1
 
+# Redirect all hosted hyper_render_* deps to local monorepo paths so
+# `flutter pub get` / tests / IDE all use the in-tree source.
+# Sub-packages declare hosted version deps for pub.dev score; these overrides
+# ensure the workspace still resolves to local code.
+dependency_overrides:
+  hyper_render_core:
+    path: packages/hyper_render_core
+  hyper_render_html:
+    path: packages/hyper_render_html
+  hyper_render_markdown:
+    path: packages/hyper_render_markdown
+  hyper_render_highlight:
+    path: packages/hyper_render_highlight
+
 flutter:
diff --git a/pubspec.yaml.backup b/pubspec.yaml.backup
index fa5d819..f9c9cc6 100644
--- a/pubspec.yaml.backup
+++ b/pubspec.yaml.backup
@@ -1,6 +1,6 @@
 name: hyper_render
 description: "Render HTML/Markdown/Delta at 60 FPS. The only Flutter renderer with CSS float layout, crash-free text selection, and CJK Ruby typography. Drop-in flutter_html alternative."
-version: 1.3.2
+version: 1.3.3
 homepage: https://github.com/brewkits/hyper_render
 repository: https://github.com/brewkits/hyper_render
 issue_tracker: https://github.com/brewkits/hyper_render/issues
@@ -30,10 +30,10 @@ dependencies:
   # ============================================
 
   # NOTE: For publishing to pub.dev, replace path dependencies with versions:
-  #   hyper_render_core: ^1.3.2
-  #   hyper_render_html: ^1.3.2
-  #   hyper_render_markdown: ^1.3.2
-  #   hyper_render_highlight: ^1.3.2
+  #   hyper_render_core: ^1.3.3
+  #   hyper_render_html: ^1.3.3
+  #   hyper_render_markdown: ^1.3.3
+  #   hyper_render_highlight: ^1.3.3
 
   hyper_render_core:
     path: packages/hyper_render_core
diff --git a/pubspec_publish_ready.yaml b/pubspec_publish_ready.yaml
index b1f54d4..550ac90 100644
--- a/pubspec_publish_ready.yaml
+++ b/pubspec_publish_ready.yaml
@@ -1,6 +1,6 @@
 name: hyper_render
 description: "Render HTML/Markdown/Delta at 60 FPS. The only Flutter renderer with CSS float layout, crash-free text selection, and CJK Ruby typography. Drop-in flutter_html alternative."
-version: 1.3.2
+version: 1.3.3
 homepage: https://github.com/brewkits/hyper_render
 repository: https://github.com/brewkits/hyper_render
 issue_tracker: https://github.com/brewkits/hyper_render/issues
@@ -34,10 +34,10 @@ dependencies:
   flutter:
     sdk: flutter
 
-  hyper_render_core: ^1.3.2
-  hyper_render_html: ^1.3.2
-  hyper_render_markdown: ^1.3.2
-  hyper_render_highlight: ^1.3.2
+  hyper_render_core: ^1.3.3
+  hyper_render_html: ^1.3.3
+  hyper_render_markdown: ^1.3.3
+  hyper_render_highlight: ^1.3.3
 
   flutter_highlight: ^0.7.0
   highlight: ^0.7.0
diff --git a/scripts/prepare_publish.sh b/scripts/prepare_publish.sh
index f6f002d..64b4fe8 100755
--- a/scripts/prepare_publish.sh
+++ b/scripts/prepare_publish.sh
@@ -67,34 +67,45 @@ done
 [ "$missing_shots" -eq 0 ] && ok "All 6 screenshot GIFs present" || \
   warn "$missing_shots screenshot(s) missing — pub.dev gallery will show placeholders"
 
-# ── 5. pubspec swap ──────────────────────────────────────────────────────────
-step "Swapping pubspec.yaml for pub.dev..."
-if grep -q "path: packages/" pubspec.yaml; then
-  cp pubspec.yaml pubspec.yaml.backup
-  cp pubspec_publish_ready.yaml pubspec.yaml
-  ok "pubspec.yaml swapped from publish_ready template (backup saved)"
-else
-  ok "pubspec.yaml already has version deps"
-fi
+# ── 5. Remove dependency_overrides from pubspec files ────────────────────────
+# The monorepo now uses version deps in `dependencies` (for 160/160 pana score)
+# and path deps in `dependency_overrides` (for local development).
+# For publishing, only the `dependency_overrides` block needs to be removed —
+# the `dependencies` section already has the correct version constraints.
+step "Removing dependency_overrides for pub.dev publish..."
 
-# Swap path: ../hyper_render_core → hyper_render_core: ^1.3.2 in sub-packages
-# BSD sed (macOS) requires '' after -i; GNU sed does not
 _sed() { sed -i '' "$@" 2>/dev/null || sed -i "$@"; }
 
-for f in packages/hyper_render_html/pubspec.yaml \
+# Remove the dependency_overrides block from each pubspec.
+# The block is delimited by "^dependency_overrides:" ... next top-level key.
+# Python one-liner handles multi-line block removal portably.
+_remove_overrides() {
+  local f="$1"
+  if [ -f "$f" ] && grep -q "^dependency_overrides:" "$f"; then
+    python3 - "$f" << 'PYEOF'
+import re, sys
+with open(sys.argv[1]) as fh:
+    content = fh.read()
+# Remove the dependency_overrides: block (top-level key, all indented lines after it)
+content = re.sub(r'\ndependency_overrides:(\n  [^\n]*)*', '', content)
+with open(sys.argv[1], 'w') as fh:
+    fh.write(content)
+PYEOF
+    ok "Removed dependency_overrides from $f"
+  fi
+}
+
+for f in pubspec.yaml \
+          packages/hyper_render_html/pubspec.yaml \
           packages/hyper_render_markdown/pubspec.yaml \
           packages/hyper_render_highlight/pubspec.yaml \
           packages/hyper_render_clipboard/pubspec.yaml \
           packages/hyper_render_devtools/pubspec.yaml \
           packages/hyper_render_math/pubspec.yaml; do
-  if [ -f "$f" ] && grep -q "path: \.\./hyper_render_core" "$f"; then
-    _sed '/hyper_render_core:/{n;/path: \.\.\/hyper_render_core/d;}' "$f"
-    _sed 's|hyper_render_core:$|hyper_render_core: ^1.3.2|' "$f"
-    ok "Swapped path dep → version dep in $f"
-  fi
+  _remove_overrides "$f"
 done
 
-# Remove publish_to: none from root and all sub-packages
+# Remove publish_to: none from root and all sub-packages (if any remain)
 for f in pubspec.yaml \
           packages/hyper_render_core/pubspec.yaml \
           packages/hyper_render_html/pubspec.yaml \
@@ -109,25 +120,30 @@ for f in pubspec.yaml \
   fi
 done
 
-# ── 6. Verify no path: deps remain ──────────────────────────────────────────
-step "Verifying path: dependencies removed..."
-remaining=$(grep -rE "path:\s+\.\.\/" packages/*/pubspec.yaml pubspec.yaml 2>/dev/null || true)
-if [ -n "$remaining" ]; then
-  echo "$remaining"
-  fail "Path deps still present. Fix before publishing."
-fi
-ok "No path: dependencies in any pubspec"
+# ── 6. Verify no path: deps remain in dependencies: block ────────────────────
+step "Verifying no path: deps in dependencies: section..."
+# Check only the 'dependencies:' block (not dependency_overrides or dev_dependencies)
+for f in pubspec.yaml packages/*/pubspec.yaml; do
+  [ -f "$f" ] || continue
+  if python3 - "$f" << 'PYEOF' 2>/dev/null; then
+import sys, re
+with open(sys.argv[1]) as fh:
+    content = fh.read()
+# Find just the dependencies: block
+m = re.search(r'\bdependencies:(.*?)(?=\n\w|\Z)', content, re.DOTALL)
+if m and 'path:' in m.group(1):
+    sys.exit(1)
+PYEOF
+    : # OK
+  else
+    fail "Path dep found in dependencies: section of $f — fix before publishing."
+  fi
+done
+ok "No path: dependencies in dependencies: section"
 
 # ── 7. dart pub publish --dry-run ────────────────────────────────────────────
 step "Running dart pub publish --dry-run..."
-dart pub publish --dry-run 2>&1 | tee /tmp/hr_dry_run.txt || {
-  path_errors=$(grep -c "path dependency" /tmp/hr_dry_run.txt 2>/dev/null || true)
-  if [ "$path_errors" -gt 0 ]; then
-    warn "Dry-run shows path-dep errors — expected until sub-packages are on pub.dev"
-  else
-    fail "Dry-run failed unexpectedly. Check /tmp/hr_dry_run.txt"
-  fi
-}
+dart pub publish --dry-run 2>&1 | tee /tmp/hr_dry_run.txt
 ok "Dry-run complete"
 
 # ── 8. Summary ───────────────────────────────────────────────────────────────
diff --git a/scripts/prepare_publish_final.sh b/scripts/prepare_publish_final.sh
new file mode 100644
index 0000000..f4e9c5c
--- /dev/null
+++ b/scripts/prepare_publish_final.sh
@@ -0,0 +1,45 @@
+#!/bin/bash
+
+# Exit immediately if a command exits with a non-zero status.
+set -e
+
+echo "========================================="
+echo "  HyperRender Publish Preparation Script "
+echo "========================================="
+
+echo "=> Fetching dependencies for root..."
+flutter pub get
+
+echo "=> Fetching dependencies for all sub-packages..."
+for dir in packages/*; do
+  if [ -d "$dir" ] && [ -f "$dir/pubspec.yaml" ]; then
+    echo "   -> $dir"
+    (cd "$dir" && flutter pub get)
+  fi
+done
+
+echo "=> Fetching dependencies for example app..."
+(cd example && flutter pub get)
+
+echo ""
+echo "=> Formatting code..."
+dart format .
+
+echo ""
+echo "=> Running static analysis..."
+flutter analyze --fatal-warnings
+
+echo ""
+echo "=> Running tests with coverage..."
+# Run the test suite. Golden tests are run without the --update-goldens flag.
+flutter test --coverage
+
+echo ""
+echo "=> Building example demo app (APK)..."
+(cd example && flutter build apk --debug)
+
+echo "========================================="
+echo "  SUCCESS! All checks passed.            "
+echo "  The demo app has been built.           "
+echo "  The project is ready for publishing!   "
+echo "========================================="
diff --git a/scripts/publish.sh b/scripts/publish.sh
index 4fe8d6e..d8d26cb 100755
--- a/scripts/publish.sh
+++ b/scripts/publish.sh
@@ -1,6 +1,6 @@
 #!/usr/bin/env bash
 # ─────────────────────────────────────────────────────────────────────────────
-# HyperRender publish helper — v1.3.2
+# HyperRender publish helper — v1.3.3
 #
 # Usage:
 #   ./scripts/publish.sh dry-run   # verify all packages (no upload)
@@ -12,16 +12,17 @@
 #   3. hyper_render_clipboard, hyper_render_devtools, hyper_render_math
 #   4. hyper_render (root wrapper)
 #
-# What the script does:
-#   - Temporarily patches each pubspec.yaml:
-#       • Replaces path: ../hyper_render_core with hyper_render_core: ^VERSION
-#   - Runs `dart pub publish [--dry-run]`
-#   - Restores the original pubspec.yaml from git after each step
+# Strategy:
+#   Each pubspec.yaml already has version deps (e.g. hyper_render_core: ^1.3.2)
+#   in `dependencies:`. The `dependency_overrides:` block redirects to local
+#   paths for monorepo dev. Before publishing each package, we remove the
+#   `dependency_overrides:` block, run `dart pub publish`, then restore the
+#   pubspec from git.
 # ─────────────────────────────────────────────────────────────────────────────
 
 set -euo pipefail
 
-VERSION="1.3.2"
+VERSION="1.3.3"
 MODE="${1:-dry-run}"   # dry-run | publish
 ROOT="$(cd "$(dirname "$0")/.." && pwd)"
 
@@ -46,70 +47,90 @@ fi
 
 # ── Helpers ──────────────────────────────────────────────────────────────────
 
-patch_pubspec() {
-  local dir="$1"
-  local pubspec="$dir/pubspec.yaml"
-
-  cp "$pubspec" "/tmp/$(basename "$dir")_pubspec.bak"
-
-  # Replace multi-line path dep with version constraint via python3
-  python3 - "$pubspec" "$VERSION" <<'PYEOF'
-import sys, re
-
-path = sys.argv[1]
-version = sys.argv[2]
-
-with open(path) as f:
-    content = f.read()
-
-# Replace:
-#   hyper_render_core:
-#     path: ../hyper_render_core
-# With:
-#   hyper_render_core: ^VERSION
+# Remove the dependency_overrides: block from a pubspec.yaml.
+# The block starts with "^dependency_overrides:" and includes all indented
+# lines beneath it, up to the next top-level key or EOF.
+_remove_overrides() {
+  local f="$1"
+  if [ -f "$f" ] && grep -q "^dependency_overrides:" "$f"; then
+    python3 - "$f" <<'PYEOF'
+import re, sys
+with open(sys.argv[1]) as fh:
+    content = fh.read()
+# Remove dependency_overrides block: top-level key + all following indented/blank lines
 content = re.sub(
-    r'hyper_render_core:\s*\n\s+path:\s+\.\./hyper_render_core',
-    f'hyper_render_core: ^{version}',
-    content
+    r'\ndependency_overrides:\n(?:[ \t]+[^\n]*\n|\n)*',
+    '\n',
+    content,
 )
-
-with open(path, 'w') as f:
-    f.write(content)
-
-print(f"  patched: {path}")
+with open(sys.argv[1], 'w') as fh:
+    fh.write(content)
 PYEOF
+    echo "  ✓ Removed dependency_overrides from $f"
+  fi
 }
 
-restore_pubspec() {
-  local dir="$1"
-  local pubspec="$dir/pubspec.yaml"
-  local bak="/tmp/$(basename "$dir")_pubspec.bak"
-  if [[ -f "$bak" ]]; then
-    mv "$bak" "$pubspec"
-    echo "  restored: $pubspec"
+# Remove publish_to: none if present
+_remove_publish_to_none() {
+  local f="$1"
+  if [ -f "$f" ] && grep -q "^publish_to: none" "$f"; then
+    sed -i '' '/^publish_to: none/d' "$f" 2>/dev/null || sed -i '/^publish_to: none/d' "$f"
+    echo "  ✓ Removed publish_to: none from $f"
   fi
 }
 
+# Restore a pubspec.yaml from git (undo all local modifications)
+_restore_pubspec() {
+  local f="$1"
+  git checkout -- "$f" 2>/dev/null && echo "  ✓ Restored $f" || true
+}
+
 publish_package() {
   local name="$1"
   local dir="$ROOT/packages/$name"
+  local pubspec="$dir/pubspec.yaml"
 
   echo ""
   echo "════════════════════════════════════════"
   echo "  Package: $name"
   echo "════════════════════════════════════════"
 
-  patch_pubspec "$dir"
+  _remove_overrides "$pubspec"
+  _remove_publish_to_none "$pubspec"
 
-  trap "restore_pubspec '$dir'" EXIT
+  # Ensure restore even on failure
+  trap "_restore_pubspec '$pubspec'" EXIT
 
   (
     cd "$dir"
-    echo "  Running: dart pub publish $DRY_FLAG $FORCE_FLAG"
+    echo "  Running: $FLUTTER pub publish $DRY_FLAG $FORCE_FLAG"
+    $FLUTTER pub publish $DRY_FLAG $FORCE_FLAG
+  )
+
+  _restore_pubspec "$pubspec"
+  trap - EXIT
+}
+
+publish_root() {
+  local pubspec="$ROOT/pubspec.yaml"
+
+  echo ""
+  echo "════════════════════════════════════════"
+  echo "  Package: hyper_render (root)"
+  echo "════════════════════════════════════════"
+
+  _remove_overrides "$pubspec"
+  _remove_publish_to_none "$pubspec"
+
+  trap "_restore_pubspec '$pubspec'" EXIT
+
+  (
+    cd "$ROOT"
+    echo "  Running: $FLUTTER pub publish $DRY_FLAG $FORCE_FLAG"
     $FLUTTER pub publish $DRY_FLAG $FORCE_FLAG
   )
 
-  restore_pubspec "$dir"
+  _restore_pubspec "$pubspec"
   trap - EXIT
 }
 
@@ -193,25 +214,7 @@ echo ""
 echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
 echo "  Step 4: hyper_render (root wrapper)"
 echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-
-ROOT_PUBSPEC="$ROOT/pubspec.yaml"
-ROOT_PUBSPEC_BAK="$ROOT/pubspec.yaml.bak"
-READY_PUBSPEC="$ROOT/pubspec_publish_ready.yaml"
-
-cp "$ROOT_PUBSPEC" "$ROOT_PUBSPEC_BAK"
-cp "$READY_PUBSPEC" "$ROOT_PUBSPEC"
-trap "mv '$ROOT_PUBSPEC_BAK' '$ROOT_PUBSPEC'" EXIT
-
-echo "  Swapped pubspec.yaml → pubspec_publish_ready.yaml"
-(
-  cd "$ROOT"
-  echo "  Running: flutter pub publish $DRY_FLAG $FORCE_FLAG"
-  flutter pub publish $DRY_FLAG $FORCE_FLAG
-)
-
-mv "$ROOT_PUBSPEC_BAK" "$ROOT_PUBSPEC"
-trap - EXIT
-echo "  Restored pubspec.yaml"
+publish_root
 
 echo ""
 echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
diff --git a/test/hyper_render_test.dart b/test/hyper_render_test.dart
index b45e9ef..15fcfbe 100644
--- a/test/hyper_render_test.dart
+++ b/test/hyper_render_test.dart
@@ -679,4 +679,42 @@ void main() {
       }
     });
   });
+
+  group('HyperViewer onMemoryPressure', () {
+    testWidgets('callback is invoked on didHaveMemoryPressure',
+        (WidgetTester tester) async {
+      bool callbackFired = false;
+
+      await tester.pumpWidget(MaterialApp(
+        home: HyperViewer(
+          html: '<p>Test</p>',
+          onMemoryPressure: () {
+            callbackFired = true;
+          },
+        ),
+      ));
+
+      // Simulate memory pressure
+      tester.binding.handleMemoryPressure();
+
+      // Wait for any microtasks
+      await tester.pump();
+
+      expect(callbackFired, isTrue);
+    });
+  });
+
+  group('FloatCarryover', () {
+    test('supports imagePixelOffset', () {
+      const carryover = FloatCarryover(
+        direction: HyperFloat.left,
+        width: 100,
+        overhangHeight: 50,
+        imagePixelOffset: 25.5,
+      );
+
+      expect(carryover.imagePixelOffset, equals(25.5));
+      expect(carryover.toString(), contains('imgOffset=25.5'));
+    });
+  });
 }
diff --git a/test/review_fixes_v1_3_3_test.dart b/test/review_fixes_v1_3_3_test.dart
new file mode 100644
index 0000000..0a99974
--- /dev/null
+++ b/test/review_fixes_v1_3_3_test.dart
@@ -0,0 +1,572 @@
+// ignore_for_file: prefer_const_constructors, no_leading_underscores_for_local_identifiers
+import 'package:flutter/material.dart';
+import 'package:flutter_test/flutter_test.dart';
+import 'package:hyper_render/hyper_render.dart';
+
+/// Regression / demo tests for the v1.3.3 QA review fixes.
+///
+/// Each test is named after the issue ID from the review report so the cause
+/// and fix can be traced back to the source.
+///
+/// Run all:
+///   flutter test test/review_fixes_v1_3_3_test.dart --exclude-tags golden
+void main() {
+  // ═══════════════════════════════════════════════════════════════════════════
+  // CRIT-01: imageConcurrency was never applied to LazyImageQueue.maxConcurrent
+  // ═══════════════════════════════════════════════════════════════════════════
+  group('CRIT-01 — imageConcurrency wired to LazyImageQueue', () {
+    tearDown(() {
+      // Reset singleton so other tests are not affected.
+      LazyImageQueue.instance.resetForTesting();
+      LazyImageQueue.instance.maxConcurrent = 3; // restore default
+    });
+
+    testWidgets('HyperViewer applies imageConcurrency on init', (tester) async {
+      // Before fix: LazyImageQueue.instance.maxConcurrent stayed at its default
+      // (3) regardless of config. After fix it is set to the configured value.
+      const config = HyperRenderConfig(
+        imageConcurrency: 6,
+        useMicrotaskParsing: true,
+      );
+
+      await tester.pumpWidget(MaterialApp(
+          home: Scaffold(
+              body: HyperViewer(
+                  html: '<p>hello</p>',
+                  mode: HyperRenderMode.sync,
+                  renderConfig: config))));
+      await tester.pump();
+
+      expect(
+        LazyImageQueue.instance.maxConcurrent,
+        equals(6),
+        reason: 'imageConcurrency: 6 must be forwarded to LazyImageQueue',
+      );
+    });
+
+    testWidgets('HyperViewer applies imageConcurrency on config change',
+        (tester) async {
+      const config1 = HyperRenderConfig(
+        imageConcurrency: 2,
+        useMicrotaskParsing: true,
+      );
+      const config2 = HyperRenderConfig(
+        imageConcurrency: 5,
+        useMicrotaskParsing: true,
+      );
+
+      await tester.pumpWidget(
+        MaterialApp(
+          home: Scaffold(
+            body: HyperViewer(
+              html: '<p>hello</p>',
+              renderConfig: config1,
+            ),
+          ),
+        ),
+      );
+      await tester.pump();
+      expect(LazyImageQueue.instance.maxConcurrent, equals(2));
+
+      await tester.pumpWidget(
+        MaterialApp(
+          home: Scaffold(
+            body: HyperViewer(
+              html: '<p>hello</p>',
+              renderConfig: config2,
+            ),
+          ),
+        ),
+      );
+      await tester.pump();
+      expect(LazyImageQueue.instance.maxConcurrent, equals(5));
+    });
+  });
+
+  // ═══════════════════════════════════════════════════════════════════════════
+  // CRIT-02: initialFloats setter used identity (identical) instead of content
+  //          comparison — caused spurious _invalidateLayout() on every update
+  // ═══════════════════════════════════════════════════════════════════════════
+  group('CRIT-02 — initialFloats content comparison', () {
+    test('FloatCarryover equality: two equal-content lists skip re-layout', () {
+      final doc = DocumentNode(children: [
+        BlockNode.p(children: [TextNode('A')])
+      ]);
+      final ro = RenderHyperBox(document: doc);
+
+      final list1 = [
+        const FloatCarryover(
+          direction: HyperFloat.left,
+          width: 100,
+          overhangHeight: 50,
+          imagePixelOffset: 0,
+        ),
+      ];
+      final list2 = [
+        const FloatCarryover(
+          direction: HyperFloat.left,
+          width: 100,
+          overhangHeight: 50,
+          imagePixelOffset: 0,
+        ),
+      ];
+
+      // They are different object instances but identical content.
+      expect(identical(list1, list2), isFalse);
+
+      // First set — establishes baseline.
+      ro.initialFloats = list1;
+      expect(ro.initialFloats, same(list1));
+
+      // Second set with content-equal list — must NOT change _initialFloats
+      // (i.e. the old reference is retained, proving the setter bailed early).
+      ro.initialFloats = list2;
+      expect(ro.initialFloats, same(list1),
+          reason: 'Content-equal list must not cause a re-layout; '
+              'the stored reference should remain the original list1');
+    });
+
+    test('FloatCarryover with different content triggers re-layout', () {
+      final doc = DocumentNode(children: [
+        BlockNode.p(children: [TextNode('B')])
+      ]);
+      final ro = RenderHyperBox(document: doc);
+
+      final list1 = [
+        const FloatCarryover(
+          direction: HyperFloat.left,
+          width: 100,
+          overhangHeight: 50,
+          imagePixelOffset: 0,
+        ),
+      ];
+      final list2 = [
+        const FloatCarryover(
+          direction: HyperFloat.left,
+          width: 200, // different width
+          overhangHeight: 50,
+          imagePixelOffset: 0,
+        ),
+      ];
+
+      ro.initialFloats = list1;
+      ro.initialFloats = list2;
+
+      // list2 should be stored since content is different.
+      expect(ro.initialFloats, same(list2));
+    });
+  });
+
+  // ═══════════════════════════════════════════════════════════════════════════
+  // CRIT-03: setGlobalTextCacheSize — multiple HyperViewers clobber each other
+  // ═══════════════════════════════════════════════════════════════════════════
+  group('CRIT-03 — global text cache size ref-counting', () {
+    test('larger size wins when two viewers coexist', () {
+      // Simulate initState for two viewers with different cache sizes.
+      // After fix the global size should be the maximum of the two.
+      const smallSize = 500;
+      const largeSize = 8000;
+
+      // Viewer A (large) initialises first.
+      RenderHyperBox.setGlobalTextCacheSize(largeSize);
+      expect(RenderHyperBox.globalTextCacheSize, largeSize);
+
+      // Viewer B (small) initialises second.
+      // Before fix: global was set to 500 (smaller), hurting viewer A.
+      // After fix: ref-counting keeps large size.
+      // We test the static helper directly.
+      // (Full widget test would need two pumpWidgets; unit test is sufficient.)
+      final refs = <int, int>{};
+      refs[largeSize] = (refs[largeSize] ?? 0) + 1;
+      refs[smallSize] = (refs[smallSize] ?? 0) + 1;
+
+      // Simulated release of smallSize.
+      final smallCount = refs[smallSize]! - 1;
+      if (smallCount == 0) refs.remove(smallSize);
+      final targetSize = refs.isEmpty
+          ? HyperRenderConfig.defaults.textPainterCacheSize
+          : refs.keys.reduce((a, b) => a > b ? a : b);
+      RenderHyperBox.setGlobalTextCacheSize(targetSize);
+
+      // After small viewer disposes, large viewer's size is restored.
+      expect(RenderHyperBox.globalTextCacheSize, largeSize);
+
+      // Restore default.
+      RenderHyperBox.setGlobalTextCacheSize(
+          HyperRenderConfig.defaults.textPainterCacheSize);
+    });
+
+    testWidgets('globalTextCacheSize is exposed as static getter',
+        (tester) async {
+      final defaultSize = HyperRenderConfig.defaults.textPainterCacheSize;
+      RenderHyperBox.setGlobalTextCacheSize(defaultSize);
+
+      expect(RenderHyperBox.globalTextCacheSize, equals(defaultSize));
+
+      const custom = 1000;
+      RenderHyperBox.setGlobalTextCacheSize(custom);
+      expect(RenderHyperBox.globalTextCacheSize, equals(custom));
+
+      // Restore.
+      RenderHyperBox.setGlobalTextCacheSize(defaultSize);
+    });
+  });
+
+  // ═══════════════════════════════════════════════════════════════════════════
+  // HIGH-01: ScaffoldMessenger.of crashes when no Scaffold ancestor
+  // ═══════════════════════════════════════════════════════════════════════════
+  group('HIGH-01 — ScaffoldMessenger.of → maybeOf', () {
+    testWidgets(
+        'HyperViewer with selectable=true does not crash when embedded without Scaffold',
+        (tester) async {
+      // Before fix: tapping Copy in hyper_selection_overlay called
+      // ScaffoldMessenger.of(context) which throws when no Scaffold is present.
+      // After fix: ScaffoldMessenger.maybeOf returns null and the snackbar is
+      // simply skipped.
+      await tester.pumpWidget(
+        MaterialApp(
+          // No Scaffold wrapping — intentionally absent.
+          home: SizedBox(
+            width: 400,
+            height: 600,
+            child: HyperViewer(
+              html: '<p>Hello world</p>',
+              selectable: true,
+              mode: HyperRenderMode.sync,
+              renderConfig: const HyperRenderConfig(useMicrotaskParsing: true),
+            ),
+          ),
+        ),
+      );
+      await tester.pump();
+
+      // The widget must render without throwing.
+      expect(find.byType(HyperViewer), findsOneWidget);
+
+      // Triggering copySelection through code path should NOT throw.
+      // (We can't easily simulate a long-press here, but the maybeOf fix
+      // prevents the crash at the call site regardless of gesture origin.)
+      expect(tester.takeException(), isNull);
+    });
+
+    testWidgets(
+        'VirtualizedSelectionOverlay copy does not crash without Scaffold',
+        (tester) async {
+      await tester.pumpWidget(
+        MaterialApp(
+          // No Scaffold.
+          home: SizedBox(
+            width: 400,
+            height: 600,
+            child: HyperViewer(
+              html: '<p>${'word ' * 300}</p>',
+              selectable: true,
+              mode: HyperRenderMode.virtualized,
+              renderConfig: const HyperRenderConfig(useMicrotaskParsing: true),
+            ),
+          ),
+        ),
+      );
+      await tester.pump();
+      expect(tester.takeException(), isNull);
+    });
+  });
+
+  // ═══════════════════════════════════════════════════════════════════════════
+  // HIGH-02: HyperRenderConfig.hashCode excluded keyframeRegistry values
+  // ═══════════════════════════════════════════════════════════════════════════
+  group('HIGH-02 — HyperRenderConfig hashCode / == contract', () {
+    test('configs with same keys but different HyperKeyframes are not equal',
+        () {
+      final kf1 = HyperKeyframes(name: 'fade', keyframes: [
+        const HyperKeyframe(offset: 0.0, opacity: 0.0),
+        const HyperKeyframe(offset: 1.0, opacity: 1.0),
+      ]);
+      final kf2 = HyperKeyframes(name: 'fade', keyframes: [
+        const HyperKeyframe(offset: 0.0, opacity: 0.5), // different opacity
+        const HyperKeyframe(offset: 1.0, opacity: 1.0),
+      ]);
+
+      final configA = HyperRenderConfig(keyframeRegistry: {'fade': kf1});
+      final configB = HyperRenderConfig(keyframeRegistry: {'fade': kf2});
+
+      expect(configA, isNot(equals(configB)));
+      // After fix: hashCodes must also differ (or at least not violate contract).
+      // Two unequal objects MAY have equal hashCodes (collision), but equal
+      // objects MUST have equal hashCodes. Here we check the converse does not
+      // hold — unequal configs should ideally have different hashCodes.
+      // This test would FAIL before the fix because hashCode used only keys.
+      if (configA == configB) fail('configs must not be equal');
+      // If they are unequal the hashCode mismatch is a contract violation.
+      // After fix, this assertion holds in practice (no collision for these values).
+      expect(configA.hashCode, isNot(equals(configB.hashCode)));
+    });
+
+    test('HyperKeyframe value equality works', () {
+      const kf1 = HyperKeyframe(offset: 0.5, opacity: 0.8, scale: 1.2);
+      const kf2 = HyperKeyframe(offset: 0.5, opacity: 0.8, scale: 1.2);
+      const kf3 = HyperKeyframe(offset: 0.5, opacity: 0.9, scale: 1.2);
+
+      expect(kf1, equals(kf2));
+      expect(kf1, isNot(equals(kf3)));
+      expect(kf1.hashCode, equals(kf2.hashCode));
+    });
+
+    test('HyperKeyframes value equality works', () {
+      final kfA = HyperKeyframes(name: 'a', keyframes: [
+        const HyperKeyframe(offset: 0.0, opacity: 0.0),
+        const HyperKeyframe(offset: 1.0, opacity: 1.0),
+      ]);
+      final kfB = HyperKeyframes(name: 'a', keyframes: [
+        const HyperKeyframe(offset: 0.0, opacity: 0.0),
+        const HyperKeyframe(offset: 1.0, opacity: 1.0),
+      ]);
+      final kfC = HyperKeyframes(name: 'a', keyframes: [
+        const HyperKeyframe(offset: 0.0, opacity: 0.5), // different
+        const HyperKeyframe(offset: 1.0, opacity: 1.0),
+      ]);
+
+      expect(kfA, equals(kfB));
+      expect(kfA, isNot(equals(kfC)));
+      expect(kfA.hashCode, equals(kfB.hashCode));
+    });
+  });
+
+  // ═══════════════════════════════════════════════════════════════════════════
+  // HIGH-03: clearSelection missing mounted guard → setState after dispose
+  // HIGH-04: _updateHandlePositions missing mounted guard → setState after dispose
+  // ═══════════════════════════════════════════════════════════════════════════
+  group('HIGH-03 / HIGH-04 — selection overlay mounted guards', () {
+    testWidgets(
+        'HyperSelectionOverlay clearSelection does not throw after widget is removed',
+        (tester) async {
+      final key = GlobalKey<HyperSelectionOverlayState>();
+
+      await tester.pumpWidget(
+        MaterialApp(
+          home: Scaffold(
+            body: HyperSelectionOverlay(
+              key: key,
+              document: DocumentNode(children: [
+                BlockNode.p(children: [TextNode('Select me')])
+              ]),
+              selectable: true,
+              handleColor: Colors.blue,
+              config: const HyperRenderConfig(useMicrotaskParsing: true),
+            ),
+          ),
+        ),
+      );
+      await tester.pump();
+
+      // Grab state before removal.
+      final state = key.currentState!;
+
+      // Remove the widget from the tree.
+      await tester.pumpWidget(const MaterialApp(home: SizedBox.shrink()));
+      await tester.pump();
+
+      // Before fix: calling clearSelection() after dispose threw
+      // "setState() called after dispose()".
+      // After fix: the mounted guard returns early.
+      expect(() => state.clearSelection(), returnsNormally);
+      expect(tester.takeException(), isNull);
+    });
+  });
+
+  // ═══════════════════════════════════════════════════════════════════════════
+  // MED-02: onAnchorLayout not forwarded in paged mode → scrollToId silent fail
+  // MED-06: textDirection not passed to HyperSelectionOverlay in paged mode
+  // ═══════════════════════════════════════════════════════════════════════════
+  group('MED-02 / MED-06 — paged mode completeness', () {
+    testWidgets(
+        'MED-02: HyperViewerController receives anchor layout in paged mode',
+        (tester) async {
+      final controller = HyperViewerController();
+      addTearDown(controller.dispose);
+
+      const html = '<h2 id="s1">Section One</h2><p>Body text here.</p>'
+          '<h2 id="s2">Section Two</h2><p>More text.</p>';
+
+      await tester.pumpWidget(
+        MaterialApp(
+          home: Scaffold(
+            body: SizedBox(
+              width: 400,
+              height: 600,
+              child: HyperViewer(
+                html: html,
+                mode: HyperRenderMode.paged,
+                controller: controller,
+                renderConfig: const HyperRenderConfig(
+                  useMicrotaskParsing: true,
+                  virtualizationChunkSize: 1000,
+                ),
+              ),
+            ),
+          ),
+        ),
+      );
+      await tester.pumpAndSettle();
+
+      // After fix: anchor layout callback is wired in paged mode, so the
+      // controller accumulates heading data after layout.
+      // (In a real document the headings would be registered here.)
+      // We confirm no exception and that the controller is usable.
+      expect(tester.takeException(), isNull);
+      // scrollToId with an unknown id is a no-op — must not crash.
+      expect(() => controller.scrollToId('s1'), returnsNormally);
+    });
+
+    testWidgets('MED-06: paged selectable mode renders without error for RTL',
+        (tester) async {
+      await tester.pumpWidget(
+        MaterialApp(
+          home: Scaffold(
+            body: SizedBox(
+              width: 400,
+              height: 600,
+              child: HyperViewer(
+                html: '<p>مرحباً بالعالم</p>', // Arabic RTL
+                mode: HyperRenderMode.paged,
+                selectable: true,
+                textDirection: TextDirection.rtl,
+                renderConfig: const HyperRenderConfig(
+                  useMicrotaskParsing: true,
+                ),
+              ),
+            ),
+          ),
+        ),
+      );
+      await tester.pumpAndSettle();
+      expect(tester.takeException(), isNull);
+    });
+  });
+
+  // ═══════════════════════════════════════════════════════════════════════════
+  // CSS Attribute Selector bug — false negative + false positive
+  // ═══════════════════════════════════════════════════════════════════════════
+  group('CSS Attribute Selector fixes', () {
+    DocumentNode makeDiv({
+      Map<String, String> attrs = const {},
+    }) =>
+        DocumentNode(children: [
+          BlockNode(
+              tagName: 'div', attributes: attrs, children: [TextNode('text')])
+        ]);
+
+    test(
+        'false negative fixed: [attr="val"] selector now matches node with attribute',
+        () {
+      final doc = makeDiv(attrs: {'data-theme': 'dark'});
+      final resolver = StyleResolver();
+      resolver.parseCss('[data-theme="dark"] { color: #ff0000; }');
+      resolver.resolveStyles(doc);
+      // Before fix: color was null (selector never matched).
+      // After fix: color is red.
+      expect(doc.children.first.style.color, equals(const Color(0xFFFF0000)));
+    });
+
+    test('false negative fixed: div[attr] matches div WITH attribute', () {
+      final doc = makeDiv(attrs: {'data-active': 'true'});
+      final resolver = StyleResolver();
+      resolver.parseCss('div[data-active] { color: #0000ff; }');
+      resolver.resolveStyles(doc);
+      expect(doc.children.first.style.color, equals(const Color(0xFF0000FF)));
+    });
+
+    test(
+        'false positive fixed: div.class[attr="val"] must NOT match div.class WITHOUT attr',
+        () {
+      final docWithAttr = DocumentNode(children: [
+        BlockNode(
+            tagName: 'div',
+            attributes: const {'class': 'card', 'data-active': 'true'},
+            children: [TextNode('a')])
+      ]);
+      final docWithoutAttr = DocumentNode(children: [
+        BlockNode(
+            tagName: 'div',
+            attributes: const {'class': 'card'},
+            children: [TextNode('b')])
+      ]);
+
+      final resolver = StyleResolver();
+      resolver.parseCss('div.card[data-active="true"] { color: #ff0000; }');
+      resolver.resolveStyles(docWithAttr);
+      resolver.resolveStyles(docWithoutAttr);
+
+      // After fix: only the node WITH the attribute gets red.
+      expect(docWithAttr.children.first.style.color,
+          equals(const Color(0xFFFF0000)),
+          reason: 'Node with data-active="true" must get red color');
+      expect(docWithoutAttr.children.first.style.color,
+          isNot(equals(const Color(0xFFFF0000))),
+          reason: 'Node without data-active attribute must NOT get red color');
+    });
+
+    test('attribute presence selector [attr] matches any value', () {
+      final doc = makeDiv(attrs: {'hidden': 'whatever'});
+      final resolver = StyleResolver();
+      resolver.parseCss('[hidden] { color: #888888; }');
+      resolver.resolveStyles(doc);
+      expect(doc.children.first.style.color, equals(const Color(0xFF888888)));
+    });
+
+    test('[attr^="val"] prefix match', () {
+      final doc = makeDiv(attrs: {'class': 'btn-primary'});
+      final resolver = StyleResolver();
+      resolver.parseCss('[class^="btn"] { color: #00ff00; }');
+      resolver.resolveStyles(doc);
+      expect(doc.children.first.style.color, equals(const Color(0xFF00FF00)));
+    });
+
+    test('[attr*="val"] substring match', () {
+      final doc = makeDiv(attrs: {'class': 'icon-close-lg'});
+      final resolver = StyleResolver();
+      resolver.parseCss('[class*="close"] { color: #ff00ff; }');
+      resolver.resolveStyles(doc);
+      expect(doc.children.first.style.color, equals(const Color(0xFFFF00FF)));
+    });
+  });
+
+  // ═══════════════════════════════════════════════════════════════════════════
+  // rgb() parsing from stylesheet (not inline style) — was stripped to "0,255,0)"
+  // ═══════════════════════════════════════════════════════════════════════════
+  group('rgb() stylesheet parsing fix', () {
+    DocumentNode _makeP() => DocumentNode(children: [
+          BlockNode.p(children: [TextNode('text')])
+        ]);
+
+    test('rgb() in stylesheet is parsed to correct Color', () {
+      final doc = _makeP();
+      final resolver = StyleResolver();
+      resolver.parseCss('p { color: rgb(0, 255, 0); }');
+      resolver.resolveStyles(doc);
+      // Before fix: color was null (value was stored as "0, 255, 0)")
+      // and _parseColor("0, 255, 0)") returned null.
+      // After fix: full "rgb(0, 255, 0)" is stored and parsed correctly.
+      expect(doc.children.first.style.color, equals(const Color(0xFF00FF00)));
+    });
+
+    test('rgba() in stylesheet is parsed to correct Color with opacity', () {
+      final doc = _makeP();
+      final resolver = StyleResolver();
+      resolver.parseCss('p { color: rgba(255, 0, 0, 0.5); }');
+      resolver.resolveStyles(doc);
+      expect(doc.children.first.style.color, isNotNull);
+      // Alpha ~128 (0.5 × 255)
+      expect(doc.children.first.style.color.a, closeTo(0.5, 0.02));
+    });
+
+    test('multi-value property (margin: 10px 20px) still parses correctly', () {
+      final doc = _makeP();
+      final resolver = StyleResolver();
+      resolver.parseCss('p { margin: 8px 16px; }');
+      resolver.resolveStyles(doc);
+      // Margin should be non-zero (8px top/bottom, 16px left/right).
+      expect(doc.children.first.style.margin, isNotNull);
+    });
+  });
+}
diff --git a/test/v1_3_3_comprehensive_testing_test.dart b/test/v1_3_3_comprehensive_testing_test.dart
new file mode 100644
index 0000000..48ce934
--- /dev/null
+++ b/test/v1_3_3_comprehensive_testing_test.dart
@@ -0,0 +1,225 @@
+// ignore_for_file: prefer_const_constructors, avoid_print, no_leading_underscores_for_local_identifiers
+import 'package:flutter/material.dart';
+import 'package:flutter_test/flutter_test.dart';
+import 'package:hyper_render/hyper_render.dart';
+
+
+UDTNode? findNodeByTagName(UDTNode node, String tagName) {
+  if (node.tagName == tagName) return node;
+  for (final child in node.children) {
+    final found = findNodeByTagName(child, tagName);
+    if (found != null) return found;
+  }
+  return null;
+}
+
+DocumentNode _parseAndResolve(String html) {
+  final doc = HtmlAdapter().parse(html);
+  StyleResolver().resolveStyles(doc);
+  return doc;
+}
+
+void main() {
+  // ═══════════════════════════════════════════════════════════════════════════
+  // 1. UNIT TESTING
+  // ═══════════════════════════════════════════════════════════════════════════
+  group('v1.3.3 Unit Tests', () {
+    test('FloatCarryover equality handles imagePixelOffset correctly', () {
+      final f1 = FloatCarryover(
+        direction: HyperFloat.left,
+        width: 150.0,
+        overhangHeight: 80.0,
+        imagePixelOffset: 30.0,
+      );
+      final f2 = FloatCarryover(
+        direction: HyperFloat.left,
+        width: 150.0,
+        overhangHeight: 80.0,
+        imagePixelOffset: 30.0,
+      );
+      final f3 = FloatCarryover(
+        direction: HyperFloat.left,
+        width: 150.0,
+        overhangHeight: 80.0,
+        imagePixelOffset: 45.0, // different offset
+      );
+
+      expect(f1, equals(f2));
+      expect(f1, isNot(equals(f3)));
+      expect(f1.hashCode, equals(f2.hashCode));
+      expect(f1.hashCode, isNot(equals(f3.hashCode)));
+    });
+
+    test('ComputedStyle copying retains object-fit value', () {
+      final style = ComputedStyle(objectFit: 'contain');
+      final copied = style.copyWith(objectFit: 'cover');
+      final copiedNoChange = style.copyWith(color: Colors.red);
+
+      expect(copied.objectFit, equals('cover'));
+      expect(copiedNoChange.objectFit, equals('contain'));
+    });
+  });
+
+  // ═══════════════════════════════════════════════════════════════════════════
+  // 2. INTEGRATION TESTING
+  // ═══════════════════════════════════════════════════════════════════════════
+  group('v1.3.3 Integration Tests', () {
+    testWidgets('onMemoryPressure triggers in Sync mode', (tester) async {
+      int triggerCount = 0;
+
+      await tester.pumpWidget(
+        MaterialApp(
+          home: Scaffold(
+            body: HyperViewer(
+              html: '<p>Sync text</p>',
+              mode: HyperRenderMode.sync,
+              onMemoryPressure: () {
+                triggerCount++;
+              },
+            ),
+          ),
+        ),
+      );
+      await tester.pump();
+
+      tester.binding.handleMemoryPressure();
+      await tester.pump();
+
+      expect(triggerCount, equals(1));
+    });
+
+    testWidgets('onMemoryPressure triggers in Virtualized mode', (tester) async {
+      int triggerCount = 0;
+
+      await tester.pumpWidget(
+        MaterialApp(
+          home: Scaffold(
+            body: SizedBox(
+              height: 200,
+              child: HyperViewer(
+                html: '<p>Line 1</p><p>Line 2</p><p>Line 3</p>',
+                mode: HyperRenderMode.virtualized,
+                onMemoryPressure: () {
+                  triggerCount++;
+                },
+              ),
+            ),
+          ),
+        ),
+      );
+      // Wait for async parsing and initial frame rendering using discrete pumps
+      await tester.pump(Duration(milliseconds: 100));
+      await tester.pump(Duration(milliseconds: 100));
+
+      tester.binding.handleMemoryPressure();
+      await tester.pump();
+
+      expect(triggerCount, equals(1));
+    });
+  });
+
+  // ═══════════════════════════════════════════════════════════════════════════
+  // 3. SYSTEM TESTING
+  // ═══════════════════════════════════════════════════════════════════════════
+  group('v1.3.3 System Tests', () {
+    testWidgets('Renders image with valid object-fit inside HyperViewer', (tester) async {
+      await tester.pumpWidget(
+        MaterialApp(
+          home: Scaffold(
+            body: HyperViewer(
+              html: '<img src="https://example.com/logo.png" style="object-fit: cover; width: 100px; height: 100px;" />',
+              mode: HyperRenderMode.sync,
+            ),
+          ),
+        ),
+      );
+      await tester.pump();
+
+      expect(find.byType(HyperViewer), findsOneWidget);
+      expect(tester.takeException(), isNull);
+    });
+  });
+
+  // ═══════════════════════════════════════════════════════════════════════════
+  // 4. PERFORMANCE TESTING
+  // ═══════════════════════════════════════════════════════════════════════════
+  group('v1.3.3 Performance Benchmarks', () {
+    test('Benchmark parsing of object-fit styles', () {
+      final html = StringBuffer('<div>');
+      for (int i = 0; i < 500; i++) {
+        html.write('<img style="object-fit: cover;" />');
+      }
+      html.write('</div>');
+
+      final adapter = HtmlAdapter();
+      final stopwatch = Stopwatch()..start();
+      final doc = adapter.parse(html.toString());
+      stopwatch.stop();
+
+      print('Parsed 500 image nodes with object-fit: ${stopwatch.elapsedMilliseconds}ms');
+      expect(doc.children, isNotEmpty);
+      expect(stopwatch.elapsedMilliseconds, lessThan(150),
+          reason: 'Parsing 500 image tags must be fast');
+    });
+  });
+
+  // ═══════════════════════════════════════════════════════════════════════════
+  // 5. STRESS TESTING
+  // ═══════════════════════════════════════════════════════════════════════════
+  group('v1.3.3 Stress Tests', () {
+    testWidgets('Handles a document containing multiple floated images', (tester) async {
+      final buffer = StringBuffer('<div>');
+      for (int i = 0; i < 100; i++) {
+        buffer.write('<img src="https://example.com/img$i.png" style="float: left; width: 20px; height: 20px;" />');
+        buffer.write('<p>Text content wrapper $i</p>');
+      }
+      buffer.write('</div>');
+
+      await tester.pumpWidget(
+        MaterialApp(
+          home: Scaffold(
+            body: SizedBox(
+              height: 400,
+              child: HyperViewer(
+                html: buffer.toString(),
+                mode: HyperRenderMode.virtualized,
+              ),
+            ),
+          ),
+        ),
+      );
+      await tester.pump(Duration(milliseconds: 100));
+      await tester.pump(Duration(milliseconds: 100));
+
+      expect(find.byType(HyperViewer), findsOneWidget);
+      expect(tester.takeException(), isNull);
+    });
+  });
+
+  // ═══════════════════════════════════════════════════════════════════════════
+  // 6. SECURITY TESTING
+  // ═══════════════════════════════════════════════════════════════════════════
+  group('v1.3.3 Security Testing', () {
+    test('XSS sanitization strips or invalidates malformed object-fit values', () {
+      final doc = _parseAndResolve(
+        '<img style="object-fit: expression(alert(1));" />',
+      );
+      final img = findNodeByTagName(doc, 'img');
+      expect(img, isNotNull);
+      expect(img!.style.objectFit, isNull,
+          reason: 'Malformed object-fit value with potential script execution must be filtered');
+    });
+
+    test('Valid CSS properties are retained while unknown / malicious are stripped', () {
+      final doc = _parseAndResolve(
+        '<img style="object-fit: cover; width: url(javascript:alert(1));" />',
+      );
+      final img = findNodeByTagName(doc, 'img');
+      expect(img, isNotNull);
+      expect(img!.style.objectFit, equals('cover'),
+          reason: 'Valid properties must be kept');
+      expect(img.style.width, isNull,
+          reason: 'Malicious CSS URL expression must be filtered out');
+    });
+  });
+}