Files
readest/apps/readest-app/src/services/send/clipOptions.ts
T
Huang Xin a1279a65ce feat(send): clip web URLs into self-contained EPUBs via Tauri webview (#4241)
Builds the URL-clipping path of the "Send to Readest" feature: paste a
link, the renderer ingests the rendered page, and a self-contained EPUB
lands in the library. No server proxy, no external CDN refs left in the
EPUB once it's saved.

Architecture

- New Rust `clip_url` command spawns a hidden Tauri WebviewWindow at the
  target URL with a real Chrome UA + WebKit fingerprint mask, so TLS-
  fingerprint and JS-challenge walls (Cloudflare, Medium, X, WeChat MP)
  resolve naturally instead of bouncing the server proxy.
- Capture transport is URL-payload navigation to a one-shot
  127.0.0.1:RANDOM_PORT/clip/{token}?d={url-safe-base64} listener.
  Top-level navigation isn't governed by CSP connect-src / form-action /
  WebKit Private Network Access — the four earlier transports
  (fetch, <form>, custom URI scheme, window.name) were each blocked by
  one of those.
- Page-to-EPUB bundler (`assetBundler`) walks <img>/<picture> with
  src → data-src → data-original → data-srcset → srcset fallback so lazy-
  loading sites don't ship a 60px LQIP; fetches assets in parallel with a
  per-asset timeout + per-asset/total caps; failed images degrade to alt-
  text placeholders. A per-site rules table (seeded with WeChat MP) + a
  selector fallback catches articles Readability misextracts. Builder
  prepends the article <h1> + byline so the EPUB has a proper opening.
- Nested EPUB TOC built from h1–h6.

UI surfaces

- "From Web URL" entry in the library Import menu, gated to Tauri; web
  build hides the URL field and points at the browser extension.
- `ImportFromUrlDialog` with auto-height (overrides Dialog's `sm:h-[65%]`
  default) and a dim placeholder for the URL field.
- Clip webview window styled to match Readest's main window — macOS
  decorations + overlay title bar; other desktops decorationless with a
  drop shadow; native background + in-page loading overlay pick up the
  caller's `themeCode.bg`/`fg` so light/dark/eink/custom themes all
  render correctly. Title localised, all five overlay/title strings
  translated across 33 locales.

Notes

- Gates the macOS traffic-light positioner to main/reader-* windows so
  the decorationless clip window no longer null-derefs in
  `position_traffic_lights`.
- Stricter validation across the path: schemes restricted to http/https,
  hex-color parsing rejects malformed values, server endpoint returns
  400 on missing/invalid base64.

Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-20 19:48:09 +02:00

40 lines
1.2 KiB
TypeScript

/**
* Options handed to the Rust `clip_url` command so the in-webview
* loading overlay, window title, "Saved" page, and native window
* background all match Readest's current theme + UI language.
*
* Each `_()` call is a literal string so the i18next scanner can
* extract the keys — keep them inline here rather than building from
* dynamic input. The theme `bg`/`fg` come from the same
* `getThemeCode()` that paints the rest of the app, so a user on
* light, dark, eink, or a custom palette sees the same chrome in the
* clipper window.
*/
import { getThemeCode } from '@/utils/style';
type Translate = (key: string) => string;
export interface ClipOptions {
windowTitle: string;
overlayTitle: string;
loadingStatus: string;
capturingStatus: string;
savedTitle: string;
background: string;
foreground: string;
}
export function getClipOptions(_: Translate): ClipOptions {
const { bg, fg } = getThemeCode();
return {
windowTitle: _('Saving to your Readest library…'),
overlayTitle: _('Saving to Readest'),
loadingStatus: _('Loading article…'),
capturingStatus: _('Capturing article…'),
savedTitle: _('Saved to Readest'),
background: bg,
foreground: fg,
};
}