Merge develop into main: release v1.8.0

Release v1.8.0

Author: Gnathonic

.claude/skills/verify/SKILL.md

@@ -0,0 +1,45 @@
+---
+name: verify
+description: Verify reader features end-to-end by importing a synthetic volume through the real upload modal and driving the reader with Playwright. Use when a change needs runtime observation in the actual app (not unit tests).
+---
+
+# Verifying mokuro-reader changes end-to-end
+
+## Launch
+
+```bash
+npm run dev -- --port 5199 --strictPort   # dedicated port; NEVER bare 5173 (other worktrees own it)
+```
+
+Browser: Playwright from `node_modules`, executablePath
+`~/.cache/ms-playwright/chromium-1208/chrome-linux64/chrome` (note `chrome-linux64`, not `chrome-linux`).
+Headless is fine. Don't drive the user's Chrome (stale service worker, port collisions, hidden-window rAF freeze).
+
+## Synthetic volume fixture
+
+The import needs a `.mokuro` + matching `.cbz` (same basename):
+
+- Pages: ImageMagick solid-color portraits with page numbers:
+  `magick -size 1400x2000 xc:"#d8f0ff" -bordercolor black -border 8 -resize 1400x2000\! -gravity center -pointsize 400 -annotate 0 "1" 001.png`
+- `vol1.cbz`: `zip -j vol1.cbz *.png`
+- `vol1.mokuro` (all fields required): `{version, title, title_uuid, volume, volume_uuid, chars, pages: [{version, img_width, img_height, blocks: [], img_path}]}`
+
+## Import through the real UI
+
+1. Navbar icon cluster: `div.flex.gap-5 > button` — nth(2) is the upload icon → opens the Import modal (`<dialog>`).
+2. **Gotcha:** `getByRole()` fails to match buttons inside the flowbite modal `<dialog>` — use CSS locators (`page.locator('dialog button', { hasText: ... })`) or `page.evaluate` with `textContent.trim()` matching.
+3. `waitForEvent('filechooser')` + click the `choose files` button, `setFiles([vol1.mokuro, vol1.cbz])`, then click the exact-text `Import` button.
+4. Wait for `text=GapTest` in the catalog, click series → volume → reader (`#/reader/<title>/<uuid>`).
+
+## Driving the reader
+
+- RTL default: `ArrowLeft` = forward. Auto view mode pairs pages (cover shows alone first).
+- Page elements: `#manga-panel [data-page-index]` — measure `getBoundingClientRect()` for gap/scale/pan assertions (natural page width 1400 → scale = rect.width/1400).
+- Wheel with modifiers: `page.keyboard.down('Control'/'Shift')` + `page.mouse.wheel(0, ±100)` — Playwright applies held modifiers to the wheel event. CDP does NOT swap deltaY→deltaX under shift the way real input does; handlers reading `deltaY || deltaX` cover both.
+- Reader toast: search text nodes for the notification string.
+- Reader settings drawer: `button.reader-hud.right-3` (there are 3 `.reader-hud` buttons; `.first()` is the page-counter). Toggle labels (e.g. "Continuous scroll") are clickable once the drawer opens; close by clicking far from the drawer.
+- Persisted settings check: `JSON.parse(localStorage.getItem('profiles'))[currentProfile]`.
+
+## Known noise
+
+- `[pageerror] Unexpected token '<'` on first dev-server load — pre-existing dev artifact, unrelated to features.

.env.example

@@ -0,0 +1,7 @@
+# Google Drive sync (optional — omit to disable)
+VITE_GDRIVE_CLIENT_ID=
+VITE_GDRIVE_API_KEY=
+
+# OneDrive sync (optional — omit to hide the OneDrive option)
+# Azure AD app registration with the deploy origin as an SPA redirect URI.
+VITE_ONEDRIVE_CLIENT_ID=

CHANGELOG.md

@@ -1,5 +1,27 @@
 # Changelog
 
+## [1.8.0] - 2026-07-05
+
+### Added
+
+- New Local Folder provider: Chromium-only bulk export, or direct access to sync-only files (#250)
+- OneDrive added as a cloud sync provider (#250)
+- Paged mode pages can now have a gap between them (#234)
+- Ctrl/Cmd+Shift+Scroll live-adjusts the page gap (#234)
+
+### Fixed
+
+- Quick Actions button's solid background restored (#249)
+- Fixed a bug where reconnecting Google Drive could revert synced progress
+- File type matching on Drive and MEGA is now case-insensitive
+- Fixed overlapping text lines in auto mode
+
+### Changed
+
+- Expired Google Drive sessions now show a Reconnect button
+- Google Drive reconnect works reliably everywhere now, no popup setup needed
+- WebDAV now mentions Mokuro-Bunko server compatibility
+
 ## [1.7.5] - 2026-07-05
 
 ### Added

CLAUDE.md

@@ -250,14 +250,21 @@ Night mode applies a CSS `filter` to `<dialog>` elements (see `app.html`). The `
 
 ## Environment Variables
 
-Create a `.env.local` file for Google Drive integration:
+Create a `.env.local` file for cloud provider integration:
 
 ```
 VITE_GDRIVE_CLIENT_ID=your_client_id
 VITE_GDRIVE_API_KEY=your_api_key
+VITE_ONEDRIVE_CLIENT_ID=your_azure_app_client_id
 ```
 
-These are only required for Google Drive sync. MEGA and WebDAV don't require env vars.
+- `VITE_GDRIVE_*`: required only for Google Drive sync.
+- `VITE_ONEDRIVE_CLIENT_ID`: required only for OneDrive sync. Register an
+  Azure AD app (any Microsoft account tenant, "common" authority) and add the
+  deploy origin as a **Single-page application** redirect URI. Scopes used:
+  `Files.ReadWrite`, `offline_access`, `User.Read`. When unset, the OneDrive
+  option is hidden from the cloud screen.
+- MEGA, WebDAV, and Local Folder require no env vars.
 
 ## Testing
 

README.md

@@ -183,13 +183,18 @@ npm test
 
 ### Environment Variables
 
-For Google Drive integration, create a `.env` file:
+For Google Drive and/or OneDrive integration, create a `.env` file:
 
 ```env
 VITE_GDRIVE_CLIENT_ID=your_client_id
 VITE_GDRIVE_API_KEY=your_api_key
+VITE_ONEDRIVE_CLIENT_ID=your_azure_app_client_id
 ```
 
+For OneDrive, register an Azure AD app ("common" authority) and add your deploy
+origin as a **Single-page application** redirect URI. When unset, the OneDrive
+option is hidden. MEGA, WebDAV, and Local Folder need no configuration.
+
 ## 💬 Community
 
 Wanna chat with the devs? Share your hopes, dreams, and issues (with Mokuro Reader specifically)? Come join the [Mokuro Reader Discord](https://discord.gg/AU5pjjSQBw)!

docs/INPUT-CONTRACTS.md

@@ -112,7 +112,14 @@ Zoom settles carry a `SettleReason` (`zoom-controller.ts`): only
 | Pinch survivor | keeps panning                     | ignored until fresh press               |
 | Tap commit     | immediate                         | deferred (300 ms)                       |
 | Swipe-to-flip  | yes (mobile setting, edge-gated)  | no (panning is the scroll)              |
-| Wheel          | zoom or camera glide              | zoom or (native/strip) scroll           |
+| Wheel          | zoom, gap, or camera glide        | zoom, gap, or (native/strip) scroll     |
+
+Ctrl/meta+shift+wheel is the page-gap adjustment chord on every surface
+(paged writes `pagedGap`; scroll readers write `scrollGap` and sync
+`pageDividers`), checked before the zoom intent. Binding rule: wheel combos
+with a native browser meaning keep that meaning tuned for the reader
+(ctrl+wheel zooms, shift+wheel stays a horizontal pan); the gap chord is
+deliberately one no browser binds.
 
 ## Testing