Generate EPUB workers at build time and retire stale reader artifacts

.github/workflows/ci.yml

@@ -16,12 +16,11 @@ jobs:
       - uses: actions/checkout@v4
       - uses: subosito/flutter-action@v2
         with:
-          flutter-version: '3.41.2'
+          flutter-version: '3.47.9'
           channel: stable
           cache: true
       - run: flutter pub get --enforce-lockfile
-      - run: bash tool/build_epub_worker.sh --check
-      - run: dart format --output=none --set-exit-if-changed lib test example/lib example/test tool
+      - run: dart format --output=none --set-exit-if-changed bin lib test example/lib example/test tool
       - run: flutter analyze
       - run: flutter test
       - run: flutter analyze
@@ -30,6 +29,7 @@ jobs:
         working-directory: example
       - run: flutter build web
         working-directory: example
+      - run: python3 tool/check_worker_build.py
       - uses: actions/setup-node@v4
         with:
           node-version: '22'
@@ -55,24 +55,12 @@ jobs:
       - uses: actions/checkout@v4
       - uses: subosito/flutter-action@v2
         with:
-          flutter-version: '3.41.2'
+          flutter-version: '3.47.9'
           channel: stable
           cache: true
       - run: sudo apt-get update && sudo apt-get install -y libgtk-3-dev
         if: matrix.target == 'linux'
       - run: flutter pub get
         working-directory: example
       - run: flutter build ${{ matrix.target }}
-        if: matrix.target != 'macos'
-        working-directory: example
-      - run: flutter build macos --config-only --release
-        if: matrix.target == 'macos'
-        working-directory: example
-      # Flutter 3.41.2's universal build has an Xcode 27 architecture-check issue.
-      # Compile the runner architecture until flutter/flutter#188346 is fixed.
-      - run: >-
-          xcodebuild -workspace macos/Runner.xcworkspace -scheme Runner
-          -configuration Release -derivedDataPath build/macos -sdk macosx
-          ARCHS="$(uname -m)" ONLY_ACTIVE_ARCH=YES CODE_SIGNING_ALLOWED=NO build
-        if: matrix.target == 'macos'
         working-directory: example

AGENTS.md

@@ -2,7 +2,7 @@
 
 This is an independent Flutter package and Git repository. The owning workspace
 is one level up; use its `tools/flutter` and `tools/dart` SDK wrappers when present.
-Read `docs/architecture.md` before changing architecture or expanding formats.
+Read `docs/ARCHITECTURE.md` before changing architecture or expanding formats.
 
 - Domain types are host-facing and serializable. Implement the current locator contract
   without compatibility shims for older app versions.
@@ -13,11 +13,11 @@ Read `docs/architecture.md` before changing architecture or expanding formats.
 - EPUB document processing is pure Dart in `lib/src/engine/epub/worker`. Native
   isolates and browser workers use the same request/response protocol. Never
   move ZIP, XML or chapter HTML parsing back onto the Flutter UI thread.
-- Rebuild `assets/epub_worker.js` with `tool/build_epub_worker.sh` after modifying
-  worker source. The packaged JS lets dependent applications build without a
-  manual worker generation step. CI checks the generated asset for drift.
-  This package commits `pubspec.lock` and pins its CI SDK so the
-  browser worker and third-party notices are reproducible.
+- Flutter 3.47 or newer generates the browser worker automatically during web
+  builds through `bin/compile_epub_worker.dart`. Keep its dependency report complete
+  so imported source and license changes invalidate the generated asset. Native
+  builds exclude it. Do not commit generated JavaScript or third-party notices.
+  This package commits `pubspec.lock` and pins its CI SDK.
 - UI text measurement belongs in Flutter. Preserve semantic runs, Unicode,
   illustrations and content offsets when reflowing. Layout must use actual viewport
   constraints, system insets and text scaling.

README.md

@@ -57,7 +57,7 @@ and a live `buildContent(context, scrollController)` builder without reader head
 or framing. Return an unpushed `Route<void>`; the reader handles presentation,
 activity tracking and cleanup. Connect the builder's scroll controller to your
 sheet's scrolling coordinator. Omit this hook to use the standalone defaults.
-See [Architecture](docs/architecture.md) for the presentation contract.
+See [Architecture](docs/ARCHITECTURE.md) for the presentation contract.
 
 ## Example
 
@@ -76,27 +76,32 @@ production persistence belongs to the host application.
 The initial release supports reflowable EPUB 2/3 and PDF. Fixed-layout EPUBs
 return `ReaderErrorCode.unsupportedFixedLayout`. MOBI/AZW3, TXT, comic
 archives, search, bookmarks, highlights, and notes are planned extensions.
+Encrypted/DRM documents are unsupported. EPUB uses semantic reflow: publisher
+stylesheets, embedded fonts, advanced SVG/math, RTL progression and footnote
+interaction are incomplete; complex tables render as readable rows.
 
-- [Architecture](docs/architecture.md)
-- [Client integration](docs/integration.md)
-- [Supported formats](docs/supported-formats.md)
+- [Architecture](docs/ARCHITECTURE.md)
+- [Client integration](docs/INTEGRATION.md)
 
 ## Development
 
 ```bash
 flutter analyze
 flutter test
-./tool/build_epub_worker.sh
 (cd example && flutter analyze && flutter test && flutter build web)
 # From the reader repository, after building the example:
 (cd tool/browser && npm ci && npx playwright install chromium && npm test)
 ```
 
-Use the parent workspace's pinned SDK wrappers when available. The generated
-browser worker is packaged so host applications need no extra build step; rebuild
-it after changing worker source. Browser CSP must allow `worker-src blob:`.
-Use `tool/build_epub_worker.sh --check` to check asset drift. Browser checks can
-use an installed Chrome via `PAPYRUS_CHROME_EXECUTABLE` and save screenshots via
-`PAPYRUS_SCREENSHOT_DIR`. See [Validation](docs/validation.md) for platform coverage.
+Use the parent workspace's pinned SDK wrappers when available. Flutter 3.47 or
+newer automatically compiles the browser worker from `tool/epub_worker.dart` during
+web builds, using the host application's resolved dependencies. The one-line
+`assets/epub_worker` file identifies that Dart entrypoint for the asset transformer.
+The generated JavaScript includes dependency license notices; neither is checked
+into this package.
+Native builds omit this asset. Browser CSP must allow `worker-src blob:`.
+Browser checks can use an installed Chrome via `PAPYRUS_CHROME_EXECUTABLE` and save
+screenshots via `PAPYRUS_SCREENSHOT_DIR`. See [Validation](docs/VALIDATION.md) for
+platform coverage.
 
 Licensed under AGPL-3.0.

assets/epub_worker

@@ -0,0 +1 @@
+tool/epub_worker.dart