.dockerignore: let moments.js into the image; guard test checks the allowlist too

f38f218 failed to build: .dockerignore is an allowlist and kept moments.js out of the build context. Verified by building the image and starting the reader from it (health ok). Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Dockerfile: copy moments.js; guard test for required top-level modules
2026-10-27 13:47:26 +01:00 · 2026-10-27 12:56:07 +01:00 · 2026-10-27 12:38:22 +01:00 · 2026-10-27 12:30:24 +01:00 · 2026-10-27 12:08:35 +01:00 · 2026-10-27 12:02:16 +01:00
33 changed files with 1170 additions and 44 deletions
@@ -10,6 +10,7 @@
 !backup.js
 !reading-analytics.js
 !reading-access.js
 !moments.js
 !public/
 !public/**
 !greatest/
@@ -3,7 +3,7 @@ RUN apk add --no-cache tzdata openssl
 WORKDIR /app
 ARG VCS_REF=development
 LABEL org.opencontainers.image.title="MangaCircus" org.opencontainers.image.revision=$VCS_REF
-COPY package.json server.js library.js reading-direction.js chapter-identity.js chapter-dates.js reading-analytics.js reading-access.js catalog.js backup.js ./
+COPY package.json server.js library.js reading-direction.js chapter-identity.js chapter-dates.js reading-analytics.js reading-access.js catalog.js backup.js moments.js ./
 COPY public ./public
 COPY greatest ./greatest
 COPY discovery ./discovery
@@ -142,6 +142,7 @@ completeness.
 - **Flow page gap:** Settings → Reading lets each user keep the normal separator between Flow pages or remove it for continuous webtoon artwork and text that crosses image edges.
 - **Page tone:** the reader's **Tone** button cycles Original → Inverted → Sepia → Dim → Extra dim in Flow, Page and Book. It changes only the artwork, never the controls or site theme. The choice is saved per user; it can also be selected in Settings → User → Reading.
 - **Active Reading Clock:** opt in under Settings → User → Reading time & privacy. No scrolling-speed limit; a visit counts at 60% viewed-page coverage and saves on exit. Pauses in the background or after 30 seconds without reader activity. Tap the clock for this visit's time, coverage, qualification and loading wait.
 - **Continue where you left off:** the first line of the library content (below the search, filters and tags) is one row of the five manga you read most recently and have not finished (same tiles as the grid; they stay in the grid too). It hides while a search is typed, a status filter is set, or the library is sorted by *Recently read*; tags and collection grouping do not affect it. Turn it off under Settings → User → Reading → *Library page*.
 - **Your Reading Story:** private active-time summaries appear on the library and manga pages when history exists. Chapter rows show the last timed read (60%-coverage visit), rereads remain visible as lifetime time, and Settings lets each user hide, export, or delete their own history. No leaderboards or speed ranking are used.
 - **Tap / click zones:**
  - Tapping **beside the pages** always shows or hides the controls.
@@ -149,8 +150,9 @@ completeness.
  - In Flow: the bottom part of the screen goes forward, the top part goes back.
  - The middle of the page also toggles the controls (useful when a zoomed page fills the screen).
  - A horizontal swipe also turns pages on touch screens.
-  - Keys: arrows, Space / PageDown, `m` = controls, `f` = fullscreen.
+  - Keys: arrows, Space / PageDown, `i` = controls, `m` = save a moment, `f` = fullscreen, `?` = all shortcuts (also under Settings → User → Keyboard shortcuts).
- **Controls stay out of the way:** they hide as soon as you turn a page or scroll, and come back only with a tap (middle of the page or beside it). Scrolling up never brings them back. The first time they hide, a short hint says so.
+- **Moments:** the bookmark button in the top bar (or `m`) saves the page you are on (in Book mode the spread) as a moment. A picture that runs over several pages can take up to four: *+ Previous page* / *+ Next page* add them, stacked in Flow and side by side in Page and Book. Drag over the preview to keep only a region (pages it doesn't touch are left out), and pick exactly one category: Twist, Hot, Awesome, Cute, Funny or Feels, plus an optional note. The button is filled on pages that already have one. Each manga page shows *Your moments* as a strip of crops, sorted by story or by when you saved them; click one to step through them, see the full page, edit, delete or jump into the reader at that page. Moments are private to each user.
 - **Controls stay out of the way:** they hide as soon as you turn a page or scroll, and come back only with a tap (middle of the page or beside it) or `i`. Scrolling up never brings them back. The first time they hide, a short hint says so.
 - **Controls:** the top bar has a chapter picker with every chapter of the manga, grouped by book, with ✓ for read ones. The bottom bar has the page slider, the mode switch, Shift, zoom, the version picker and previous/next chapter.
 - **Loading:** the next pages (next 3 in Page mode, next 2 spreads in Book mode) are downloaded and decoded in advance, so page turns don't flash. A page that still isn't there shows a spinner. On phones, "Add to home screen" opens the app without browser bars, and the ⛶ button (where supported) goes fullscreen.
 - **Progress** is saved per user and chapter version: the last page, whether the chapter is done, and book-mode shifts. The manga page offers *Continue*. Tap a chapter's status to mark it read/unread.
@@ -60,6 +60,7 @@ services:
      SCRAPER_TOKEN_FILE: /run/secrets/scraper_token
      DISCOVERY_HARVEST_AT: ${DISCOVERY_HARVEST_AT:-03:30}
      DISCOVERY_ANILIST_URL: ${DISCOVERY_ANILIST_URL:-}
      GREATEST_COVER_WARM: ${GREATEST_COVER_WARM:-1}
    networks: [backend, egress]
    healthcheck:
      test: [CMD, node, tools/healthcheck.js, reader]
@@ -128,6 +128,7 @@ This keeps ids human-readable and derivable without a database. The price: renam
        "flowPageGap": true,            // show the 8 px separator between pages in Flow
        "readingClock": false,           // opt in to credible per-chapter active-time tracking
        "readingStory": true,            // show private retrospective summaries when history exists
        "continueRow": true,             // library: "Continue where you left off" row at the top
        "zoom": { "flow": 1, "page": 1.5, "book": 1, "strip": 0.8 },   // page zoom per mode
        "webhook": ""
      }
@@ -150,6 +151,11 @@ This keeps ids human-readable and derivable without a database. The price: renam
  "follows":   { "admin": { "Moon Garden": true } },
  "notes":     { "admin": [ { "id": "a1b2c3d4e5f6", "t": 1790797300000, "m": "Moon Garden", "c": "2/6",
                              "text": "Moon Garden · Ch. 6: Frost", "read": false } ] },
  "moments":   { "admin": [ { "id": "9f1c2b3a4d5e", "m": "Moon Garden", "c": "1/2", "v": "c0002 Roots [MangaDex]",
                              "i": [4], "f": ["0005.png"], "sha": ["<sha256 of the file>"],   // 1–4 pages in displayed order
                              "layout": "row",                                                // "row" side by side (Page/Book), "column" stacked (Flow)
                              "region": { "x": 0.1, "y": 0.5, "w": 0.5, "h": 0.25 },          // fractions of the pages put together; null = all
                              "cat": "awesome", "note": "", "t": 1790797400000 } ] },
  "votes":     { "Moon Garden": { "1/2": { "c0002 Roots [Official]": { "admin": 1, "reader": -1 } } } },
  "known":     { "Moon Garden": ["1/1", "1/2", "1/2.5", "..."] }   // every chapter id ever seen (append-only)
 }
@@ -200,6 +206,9 @@ All requests and responses are JSON. POSTs require `Content-Type: application/js
 | `POST /api/unread` `{m, c}` | user | Forget progress for a chapter |
 | `POST /api/vote` `{m, c, v, value: 1\|-1\|0}` | user | Vote a version; returns the re-ranked versions |
 | `POST /api/follow` `{m, on}` | user | Follow a manga for notifications |
 | `GET /api/moments?m=` | user | The caller's moments of that manga in story order: category, note, region, chapter, `order`, page images, `missing` when a page file is gone. `/api/chapter` also lists the caller's moments on the opened version |
 | `POST /api/moments` `{m, c, v, pages, layout, region, cat, note}` | user | Save a moment: `pages` are 1–4 distinct indexes in displayed order, `layout` `row` (default) or `column`, `cat` one of `twist hot awesome cute funny feels` (required), `region` fractions of the pages put together, or null |
 | `POST /api/moments/update` `{id, cat?, region?, note?}` · `POST /api/moments/delete` `{id}` | user | Edit or delete one of the caller's own moments (another user's id is `404`) |
 | `GET /api/notifications` · `POST /api/notifications/read` `{id \| all}` | user | Notification list and read state |
 | `GET /api/admin` | admin | Users, last scan result, library path |
 | `POST /api/admin/rescan` `{full}` | admin | Scan now, and wait for the result |
@@ -207,6 +216,7 @@ All requests and responses are JSON. POSTs require `Content-Type: application/js
 | `POST /api/admin/user/role` `{name, admin}` | admin | Grant or revoke admin rights; keeps the password and sessions. Revoking your own rights is refused, so one admin always remains |
 | `POST /api/admin/user/delete` `{name}` | admin | Delete a user and their data |
 | `GET /api/admin/backup` · `POST /api/admin/backup` `{command:"settings"\|"run"}` | admin | Built-in backup status, schedule/retention, "back up now" ([backup.md](backup.md)) |
 | `GET /api/greatest-cover?id=<entry>&v=<version>` | user | The Greatest entry's cover from `data/greatest-covers/` (`greatest/covers.js`), cached by the browser for a year; `v` changes with the catalog URL. A `302` to the catalog URL until the copy exists. `/api/greatest` lists this URL as `cover` for titles not in the library |
 | `GET /api/discovery` | user | The caller's discovery feed, settings, feedback and `refresh: { state: idle\|queued\|running, position?, nextAllowedAt?, blockedReason? }` (§6.6) |
 | `POST /api/discovery/feedback` `{candidateId, value}` | user | The caller's choice for a candidate; requires opt-in |
 | `POST /api/discovery/refresh` | user | Queue a per-user AniList harvest for the caller (opt-in required, else `403`). `{ harvestId, position }`; `409` while one is queued or running for the caller; `429 { nextAllowedAt }` within an hour of the last accepted refresh; `503 { blockedReason }` after AniList pushed back, until a nightly or admin harvest |
@@ -321,12 +331,12 @@ mode       = adapt && intended ∉ compatible ? compatible[0] : intended
 | Horizontal swipe ≥ 50 px within 800 ms (paged, not zoomed in) | Previous/next |
 | Ctrl + wheel, touchpad pinch, Safari gesture events, two-finger pinch | Continuous page zoom 20–600 %, snapping to 100 % within ±1 %, anchored at the pointer or finger midpoint. Browser zoom is suppressed only over the pages |
 | Mouse drag (moved ≥ 6 px) | Pan; the following click is swallowed. Hand cursor when the content is larger than the screen |
-| Keys | Arrows follow the direction; Space/PageDown/PageUp (paged); `+` and `-` zoom in 5-percentage-point steps, `0` fits at 100 %; `m`/Esc bars; `f` fullscreen |
+| Keys | Dispatched through `READER_KEYS` in `public/keys.js`, which also feeds Settings → Keyboard shortcuts and the reader's `?` list. Arrows follow the direction; Space/PageDown/PageUp (paged); `+` and `-` zoom in 5-percentage-point steps, `0` fits at 100 %; `m` saves a moment; `i`/Esc bars; `f` fullscreen; `?` shortcuts |
 **Bars:**
 - Shown on open.
 - Hidden on the first page turn or after 100 px of scrolling. The first automatic hide (per device, once for Flow and once for Page/Book) shows a hint on how to get them back.
- **Never shown by scrolling**, only by a tap beside the pages or in the middle of a page (or `m`). Showing them stops a running smooth scroll, so it can't hide them again right away.
+- **Never shown by scrolling**, only by a tap beside the pages or in the middle of a page (or `i`). Showing them stops a running smooth scroll, so it can't hide them again right away.
 - The top bar has the chapter picker (every chapter, grouped by book, ✓ = read).
 **Loading:**
@@ -350,6 +360,8 @@ mode       = adapt && intended ∉ compatible ? compatible[0] : intended
 - Pulses are sent at most every 10 seconds and on pause/page exit. The server validates the manga/chapter/version and page indices, de-duplicates `(session, seq)`, clamps time to server-observed intervals and stores compact page ranges separately from ordinary progress.
 - The bottom toolbar chip shows active time and the current state; its panel adds pass time, verified pages, predominant input and loading wait.
 **Moments** (`public/moments.js`): the top bar's bookmark button (or `m`) opens a sheet for the page(s) on screen: in Flow the page at the reading line, in Book the spread. "+ Previous page" / "+ Next page" add neighbours (up to four pages) for a picture that runs over several pages: stacked in Flow (`column`), side by side in Page and Book (`row`, right to left for `rtl`). A rectangle dragged over the preview keeps only that region, and pages it does not touch are left out. Exactly one category is required. The button is filled when the page already has a moment. The manga page shows the user's moments as a strip of crops (sort by story or by date saved, category filters from five moments), with a viewer to step through them, edit, delete or open the reader at `read.html?…&p=<page index>`. Crops position the full page images inside a clipping box; nothing is generated on the server.
 **Zoom persistence:** per mode key (`flow`, `page`, `book`, `strip`), saved 800 ms after the last change.
 ## 8. Deployment
@@ -21,7 +21,7 @@ Data on the host, all bind mounts (no named volumes):
 | Path (`.env`) | Contents | Back up? |
 |---|---|---|
 | `LIBRARY_PATH` | The manga: `Manga/Book/Chapter/images` ([library-format.md](library-format.md)) | Yes, it is your collection |
-| `DATA_PATH` | `db.json` (users, progress, votes), catalog, discovery feeds, library index cache | Yes (built-in backup, section 8). `discovery-cache/` inside it is safe to delete and may be left out of backups: the next harvest rebuilds it |
+| `DATA_PATH` | `db.json` (users, progress, votes), catalog, discovery feeds, library index cache | Yes (built-in backup, section 8). `discovery-cache/` inside it is safe to delete and may be left out of backups: the next harvest rebuilds it. The same holds for `greatest-covers/` (local copies of the Greatest catalog's cover images, fetched again after the next start) |
 | `SCRAPER_DATA_PATH` | Queue, settings, source ledger, metadata cache | Included in the built-in backup |
 | `BACKUP_PATH` | Built-in backup archives | Keep it on another disk or NAS |
 | `SCRAPER_TOKEN_PATH` | Shared secret between reader and scraper | Regenerate if lost |
@@ -71,6 +71,7 @@ demo manga in an empty library after the build in section 5:
 | `READING_WINDOWS_JSON`, `READING_TIMEZONE`, `READING_QUIZ_*` | off | Optional server-enforced reading hours ([reading-limiter.md](reading-limiter.md)) |
 | `DISCOVERY_HARVEST_AT` | `03:30` | Daily time (`HH:MM`) of the nightly Discover harvest from AniList, in the container's local time zone (`TZ`). Only users who opted in are harvested; the admin can change the time or switch it off on the Discover page ([discovery.md](discovery.md)) |
 | `DISCOVERY_ANILIST_URL` | AniList's public API | Tests only: points the discovery harvest at a fixture server. Leave unset in production |
 | `GREATEST_COVER_WARM` | `1` | `0` stops the reader from downloading the Greatest catalog's covers (about 100 images, one per second, 10 s after start and once a day for missing ones). Tests and offline installs set `0`; the page then loads covers from the catalog's own URLs |
 | `APP_IMAGE`, `VCS_REF` | `mangacircus:local`, `development` | Image to run; set a pinned registry image to deploy prebuilt releases (section 7) |
 | `COMPOSE_FILE` | `docker-compose.yml` | Extra Compose files, `:`-separated (e.g. `docker-compose.yml:deploy/compose.https.yml`) |
 | `MANGACIRCUS_DOMAIN` | – | Host name for `deploy/compose.https.yml` |
@@ -23,7 +23,7 @@ Within each cohort, **Rank by my vote** sorts flame → good → neutral → sku
 The one-time seed is curated from the research document. All 106 catalog entries now have a cover URL. Most were matched to public AniList manga metadata; the five initial gaps were checked individually. Phoenix (1954) and Nausicaä use matching AniList records; Kitarō uses Drawn & Quarterly's Kitaro edition, Someone Hertz uses Shonen Jump's first-volume cover, and Hitoner uses Shueisha's 2026 first-volume cover. Hitoner's AniList 2024 entry represents an earlier work, so it was **not** used for the 2026 series. The five added URLs returned image content on 2026-10-09, but remote hosts can change them; the UI still shows a title-letter fallback if an image fails.
-`node tools/enrich-greatest-catalog.js` is an **optional manual** public-AniList metadata refresh, paced at one request every 1.5 seconds. It only accepts matching manga title and **original serialization year**, leaving uncertain results untouched rather than using a sequel or remake cover. The dashboard makes **no metadata calls when loading**; only an admin pressing **Search MangaDex** triggers a bounded lookup. Browser covers are lazy-loaded from their listed source; local library covers take precedence.
+`node tools/enrich-greatest-catalog.js` is an **optional manual** public-AniList metadata refresh, paced at one request every 1.5 seconds. It only accepts matching manga title and **original serialization year**, leaving uncertain results untouched rather than using a sequel or remake cover. The dashboard makes **no metadata calls when loading**; only an admin pressing **Search MangaDex** triggers a bounded lookup. Local library covers take precedence. For the rest, the reader keeps its own copy of each catalog cover in `data/greatest-covers/` (`greatest/covers.js`): it downloads missing ones one at a time, about one a second, 10 seconds after start and once a day, stops on HTTP 401/403/429, and accepts only JPEG/PNG/WebP/GIF/AVIF images up to 2 MB from the catalog's own HTTPS URLs. The page loads covers from `/api/greatest-cover`, which the browser caches for a year; until a copy exists that route redirects to the catalog URL. Hotlinking about 100 covers per page load made the image CDN drop some of them at random. `GREATEST_COVER_WARM=0` switches the downloads off.
 Public catalog chapter counts are often absent; the UI says “Chapters unknown” rather than inventing one. For owned titles, the local library count wins. Status comes from AniList's releasing/finished flag or local library metadata, and may be unknown. Official source links may be publisher editions, chapter services, or an award/info lead; they do not imply all chapters are available in every country. No unverified hoster coverage is claimed.
@@ -0,0 +1,73 @@
 'use strict';
 // Local copies of the Greatest catalog's cover images. Hotlinking ~100 covers per page
 // load makes the image CDN drop some of them at random; one polite download each fixes that.
 const fs = require('node:fs');
 const path = require('node:path');
 const crypto = require('node:crypto');
 const TYPES = { 'image/jpeg': '.jpg', 'image/png': '.png', 'image/webp': '.webp', 'image/gif': '.gif', 'image/avif': '.avif' };
 const EXTENSIONS = new Set(Object.values(TYPES));
 const USER_AGENT = 'MangaCircus-Greatest/1.0';
 class GreatestCovers {
  constructor(dir, { fetchImpl = fetch, sleep = ms => new Promise(resolve => setTimeout(resolve, ms)),
    delayMs = 1000, maxBytes = 2 * 1024 * 1024, timeoutMs = 20000 } = {}) {
    this.dir = path.resolve(dir);
    Object.assign(this, { fetchImpl, sleep, delayMs, maxBytes, timeoutMs });
    this.files = new Map(); // key -> file name
    try {
      for (const name of fs.readdirSync(this.dir)) {
        const ext = path.extname(name);
        if (EXTENSIONS.has(ext)) this.files.set(path.basename(name, ext), name);
      }
    } catch (error) { if (error.code !== 'ENOENT') throw error; }
  }
  // A hash of the URL names the file, so a changed catalog URL is fetched again.
  version(url) { return crypto.createHash('sha256').update(String(url)).digest('hex').slice(0, 16); }
  file(url) {
    const name = url ? this.files.get(this.version(url)) : null;
    return name ? path.join(this.dir, name) : null;
  }
  // Sequential, paced, and stops on 403/429 like every other outbound client here.
  async warm(urls) {
    const result = { fetched: 0, skipped: 0, failed: 0, stopped: null };
    let requested = false;
    for (const url of new Set(urls.filter(url => /^https:\/\/\S+$/i.test(String(url || ''))))) {
      if (this.file(url)) { result.skipped++; continue; }
      if (requested) await this.sleep(this.delayMs);
      requested = true;
      try {
        await this.download(url);
        result.fetched++;
      } catch (error) {
        if (error.stop) { result.stopped = error.message; break; }
        result.failed++;
      }
    }
    // Duplicates and repeats of stored covers count as skipped.
    result.skipped += urls.filter(Boolean).length - new Set(urls.filter(Boolean)).size;
    return result;
  }
  async download(url) {
    const response = await this.fetchImpl(url, { headers: { 'user-agent': USER_AGENT },
      signal: AbortSignal.timeout(this.timeoutMs) });
    if ([401, 403, 429].includes(response.status)) throw Object.assign(new Error(`HTTP ${response.status}`), { stop: true });
    if (!response.ok) throw new Error(`HTTP ${response.status}`);
    const ext = TYPES[String(response.headers.get('content-type') || '').split(';')[0].trim().toLowerCase()];
    if (!ext) throw new Error('Not an image');
    if (Number(response.headers.get('content-length')) > this.maxBytes) throw new Error('Image too large');
    const body = Buffer.from(await response.arrayBuffer());
    if (!body.length || body.length > this.maxBytes) throw new Error('Image too large or empty');
    const key = this.version(url), name = key + ext;
    fs.mkdirSync(this.dir, { recursive: true });
    const temp = path.join(this.dir, `.${key}.${crypto.randomBytes(4).toString('hex')}.tmp`);
    try {
      fs.writeFileSync(temp, body);
      fs.renameSync(temp, path.join(this.dir, name));
    } finally { fs.rmSync(temp, { force: true }); }
    this.files.set(key, name);
  }
 }
 module.exports = { GreatestCovers };
@@ -0,0 +1,77 @@
 'use strict';
 /*
 * Moments: a page, or a region across up to four neighbouring pages, that a reader saved with exactly one category.
 * `layout` says how those pages sit together: side by side ("row", Page and Book mode) or stacked ("column", Flow).
 * Stored per user in db.moments[user] as a list. A moment points at its pages by version folder and file
 * name (plus the file's SHA-256 for a later relocation), so a re-scan that shifts page numbers never makes it
 * point at the wrong picture: a file that is gone shows as "page moved" instead.
 */
 const CATEGORIES = ['twist', 'hot', 'awesome', 'cute', 'funny', 'feels'];
 const NOTE_MAX = 200, MAX_PER_USER = 5000, MAX_PAGES = 4, LAYOUTS = ['row', 'column'];
 class MomentError extends Error { constructor(msg) { super(msg); this.code = 400; } }
 const fail = msg => { throw new MomentError(msg); };
 const clamp01 = x => Math.min(1, Math.max(0, x));
 // A region is a rectangle in fractions (0–1) of the displayed page, or of all its pages put together in `layout`.
 // Nothing or a rectangle covering (almost) everything means the whole page.
 function cleanRegion(r) {
  if (r == null) return null;
  const n = ['x', 'y', 'w', 'h'].map(k => Number(r[k]));
  if (n.some(v => !Number.isFinite(v))) fail('Invalid region.');
  const x = clamp01(n[0]), y = clamp01(n[1]), w = clamp01(Math.min(n[2], 1 - x)), h = clamp01(Math.min(n[3], 1 - y));
  if (w < 0.01 || h < 0.01) fail('The selected region is too small.');
  if (w > 0.995 && h > 0.995) return null;
  const round = v => Math.round(v * 1e4) / 1e4;
  return { x: round(x), y: round(y), w: round(w), h: round(h) };
 }
 function cleanCategory(cat) {
  return CATEGORIES.includes(cat) ? cat : fail('Pick one category: ' + CATEGORIES.join(', ') + '.');
 }
 const cleanNote = note => String(note == null ? '' : note).replace(/\s+/g, ' ').trim().slice(0, NOTE_MAX);
 // Page indexes (into the version's full page list) in displayed order: left to right, or top to bottom.
 function cleanPages(pages, version) {
  if (!Array.isArray(pages) || pages.length < 1 || pages.length > MAX_PAGES) fail(`A moment covers 1 to ${MAX_PAGES} pages.`);
  const out = pages.map(Number);
  if (out.some(i => !Number.isInteger(i) || i < 0 || i >= version.pages.length)) fail('Page not found.');
  if (new Set(out).size !== out.length) fail('A page appears twice.');
  return out;
 }
 const cleanLayout = layout => (layout == null ? 'row' : LAYOUTS.includes(layout) ? layout : fail('Invalid page layout.'));
 // Where a stored moment's pages are now. Returns null when the chapter, the version or a page file is gone.
 function locate(moment, manga) {
  const chapter = manga && manga.chapterById.get(moment.c), version = chapter && chapter.versions.find(v => v.id === moment.v);
  if (!version) return null;
  const pages = moment.f.map((file, k) => {
    const at = moment.i[k];
    return version.pages[at] && version.pages[at].f === file ? at : version.pages.findIndex(p => p.f === file);
  });
  return pages.every(i => i >= 0) ? { chapter, version, pages } : null;
 }
 // The browser's view of a moment. `url` turns a library-relative path into an image URL.
 function view(moment, manga, url) {
  const at = locate(moment, manga);
  const chapter = at ? at.chapter : manga && manga.chapterById.get(moment.c);
  return {
    id: moment.id, c: moment.c, v: moment.v, cat: moment.cat, note: moment.note || '', t: moment.t, region: moment.region || null,
    layout: moment.layout || 'row',
    chapter: chapter ? { label: chapter.label, title: chapter.title, book: chapter.book } : { label: moment.c, title: '', book: '' },
    // Story order: chapter position in the manga, then page, then how far down the page the region starts.
    order: [chapter ? manga.chapters.indexOf(chapter) : 1e9, at ? Math.min(...at.pages) : moment.i[0], moment.region ? moment.region.y : 0],
    missing: !at,
    pages: at ? at.pages.map(i => {
      const p = at.version.pages[i];
      return { i, u: url(at.version.rel + '/' + p.f), w: p.w, h: p.h, r: p.r || 0 };
    }) : [],
  };
 }
 function storyCompare(a, b) {
  for (let k = 0; k < 3; k++) if (a.order[k] !== b.order[k]) return a.order[k] - b.order[k];
  return a.t - b.t;
 }
 module.exports = { CATEGORIES, NOTE_MAX, MAX_PER_USER, MAX_PAGES, MomentError, cleanRegion, cleanCategory, cleanNote, cleanPages, cleanLayout, locate, view, storyCompare };
@@ -94,7 +94,18 @@ main { max-width: 1200px; margin: 0 auto; padding: 16px; }
 .prog i { display: block; height: 100%; background: var(--accent); }
 .badge { position: absolute; top: 7px; right: 7px; background: var(--accent); color: #fff; font-size: 12px; font-weight: 700; padding: 2px 8px; border-radius: 10px; }
 .empty { text-align: center; padding: 60px 10px; }
 /* One fixed row; tiles sized like a six-column .grid, extra tiles scroll sideways instead of wrapping. */
 .continue-row { margin-bottom: 20px; padding-bottom: 16px; border-bottom: 1px solid var(--line); }
 .continue-banner {
  display: inline-flex; gap: 6px; align-items: center; margin-bottom: 9px; padding: 2px 9px; border-radius: 10px;
  background: color-mix(in srgb, var(--accent) 22%, var(--card)); color: #ffd8de; font-size: 12px; font-weight: 650;
 }
 .continue-tiles {
  display: grid; grid-auto-flow: column; grid-auto-columns: max(140px, calc((100% - 80px) / 6)); gap: 16px;
  overflow-x: auto; padding-bottom: 4px; scrollbar-width: thin;
 }
@media (max-width: 560px) {
  .continue-tiles { grid-auto-columns: calc((100% - 12px) / 2); gap: 12px; }
  main { padding: 12px; }
  .toolbar { flex-wrap: wrap; }
  .toolbar input { flex-basis: 100%; }
@@ -491,3 +502,66 @@ body.nobars #bot { transform: translateY(100%); opacity: 0; pointer-events: none
  .seg button { padding: 7px 10px; } #bot .btn { padding: 6px 10px; } .wide-only { display: none; }
  .clock-panel { bottom: calc(124px + env(safe-area-inset-bottom)); }
 }
 /* ---------------- moments (BL-0055) ---------------- */
 .moment-btn.on { color: var(--accent); border-color: var(--accent); }
 .moment-btn.on svg path:first-child { fill: currentColor; }
 .moment-dialog { width: min(640px, calc(100vw - 16px)); max-height: calc(100vh - 16px); overflow: auto; color: var(--fg); background: var(--bg);
  border: 1px solid var(--line); border-radius: 12px; padding: 16px; }
 .moment-dialog::backdrop { background: #000c; }
 .moment-dialog h2 { margin: 0; font-size: 18px; }
 .moment-head { display: flex; align-items: center; gap: 10px; margin-bottom: 8px; }
 .moment-head > :first-child { flex: 1; min-width: 0; }
 .moment-context { font-weight: 600; }
 .moment-preview-wrap { display: flex; justify-content: center; margin: 12px 0 8px; }
 .moment-preview { position: relative; line-height: 0; }
 .moment-composite { position: relative; }
 .moment-page { position: absolute; top: 0; overflow: hidden; background: #19191c; }
 .moment-page img { display: block; width: 100%; height: 100%; -webkit-user-drag: none; user-select: none; }
 .region-layer { position: absolute; inset: 0; cursor: crosshair; touch-action: none; overflow: hidden; }
 .region-box { position: absolute; border: 2px solid #fff; outline: 1px solid #0008; box-shadow: 0 0 0 9999px #0009; pointer-events: none; }
 .moment-region-row { display: flex; align-items: center; justify-content: space-between; gap: 10px; min-height: 32px; }
 .moment-chips { display: flex; flex-wrap: wrap; gap: 8px; margin: 12px 0; }
 .moment-chip { display: inline-flex; align-items: center; gap: 6px; padding: 6px 12px; border-radius: 18px; border: 1px solid var(--line);
  background: var(--card); color: var(--fg); font: inherit; cursor: pointer; }
 .moment-chip:hover { background: var(--card2); }
 .moment-chip[aria-checked="true"] { border-color: var(--cat); background: color-mix(in srgb, var(--cat) 22%, var(--card)); box-shadow: 0 0 0 1px var(--cat); }
 .moment-dialog input[type=text] { width: 100%; }
 .moment-actions { display: flex; flex-wrap: wrap; align-items: center; gap: 8px; margin-top: 12px; }
 .moment-dialog .btn[disabled] { opacity: .45; pointer-events: none; }
 .moment-crop { position: relative; overflow: hidden; border-radius: 6px; background: #19191c; flex: none; }
 .moment-crop.missing { display: flex; align-items: center; justify-content: center; color: var(--muted); font-size: 13px; line-height: 1.2; text-align: center; }
 .moment-viewer { width: auto; max-width: calc(100vw - 16px); }
 .moment-viewer-body { display: flex; align-items: center; justify-content: center; gap: 8px; }
 .moment-viewer-stage { display: flex; justify-content: center; touch-action: pan-y; user-select: none; }
 .moment-viewer-info { display: flex; flex-wrap: wrap; align-items: center; gap: 4px 12px; }
 .moment-tag { display: inline-flex; align-items: center; gap: 5px; padding: 2px 10px; border-radius: 12px; font-size: 13px;
  border: 1px solid var(--cat); background: color-mix(in srgb, var(--cat) 18%, var(--card)); }
 .moment-note { flex-basis: 100%; color: var(--muted); font-style: italic; }
 .moment-nav { font-size: 22px; min-width: 40px; }
@media (max-width: 600px) {
  .moment-viewer-body { position: relative; }
  .moment-nav { position: absolute; z-index: 1; background: #000a; }
  .moment-nav.prev { left: 2px; } .moment-nav.next { right: 2px; }
 }
 .moments-card { max-width: none; }
 .moments-head { display: flex; align-items: center; gap: 10px; flex-wrap: wrap; margin-bottom: 8px; }
 .moments-card h2 { margin: 0; }
 .moment-filters { display: flex; gap: 7px; overflow-x: auto; padding-bottom: 6px; }
 .moment-filter { display: inline-flex; align-items: center; gap: 5px; }
 .moment-strip { display: flex; gap: 10px; overflow-x: auto; padding: 4px 2px 10px; scrollbar-width: thin; }
 .moment-thumb { position: relative; flex: none; display: flex; flex-direction: column; gap: 4px; padding: 0; border: 0; background: none;
  color: var(--fg); font: inherit; cursor: pointer; text-align: left; }
 .moment-thumb .moment-crop { transition: transform .15s; }
 .moment-thumb:hover .moment-crop, .moment-thumb:focus-visible .moment-crop { transform: scale(1.03); }
 .moment-thumb-cat { position: absolute; top: 5px; left: 5px; display: flex; padding: 3px; border-radius: 50%; background: #000b; }
 .moment-thumb-label { font-size: 12px; color: var(--muted); white-space: nowrap; overflow: hidden; text-overflow: ellipsis; max-width: 200px; }
 .key-group h3 { margin: 4px 0 8px; font-size: 15px; }
 .key-group + .key-group { margin-top: 16px; }
 .key-table { border-collapse: collapse; width: 100%; }
 .key-table td { padding: 5px 8px; border-top: 1px solid var(--line); vertical-align: top; }
 .key-table td:first-child { width: 1%; white-space: nowrap; }
 kbd { display: inline-block; min-width: 24px; padding: 1px 7px; border: 1px solid var(--line); border-bottom-width: 2px; border-radius: 5px;
  background: var(--card2); font: 13px/1.5 ui-monospace, monospace; text-align: center; }
@media (max-width: 480px) { .moment-dialog { padding: 12px; } .moment-actions .moment-hint { flex-basis: 100%; } .moment-actions .moment-hint:empty { display: none; } }
 .moment-extend { display: flex; flex-wrap: wrap; justify-content: center; gap: 8px; margin-bottom: 8px; }
@@ -65,8 +65,10 @@
  function cover(item) {
    const box = h('span', { class: 'greatest-cover' }, h('span', { class: 'greatest-cover-fallback', 'aria-hidden': 'true' }, item.title.slice(0, 1)));
-    if (item.cover && safeHref(item.cover)) {
+    // Covers come from the server (cached catalog covers, owned library covers) as relative URLs.
-      const image = h('img', { src: item.cover, alt: '', loading: 'lazy' });
+    const src = /^(api\/greatest-cover\?|lib\/)/.test(item.cover || '') ? item.cover : safeHref(item.cover);
    if (src) {
      const image = h('img', { src, alt: '', loading: 'lazy' });
      image.onerror = () => image.remove();
      box.append(image);
    }
@@ -0,0 +1,35 @@
 'use strict';
 /*
 * Keyboard shortcuts. The reader dispatches keys through READER_KEYS, and Settings and the reader's "?" list
 * are drawn from the same tables, so the documentation cannot drift from what the keys do.
 */
 const READER_KEYS = [
  { keys: ['ArrowLeft', 'ArrowRight'], label: '← →', action: 'turn', text: 'Previous / next page, following the reading direction' },
  { keys: [' ', 'PageDown'], label: 'Space · Page Down', action: 'forward', text: 'Next page (Shift + Space: previous) · Page and Book mode' },
  { keys: ['PageUp'], label: 'Page Up', action: 'back', text: 'Previous page · Page and Book mode' },
  { keys: ['+', '='], label: '+', action: 'zoomIn', text: 'Zoom in 5 %' },
  { keys: ['-'], label: '−', action: 'zoomOut', text: 'Zoom out 5 %' },
  { keys: ['0'], label: '0', action: 'zoomFit', text: 'Fit the screen (100 %)' },
  { keys: ['m', 'M'], label: 'M', action: 'moment', text: 'Save a moment of the page you are on' },
  { keys: ['i', 'I'], label: 'I', action: 'bars', text: 'Show or hide the controls' },
  { keys: ['Escape'], label: 'Esc', action: 'bars', text: 'Show or hide the controls (closes an open dialog first)' },
  { keys: ['f', 'F'], label: 'F', action: 'fullscreen', text: 'Fullscreen' },
  { keys: ['?'], label: '?', action: 'help', text: 'Show these shortcuts' },
 ];
 const MOMENT_VIEWER_KEYS = [
  { keys: ['ArrowLeft', 'ArrowRight'], label: '← →', action: 'step', text: 'Previous / next moment' },
  { keys: ['Escape'], label: 'Esc', action: 'close', text: 'Close the viewer' },
 ];
 const KEY_GROUPS = [
  { title: 'Reader', keys: READER_KEYS },
  { title: 'Moments viewer (manga page)', keys: MOMENT_VIEWER_KEYS },
 ];
 const keyAction = (table, key) => (table.find(entry => entry.keys.includes(key)) || {}).action || null;
 function keyTable(groups = KEY_GROUPS) {
  return groups.map(group => h('section', { class: 'key-group' }, h('h3', {}, group.title),
    h('table', { class: 'key-table' }, h('tbody', {}, group.keys.map(entry =>
      h('tr', {}, h('td', {}, h('kbd', {}, entry.label)), h('td', {}, entry.text)))))));
 }
 if (typeof module !== 'undefined') module.exports = { READER_KEYS, MOMENT_VIEWER_KEYS, KEY_GROUPS, keyAction };
@@ -55,6 +55,12 @@
    h('option', { value: 'grouped' }, 'Group collections'), h('option', { value: 'expanded' }, 'Expand collections'), h('option', { value: 'individual' }, 'Individual manga'));
  grouping.value = ['grouped', 'expanded', 'individual'].includes(store.get('grouping')) ? store.get('grouping') : 'grouped';
  grouping.onchange = render;
  // Started but unfinished manga, most recently read first; the same manga still appear in the grid.
  const continueItems = data.mangas.filter(m => m.lastRead && m.read < m.chapters)
    .sort((a, b) => b.lastRead - a.lastRead).slice(0, 5);
  const continueRow = h('section', { class: 'continue-row', 'aria-label': 'Continue where you left off', hidden: true },
    h('div', { class: 'continue-banner' }, h('span', { 'aria-hidden': 'true' }, '▶'), 'Continue where you left off'),
    h('div', { class: 'continue-tiles' }, continueItems.map(m => tile(m))));
  if (storyAvailable) {
    const most = data.mangas.find(manga => manga.id === data.reading.mostTimeMangaId);
    const latest = data.mangas.find(manga => manga.id === data.reading.lastMangaId);
@@ -76,7 +82,7 @@
        h('div', { class: 'filter-heading' }, h('b', {}, 'Tags'), h('span', { class: 'muted small' }, 'Manga must match every selected tag')),
        tagBar) : null,
      resultCount),
-    grid);
+    continueRow, grid);
  function syncTags() {
    store.set('tags', JSON.stringify([...selectedTags]));
@@ -95,8 +101,24 @@
    return direction * (at - bt) || a.title.localeCompare(b.title);
  }
  function tile(m) {
    const cover = m.isCollection && m.coverMode === 'mosaic' && m.covers.length
      ? h('div', { class: 'cv collection-mosaic' }, m.covers.map(src => h('img', { loading: 'lazy', src, alt: '' })))
      : h('div', { class: 'cv' }, m.cover ? h('img', { loading: 'lazy', src: m.cover, alt: '' }) : null);
    return h('a', { class: 'tile', href: m.isCollection ? 'collection.html?' + qsa({ id: m.id }) : mangaUrl(m.id) },
      cover, m.isCollection ? h('span', { class: 'collection-count' }, `${m.members.length} manga`) : null,
      m.unread ? h('span', { class: 'badge' }, m.unread + ' new') : null,
      h('div', { class: 't' }, m.title),
      h('div', { class: 's' }, [m.firstRelease, m.status, m.read ? `${m.read} / ${m.chapters} read` : `${m.chapters} chapters`].filter(Boolean).join(' · ')),
      m.read ? h('div', { class: 'prog' }, h('i', { style: `width:${Math.round((100 * m.read) / Math.max(1, m.chapters))}%` })) : null);
  }
  function render() {
    store.set('filter', filter.value); store.set('sort', sort.value); store.set('status', status.value); store.set('grouping', grouping.value);
    // Only on the plain overview: a search or status filter means the reader is looking for something else,
    // and "Recently read" already puts these first. Tags and grouping keep it.
    continueRow.hidden = !me.settings.continueRow || !continueItems.length || sort.value === 'read'
      || !!filter.value.trim() || !!status.value;
    const q = filter.value.trim().toLowerCase();
    const groups = (data.collections || []).filter(c => c.grouped);
    const membership = new Set(groups.flatMap(c => c.members.map(m => m.id)));
@@ -125,17 +147,6 @@
    }
    resultCount.textContent = `${list.length} results · ${data.mangas.length} manga in the library`;
    grid.textContent = '';
    const tile = m => {
      const cover = m.isCollection && m.coverMode === 'mosaic' && m.covers.length
        ? h('div', { class: 'cv collection-mosaic' }, m.covers.map(src => h('img', { loading: 'lazy', src, alt: '' })))
        : h('div', { class: 'cv' }, m.cover ? h('img', { loading: 'lazy', src: m.cover, alt: '' }) : null);
      return h('a', { class: 'tile', href: m.isCollection ? 'collection.html?' + qsa({ id: m.id }) : mangaUrl(m.id) },
        cover, m.isCollection ? h('span', { class: 'collection-count' }, `${m.members.length} manga`) : null,
        m.unread ? h('span', { class: 'badge' }, m.unread + ' new') : null,
        h('div', { class: 't' }, m.title),
        h('div', { class: 's' }, [m.firstRelease, m.status, m.read ? `${m.read} / ${m.chapters} read` : `${m.chapters} chapters`].filter(Boolean).join(' · ')),
        m.read ? h('div', { class: 'prog' }, h('i', { style: `width:${Math.round((100 * m.read) / Math.max(1, m.chapters))}%` })) : null);
    };
    if (grouping.value === 'expanded') {
      const visible = new Set(list.map(m => m.id));
      for (const c of groups) {
@@ -9,6 +9,8 @@
 <link rel="manifest" href="manifest.webmanifest">
 <meta name="theme-color" content="#121214">
 <script src="common.js" defer></script>
 <script src="keys.js" defer></script>
 <script src="moments.js" defer></script>
 <script src="manga.js" defer></script>
 </head>
 <body>
@@ -164,6 +164,7 @@
  main.append(h('details', { class: 'metadata card', open: metadataOpen },
    h('summary', { class: 'metadata-summary' }, h('h2', {}, 'Metadata')),
    metadata, rawMeta));
  main.append(momentsGallery());
  const volumeButtons = new Map();
  const volumeBar = h('div', { class: 'volume-filter', 'aria-label': 'Filter chapters by volume' });
@@ -316,6 +317,54 @@
    return { text: `◷ ${readingDuration(active, true)}`, title: `${readingDuration(active)} active; current pass in progress` };
  }
  // Your moments (BL-0055): hidden until there is at least one. Only the user's own are ever returned.
  function momentsGallery() {
    const sortKey = `moments-sort.${me.name}`;
    let list = [], sort = store.get(sortKey) === 'recent' ? 'recent' : 'story', filter = null;
    const section = h('section', { class: 'card moments-card', hidden: true });
    const count = h('span', { class: 'muted small' });
    const sortButtons = ['story', 'recent'].map(key => h('button', { type: 'button', 'data-sort': key,
      onclick: () => { sort = key; store.set(sortKey, key); draw(); } }, key === 'story' ? 'Story' : 'Recent'));
    const filters = h('div', { class: 'moment-filters', role: 'group', 'aria-label': 'Filter moments by category' });
    const strip = h('div', { class: 'moment-strip' });
    section.append(h('div', { class: 'moments-head' }, h('h2', {}, 'Your moments'), count, h('div', { class: 'grow' }),
      h('div', { class: 'seg', role: 'group', 'aria-label': 'Sort moments' }, sortButtons)), filters, strip);
    const shown = () => {
      const items = list.filter(m => !filter || m.cat === filter);
      return sort === 'recent' ? items.sort((a, b) => b.t - a.t) : items.sort((a, b) => {
        for (let k = 0; k < 3; k++) if (a.order[k] !== b.order[k]) return a.order[k] - b.order[k];
        return a.t - b.t;
      });
    };
    function draw() {
      section.hidden = !list.length;
      count.textContent = `${list.length} saved`;
      for (const b of sortButtons) b.classList.toggle('on', b.dataset.sort === sort);
      // Category filters only help once there are a few moments in more than one category.
      const cats = MOMENT_CATS.filter(c => list.some(m => m.cat === c.id));
      if (filter && !cats.some(c => c.id === filter)) filter = null;
      filters.hidden = list.length < 5 || cats.length < 2;
      filters.replaceChildren(...cats.map(c => h('button', { type: 'button', class: 'filter-chip moment-filter' + (filter === c.id ? ' on' : ''),
        'aria-pressed': String(filter === c.id), onclick: () => { filter = filter === c.id ? null : c.id; draw(); } },
      momentIcon(c.id, 14), `${c.label} ${list.filter(m => m.cat === c.id).length}`)));
      const items = shown();
      strip.replaceChildren(...items.map((m, k) => h('button', { type: 'button', class: 'moment-thumb', title: `${momentCat(m.cat).label} · ${m.chapter.label} · ${m.missing ? 'page moved' : momentPageLabel(m.pages)}${m.note ? '\n' + m.note : ''}`,
        onclick: () => momentViewer({ mangaId: M.id, mangaTitle: M.title, list: items, index: k, onChange: changed }) },
      momentCrop(m.pages, m.region, 200, 120, m.layout),
      h('span', { class: 'moment-thumb-cat' }, momentIcon(m.cat, 14)),
      h('span', { class: 'moment-thumb-label' }, `${m.chapter.label} · ${m.missing ? 'moved' : momentPageLabel(m.pages)}`))));
    }
    // The viewer edits its (sorted, filtered) copy; fold the changes back into the full list.
    function changed(items) {
      const byId = new Map(items.map(m => [m.id, m]));
      const visible = new Set(shown().map(m => m.id));
      list = list.filter(m => !visible.has(m.id) || byId.has(m.id)).map(m => byId.get(m.id) || m);
      draw();
    }
    api('api/moments?' + qsa({ m: M.id })).then(data => { list = data.moments; draw(); }).catch(() => {});
    return section;
  }
  drawVolumeFilter();
  drawChapters();
 })();
@@ -0,0 +1,302 @@
 'use strict';
 /*
 * Moments (BL-0055): a page, or a region of one or two facing pages, saved with exactly one category.
 * Shared by the reader (save sheet) and the manga page (gallery and viewer). Crops are drawn by positioning the
 * full page images inside a clipping box, so no thumbnails are generated on the server.
 */
 const MOMENT_CATS = [
  { id: 'twist', label: 'Twist', color: '#a29bf2', svg: '<path d="M12 1.5L13.8 4.6L17.3 3.2L17.4 6.8L21 7.6L19.2 10.8L22 13.2L18.8 14.9L19.6 18.5L16 18.2L14.6 21.6L12 19.2L9.4 21.6L8 18.2L4.4 18.5L5.2 14.9L2 13.2L4.8 10.8L3 7.6L6.6 6.8L6.7 3.2L10.2 4.6Z"/><path d="M9.3 8.3v4.4"/><path d="M12.6 9.2a1.9 1.9 0 1 1 2.6 1.8c-.6.3-.8.7-.8 1.5"/><circle cx="9.3" cy="15.3" r=".5" fill="currentColor"/><circle cx="14.4" cy="15.3" r=".5" fill="currentColor"/>' },
  { id: 'hot', label: 'Hot', color: '#f0845c', svg: '<path d="M12 2.5c.5 3 3 4.5 4.5 7a6.5 6.5 0 1 1-11 1.5c.8 1.2 1.8 1.8 2.8 1.8C7.5 9 9.5 5.5 12 2.5z"/><path d="M12 21a3 3 0 0 1-3-3c0-1.8 1.5-3 3-5c1.5 2 3 3.2 3 5a3 3 0 0 1-3 3z"/><path d="M19.5 3l-1 1.6M21.5 5.5l-1.6.8"/>' },
  { id: 'awesome', label: 'Awesome', color: '#f2b443', svg: '<path d="M12 5.5L13.5 10.5L18.5 12L13.5 13.5L12 18.5L10.5 13.5L5.5 12L10.5 10.5Z"/><path d="M3 3l2.6 2.6M21 3l-2.6 2.6M3 21l2.6-2.6M21 21l-2.6-2.6M12 1.5v1.8M12 20.7v1.8M1.5 12h1.8M20.7 12h1.8"/>' },
  { id: 'cute', label: 'Cute', color: '#f07aa5', svg: '<path d="M11 21.5s-7-4.4-7-9.5a4 4 0 0 1 7-2.6a4 4 0 0 1 7 2.6c0 5.1-7 9.5-7 9.5z"/><path d="M8 13.5l1 1M13 13.5l1 1"/><path d="M19.5 2v4M17.5 4h4"/><path d="M4 3.5v2.4M2.8 4.7h2.4"/>' },
  { id: 'funny', label: 'Funny', color: '#4fcfa0', svg: '<circle cx="11" cy="13" r="8"/><path d="M6.8 11.6l1.6-1.6l1.6 1.6M12 11.6l1.6-1.6l1.6 1.6"/><path d="M7.3 14.5h7.4a3.7 3.7 0 0 1-7.4 0z"/><path d="M20.2 2.5c-1 1.6-1.6 2.6-1.6 3.4a1.6 1.6 0 0 0 3.2 0c0-.8-.6-1.8-1.6-3.4z"/>' },
  { id: 'feels', label: 'Feels', color: '#6aa8ec', svg: '<path d="M2.5 10c2.5-4 6-5.5 9.5-5.5S19 6 21.5 10"/><path d="M5 11.5a7 7 0 0 0 14 0"/><circle cx="12" cy="11" r="4"/><circle cx="13.5" cy="9.5" r="1" fill="currentColor"/><path d="M18 16.5c-1 1.5-1.5 2.4-1.5 3.1a1.5 1.5 0 0 0 3 0c0-.7-.5-1.6-1.5-3.1z"/>' },
 ];
 const momentCat = id => MOMENT_CATS.find(c => c.id === id) || MOMENT_CATS[0];
 function momentIcon(id, size = 18) {
  const el = icon(`<svg viewBox="0 0 24 24" width="${size}" height="${size}" fill="none" stroke="currentColor" stroke-width="${size < 20 ? 2 : 1.6}" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true">${momentCat(id).svg}</svg>`);
  el.style.color = momentCat(id).color;
  return el;
 }
 const momentPageLabel = pages => {
  const ns = pages.map(p => p.i + 1).sort((a, b) => a - b);
  return 'p. ' + (ns.length > 1 ? ns[0] + '–' + ns[ns.length - 1] : ns[0]);
 };
 // Displayed size after rotation, as in the reader.
 const shapeOf = p => {
  const turned = (p.r || 0) % 180, w = (turned ? p.h : p.w) || 1000, hh = (turned ? p.w : p.h) || 1414;
  return { ...p, a: w / hh };
 };
 const FULL = { x: 0, y: 0, w: 1, h: 1 };
 // Each page's box in units: side by side ("row", Page/Book) pages share a height of 1,
 // stacked ("column", Flow) pages share a width of 1.
 function arrange(pages, layout) {
  const column = layout === 'column';
  let at = 0;
  const boxes = pages.map(shapeOf).map((p, k) => {
    const b = column ? { k, p, x: 0, y: at, w: 1, h: 1 / p.a } : { k, p, x: at, y: 0, w: p.a, h: 1 };
    at += column ? b.h : b.w;
    return b;
  });
  return { boxes, w: column ? 1 : at, h: column ? at : 1 };
 }
 // The pages put together at `scale` px per unit.
 function composite(pages, layout, scale) {
  const { boxes, w, h: hh } = arrange(pages, layout), el = h('div', { class: 'moment-composite' });
  for (const b of boxes) {
    const W = b.w * scale, H = b.h * scale, r = b.p.r || 0;
    const img = h('img', { src: b.p.u, alt: '', draggable: 'false', decoding: 'async', loading: 'lazy' });
    if (r) img.style.cssText = `position:absolute;left:50%;top:50%;max-width:none;width:${r % 180 ? H : W}px;height:${r % 180 ? W : H}px;transform:translate(-50%,-50%) rotate(${r}deg)`;
    el.append(h('div', { class: 'moment-page', style: `left:${b.x * scale}px;top:${b.y * scale}px;width:${W}px;height:${H}px` }, img));
  }
  el.style.width = w * scale + 'px';
  el.style.height = hh * scale + 'px';
  return el;
 }
 // A box of at most maxW × maxH showing `region` (or everything) of the pages.
 function momentCrop(pages, region, maxW, maxH, layout = 'row') {
  if (!pages.length) return h('div', { class: 'moment-crop missing', style: `width:${Math.round(maxH * 0.7)}px;height:${maxH}px` }, 'Page moved');
  const r = region || FULL, { w: TW, h: TH } = arrange(pages, layout), aspect = (r.w * TW) / (r.h * TH);
  const boxW = Math.min(maxW, maxH * aspect), boxH = boxW / aspect, scale = boxW / (r.w * TW);
  const inner = composite(pages, layout, scale);
  inner.style.transform = `translate(${-r.x * TW * scale}px, ${-r.y * TH * scale}px)`;
  return h('div', { class: 'moment-crop', style: `width:${Math.round(boxW)}px;height:${Math.round(boxH)}px` }, inner);
 }
 // Drag a rectangle over `target` (position: relative). Coordinates are fractions of the target box.
 function regionPicker(target, initial, onChange) {
  let region = initial || null, start = null;
  const box = h('div', { class: 'region-box', hidden: true });
  const layer = h('div', { class: 'region-layer' }, box);
  const draw = () => {
    box.hidden = !region;
    if (region) Object.assign(box.style, { left: region.x * 100 + '%', top: region.y * 100 + '%', width: region.w * 100 + '%', height: region.h * 100 + '%' });
    layer.classList.toggle('has-region', !!region);
  };
  const at = e => {
    const rect = layer.getBoundingClientRect();
    return { x: Math.min(1, Math.max(0, (e.clientX - rect.left) / rect.width)), y: Math.min(1, Math.max(0, (e.clientY - rect.top) / rect.height)) };
  };
  layer.addEventListener('pointerdown', e => { e.preventDefault(); layer.setPointerCapture(e.pointerId); start = at(e); });
  layer.addEventListener('pointermove', e => {
    if (!start) return;
    const p = at(e);
    region = { x: Math.min(start.x, p.x), y: Math.min(start.y, p.y), w: Math.abs(p.x - start.x), h: Math.abs(p.y - start.y) };
    draw();
  });
  const end = () => {
    if (!start) return;
    start = null;
    if (region && (region.w < 0.03 || region.h < 0.03)) region = null; // a tap, not a selection
    draw();
    onChange(region);
  };
  layer.addEventListener('pointerup', end);
  layer.addEventListener('pointercancel', end);
  target.append(layer);
  draw();
  return { get: () => region, clear() { region = null; draw(); onChange(null); } };
 }
 // Pages the region does not touch are dropped and the region is mapped onto the pages that remain,
 // so a selection inside one page of a spread or a stack saves that page alone.
 function trimPages(pages, region, layout = 'row') {
  if (pages.length < 2 || !region) return { pages, region };
  const column = layout === 'column', { boxes, w: TW, h: TH } = arrange(pages, layout), total = column ? TH : TW;
  const from = (column ? region.y : region.x) * total, to = from + (column ? region.h : region.w) * total, eps = 0.002 * total;
  const startOf = b => (column ? b.y : b.x), endOf = b => startOf(b) + (column ? b.h : b.w);
  const keep = boxes.filter(b => endOf(b) > from + eps && startOf(b) < to - eps);
  if (!keep.length || keep.length === boxes.length) return { pages, region };
  const s0 = startOf(keep[0]), len = endOf(keep[keep.length - 1]) - s0;
  const a = Math.max(0, (from - s0) / len), b = Math.min(1, (to - s0) / len);
  return { pages: keep.map(x => pages[x.k]), region: column ? { ...region, y: a, h: b - a } : { ...region, x: a, w: b - a } };
 }
 // `dialog.done()` closes and cleans up at once. The "close" event (Esc) does the same, but it is a queued task
 // that a backgrounded page may run late, so the app never waits for it.
 function openDialog(className, onClose) {
  const dialog = h('dialog', { class: 'moment-dialog ' + className });
  let finished = false;
  dialog.done = () => {
    if (finished) return;
    finished = true;
    if (dialog.open) dialog.close();
    dialog.remove();
    if (onClose) onClose();
  };
  dialog.addEventListener('close', dialog.done);
  dialog.addEventListener('click', e => { if (e.target === dialog) dialog.done(); }); // click on the backdrop
  document.body.append(dialog);
  return dialog;
 }
 /*
 * The save / edit sheet. `context` [manga title, chapter text]; `initial` {region, cat, note}.
 * Pages come either fixed (`pages` in displayed order, for an edit) or from `sequence` (pages in reading order)
 * with the shown `range` [first, last], which "+ Previous page" / "+ Next page" widen up to four pages.
 * `layout` "row" puts them side by side (right to left when `rtl`), "column" stacks them as in Flow.
 * `save({pages, layout, region, cat, note})` returns a promise. Resolves with its result, or null when cancelled.
 */
 function momentSheet({ heading, context, pages: fixed, sequence, range, layout = 'row', rtl = false, initial = {}, save }) {
  return new Promise(resolve => {
    let result = null, cat = initial.cat || null, region = initial.region || null, picker = null;
    let [lo, hi] = range || [0, 0];
    const start = [lo, hi], MAX = 4;
    const dialog = openDialog('moment-sheet', () => resolve(result));
    const pagesNow = () => {
      if (fixed) return fixed;
      const run = sequence.slice(lo, hi + 1);
      return layout === 'row' && rtl ? run.reverse() : run;
    };
    const wrap = h('div', { class: 'moment-preview-wrap' });
    const where = h('div', { class: 'muted small' });
    const whole = h('button', { class: 'btn small', type: 'button', hidden: true, onclick: () => picker.clear() }, 'Whole selection');
    const help = h('span', { class: 'muted small' });
    const earlier = h('button', { class: 'btn small', type: 'button', onclick: () => { lo--; drawPreview(); } }, '+ Previous page');
    const later = h('button', { class: 'btn small', type: 'button', onclick: () => { hi++; drawPreview(); } }, '+ Next page');
    const reset = h('button', { class: 'btn small', type: 'button', onclick: () => { [lo, hi] = start; drawPreview(); } }, 'Reset pages');
    const extend = h('div', { class: 'moment-extend', hidden: !sequence },
      layout === 'row' && rtl ? [later, reset, earlier] : [earlier, reset, later]);
    // Changing the pages changes the geometry, so a selection starts over.
    function drawPreview() {
      const pages = pagesNow(), { w: TW, h: TH } = arrange(pages, layout);
      const maxW = Math.min(560, innerWidth - 48);
      const maxH = Math.min(innerHeight * (layout === 'column' ? 0.62 : innerWidth < 600 ? 0.42 : 0.5), layout === 'column' ? 900 : 520);
      const preview = h('div', { class: 'moment-preview' }, composite(pages, layout, Math.min(maxW / TW, maxH / TH)));
      if (picker) region = null;
      picker = regionPicker(preview, region, r => { region = r; whole.hidden = !r; });
      whole.hidden = !region;
      wrap.replaceChildren(preview);
      where.textContent = `${context[1]} · ${momentPageLabel(pages)}`;
      help.textContent = 'Drag over the picture to keep just a part; pages it does not touch are left out. Without a selection everything shown is saved.';
      if (sequence) {
        const count = hi - lo + 1;
        earlier.disabled = lo === 0 || count >= MAX;
        later.disabled = hi === sequence.length - 1 || count >= MAX;
        reset.hidden = lo === start[0] && hi === start[1];
      }
    }
    const hint = h('span', { class: 'muted small moment-hint' });
    const saveBtn = h('button', { class: 'btn primary', type: 'submit' }, 'Save moment');
    const chips = MOMENT_CATS.map(c => {
      const chip = h('button', { class: 'moment-chip', type: 'button', role: 'radio', 'data-cat': c.id, style: `--cat:${c.color}` }, momentIcon(c.id, 18), c.label);
      chip.onclick = () => { cat = c.id; drawChips(); };
      return chip;
    });
    const drawChips = () => {
      for (const chip of chips) chip.setAttribute('aria-checked', String(chip.dataset.cat === cat));
      saveBtn.disabled = !cat;
      hint.textContent = cat ? '' : 'Pick a category to save';
    };
    const note = h('input', { type: 'text', maxlength: '200', placeholder: 'Optional note', 'aria-label': 'Note', value: initial.note || '' });
    const error = h('p', { class: 'error small', hidden: true });
    const form = h('form', { method: 'dialog' },
      h('div', { class: 'moment-head' }, h('h2', {}, heading),
        h('button', { class: 'btn icon', type: 'button', 'aria-label': 'Close', onclick: () => dialog.done() }, '×')),
      h('div', { class: 'moment-context' }, context[0]), where,
      wrap, extend,
      h('div', { class: 'moment-region-row' }, help, whole),
      h('div', { class: 'moment-chips', role: 'radiogroup', 'aria-label': 'Category' }, chips),
      note, error,
      h('div', { class: 'moment-actions' }, hint, h('div', { class: 'grow' }),
        h('button', { class: 'btn', type: 'button', onclick: () => dialog.done() }, 'Cancel'), saveBtn));
    form.addEventListener('submit', async e => {
      e.preventDefault();
      if (!cat) return;
      saveBtn.disabled = true; error.hidden = true;
      try {
        const kept = fixed ? { pages: fixed, region } : trimPages(pagesNow(), region, layout);
        result = await save({ pages: kept.pages, layout, region: kept.region, cat, note: note.value });
        dialog.done();
      } catch (err) { error.textContent = err.message; error.hidden = false; saveBtn.disabled = false; }
    });
    dialog.append(form);
    drawPreview();
    drawChips();
    dialog.showModal();
  });
 }
 const momentReadUrl = (mangaId, m) => 'read.html?' + qsa({ m: mangaId, c: m.c, v: m.v, p: m.pages.length ? Math.min(...m.pages.map(p => p.i)) : null });
 /*
 * The large viewer: `list` of moment views, starting at `index`. `onChange(list)` after an edit or a delete.
 */
 function momentViewer({ mangaId, mangaTitle, list, index, onChange }) {
  let k = index, full = false;
  const dialog = openDialog('moment-viewer', () => removeEventListener('resize', draw));
  const stage = h('div', { class: 'moment-viewer-stage' });
  const info = h('div', { class: 'moment-viewer-info' });
  const prevBtn = h('button', { class: 'btn icon moment-nav prev', type: 'button', 'aria-label': 'Previous moment', onclick: () => step(-1) }, '‹');
  const nextBtn = h('button', { class: 'btn icon moment-nav next', type: 'button', 'aria-label': 'Next moment', onclick: () => step(1) }, '›');
  const counter = h('span', { class: 'muted small' });
  const fullBtn = h('button', { class: 'btn small', type: 'button', onclick: () => { full = !full; draw(); } });
  const readLink = h('a', { class: 'btn primary small' }, 'Open in reader');
  const actions = h('div', { class: 'moment-actions' }, fullBtn,
    h('button', { class: 'btn small', type: 'button', onclick: edit }, 'Edit'),
    h('button', { class: 'btn small danger', type: 'button', onclick: remove }, 'Delete'),
    h('div', { class: 'grow' }), readLink);
  dialog.append(
    h('div', { class: 'moment-head' }, info, counter, h('button', { class: 'btn icon', type: 'button', 'aria-label': 'Close', onclick: () => dialog.done() }, '×')),
    h('div', { class: 'moment-viewer-body' }, prevBtn, stage, nextBtn), actions);
  function step(d) {
    if (!list.length) return;
    k = (k + d + list.length) % list.length; full = false; draw();
  }
  function draw() {
    if (!list.length) return dialog.done();
    const m = list[k], c = momentCat(m.cat);
    const maxW = Math.min(1100, innerWidth - (innerWidth < 600 ? 32 : 140)), maxH = innerHeight - (innerWidth < 600 ? 230 : 200);
    stage.replaceChildren(momentCrop(m.pages, full ? null : m.region, maxW, maxH, m.layout));
    info.replaceChildren(h('span', { class: 'moment-tag', style: `--cat:${c.color}` }, momentIcon(m.cat, 16), c.label),
      h('span', {}, `${m.chapter.label}${m.chapter.title ? ' · ' + m.chapter.title : ''} · ${m.missing ? 'page moved' : momentPageLabel(m.pages)}`),
      h('span', { class: 'muted small' }, ago(m.t)),
      ...(m.note ? [h('span', { class: 'moment-note' }, m.note)] : []));
    counter.textContent = `${k + 1} / ${list.length}`;
    prevBtn.hidden = nextBtn.hidden = list.length < 2;
    fullBtn.hidden = !m.region || m.missing;
    fullBtn.textContent = full ? 'Show selection' : (m.pages.length > 1 ? 'Show all pages' : 'Show full page');
    readLink.href = momentReadUrl(mangaId, m); // a moved page still opens its chapter
  }
  async function edit() {
    const m = list[k];
    if (m.missing) return;
    const saved = await momentSheet({ heading: 'Edit moment', context: [mangaTitle, `${m.chapter.label}${m.chapter.title ? ' · ' + m.chapter.title : ''}`],
      pages: m.pages, layout: m.layout, initial: m,
      save: async ({ region, cat, note }) => (await api('api/moments/update', { id: m.id, region, cat, note })).moment });
    if (!saved) return;
    list[k] = saved; draw(); onChange(list);
  }
  async function remove() {
    if (!confirm('Delete this moment?')) return;
    await api('api/moments/delete', { id: list[k].id });
    list.splice(k, 1);
    k = Math.min(k, list.length - 1);
    onChange(list);
    draw();
  }
  dialog.addEventListener('keydown', e => {
    if (e.target.closest('input, textarea') || dialog.querySelector('dialog[open]')) return;
    const action = keyAction(MOMENT_VIEWER_KEYS, e.key);
    if (action === 'step') { e.preventDefault(); step(e.key === 'ArrowRight' ? 1 : -1); }
  });
  let swipe = null;
  stage.addEventListener('pointerdown', e => { swipe = { x: e.clientX, y: e.clientY, t: Date.now() }; });
  stage.addEventListener('pointerup', e => {
    const s = swipe; swipe = null;
    if (!s || Date.now() - s.t > 800) return;
    const dx = e.clientX - s.x, dy = e.clientY - s.y;
    if (Math.abs(dx) >= 50 && Math.abs(dx) > 2 * Math.abs(dy)) step(dx < 0 ? 1 : -1);
  });
  addEventListener('resize', draw);
  draw();
  dialog.showModal();
 }
 if (typeof module !== 'undefined') module.exports = { MOMENT_CATS, trimPages, arrange, momentPageLabel };
@@ -14,6 +14,8 @@
 <script src="common.js" defer></script>
 <script src="reading-clock-core.js" defer></script>
 <script src="reading-clock.js" defer></script>
 <script src="keys.js" defer></script>
 <script src="moments.js" defer></script>
 <script src="reader.js" defer></script>
 </head>
 <body class="reader">
@@ -23,6 +25,7 @@
  <a id="back" class="btn icon" href="./" title="Back to the manga" aria-label="Back">‹</a>
  <div id="title" class="grow"></div>
  <select id="chsel" title="Jump to a chapter" aria-label="Chapter"></select>
  <button id="moment" class="btn icon moment-btn" title="Save a moment of this page (M)" aria-label="Save a moment"><svg viewBox="0 0 24 24" width="18" height="18" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M5 3.5h10v17l-5-3.6l-5 3.6z"/><path d="M19.5 2.5v5M17 5h5"/></svg></button>
  <button id="fs" class="btn icon" title="Fullscreen" aria-label="Fullscreen"><svg viewBox="0 0 24 24" width="18" height="18" fill="none" stroke="currentColor" stroke-width="2"><path d="M4 9V4h5M20 9V4h-5M4 15v5h5M20 15v5h-5"/></svg></button>
 </div>
@@ -149,6 +149,8 @@
    const k = list.findIndex(x => x.i >= p);
    cur = k < 0 ? list.length - 1 : k;
  }
  // A link to a page (e.g. "Open in reader" from a moment) wins over the saved position.
  if (P.get('p') != null) { const k = list.findIndex(x => x.i >= +P.get('p')); if (k >= 0) cur = k; }
  // Book mode: pages pair up inside each run of single pages. Runs restart after every double page / cover,
  // so one missing pair never shifts the rest of the chapter. "Shift" makes a run start with a lone page.
@@ -480,18 +482,69 @@
    else toggleBars();
  });
  // Keys are looked up in READER_KEYS (keys.js), the same table Settings and "?" show.
  const keyActions = {
    turn: e => { e.preventDefault(); (e.key === (rtl ? 'ArrowLeft' : 'ArrowRight') ? next : prev)(); },
    forward: e => { if (mode === 'flow') return; e.preventDefault(); (e.shiftKey ? prev : next)(); },
    back: e => { if (mode === 'flow') return; e.preventDefault(); prev(); },
    zoomIn: () => stepZoom(1),
    zoomOut: () => stepZoom(-1),
    zoomFit: () => setZoom(1),
    moment: e => { e.preventDefault(); saveMoment(); },
    bars: () => toggleBars(),
    fullscreen: () => toggleFullscreen(),
    help: () => showKeys(),
  };
  addEventListener('keydown', e => {
    if ((e.target.closest && e.target.closest('input, select, textarea')) || e.ctrlKey || e.metaKey || e.altKey) return;
-    const k = e.key;
+    if (document.querySelector('dialog[open]')) return; // an open dialog handles its own keys (Esc closes it)
-    if (k === 'ArrowLeft' || k === 'ArrowRight') { e.preventDefault(); (k === (rtl ? 'ArrowLeft' : 'ArrowRight') ? next : prev)(); }
+    const action = keyAction(READER_KEYS, e.key);
-    else if ((k === ' ' || k === 'PageDown') && mode !== 'flow') { e.preventDefault(); (e.shiftKey ? prev : next)(); }
+    if (action) keyActions[action](e);
    else if (k === 'PageUp' && mode !== 'flow') { e.preventDefault(); prev(); }
    else if (k === '+' || k === '=') stepZoom(1);
    else if (k === '-') stepZoom(-1);
    else if (k === '0') setZoom(1);
    else if (k === 'm' || k === 'Escape') toggleBars();
    else if (k === 'f') toggleFullscreen();
  });
  function showKeys() {
    const dialog = openDialog('key-dialog', () => stage.focus({ preventScroll: true }));
    dialog.append(
      h('div', { class: 'moment-head' }, h('h2', {}, 'Keyboard shortcuts'),
        h('button', { class: 'btn icon', type: 'button', 'aria-label': 'Close', onclick: () => dialog.done() }, '×')),
      keyTable([{ title: 'Reader', keys: READER_KEYS }]),
      h('p', { class: 'muted small' }, 'Also listed in Settings → Keyboard shortcuts.'));
    dialog.showModal();
  }
  // ---------- moments ----------
  const momentPages = new Set((D.moments || []).flatMap(x => x.pages));
  const momentPage = p => ({ i: p.i, u: p.u, w: D.pages[p.i].w, h: D.pages[p.i].h, r: p.r });
  // Positions in `list` of the page(s) on screen, in reading order. In Flow the page at the reading line.
  function currentRange() {
    if (atEnd && mode !== 'flow') return null;
    const ks = (mode === 'book' ? shown : [cur]).filter(k => list[k]);
    return ks.length ? [Math.min(...ks), Math.max(...ks)] : null;
  }
  function currentPages() {
    const range = currentRange();
    return range ? list.slice(range[0], range[1] + 1).map(momentPage) : [];
  }
  let momentOpen = false;
  async function saveMoment() {
    const range = currentRange();
    if (!range) return toast('No page here');
    if (momentOpen) return;
    momentOpen = true;
    const chapter = D.chapters.find(c => c.id === D.chapter.id), book = D.books.length > 1 && chapter && D.books.find(b => b.key === chapter.book);
    // A picture can run over several pages: the sheet can add neighbours, stacked in Flow, side by side in Page/Book.
    const saved = await momentSheet({
      heading: 'Save moment', sequence: list.map(momentPage), range, layout: mode === 'flow' ? 'column' : 'row', rtl,
      context: [D.manga.title, [book && book.label, D.chapter.label + (D.chapter.title ? ' · ' + D.chapter.title : '')].filter(Boolean).join(' · ')],
      save: async v => (await api('api/moments', { m: D.manga.id, c: D.chapter.id, v: D.version, pages: v.pages.map(p => p.i), layout: v.layout,
        region: v.region, cat: v.cat, note: v.note })).moment,
    });
    momentOpen = false;
    stage.focus({ preventScroll: true });
    if (!saved) return;
    for (const p of saved.pages) momentPages.add(p.i);
    updateUI();
    toast(`Saved · ${momentCat(saved.cat).label} moment`, 1500);
  }
  let scrollRaf = 0;
  stage.addEventListener('scroll', () => {
@@ -598,8 +651,8 @@
    const key = mode === 'flow' ? 'hint.flow' : 'hint.paged';
    if (store.get(key)) return;
    store.set(key, '1');
-    toast(mode === 'flow' ? 'Controls hidden · tap the middle of the screen or beside the pages to show them'
+    toast(mode === 'flow' ? 'Controls hidden · tap the middle of the screen or beside the pages (or press I) to show them'
-      : 'Controls hidden · tap the middle of the page or beside it to show them', 3500);
+      : 'Controls hidden · tap the middle of the page or beside it (or press I) to show them', 3500);
  }
  let toastTimer = 0;
@@ -625,6 +678,9 @@
    sh.hidden = mode !== 'book';
    sh.classList.toggle('on', shown.length > 0 && !solo(list[shown[0]]) && shift.has(list[runStart(shown[0])].i));
    $('#zoom').textContent = Math.round(zoom() * 100) + '%';
    const hasMoment = currentPages().some(p => momentPages.has(p.i));
    $('#moment').classList.toggle('on', hasMoment);
    $('#moment').title = (hasMoment ? 'This page has a moment · save another' : 'Save a moment of this page') + ' (M)';
  }
  let saveTimer = 0;
@@ -669,6 +725,7 @@
  ver.onchange = () => { saveProgress(true); location.href = readUrl(D.manga.id, D.chapter.id, ver.value); };
  for (const b of modeBtns) b.onclick = () => { if (b.dataset.mode !== mode) setMode(b.dataset.mode, true); };
  toneButton.onclick = cycleTone;
  $('#moment').onclick = saveMoment;
  $('#shift').onclick = toggleShift;
  $('#zoomout').onclick = () => stepZoom(-1);
  $('#zoom').onclick = () => setZoom(1);
@@ -5,6 +5,7 @@ const SETTINGS_SECTIONS = [
  { id: 'user/reading', group: 'User', title: 'Reading', hint: 'Reader modes, page spacing and zoom.' },
  { id: 'user/reading-hours', group: 'User', title: 'Reading hours', hint: 'When this server allows chapter reading.' },
  { id: 'user/reading-time', group: 'User', title: 'Reading time & privacy', hint: 'Your clock, Reading Story and personal data.' },
  { id: 'user/shortcuts', group: 'User', title: 'Keyboard shortcuts', hint: 'Every key the reader understands. Press ? in the reader for the same list.' },
  { id: 'user/notifications', group: 'User', title: 'Notifications', hint: 'Chapter alerts and your optional webhook.' },
  { id: 'user/account', group: 'User', title: 'Account', hint: 'Your account and password.' },
  { id: 'admin/scraper', group: 'Admin', title: 'Scraper', hint: 'Live activity, downloads, update checks and sources.' },
@@ -9,6 +9,7 @@
 <link rel="manifest" href="manifest.webmanifest">
 <meta name="theme-color" content="#121214">
 <script src="common.js" defer></script>
 <script src="keys.js" defer></script>
 <script src="settings-nav.js" defer></script>
 <script src="settings.js" defer></script>
 </head>
@@ -90,6 +90,11 @@
      h('button', { class: 'btn small', onclick: async () => { await save({ zoom: {} }); zoomText.textContent = zooms(); } }, 'Reset to fit'),
      h('div', { class: 'muted small' }, '100% = the page fits the screen. Change it in the reader with Ctrl + mouse wheel, a pinch, or the + / - keys.'))));
  section('user/reading').append(h('section', { class: 'card' },
    h('h2', {}, 'Library page'),
    check('continueRow', 'Show "Continue where you left off" at the top',
      'One row with the five manga you read most recently and have not finished. It hides itself while you search, filter by status, or sort by "Recently read".')));
  section('user/reading').append(h('section', { class: 'card' },
    h('h2', {}, 'Chapter list dates'),
    h('label', { class: 'field' }, h('span', {}, 'When I read a chapter'), readDate,
@@ -135,6 +140,7 @@
  const oldPw = h('input', { type: 'password', autocomplete: 'current-password', placeholder: 'Current password' });
  const newPw = h('input', { type: 'password', autocomplete: 'new-password', placeholder: 'New password' });
  const pwMsg = h('span', { class: 'small' });
  section('user/shortcuts').append(h('section', { class: 'card' }, keyTable()));
  section('user/account').append(h('section', { class: 'card' },
    h('h2', {}, 'Account · ' + me.name),
    h('div', { class: 'row' }, oldPw, newPw, h('button', { class: 'btn', onclick: async () => {
@@ -19,6 +19,7 @@ const { Catalog, CatalogError, collectionViews, TYPES, ROLES } = require('./cata
 const { RATINGS: GREATEST_RATINGS, loadCatalog: loadGreatestCatalog, findOwned: findGreatestOwned,
  countsFor: greatestCounts, scoreFor: greatestScore } = require('./greatest');
 const { hosterLinks } = require('./greatest/hosters');
 const { GreatestCovers } = require('./greatest/covers');
 const { secret } = require('./runtime/config');
 const { PeeringState, requirePeer } = require('./peering/state');
 const peerClient = require('./peering/client');
@@ -34,6 +35,7 @@ const {
 const { chapterDates } = require('./chapter-dates');
 const { parseSchedule, publicSchedule, loadQuestionBank, createReadingAccess } = require('./reading-access');
 const { BackupService, BackupError } = require('./backup');
 const moments = require('./moments');
 const PORT = +process.env.PORT || 8080;
 const LIB = path.resolve(process.env.LIBRARY || 'library');
@@ -65,8 +67,12 @@ fs.mkdirSync(DATA, { recursive: true });
 const catalog = new Catalog(DATA);
 const greatestCatalog = loadGreatestCatalog();
 const greatestById = new Map(greatestCatalog.entries.map(entry => [entry.id, entry]));
 const greatestCovers = new GreatestCovers(path.join(DATA, 'greatest-covers'));
 // The versioned URL lets browsers keep a cover for a year; a new catalog URL changes `v`.
 const greatestCoverUrl = entry => entry.cover
  ? `api/greatest-cover?id=${encodeURIComponent(entry.id)}&v=${greatestCovers.version(entry.cover)}` : null;
 const DB_FILE = path.join(DATA, 'db.json'), CACHE_FILE = path.join(DATA, 'scan-cache.json'), INDEX_FILE = path.join(DATA, 'library-index.json');
-const db = { users: {}, sessions: {}, progress: {}, reading: {}, readingAccess: {}, follows: {}, notes: {}, votes: {}, greatestRatings: {}, discoveryFeedback: {}, known: {} };
+const db = { users: {}, sessions: {}, progress: {}, reading: {}, readingAccess: {}, follows: {}, notes: {}, votes: {}, greatestRatings: {}, discoveryFeedback: {}, moments: {}, known: {} };
 // A corrupt db.json stops the server instead of silently starting empty and overwriting it.
 if (fs.existsSync(DB_FILE)) Object.assign(db, JSON.parse(fs.readFileSync(DB_FILE, 'utf8')));
 function writeAtomic(file, text) { fs.writeFileSync(file + '.tmp', text); fs.renameSync(file + '.tmp', file); }
@@ -106,7 +112,7 @@ function checkPw(pw, stored) {
 }
 const DUMMY_HASH = hashPw('x');
 const DEFAULTS = { startMode: 'last', lastMode: 'page', adapt: true, skipExtras: false, skipCovers: false, flowPageGap: true, pageTone: 'original', readingClock: false, readingStory: true,
-  readDate: 'hour', releaseDate: true, discoveryEnabled: false, discoveryReadingActivity: false, discoveryMature: false, zoom: {}, webhook: '' };
+  continueRow: true, readDate: 'hour', releaseDate: true, discoveryEnabled: false, discoveryReadingActivity: false, discoveryMature: false, zoom: {}, webhook: '' };
 const settingsOf = u => ({ ...DEFAULTS, ...u.settings, zoom: { ...(u.settings && u.settings.zoom) } });
 function createUser(name, pw, admin, replace) {
@@ -226,6 +232,15 @@ const progressOf = (u, m) => (db.progress[u.name] && db.progress[u.name][m.id])
 const mangaReadingOf = (u, m) => (db.reading[u.name] && db.reading[u.name][m.id]) || {};
 const readingOf = (u, m, ch) => (db.reading[u.name] && db.reading[u.name][m.id] && db.reading[u.name][m.id][ch.id]) || null;
 const unreadOf = u => (db.notes[u.name] || []).filter(n => !n.read).length;
 const momentsOf = u => (db.moments[u.name] ||= []);
 const momentOf = (u, id) => momentsOf(u).find(x => x.id === String(id || '')) || bad(404, 'Moment not found');
 const fileSha = async rel => sha256File(path.join(LIB, rel)).catch(() => null);
 function sha256File(file) {
  return new Promise((resolve, reject) => {
    const hash = crypto.createHash('sha256');
    fs.createReadStream(file).on('error', reject).on('data', d => hash.update(d)).on('end', () => resolve(hash.digest('hex')));
  });
 }
 const admin = u => u.admin || bad(403, 'Admins only');
 const READING_LEASE_MS = 15000;
 const readingLeases = new Map();
@@ -525,7 +540,7 @@ const routes = {
    if (['flow', 'page', 'book'].includes(b.lastMode)) s.lastMode = b.lastMode;
    if (['original', 'inverted', 'sepia', 'dim', 'extra-dim'].includes(b.pageTone)) s.pageTone = b.pageTone;
    if (['off', 'date', 'hour'].includes(b.readDate)) s.readDate = b.readDate;
-    for (const k of ['adapt', 'skipExtras', 'skipCovers', 'flowPageGap', 'readingClock', 'readingStory', 'releaseDate',
+    for (const k of ['adapt', 'skipExtras', 'skipCovers', 'flowPageGap', 'readingClock', 'readingStory', 'releaseDate', 'continueRow',
      'discoveryEnabled', 'discoveryReadingActivity', 'discoveryMature']) if (typeof b[k] === 'boolean') s[k] = b[k];
    if (b.zoom && typeof b.zoom === 'object') {
      s.zoom = {};
@@ -620,7 +635,7 @@ const routes = {
      const counts = greatestCounts(entry.id, db.greatestRatings || {}, db.users);
      return {
        ...entry,
-        cover: owned?.cover ? url(owned.cover) : entry.cover,
+        cover: owned?.cover ? url(owned.cover) : greatestCoverUrl(entry),
        chapters: owned ? owned.chapters.length : entry.chapters,
        status: owned?.meta?.status || entry.status,
        library: owned ? { id: owned.id, chapters: owned.chapters.length } : null,
@@ -736,6 +751,9 @@ const routes = {
      prev: neighbour(m, ch, -1, s), next: neighbour(m, ch, 1, s),
      progress: prog[ch.id] || null,
      reading: s.readingClock ? publicSummary(readingOf(u, m, ch), v.id, eligiblePages(v, s)) : null,
      // the user's moments on this version, so the reader can mark pages that already have one
      moments: momentsOf(u).filter(x => x.m === m.id && x.c === ch.id && x.v === v.id)
        .map(x => ({ id: x.id, cat: x.cat, pages: (moments.locate(x, m) || { pages: [] }).pages })),
      // for the chapter picker: the whole manga across all books
      books: m.books.map(b => ({ key: b.key, label: b.label, title: b.title })),
      chapters: m.chapters.map(c => ({ id: c.id, book: c.book, label: c.label, title: c.title, extra: c.extra, done: !!(prog[c.id] && prog[c.id].done) })),
@@ -822,6 +840,41 @@ const routes = {
    save();
    return { following: !!f[m.id] };
  },
  // Moments (BL-0055): private to their user; one category each, no uncategorised saves.
  'GET /api/moments': ({ u, q }) => {
    const m = mangaOf(q.get('m'));
    return { moments: momentsOf(u).filter(x => x.m === m.id).map(x => moments.view(x, m, url)).sort(moments.storyCompare) };
  },
  'POST /api/moments': async ({ u, b }) => {
    const m = mangaOf(b.m), ch = chapterOf(m, b.c), v = ch.versions.find(x => x.id === b.v) || bad(404, 'Version not found');
    const pages = moments.cleanPages(b.pages, v);
    const moment = { id: crypto.randomBytes(6).toString('hex'), m: m.id, c: ch.id, v: v.id, i: pages, f: pages.map(i => v.pages[i].f),
      layout: moments.cleanLayout(b.layout),
      region: moments.cleanRegion(b.region), cat: moments.cleanCategory(b.cat), note: moments.cleanNote(b.note), t: Date.now() };
    const list = momentsOf(u);
    if (list.length >= moments.MAX_PER_USER) bad(409, `You already have ${moments.MAX_PER_USER} moments.`);
    moment.sha = await Promise.all(moment.f.map(f => fileSha(v.rel + '/' + f)));
    list.push(moment);
    save();
    return { moment: moments.view(moment, m, url) };
  },
  'POST /api/moments/update': ({ u, b }) => {
    const moment = momentOf(u, b.id);
    if ('cat' in b) moment.cat = moments.cleanCategory(b.cat);
    if ('region' in b) moment.region = moments.cleanRegion(b.region);
    if ('note' in b) moment.note = moments.cleanNote(b.note);
    moment.edited = Date.now();
    save();
    return { moment: moments.view(moment, lib.byId.get(moment.m), url) };
  },
  'POST /api/moments/delete': ({ u, b }) => {
    const list = momentsOf(u), moment = momentOf(u, b.id);
    list.splice(list.indexOf(moment), 1);
    save();
    return { ok: true };
  },
  'GET /api/notifications': ({ u }) => ({ items: (db.notes[u.name] || []).slice().reverse() }),
  'POST /api/notifications/read': ({ u, b }) => {
    for (const n of db.notes[u.name] || []) if (b.all || n.id === b.id) n.read = true;
@@ -863,7 +916,7 @@ const routes = {
    admin(u);
    const name = String(b.name || '');
    if (name === u.name) bad(400, "You can't delete your own account.");
-    delete db.users[name]; delete db.progress[name]; delete db.reading[name]; delete db.follows[name]; delete db.notes[name];
+    delete db.users[name]; delete db.progress[name]; delete db.reading[name]; delete db.follows[name]; delete db.notes[name]; delete db.moments[name];
    if (db.discoveryFeedback) delete db.discoveryFeedback[name];
    if (db.greatestRatings) delete db.greatestRatings[name];
    for (const [k, s] of Object.entries(db.sessions)) if (s.u === name) delete db.sessions[k];
@@ -1034,6 +1087,16 @@ http.createServer(async (req, res) => {
      if (!c?.customCover) bad(404, 'Cover not found');
      return serveFile(req, res, path.join(DATA, 'collection-covers'), c.customCover, 'private, no-cache', IMG);
    }
    if (pathname === '/api/greatest-cover' && req.method === 'GET') {
      if (!u) bad(401, 'Please log in');
      const entry = greatestById.get(searchParams.get('id'));
      if (!entry?.cover) bad(404, 'Cover not found');
      const file = greatestCovers.file(entry.cover);
      if (file) return serveFile(req, res, greatestCovers.dir, path.basename(file), 'private, max-age=31536000, immutable', IMG);
      // Not downloaded yet: the browser fetches the catalog's own URL this once.
      res.writeHead(302, { Location: entry.cover, 'Cache-Control': 'no-store' });
      return res.end();
    }
    if (pathname === '/api/peering/cover' && req.method === 'GET') {
      if (!u) bad(401, 'Please log in');
      admin(u);
@@ -1065,7 +1128,7 @@ http.createServer(async (req, res) => {
    }
    serveFile(req, res, PUB, pathname === '/' ? 'index.html' : pathname.slice(1), 'no-cache');
  } catch (e) {
-    const expected = e instanceof HttpError || e instanceof CatalogError;
+    const expected = e instanceof HttpError || e instanceof CatalogError || e instanceof moments.MomentError;
    if (!expected) console.error(e);
    if (!res.headersSent) sendJson(res, expected ? e.code : 500, expected ? { error: e.message, ...e.extra } : { error: 'Internal error' });
  }
@@ -1074,6 +1137,18 @@ http.createServer(async (req, res) => {
 if (lib.mangas.length) refreshChanged();
 else rescan();
 if (SCAN_MINUTES > 0) setInterval(() => refreshChanged(), SCAN_MINUTES * 60000).unref();
 // Fetch missing Greatest covers shortly after start and retry failures once a day;
 // covers already on disk cost nothing.
 async function warmGreatestCovers() {
  try {
    const result = await greatestCovers.warm(greatestCatalog.entries.map(entry => entry.cover));
    if (result.fetched || result.failed || result.stopped) console.log('[greatest] covers', JSON.stringify(result));
  } catch (error) { console.error('[greatest] covers', error.message); }
 }
 if (process.env.GREATEST_COVER_WARM !== '0') {
  setTimeout(warmGreatestCovers, 10000).unref();
  setInterval(warmGreatestCovers, 86400000).unref();
 }
 // Persist the last reconciliation time. Restarting a healthy reader should not
 // trigger another full tree walk; overdue reconciliations run within a minute.
 if (FULL_SCAN_MINUTES > 0) setInterval(() => {
@@ -21,7 +21,8 @@ test('only admins can promote or demote, nobody can demote themselves, and chang
    const port = await freePort(), output = [];
    child = spawn(process.execPath, ['server.js'], { cwd: path.resolve(__dirname, '..'), windowsHide: true,
      env: { ...process.env, LIBRARY: library, DATA: data, PORT: String(port), SCAN_INTERVAL: '0', FULL_SCAN_INTERVAL: '0',
-        SCRAPER_URL: 'http://127.0.0.1:9', SCRAPER_TOKEN: 'fixture-token', SCRAPER_TOKEN_FILE: '', BACKUP: '' } });
+        SCRAPER_URL: 'http://127.0.0.1:9', SCRAPER_TOKEN: 'fixture-token', SCRAPER_TOKEN_FILE: '', BACKUP: '',
        GREATEST_COVER_WARM: '0' } });
    child.stdout.on('data', d => output.push(String(d)));
    child.stderr.on('data', d => output.push(String(d)));
    const base = `http://127.0.0.1:${port}`;
@@ -251,7 +251,7 @@ test('reader and scraper: admin backup API pauses and resumes the real queue', {
    const base = `http://127.0.0.1:${rp}`, token = 'backup-test-only';
    const env = { ...process.env, DATA: f.data, LIBRARY: library, SCRAPER_DATA: path.join(f.data, 'scraper'), BACKUP: f.target,
      PORT: String(rp), SCRAPER_PORT: String(sp), SCRAPER_HOST: '127.0.0.1', SCRAPER_URL: `http://127.0.0.1:${sp}`, SENTINEL_URL: 'http://127.0.0.1:9',
-      SCRAPER_TOKEN: token, SCRAPER_TOKEN_FILE: '', SCAN_INTERVAL: '0' };
+      SCRAPER_TOKEN: token, SCRAPER_TOKEN_FILE: '', SCAN_INTERVAL: '0', GREATEST_COVER_WARM: '0' };
    for (const script of ['server.js', 'scraper/daemon.js']) {
      const child = spawn(process.execPath, [script], { cwd: root, env, windowsHide: true }); children.push(child);
      for (const stream of [child.stdout, child.stderr]) stream.on('data', chunk => output.push(chunk.toString()));
@@ -81,7 +81,7 @@ async function startReader({ anilist, discovery = {}, mangaMeta = null, scraperU
  const child = spawn(process.execPath, ['server.js'], { cwd: path.resolve(__dirname, '..'), windowsHide: true,
    env: { ...process.env, LIBRARY: library, DATA: data, PORT: String(port), SCAN_INTERVAL: '0', FULL_SCAN_INTERVAL: '0',
      SCRAPER_URL: scraperUrl, SCRAPER_TOKEN: 'fixture-token', SCRAPER_TOKEN_FILE: '', BACKUP: '',
-      DISCOVERY_ANILIST_URL: anilist ? anilist.url : 'http://127.0.0.1:9/', DISCOVERY_HARVEST_AT: '' } });
+      DISCOVERY_ANILIST_URL: anilist ? anilist.url : 'http://127.0.0.1:9/', DISCOVERY_HARVEST_AT: '', GREATEST_COVER_WARM: '0' } });
  child.stdout.on('data', d => output.push(String(d)));
  child.stderr.on('data', d => output.push(String(d)));
  const base = `http://127.0.0.1:${port}`;
@@ -0,0 +1,27 @@
 'use strict';
 // The image copies top-level modules by name; a new module missing there crashes the reader at start.
 const test = require('node:test'), assert = require('node:assert/strict');
 const fs = require('fs'), path = require('path');
 const root = path.resolve(__dirname, '..');
 test('every top-level module the reader requires is copied into the image', () => {
  const dockerfile = fs.readFileSync(path.join(root, 'Dockerfile'), 'utf8');
  const copied = new Set(dockerfile.split('\n').filter(line => line.startsWith('COPY ')).flatMap(line => line.split(/\s+/).slice(1, -1)));
  const pending = ['server.js'], seen = new Set();
  while (pending.length) {
    const file = pending.pop();
    if (seen.has(file)) continue;
    seen.add(file);
    for (const [, name] of fs.readFileSync(path.join(root, file), 'utf8').matchAll(/require\('\.\/([\w.-]+?)(?:\.js)?'\)/g)) {
      // A folder (e.g. ./greatest) is copied as a whole; only single files need their own name in COPY.
      if (fs.existsSync(path.join(root, name)) && fs.statSync(path.join(root, name)).isDirectory()) assert.ok(copied.has(name), `${name}/ is not copied`);
      else pending.push(name + '.js');
    }
  }
  // .dockerignore is an allowlist too: a file not let through never reaches COPY.
  const allowed = new Set(fs.readFileSync(path.join(root, '.dockerignore'), 'utf8').split(/\r?\n/).filter(line => line.startsWith('!')).map(line => line.slice(1)));
  for (const file of seen) {
    assert.ok(copied.has(file), `${file} is required but not copied by the Dockerfile`);
    assert.ok(allowed.has(file), `${file} is required but not allowed through .dockerignore`);
  }
 });
@@ -0,0 +1,75 @@
 'use strict';
 // BL-0053: Greatest covers are served from the reader's own copy, with a redirect until one exists.
 const test = require('node:test'), assert = require('node:assert/strict');
 const fs = require('fs'), os = require('os'), path = require('path'), net = require('net'), crypto = require('crypto');
 const { spawn } = require('child_process');
 const { loadCatalog } = require('../greatest');
 const { GreatestCovers } = require('../greatest/covers');
 const sleep = ms => new Promise(resolve => setTimeout(resolve, ms));
 const hashPw = pw => { const salt = crypto.randomBytes(16).toString('hex'); return salt + ':' + crypto.scryptSync(pw, salt, 32).toString('hex'); };
 const sha = s => crypto.createHash('sha256').update(s).digest('hex');
 const PNG = Buffer.from('89504e470d0a1a0a0000000d49484452', 'hex');
 async function freePort() {
  const listener = net.createServer();
  await new Promise(resolve => listener.listen(0, '127.0.0.1', resolve));
  const port = listener.address().port;
  await new Promise(resolve => listener.close(resolve));
  return port;
 }
 test('Greatest covers come from the local copy, else redirect to the catalog URL', async t => {
  const entries = loadCatalog().entries.filter(entry => entry.cover);
  const [cached, missing] = entries;
  const root = fs.mkdtempSync(path.join(os.tmpdir(), 'mc-greatest-cover-'));
  const library = path.join(root, 'library'), data = path.join(root, 'data');
  fs.mkdirSync(library, { recursive: true });
  fs.mkdirSync(path.join(data, 'greatest-covers'), { recursive: true });
  const version = new GreatestCovers(path.join(data, 'greatest-covers')).version(cached.cover);
  fs.writeFileSync(path.join(data, 'greatest-covers', `${version}.png`), PNG);
  const token = crypto.randomBytes(32).toString('base64url');
  fs.writeFileSync(path.join(data, 'db.json'), JSON.stringify({
    users: { reader: { name: 'reader', hash: hashPw('reader-password'), admin: false, created: Date.now(), settings: {} } },
    sessions: { [sha(token)]: { u: 'reader', t: Date.now() } } }));
  const port = await freePort(), output = [];
  const child = spawn(process.execPath, ['server.js'], { cwd: path.resolve(__dirname, '..'), windowsHide: true,
    env: { ...process.env, LIBRARY: library, DATA: data, PORT: String(port), SCAN_INTERVAL: '0', FULL_SCAN_INTERVAL: '0',
      SCRAPER_URL: 'http://127.0.0.1:9', SCRAPER_TOKEN: 'fixture-token', SCRAPER_TOKEN_FILE: '', BACKUP: '',
      GREATEST_COVER_WARM: '0' } });
  child.stdout.on('data', d => output.push(String(d)));
  child.stderr.on('data', d => output.push(String(d)));
  t.after(async () => {
    await new Promise(resolve => { if (child.exitCode !== null) return resolve(); child.once('exit', resolve); child.kill(); });
    fs.rmSync(root, { recursive: true, force: true });
  });
  const base = `http://127.0.0.1:${port}`;
  let ready = false;
  for (let n = 0; n < 100 && !ready; n++) {
    ready = await fetch(base + '/health').then(r => r.ok).catch(() => false);
    if (!ready) await sleep(50);
  }
  assert.ok(ready, output.join(''));
  const get = (url, cookie = `sid=${token}`) => fetch(base + '/' + url, { headers: cookie ? { cookie } : {}, redirect: 'manual' });
  const listing = await (await get('api/greatest')).json();
  const coverOf = id => listing.entries.find(entry => entry.id === id).cover;
  assert.equal(coverOf(cached.id), `api/greatest-cover?id=${encodeURIComponent(cached.id)}&v=${version}`);
  assert.match(coverOf(missing.id), /^api\/greatest-cover\?id=.+&v=[0-9a-f]{16}$/);
  const hit = await get(coverOf(cached.id));
  assert.equal(hit.status, 200);
  assert.equal(hit.headers.get('content-type'), 'image/png');
  assert.equal(hit.headers.get('cache-control'), 'private, max-age=31536000, immutable');
  assert.deepEqual(Buffer.from(await hit.arrayBuffer()), PNG);
  const miss = await get(coverOf(missing.id));
  assert.equal(miss.status, 302);
  assert.equal(miss.headers.get('location'), missing.cover);
  assert.equal(miss.headers.get('cache-control'), 'no-store');
  assert.equal((await get(coverOf(cached.id), null)).status, 401);
  assert.equal((await get('api/greatest-cover?id=not-in-the-catalog')).status, 404);
  assert.equal((await get('api/greatest-cover?id=../../db.json')).status, 404);
 });
@@ -0,0 +1,84 @@
 'use strict';
 const test = require('node:test');
 const assert = require('node:assert/strict');
 const fs = require('node:fs');
 const os = require('node:os');
 const path = require('node:path');
 const { GreatestCovers } = require('../greatest/covers');
 const PNG = Buffer.from('89504e470d0a1a0a0000000d49484452', 'hex');
 const image = (body = PNG, type = 'image/png') => new Response(body, { status: 200, headers: { 'content-type': type } });
 function setup(t, responses, options = {}) {
  const dir = fs.mkdtempSync(path.join(os.tmpdir(), 'mc-greatest-covers-'));
  t.after(() => fs.rmSync(dir, { recursive: true, force: true }));
  const calls = [];
  const fetchImpl = async (url, init) => {
    calls.push({ url, init });
    const next = responses[url];
    if (next instanceof Error) throw next;
    return typeof next === 'function' ? next() : next || new Response('missing', { status: 404 });
  };
  const sleeps = [];
  const covers = new GreatestCovers(dir, { fetchImpl, sleep: async ms => { sleeps.push(ms); }, ...options });
  return { dir, calls, sleeps, covers };
 }
 test('warm downloads each cover once and serves it from disk afterwards', async t => {
  const a = 'https://img.example/a.png', b = 'https://img.example/b.jpg';
  const { dir, calls, sleeps, covers } = setup(t, { [a]: () => image(), [b]: () => image(PNG, 'image/jpeg') });
  const result = await covers.warm([a, b, a]);
  assert.deepEqual(result, { fetched: 2, skipped: 1, failed: 0, stopped: null });
  assert.equal(calls.length, 2);
  assert.deepEqual(sleeps, [1000], 'one pause between two downloads, none before the first');
  assert.ok(covers.file(a).endsWith('.png') && fs.existsSync(covers.file(a)));
  assert.ok(covers.file(b).endsWith('.jpg'));
  assert.equal(covers.file('https://img.example/other.png'), null);
  // A restarted reader finds the stored files and asks nobody.
  const reopened = new GreatestCovers(dir, { fetchImpl: async () => { throw new Error('must not fetch'); } });
  assert.deepEqual(await reopened.warm([a, b]), { fetched: 0, skipped: 2, failed: 0, stopped: null });
  assert.equal(reopened.file(a), covers.file(a));
 });
 test('a changed cover URL is a new file', async t => {
  const { covers } = setup(t, { 'https://img.example/v1.png': () => image(), 'https://img.example/v2.png': () => image() });
  await covers.warm(['https://img.example/v1.png', 'https://img.example/v2.png']);
  assert.notEqual(covers.file('https://img.example/v1.png'), covers.file('https://img.example/v2.png'));
  assert.notEqual(covers.version('https://img.example/v1.png'), covers.version('https://img.example/v2.png'));
 });
 test('non-images, oversized files, plain http and errors are skipped', async t => {
  const html = 'https://img.example/page', big = 'https://img.example/big.png', declaredBig = 'https://img.example/declared.png';
  const broken = 'https://img.example/broken.png', gone = 'https://img.example/gone.png';
  const { covers, calls } = setup(t, {
    [html]: () => new Response('<html>', { status: 200, headers: { 'content-type': 'text/html' } }),
    [big]: () => image(Buffer.alloc(64)),
    [declaredBig]: () => new Response(PNG, { status: 200, headers: { 'content-type': 'image/png', 'content-length': '999999' } }),
    [broken]: new TypeError('fetch failed'),
  }, { maxBytes: 32 });
  const result = await covers.warm([html, big, declaredBig, broken, gone, 'http://img.example/plain.png', '', null]);
  assert.deepEqual(result, { fetched: 0, skipped: 0, failed: 5, stopped: null });
  assert.equal(calls.length, 5, 'plain http and empty URLs are never requested');
  for (const url of [html, big, declaredBig, broken, gone]) assert.equal(covers.file(url), null);
  assert.deepEqual(fs.readdirSync(covers.dir).filter(name => !name.startsWith('.')), []);
 });
 test('429 and 403 stop the run at once', async t => {
  for (const status of [429, 403]) {
    const first = 'https://img.example/1.png', second = 'https://img.example/2.png';
    const { covers, calls } = setup(t, { [first]: () => new Response('', { status }), [second]: () => image() });
    const result = await covers.warm([first, second]);
    assert.equal(result.stopped, `HTTP ${status}`);
    assert.equal(calls.length, 1);
    assert.equal(covers.file(second), null);
  }
 });
 test('requests carry a timeout and a fixed user agent', async t => {
  const a = 'https://img.example/a.png';
  const { covers, calls } = setup(t, { [a]: () => image() });
  await covers.warm([a]);
  assert.ok(calls[0].init.signal instanceof AbortSignal);
  assert.match(calls[0].init.headers['user-agent'], /^MangaCircus/);
 });
@@ -78,7 +78,7 @@ test('reader serves a saved index immediately after restart and verifies it in b
    const output = [];
    child = spawn(process.execPath, ['server.js'], { cwd: path.resolve(__dirname, '..'), windowsHide: true,
      env: { ...process.env, LIBRARY: library, DATA: data, PORT: String(port), SCAN_INTERVAL: '0', FULL_SCAN_INTERVAL: '0',
-        SCRAPER_URL: 'http://127.0.0.1:9', SCRAPER_TOKEN: 'fixture-token', SCRAPER_TOKEN_FILE: '' } });
+        SCRAPER_URL: 'http://127.0.0.1:9', SCRAPER_TOKEN: 'fixture-token', SCRAPER_TOKEN_FILE: '', GREATEST_COVER_WARM: '0' } });
    child.stdout.on('data', data => output.push(String(data)));
    child.stderr.on('data', data => output.push(String(data)));
    const base = `http://127.0.0.1:${port}`;
@@ -0,0 +1,149 @@
 'use strict';
 // BL-0055: Moments, a reader's saved pages or page regions with exactly one category.
 const test = require('node:test'), assert = require('node:assert/strict');
 const fs = require('fs'), os = require('os'), path = require('path'), net = require('net');
 const { spawn } = require('child_process');
 const { Canvas } = require('../tools/png');
 const moments = require('../moments');
 const { trimPages, momentPageLabel } = require('../public/moments');
 const { READER_KEYS, MOMENT_VIEWER_KEYS, keyAction } = require('../public/keys');
 test('regions are clamped fractions; a whole-page rectangle means no region', () => {
  assert.deepEqual(moments.cleanRegion({ x: 0.1, y: 0.2, w: 0.3, h: 0.4 }), { x: 0.1, y: 0.2, w: 0.3, h: 0.4 });
  assert.deepEqual(moments.cleanRegion({ x: -1, y: 0.5, w: 3, h: 2 }), { x: 0, y: 0.5, w: 1, h: 0.5 });
  assert.equal(moments.cleanRegion({ x: 0, y: 0, w: 1, h: 1 }), null);
  assert.equal(moments.cleanRegion(null), null);
  assert.throws(() => moments.cleanRegion({ x: 0.5, y: 0.5, w: 0.001, h: 0.5 }), /too small/);
  assert.throws(() => moments.cleanRegion({ x: 'a', y: 0, w: 1, h: 1 }), /Invalid/);
 });
 test('exactly one known category is required; notes are trimmed and capped', () => {
  for (const cat of ['twist', 'hot', 'awesome', 'cute', 'funny', 'feels']) assert.equal(moments.cleanCategory(cat), cat);
  assert.throws(() => moments.cleanCategory(undefined), /Pick one category/);
  assert.throws(() => moments.cleanCategory('meh'), /Pick one category/);
  assert.equal(moments.cleanNote('  so   good \n'), 'so good');
  assert.equal(moments.cleanNote('x'.repeat(500)).length, moments.NOTE_MAX);
 });
 const near = (a, b) => Math.abs(a - b) < 1e-9;
 test('side by side: a region inside one page of a spread becomes that page alone', () => {
  const left = { i: 5, w: 700, h: 1000 }, right = { i: 4, w: 700, h: 1000 };
  const one = trimPages([left, right], { x: 0.6, y: 0.1, w: 0.2, h: 0.3 });
  assert.deepEqual(one.pages, [right]);
  assert.ok(near(one.region.x, 0.2) && near(one.region.w, 0.4) && one.region.y === 0.1);
  assert.equal(trimPages([left, right], { x: 0.3, y: 0.1, w: 0.4, h: 0.3 }).pages.length, 2);
 });
 test('stacked (Flow): a picture across the break keeps only the pages it touches', () => {
  const pages = [0, 1, 2, 3].map(i => ({ i, w: 800, h: 400 })); // each page is half as tall as wide: 0.5 of the width
  // The stack is 2 units tall; y 0.4–0.6 is the lower half of page 1 and the upper half of page 2.
  const cut = trimPages(pages, { x: 0.1, y: 0.4, w: 0.8, h: 0.2 }, 'column');
  assert.deepEqual(cut.pages.map(p => p.i), [1, 2]);
  assert.ok(near(cut.region.y, 0.3) && near(cut.region.h, 0.4) && cut.region.x === 0.1);
  assert.deepEqual(trimPages(pages, null, 'column').pages.length, 4);
  assert.equal(momentPageLabel(cut.pages), 'p. 2–3');
 });
 test('every reader key is bound once and the M / I split holds', () => {
  const keys = READER_KEYS.flatMap(entry => entry.keys);
  assert.equal(new Set(keys).size, keys.length);
  assert.equal(keyAction(READER_KEYS, 'm'), 'moment');
  assert.equal(keyAction(READER_KEYS, 'i'), 'bars');
  assert.equal(keyAction(READER_KEYS, 'Escape'), 'bars');
  assert.equal(keyAction(READER_KEYS, '?'), 'help');
  assert.equal(keyAction(MOMENT_VIEWER_KEYS, 'ArrowLeft'), 'step');
  assert.ok(READER_KEYS.every(entry => entry.label && entry.text));
 });
 async function freePort() {
  const listener = net.createServer();
  await new Promise(resolve => listener.listen(0, '127.0.0.1', resolve));
  const port = listener.address().port;
  await new Promise(resolve => listener.close(resolve));
  return port;
 }
 test('moments are private, validated, editable and survive page renumbering as "moved"', { timeout: 30000 }, async () => {
  const root = fs.mkdtempSync(path.join(os.tmpdir(), 'mc-moments-'));
  let child;
  try {
    const library = path.join(root, 'library'), data = path.join(root, 'data');
    const chapterDir = path.join(library, 'Moon Garden', 'v01', 'c001 Roots');
    fs.mkdirSync(chapterDir, { recursive: true }); fs.mkdirSync(data);
    for (const n of [1, 2, 3]) fs.writeFileSync(path.join(chapterDir, `00${n}.png`), new Canvas(60, 90, [40 * n, 60, 120]).png());
    const port = await freePort(), output = [];
    child = spawn(process.execPath, ['server.js'], { cwd: path.resolve(__dirname, '..'), windowsHide: true,
      env: { ...process.env, LIBRARY: library, DATA: data, PORT: String(port), SCAN_INTERVAL: '0', FULL_SCAN_INTERVAL: '0',
        SCRAPER_URL: 'http://127.0.0.1:9', SCRAPER_TOKEN: 'fixture-token', SCRAPER_TOKEN_FILE: '', BACKUP: '', GREATEST_COVER_WARM: '0' } });
    child.stdout.on('data', d => output.push(String(d)));
    child.stderr.on('data', d => output.push(String(d)));
    const base = `http://127.0.0.1:${port}`;
    let ready = false;
    for (let n = 0; n < 100 && !ready; n++) {
      ready = await fetch(base + '/health').then(r => r.ok).catch(() => false);
      if (!ready) await new Promise(resolve => setTimeout(resolve, 50));
    }
    assert.ok(ready, output.join(''));
    const post = (cookie, url, body) => fetch(base + url, { method: 'POST',
      headers: { 'content-type': 'application/json', ...(cookie ? { cookie } : {}) }, body: JSON.stringify(body) });
    const get = (cookie, url) => fetch(base + url, { headers: { cookie } }).then(r => r.json());
    const session = r => r.headers.get('set-cookie').split(';')[0];
    const alice = session(await post(null, '/api/signup', { name: 'alice', password: 'alice-password' }));
    await post(alice, '/api/admin/user', { name: 'bob', password: 'bob-password' });
    const bob = session(await post(null, '/api/login', { name: 'bob', password: 'bob-password' }));
    await post(alice, '/api/admin/rescan', { full: true });
    const manga = await get(alice, '/api/manga?m=' + encodeURIComponent('Moon Garden'));
    const c = manga.chapters[0].id, v = manga.chapters[0].versions[0].id;
    const base3 = { m: 'Moon Garden', c, v };
    // A category is required: nothing is ever dumped into an uncategorised pile.
    assert.equal((await post(alice, '/api/moments', { ...base3, pages: [1] })).status, 400);
    assert.equal((await post(alice, '/api/moments', { ...base3, pages: [9], cat: 'hot' })).status, 400);
    const created = await (await post(alice, '/api/moments', { ...base3, pages: [1], cat: 'awesome', region: { x: 0.1, y: 0.5, w: 0.5, h: 0.25 }, note: ' big  fight ' })).json();
    assert.equal(created.moment.cat, 'awesome');
    assert.equal(created.moment.note, 'big fight');
    assert.equal(created.moment.pages[0].i, 1);
    assert.match(created.moment.pages[0].u, /^lib\/Moon%20Garden\/v01\/c001%20Roots\/002\.png$/);
    const spread = (await (await post(alice, '/api/moments', { ...base3, pages: [2, 0], cat: 'twist' })).json()).moment;
    assert.deepEqual(spread.pages.map(p => p.i), [2, 0]);
    assert.equal(spread.layout, 'row');
    // Flow: a picture stacked over three pages; more than four pages or an unknown layout is refused.
    const stacked = (await (await post(alice, '/api/moments', { ...base3, pages: [0, 1, 2], layout: 'column', cat: 'awesome', region: { x: 0, y: 0.2, w: 1, h: 0.5 } })).json()).moment;
    assert.equal(stacked.layout, 'column');
    assert.equal((await post(alice, '/api/moments', { ...base3, pages: [0, 1, 2, 0], cat: 'hot' })).status, 400);
    assert.equal((await post(alice, '/api/moments', { ...base3, pages: [0], layout: 'grid', cat: 'hot' })).status, 400);
    assert.equal((await post(alice, '/api/moments/delete', { id: stacked.id })).status, 200);
    // Story order: page 0/2 spread starts before page 1.
    const listed = (await get(alice, '/api/moments?m=Moon%20Garden')).moments;
    assert.deepEqual(listed.map(x => x.id), [spread.id, created.moment.id]);
    const chapter = await get(alice, `/api/chapter?m=Moon%20Garden&c=${encodeURIComponent(c)}`);
    assert.deepEqual(chapter.moments.map(x => x.pages).sort(), [[1], [2, 0]].sort());
    // Private: bob sees nothing and cannot touch alice's moments.
    assert.deepEqual((await get(bob, '/api/moments?m=Moon%20Garden')).moments, []);
    assert.equal((await get(bob, `/api/chapter?m=Moon%20Garden&c=${encodeURIComponent(c)}`)).moments.length, 0);
    assert.equal((await post(bob, '/api/moments/update', { id: created.moment.id, cat: 'hot' })).status, 404);
    assert.equal((await post(bob, '/api/moments/delete', { id: created.moment.id })).status, 404);
    const edited = (await (await post(alice, '/api/moments/update', { id: created.moment.id, cat: 'feels', region: null })).json()).moment;
    assert.equal(edited.cat, 'feels'); assert.equal(edited.region, null);
    assert.equal((await post(alice, '/api/moments/update', { id: created.moment.id, cat: '' })).status, 400);
    // The file of page 2 goes away: the moment shows as moved instead of pointing at another picture.
    fs.renameSync(path.join(chapterDir, '002.png'), path.join(chapterDir, '009.png'));
    await post(alice, '/api/admin/rescan', { full: true });
    const after = (await get(alice, '/api/moments?m=Moon%20Garden')).moments;
    assert.equal(after.find(x => x.id === created.moment.id).missing, true);
    assert.equal(after.find(x => x.id === spread.id).missing, false);
    assert.equal((await post(alice, '/api/moments/delete', { id: spread.id })).status, 200);
    assert.equal((await get(alice, '/api/moments?m=Moon%20Garden')).moments.length, 1);
  } finally {
    if (child) child.kill();
    fs.rmSync(root, { recursive: true, force: true });
  }
 });
@@ -29,7 +29,7 @@ test('three services integrate collections, auth, custom covers and private heal
    const token = 'integration-test-only';
    const env = { ...process.env, DATA: data, LIBRARY: library, SCRAPER_DATA: path.join(data, 'scraper'),
      PORT: String(rp), SCRAPER_PORT: String(sp), SCRAPER_HOST: '127.0.0.1',
-      READER_URL: base, SCRAPER_URL: scraper, SCRAPER_TOKEN: token, SCRAPER_TOKEN_FILE: '', SCAN_INTERVAL: '0', COOKIE_SECURE: '0' };
+      READER_URL: base, SCRAPER_URL: scraper, SCRAPER_TOKEN: token, SCRAPER_TOKEN_FILE: '', SCAN_INTERVAL: '0', COOKIE_SECURE: '0', GREATEST_COVER_WARM: '0' };
    for (const script of ['server.js', 'scraper/daemon.js']) {
      const child = spawn(process.execPath, [script], { cwd: root, env, windowsHide: true }); children.push(child);
      for (const stream of [child.stdout, child.stderr]) stream.on('data', chunk => output.push(chunk.toString()));
@@ -67,6 +67,10 @@ test('three services integrate collections, auth, custom covers and private heal
    assert.equal((await (await request('/api/settings', { pageTone: 'sepia' })).json()).settings.pageTone, 'sepia');
    assert.equal((await (await request('/api/settings', { pageTone: 'invalid' })).json()).settings.pageTone, 'sepia');
    assert.equal((await (await anotherRequest('/api/me')).json()).settings.pageTone, 'original');
    assert.equal((await (await request('/api/me')).json()).settings.continueRow, true);
    assert.equal((await (await request('/api/settings', { continueRow: false })).json()).settings.continueRow, false);
    assert.equal((await (await request('/api/settings', { continueRow: 'no' })).json()).settings.continueRow, false);
    assert.equal((await (await anotherRequest('/api/me')).json()).settings.continueRow, true);
    assert.equal((await fetch(base + '/api/discovery')).status, 401);
    assert.equal((await anotherRequest('/api/admin/discovery/run', {})).status, 403);
    assert.equal((await request('/api/settings', { discoveryEnabled: true })).status, 200);
@@ -69,6 +69,7 @@ for (const [index, name] of ['Moon Garden', 'Before the Rain', 'Iron Harbor'].en
 const env = { ...process.env, LIBRARY_PATH: library, DATA_PATH: data, SCRAPER_DATA_PATH: path.join(data, 'scraper'),
  SCRAPER_TOKEN_PATH: tokenFile, BACKUP_PATH: backupDir, READER_PORT: port, READER_BIND: '127.0.0.1', COOKIE_SECURE: '0', APP_IMAGE: process.env.APP_IMAGE || 'mangacircus:local',
  READER_IMAGE: process.env.APP_IMAGE || 'mangacircus:local',
  GREATEST_COVER_WARM: '0', // QA stacks never download catalog covers
  ...(readingGateQa ? { READING_WINDOWS_JSON: '{"0":[],"1":[],"2":[],"3":[],"4":[],"5":[],"6":[]}',
    READING_TIMEZONE: 'Europe/Berlin', READING_QUIZ_UNLOCK_MINUTES: '60', READING_QUIZ_CATALOG_PATH: '/data/reading-quiz.json' }
    : { READING_WINDOWS_JSON: '', READING_QUIZ_CATALOG_PATH: '' }),
@@ -40,7 +40,7 @@ async function freePort() {
  const scraperPort = fakeScraper.address().port;
  const child = spawn(process.execPath, ['server.js'], { cwd: root, windowsHide: true,
    env: { ...process.env, PORT: String(port), LIBRARY: library, DATA: data, SCAN_INTERVAL: '0',
-      FULL_SCAN_INTERVAL: '0', SCRAPER_URL: `http://127.0.0.1:${scraperPort}`, COOKIE_SECURE: '0' }, stdio: 'ignore' });
+      FULL_SCAN_INTERVAL: '0', SCRAPER_URL: `http://127.0.0.1:${scraperPort}`, COOKIE_SECURE: '0', GREATEST_COVER_WARM: '0' }, stdio: 'ignore' });
  let browser;
  try {
    for (let i = 0; i < 80; i++) {
Author	SHA1	Message	Date
MaashkinoozheandClaude Opus 5.5	ea8a5b40e7	.dockerignore: let moments.js into the image; guard test checks the allowlist too `f38f218` failed to build: .dockerignore is an allowlist and kept moments.js out of the build context. Verified by building the image and starting the reader from it (health ok). Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-10-27 13:47:26 +01:00
MaashkinoozheandClaude Opus 5.5	f38f218ae0	Dockerfile: copy moments.js; guard test for required top-level modules The `5497e8b` image lacked moments.js, so the reader crashed at start on docker-01. test/dockerfile.test.js follows server.js requires and fails when a top-level module is not copied into the image. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-10-27 12:56:07 +01:00
MaashkinoozheandClaude Opus 5.5	5497e8bfbc	Moments across up to four pages: stacked in Flow, side by side in Page/Book (BL-0055) The save sheet gets "+ Previous page" / "+ Next page" (right to left for rtl in Page/Book) for a picture that runs over several pages. Moments store a layout (row \| column); pages the selected region does not touch are dropped. Crops, viewer and gallery draw both layouts. Dialogs now clean up directly instead of waiting for the "close" event, which a backgrounded page can deliver late (a closed sheet stayed in the page and M stopped working). Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-10-27 12:38:22 +01:00
MaashkinoozheandClaude Opus 5.5	74842c59e0	Moments: per-user saved pages and regions with one category (BL-0055) Reader: bookmark button and M save the page (Flow: page at the reading line, Book: the spread) with an optional dragged region, exactly one category (Twist, Hot, Awesome, Cute, Funny, Feels) and a note. I now toggles the bars; ? lists all keys. Keys dispatch through public/keys.js, which also feeds the new Settings -> Keyboard shortcuts section. Manga page: "Your moments" strip of crops (story or recent order, category filters), viewer with step, full page, edit, delete and "Open in reader" (read.html ...&p=). Moments point at pages by file name and show "page moved" when the file is gone. Private per user. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-10-27 12:30:24 +01:00
MaashkinoozheandClaude Opus 5.5	41e7ed063e	Continue row: first line of the content, only on the plain overview The row now sits below the search, filters and tags, directly above the grid. It hides while a search is typed or a status filter is set (as well as on "Recently read"); tags and collection grouping keep it. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-10-27 12:08:35 +01:00
MaashkinoozheandClaude Opus 5.5	1ddefaa7ac	Library: "Continue where you left off" row with a per-user setting One fixed row above the library showing the five most recently read, unfinished manga with the normal tiles (they stay in the grid as well). It ignores search and filters, hides while sorted by "Recently read", and can be turned off under Settings > Reading > Library page (continueRow, default on). Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-10-27 12:02:16 +01:00
MaashkinoozheandClaude Opus 5.5	e9da27e688	Greatest: serve catalog covers from a local copy (BL-0053) The page hotlinked ~100 AniList CDN covers per load and some failed at random. The reader now downloads each catalog cover once (sequential, ~1/s, stops on 401/403/429, images up to 2 MB) into data/greatest-covers/ and serves it from /api/greatest-cover with a year-long browser cache; until a copy exists the route redirects to the catalog URL. The page also accepts the server's relative cover URLs, so owned titles show their library cover again. GREATEST_COVER_WARM=0 turns the downloads off (tests, offline installs). Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-10-26 00:38:55 +01:00