komado 0.1.2 → 0.1.4

package/README.md

@@ -28,7 +28,7 @@ with [Ink](https://github.com/vadimdemedes/ink).
 - **Reading progress.** Where you left off is saved per manga and resumable from
   *Continue reading*.
 - **Sign in to MangaDex (optional).** Log in to browse your **followed library**, see
-  which chapters you've already read, and **sync progress back** — finishing a chapter
+  which chapters you've already read, and **sync progress back** - finishing a chapter
   marks it read on MangaDex. Reading itself needs no account.
 - **Offline-friendly.** Point it at folders of `.cbz`/`.zip` or loose images.
 
@@ -41,7 +41,7 @@ with [Ink](https://github.com/vadimdemedes/ink).
 
 ## Install
 
-**macOS / Linux** — one line fetches the latest, builds it, and drops a `komado`
+**macOS / Linux** - one line fetches the latest, builds it, and drops a `komado`
 launcher on your PATH:
 
 ```bash
@@ -52,24 +52,33 @@ Then just type **`komado`**. Re-run that same command any time to update. It nee
 `git`, **Node ≥ 20**, and `npm`; it installs to `~/.local/share/komado` with the
 launcher in `~/.local/bin` (override via `KOMADO_APP_DIR` / `KOMADO_BIN_DIR`).
 
-**Windows** — the PowerShell one-liner installs Node.js for you (via `winget`) if it's
-missing, then komado, leaving a native `komado` command on your `PATH`:
+**Windows** - one line installs Node.js for you (via `winget`) if it's missing,
+then komado, leaving a native `komado` command on your `PATH`. Works from **both
+CMD and PowerShell**, and ignores the execution policy either way:
 
-```powershell
-irm https://raw.githubusercontent.com/RyuPrad/komado/main/install.ps1 | iex
+```
+powershell -NoProfile -ExecutionPolicy Bypass -c "irm https://raw.githubusercontent.com/RyuPrad/komado/main/install.ps1 | iex"
 ```
 
-Already have **Node ≥ 20**? Install straight from PowerShell or CMD instead:
+Prefer the native syntax? In **PowerShell**:
 
 ```powershell
-npm i -g komado
+irm https://raw.githubusercontent.com/RyuPrad/komado/main/install.ps1 | iex
 ```
 
-Don't use the `curl … | bash` line on Windows — under **Git Bash** or **WSL** it
+Already have **Node ≥ 20**? `npm i -g komado` works from either shell - CMD runs
+npm's `.cmd` shim directly, and PowerShell does too if your execution policy
+allows scripts.
+
+> Note: the short `irm … | iex` form is PowerShell-only - in **CMD** it prints
+> `'irm' is not recognized`. Use the longer one-liner above (which works in both),
+> or run `npm i -g komado` directly.
+
+Don't use the `curl … | bash` line on Windows - under **Git Bash** or **WSL** it
 installs a launcher that only runs inside that shell, never from CMD/PowerShell.
 
-Uninstall from inside the app — **Settings → Uninstall komado…** (type `uninstall` to
-confirm) — removes the app, its launcher, and `~/.komado` (config, reading progress,
+Uninstall from inside the app - **Settings → Uninstall komado…** (type `uninstall` to
+confirm) - removes the app, its launcher, and `~/.komado` (config, reading progress,
 MangaDex login). By hand that's
 `rm -rf ~/.local/share/komado ~/.local/bin/komado ~/.komado`.
 
@@ -87,7 +96,7 @@ terminal supports and where state is stored:
 npm run doctor
 ```
 
-Render a single image (path or URL) at the best fidelity your terminal allows — handy
+Render a single image (path or URL) at the best fidelity your terminal allows - handy
 for testing sixel/kitty terminals:
 
 ```bash
@@ -118,7 +127,7 @@ Readable text needs real pixels. At startup the app probes your terminal (run
   full-width with vertical pan by default; press `f` to toggle whole-page fit.
   Keys: `←`/`→` or `a`/`d` page · `↑`/`↓` pan · `n`/`p` chapter · `f` fit · `q` back.
 - **neither** → the in-Ink **cell reader** is used (Unicode half-blocks, or
-  chafa symbols when available). Fine for art, coarse for small lettering —
+  chafa symbols when available). Fine for art, coarse for small lettering -
   that's the hard ceiling of character-cell rendering.
 
 Terminals with pixel support include kitty, WezTerm, Ghostty, foot, recent
@@ -128,9 +137,9 @@ Windows Terminal (≥ 1.22), and VS Code's terminal (with image support enabled)
 
 Reading from MangaDex needs **no account**. Signing in only adds personalization:
 
-- **My Library** — browse the manga you follow on MangaDex.
-- **Read-markers** — chapters you've already read are marked in the chapter list.
-- **Progress sync** — finishing a chapter pushes a read-marker back to MangaDex.
+- **My Library** - browse the manga you follow on MangaDex.
+- **Read-markers** - chapters you've already read are marked in the chapter list.
+- **Progress sync** - finishing a chapter pushes a read-marker back to MangaDex.
 
 MangaDex uses OAuth2 **personal clients**, so logging in is a one-time setup:
 
@@ -140,7 +149,7 @@ MangaDex uses OAuth2 **personal clients**, so logging in is a one-time setup:
 2. In the app: **Settings → Log in to MangaDex…**, then enter the client id/secret plus
    your MangaDex username and password.
 
-The session is **durable** — it requests an `offline_access` token and persists it, so
+The session is **durable** - it requests an `offline_access` token and persists it, so
 you stay logged in across restarts until you explicitly **log out** (Settings). Only the
 client id/secret + refresh token are stored, in `~/.komado/credentials.json` (mode
 `600`); your password is never written to disk. Toggle write-back any time with
@@ -166,10 +175,10 @@ archives are supported (RAR via the WASM `node-unrar-js`, no system binary neede
 
 Everything is self-contained under `~/.komado/` (override with `KOMADO_HOME`):
 
-- `config.json` — preferences + library paths
-- `progress.json` — reading progress
-- `credentials.json` — MangaDex login (client id/secret + refresh token; mode `600`)
-- `cache/` — scratch space for the renderer
+- `config.json` - preferences + library paths
+- `progress.json` - reading progress
+- `credentials.json` - MangaDex login (client id/secret + refresh token; mode `600`)
+- `cache/` - scratch space for the renderer
 
 ## Architecture
 
@@ -180,23 +189,23 @@ cli.js → app.js (screen stack) → screens → hooks/state → sources/* → H
                                      └──────────────→ render/* (image → terminal)
 ```
 
-- **`src/sources/*`** — each source (`mangadex`, `local`) implements the same interface
+- **`src/sources/*`** - each source (`mangadex`, `local`) implements the same interface
   (`search`, `getManga`, `listChapters`, `getPages`, `loadPageBuffer`) and returns the
   unified `{ data, pagination, meta }` envelope. The only source-specific seam is
   `loadPageBuffer`, which resolves raw bytes.
-- **`src/domain/shape.js`** — the unified `Manga`/`Chapter` contract.
-- **`src/render/*`** — capability detection + half-block (`sharp`) and `chafa` backends
+- **`src/domain/shape.js`** - the unified `Manga`/`Chapter` contract.
+- **`src/render/*`** - capability detection + half-block (`sharp`) and `chafa` backends
   behind one `renderInline()` dispatcher, with half-block as the always-works fallback.
-- **`src/lib/*`** — cross-cutting utilities ported from a server toolkit:
+- **`src/lib/*`** - cross-cutting utilities ported from a server toolkit:
   `fetchWithBackoff` (retries 429/5xx + timeout), `createCache` (TTL + negative caching
   + stampede protection), `AppError`/typed errors, the response `envelope`.
-- **`src/components/*` + `src/hooks/*`** — Ink UI. Effects use a cancelled-flag/abort
+- **`src/components/*` + `src/hooks/*`** - Ink UI. Effects use a cancelled-flag/abort
   guard against out-of-order responses, and reading progress writes are debounced.
 
 ## Development
 
 UI is plain JSX in `.js` files, transpiled to `dist/` by esbuild (a small
-`scripts/build.mjs` does a transpile-only, structure-preserving build — no bundling,
+`scripts/build.mjs` does a transpile-only, structure-preserving build - no bundling,
 so package imports stay external).
 
 ```bash

package/dist/cli.js

@@ -2,7 +2,7 @@
 import { jsx } from "react/jsx-runtime";
 import process from "node:process";
 function printHelp() {
-  console.log(`komado \u2014 a terminal manga reader (MangaDex + local files)
+  console.log(`komado - a terminal manga reader (MangaDex + local files)
 
 Usage:
   komado                 launch the interactive reader
@@ -40,8 +40,8 @@ async function doctor() {
       console.log(`  cell size:        ${probe.cellW ?? "?"}x${probe.cellH ?? "?"} px`);
     }
   } else {
-    console.log(`  kitty graphics:   ${caps.kitty}  (env guess \u2014 run in a real terminal to probe)`);
-    console.log(`  sixel:            ${caps.sixel}  (env guess \u2014 run in a real terminal to probe)`);
+    console.log(`  kitty graphics:   ${caps.kitty}  (env guess - run in a real terminal to probe)`);
+    console.log(`  sixel:            ${caps.sixel}  (env guess - run in a real terminal to probe)`);
   }
   console.log(`  chafa:            ${caps.chafa ? caps.chafaVersion : "not installed"}`);
   console.log(`  inline backend:   ${caps.chafa ? "chafa-symbols" : "half-block"}  (config.renderer=${cfg.renderer})`);
@@ -50,7 +50,7 @@ async function doctor() {
     console.log(
       protos.length ? `
   \u2192 Pixel graphics available (${protos.join(", ")}). Crisp rendering is possible:
-    test it with  node dist/cli.js render <some-image>` : "\n  \u2192 No pixel protocol detected \u2014 rendering is limited to character cells."
+    test it with  node dist/cli.js render <some-image>` : "\n  \u2192 No pixel protocol detected - rendering is limited to character cells."
     );
   }
   console.log("\nPaths:");
@@ -63,7 +63,7 @@ async function doctor() {
   console.log(`  dataSaver:         ${cfg.dataSaver}`);
   console.log(`  renderer:          ${cfg.renderer}`);
   console.log(`  contentRating:     ${cfg.contentRating.join(", ")}`);
-  console.log(`  localLibraryPaths: ${cfg.localLibraryPaths.length ? cfg.localLibraryPaths.join(", ") : "(none \u2014 add in Settings)"}`);
+  console.log(`  localLibraryPaths: ${cfg.localLibraryPaths.length ? cfg.localLibraryPaths.join(", ") : "(none - add in Settings)"}`);
 }
 async function renderCmd(target, rest) {
   if (!target) {

package/dist/components/screens/SettingsScreen.js

@@ -136,7 +136,7 @@ ${formatUninstallSummary(results)}
       /* @__PURE__ */ jsx(Text, { children: "This permanently deletes:" }),
       uninstallTargets().map((t) => /* @__PURE__ */ jsxs(Text, { color: "red", children: [
         `  \u2022 ${displayPath(t.path)}`,
-        /* @__PURE__ */ jsx(Text, { dimColor: true, children: `  \u2014 ${t.label}` })
+        /* @__PURE__ */ jsx(Text, { dimColor: true, children: `  - ${t.label}` })
       ] }, t.path)),
       /* @__PURE__ */ jsxs(Box, { marginTop: 1, children: [
         /* @__PURE__ */ jsx(Text, { children: "Type " }),

package/dist/config.js

@@ -29,7 +29,7 @@ const DEFAULT_CONFIG = {
   // preferred MangaDex translatedLanguage
   contentRating: ["safe", "suggestive"],
   dataSaver: true,
-  // smaller MangaDex page images — ideal for a terminal
+  // smaller MangaDex page images - ideal for a terminal
   renderer: "auto",
   // auto | halfblock | chafa
   theme: "default",

package/dist/domain/shape.js

@@ -34,7 +34,7 @@ function makeChapter(p) {
 }
 function chapterLabel(ch) {
   const head = ch.number != null && ch.number !== "" ? `Ch. ${ch.number}${ch.volume != null && ch.volume !== "" ? ` (Vol. ${ch.volume})` : ""}` : "Oneshot";
-  return ch.title ? `${head} \u2014 ${ch.title}` : head;
+  return ch.title ? `${head} - ${ch.title}` : head;
 }
 export {
   chapterLabel,

package/dist/sources/mangadex/auth.js

@@ -76,7 +76,7 @@ async function getAccessToken({ signal, force = false } = {}) {
         return access.token;
       } catch (err) {
         if (err.oauthError === "invalid_grant") {
-          logger.warn("MangaDex refresh token expired/revoked \u2014 logging out", err);
+          logger.warn("MangaDex refresh token expired/revoked - logging out", err);
           logout();
         }
         throw err;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "komado",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "A terminal manga reader (MangaDex + local files) rendered with Ink.",
   "keywords": [
     "manga",

package/src/app.js

@@ -39,7 +39,7 @@ export function App({ caps = {}, onViewer, initialRoute = null }) {
     exit();
   }, [exit]);
 
-  // Global keys — suppressed while a text input is focused (`typing`).
+  // Global keys - suppressed while a text input is focused (`typing`).
   useInput((input, key) => {
     if (typing) return;
     if (input === 'q') quit();

package/src/cli.js

@@ -2,7 +2,7 @@
 import process from 'node:process';
 
 function printHelp() {
-  console.log(`komado — a terminal manga reader (MangaDex + local files)
+  console.log(`komado - a terminal manga reader (MangaDex + local files)
 
 Usage:
   komado                 launch the interactive reader
@@ -42,8 +42,8 @@ async function doctor() {
       console.log(`  cell size:        ${probe.cellW ?? '?'}x${probe.cellH ?? '?'} px`);
     }
   } else {
-    console.log(`  kitty graphics:   ${caps.kitty}  (env guess — run in a real terminal to probe)`);
-    console.log(`  sixel:            ${caps.sixel}  (env guess — run in a real terminal to probe)`);
+    console.log(`  kitty graphics:   ${caps.kitty}  (env guess - run in a real terminal to probe)`);
+    console.log(`  sixel:            ${caps.sixel}  (env guess - run in a real terminal to probe)`);
   }
   console.log(`  chafa:            ${caps.chafa ? caps.chafaVersion : 'not installed'}`);
   console.log(`  inline backend:   ${caps.chafa ? 'chafa-symbols' : 'half-block'}  (config.renderer=${cfg.renderer})`);
@@ -52,7 +52,7 @@ async function doctor() {
     console.log(
       protos.length
         ? `\n  → Pixel graphics available (${protos.join(', ')}). Crisp rendering is possible:\n    test it with  node dist/cli.js render <some-image>`
-        : '\n  → No pixel protocol detected — rendering is limited to character cells.',
+        : '\n  → No pixel protocol detected - rendering is limited to character cells.',
     );
   }
   console.log('\nPaths:');
@@ -65,7 +65,7 @@ async function doctor() {
   console.log(`  dataSaver:         ${cfg.dataSaver}`);
   console.log(`  renderer:          ${cfg.renderer}`);
   console.log(`  contentRating:     ${cfg.contentRating.join(', ')}`);
-  console.log(`  localLibraryPaths: ${cfg.localLibraryPaths.length ? cfg.localLibraryPaths.join(', ') : '(none — add in Settings)'}`);
+  console.log(`  localLibraryPaths: ${cfg.localLibraryPaths.length ? cfg.localLibraryPaths.join(', ') : '(none - add in Settings)'}`);
 }
 
 async function renderCmd(target, rest) {

package/src/components/List.js

@@ -20,7 +20,7 @@ export function List({
   const selected = count ? Math.min(index, count - 1) : 0;
 
   // Notify the parent of the highlighted item when the selection (or list size)
-  // changes. Keyed on the index + count (primitives) — NOT the `items` array,
+  // changes. Keyed on the index + count (primitives) - NOT the `items` array,
   // whose reference changes every render in callers that rebuild it inline. If
   // `items` were a dep, a parent whose onHighlight calls setState would loop:
   // render → new items ref → effect → setState → render → … (max update depth).

package/src/components/screens/LibraryScreen.js

@@ -9,7 +9,7 @@ import { truncate } from '../../lib/text.js';
 const PAGE = 32;
 
 // The signed-in user's MangaDex follows. Same browse/paginate shape as the
-// search screen, minus the query box — getFollows is just another envelope.
+// search screen, minus the query box - getFollows is just another envelope.
 export function LibraryScreen({ params }) {
   const sourceId = params?.sourceId || 'mangadex';
   const ui = useUI();

package/src/components/screens/LoginScreen.js

@@ -22,7 +22,7 @@ export function LoginScreen() {
   const [busy, setBusy] = useState(false);
   const [error, setError] = useState(null);
 
-  // The whole screen is a form — keep global keys (q / Esc) suppressed.
+  // The whole screen is a form - keep global keys (q / Esc) suppressed.
   useEffect(() => {
     ui.setTyping(true);
     return () => ui.setTyping(false);

package/src/components/screens/MangaScreen.js

@@ -39,7 +39,7 @@ export function MangaScreen({ params }) {
         if (isLoggedIn() && source.getReadMarkers) {
           source.getReadMarkers(initial.id, { signal: ctrl.signal })
             .then((ids) => { if (!cancelled) setReadSet(new Set(ids)); })
-            .catch(() => {}); // decorative — never block the screen on this
+            .catch(() => {}); // decorative - never block the screen on this
         }
       } catch (err) {
         if (!cancelled) setError(err);

package/src/components/screens/ReaderScreen.js

@@ -75,7 +75,7 @@ export function ReaderScreen({ params }) {
     return out;
   };
 
-  // Background prefetch (own controller — survives page turns, aborts on unmount).
+  // Background prefetch (own controller - survives page turns, aborts on unmount).
   const prefetchers = useRef(new Set());
   useEffect(() => () => {
     for (const c of prefetchers.current) c.abort();

package/src/components/screens/SettingsScreen.js

@@ -136,7 +136,7 @@ export function SettingsScreen() {
           {uninstallTargets().map((t) => (
             <Text key={t.path} color="red">
               {`  • ${displayPath(t.path)}`}
-              <Text dimColor>{`  — ${t.label}`}</Text>
+              <Text dimColor>{`  - ${t.label}`}</Text>
             </Text>
           ))}
           <Box marginTop={1}>

package/src/components/ui.js

@@ -3,7 +3,7 @@ import { Box, Text } from 'ink';
 
 const FRAMES = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];
 
-// Hand-rolled spinner — dependency-light, matching your preference for not
+// Hand-rolled spinner - dependency-light, matching your preference for not
 // pulling a package for something this small.
 export function Spinner({ label = 'Loading' }) {
   const [frame, setFrame] = useState(0);

package/src/config.js

@@ -7,7 +7,7 @@ const usingDefaultHome = !process.env.KOMADO_HOME;
 const HOME = usingDefaultHome
   ? path.join(os.homedir(), '.komado')
   : path.resolve(process.env.KOMADO_HOME);
-// The pre-rename home (the project used to be "manga-tui") — migrated once on
+// The pre-rename home (the project used to be "manga-tui") - migrated once on
 // first run so existing config / reading progress / MangaDex login carry over.
 const LEGACY_HOME = path.join(os.homedir(), '.manga-tui');
 
@@ -34,7 +34,7 @@ export const DEFAULT_CONFIG = {
   localLibraryPaths: [],   // directories scanned by the local source
   language: 'en',          // preferred MangaDex translatedLanguage
   contentRating: ['safe', 'suggestive'],
-  dataSaver: true,         // smaller MangaDex page images — ideal for a terminal
+  dataSaver: true,         // smaller MangaDex page images - ideal for a terminal
   renderer: 'auto',        // auto | halfblock | chafa
   theme: 'default',
   syncProgress: true,      // push read-markers to MangaDex while logged in

package/src/domain/shape.js

@@ -43,5 +43,5 @@ export function chapterLabel(ch) {
   const head = ch.number != null && ch.number !== ''
     ? `Ch. ${ch.number}${ch.volume != null && ch.volume !== '' ? ` (Vol. ${ch.volume})` : ''}`
     : 'Oneshot';
-  return ch.title ? `${head} — ${ch.title}` : head;
+  return ch.title ? `${head} - ${ch.title}` : head;
 }

package/src/lib/AppError.js

@@ -1,4 +1,4 @@
-// Typed, operational errors — same idea as your server AppError, minus HTTP plumbing.
+// Typed, operational errors - same idea as your server AppError, minus HTTP plumbing.
 // statusCode is kept for parity/log triage; the TUI maps these to friendly messages.
 export class AppError extends Error {
   constructor(message, statusCode = 500, opts = {}) {

package/src/lib/cache.js

@@ -1,4 +1,4 @@
-// In-memory cache with TTL, negative caching, and stampede protection —
+// In-memory cache with TTL, negative caching, and stampede protection -
 // a port of your createCache. `wrap` shares a single in-flight promise per key
 // so concurrent callers (e.g. two screens requesting the same chapter) collapse
 // into one upstream request.

package/src/lib/fetchWithBackoff.js

@@ -48,7 +48,7 @@ export async function fetchWithBackoff(url, options = {}) {
       }
       return res;
     } catch (err) {
-      // Caller cancelled — propagate without retrying.
+      // Caller cancelled - propagate without retrying.
       if (extSignal?.aborted) throw err;
       if (attempt < retries) {
         const delay = Math.min(maxDelayMs, baseDelayMs * 2 ** attempt) + Math.random() * 200;

package/src/lib/logger.js

@@ -1,7 +1,7 @@
 import fs from 'node:fs';
 import { paths } from '../config.js';
 
-// A TUI owns stdout — console.log would corrupt the Ink render. So debug output
+// A TUI owns stdout - console.log would corrupt the Ink render. So debug output
 // goes to a file, only when KOMADO_DEBUG is set. Tail it with:
 //   tail -f ~/.komado/komado.log
 const enabled = !!process.env.KOMADO_DEBUG;

package/src/render/detect.js

@@ -35,7 +35,7 @@ export function detectCapabilities() {
     chafa = true;
     chafaVersion = (out.match(/version\s+([\d.]+)/i) || [])[1] || 'unknown';
   } catch {
-    /* chafa not on PATH — half-block fallback */
+    /* chafa not on PATH - half-block fallback */
   }
 
   cached = { term, termProgram, kitty, sixel, truecolor, chafa, chafaVersion };

package/src/render/halfblock.js

@@ -5,7 +5,7 @@ const RESET = `${ESC}[0m`;
 
 // Render an image buffer to terminal lines using the upper-half-block glyph (▀):
 // the glyph's foreground paints the TOP half of the cell, the background the
-// BOTTOM half — so each character encodes two vertical pixels at 24-bit colour.
+// BOTTOM half - so each character encodes two vertical pixels at 24-bit colour.
 // One column == one pixel wide, one row == two pixels tall.
 export async function renderHalfBlock(buffer, { cols = 80 } = {}) {
   const targetWidth = Math.max(1, Math.min(Math.floor(cols), 400));
@@ -34,7 +34,7 @@ export async function renderHalfBlock(buffer, { cols = 80 } = {}) {
       const [br, bg, bb] = y + 1 < height ? px(x, y + 1) : [tr, tg, tb];
       const fg = `${tr};${tg};${tb}`;
       const bgc = `${br};${bg};${bb}`;
-      // Emit colour codes only when they change — keeps lines compact.
+      // Emit colour codes only when they change - keeps lines compact.
       if (fg !== lastFg) { line += `${ESC}[38;2;${fg}m`; lastFg = fg; }
       if (bgc !== lastBg) { line += `${ESC}[48;2;${bgc}m`; lastBg = bgc; }
       line += '▀';

package/src/render/image.js

@@ -9,7 +9,7 @@ export async function imageSize(buffer) {
 }
 
 // Dispatch a buffer to the chosen inline backend, producing { lines, cols, rows }.
-// Always falls back to half-block so a chafa hiccup never blanks the reader —
+// Always falls back to half-block so a chafa hiccup never blanks the reader -
 // the same "graceful degradation" idea as your SSR→static fallback.
 export async function renderInline(buffer, { cols = 80, backend = 'halfblock' } = {}) {
   if (backend === 'chafa-symbols') {

package/src/render/sixel.js

@@ -11,7 +11,7 @@ const DEFAULT_CELL_H = 20;
 
 // Encode an already-correctly-sized image to sixel at its NATIVE pixel
 // resolution. --exact-size + font-ratio 1/1 makes chafa emit ~1 image px → 1
-// sixel px, so the displayed size is exactly what we sized the image to — no
+// sixel px, so the displayed size is exactly what we sized the image to - no
 // dependence on chafa guessing the terminal's cell size through a pipe.
 export async function encodePixels(buffer, { format = 'sixel' } = {}) {
   const { stdout } = await withTempImage(buffer, (file) =>
@@ -40,7 +40,7 @@ export async function scalePage(buffer, { cols, cellW }) {
 //   mode 'width' → full terminal width, vertical window at cell offset `scroll`
 // Pass a pre-scaled page (`scaled` from scalePage) in 'width' mode to skip the
 // per-scroll resize; without it the page is scaled inline.
-// Returns { buffer, maxScroll, scroll, imageRows } — scroll clamped to range,
+// Returns { buffer, maxScroll, scroll, imageRows } - scroll clamped to range,
 // imageRows = the rendered image's height in cells (so the caller can erase any
 // rows below it instead of clearing the whole screen).
 export async function prepareImage(buffer, { mode, cols, rows, scroll = 0, cellW, cellH, scaled = null }) {
@@ -80,7 +80,7 @@ export async function prepareImage(buffer, { mode, cols, rows, scroll = 0, cellW
 // chafa + ~50ms of sharp per frame). But sixel is laid out as a fixed palette
 // defined UP FRONT followed by independent 6px-tall bands, each of which
 // re-selects its own colours. So we encode the whole page to sixel ONCE, then
-// window the pre-encoded bands per frame — a string slice, not a re-encode.
+// window the pre-encoded bands per frame - a string slice, not a re-encode.
 // (Verified against chafa 1.14: every palette entry precedes the first band and
 // every band starts with a colour select, so any band range stands alone.)
 const BAND_PX = 6;
@@ -109,7 +109,7 @@ export function parseSixelPage(raw) {
   // chafa omits a band's leading colour select when it equals the previous
   // band's last colour (the register carries across '-'). For a band to be the
   // TOP of a sliced window it must re-select that colour itself, so prepend the
-  // carried register wherever it's missing — making every band self-contained.
+  // carried register wherever it's missing - making every band self-contained.
   let carry = '0'; // sixel's default colour register
   const bands = rawBands.map((b) => {
     const fixed = b.startsWith('#') ? b : `#${carry}${b}`;

package/src/sixel-reader.js

@@ -7,7 +7,7 @@ import { logger } from './lib/logger.js';
 const ESC = '\x1b';
 
 // Synchronized-update markers (DEC private mode 2026). Wrapping a frame makes a
-// supporting terminal present it atomically — so the strip-scroll's "scroll the
+// supporting terminal present it atomically - so the strip-scroll's "scroll the
 // region, then repaint the freed strip" can't flash a blank strip at the leading
 // edge. Ignored (harmless) on terminals that don't implement it.
 const SYNC_BEGIN = Buffer.from(`${ESC}[?2026h`, 'latin1');
@@ -30,7 +30,7 @@ export async function runViewer({ sourceId, manga, chapters, chapterIndex, start
 
   // Cell/band geometry for the optional strip-scroll. Sixel bands are 6px tall;
   // the terminal scrolls by whole cells. A "slot" = LCM(6, cellH)px is the
-  // smallest shift that's whole in BOTH grids — scrolling by slots lets us move
+  // smallest shift that's whole in BOTH grids - scrolling by slots lets us move
   // the on-screen pixels with the terminal and repaint only the newly-exposed
   // strip (seam-free), instead of re-sending the entire viewport every step.
   // Opt-in (KOMADO_SCROLL_DELTA=1) because it relies on the terminal scrolling
@@ -45,7 +45,7 @@ export async function runViewer({ sourceId, manga, chapters, chapterIndex, start
   let shownSig = null; // page + geometry the on-screen frame was drawn for
 
   // Per-page caches. draw() runs on every keypress, but the page bytes and the
-  // full-width scale are constant within a page — re-doing them per scroll step
+  // full-width scale are constant within a page - re-doing them per scroll step
   // (a network round-trip per step for remote sources) is what made scrolling
   // crawl. Cache both, keyed by page (and width for the scale).
   let rawKey = null;
@@ -200,7 +200,7 @@ export async function runViewer({ sourceId, manga, chapters, chapterIndex, start
       });
       // Last page reached → push a read-marker to MangaDex (self-guarded/deduped).
       // `pages &&`: a rapid n/p runs changeChapter() (pages = null) during one of
-      // this draw's awaits, after it started — guard before reading .length, or the
+      // this draw's awaits, after it started - guard before reading .length, or the
       // stale tail throws "Cannot read properties of null (reading 'length')".
       if (pages && pi === pages.length - 1 && source.syncChapterRead) {
         source.syncChapterRead(manga.id, chapters[ci].id);
@@ -212,7 +212,7 @@ export async function runViewer({ sourceId, manga, chapters, chapterIndex, start
     }
   }
 
-  // Whole-viewport frame: home + overwrite (no full ESC[2J each step — that
+  // Whole-viewport frame: home + overwrite (no full ESC[2J each step - that
   // clear-to-blank is what made scrolling blink), erase only the rows a shorter
   // image leaves below, then the status bar. One atomic write avoids partial
   // frames and extra syscalls.
@@ -224,7 +224,7 @@ export async function runViewer({ sourceId, manga, chapters, chapterIndex, start
   }
 
   // Strip-scroll frame (opt-in): scroll the image area with the terminal and
-  // repaint only the slot of sixel that scrolled into view — far less data than
+  // repaint only the slot of sixel that scrolled into view - far less data than
   // re-sending the whole viewport. Valid only for slot-sized shifts (whole cells
   // AND whole bands), so the moved pixels stay band-aligned and there's no seam.
   // Uses LF/RI inside a DECSTBM region (the most widely supported scroll path).
@@ -248,7 +248,7 @@ export async function runViewer({ sourceId, manga, chapters, chapterIndex, start
   }
 
   // Coalescing scheduler: while a draw runs, extra requests collapse into a
-  // single follow-up at the latest state — input is never dropped and draws
+  // single follow-up at the latest state - input is never dropped and draws
   // never stack up behind a slow encode.
   function schedule({ fullClear = false } = {}) {
     if (fullClear) pendingFullClear = true;
@@ -290,7 +290,7 @@ export async function runViewer({ sourceId, manga, chapters, chapterIndex, start
   const prevRaw = stdin.isRaw;
   let onKey;
   // Ink leaves stdin unref'd after unmount, so a bare `await`-for-keypress won't
-  // keep the process alive — it would exit the moment the first page is drawn.
+  // keep the process alive - it would exit the moment the first page is drawn.
   // A ref'd timer holds the event loop open until we're done.
   const keepAlive = setInterval(() => {}, 1 << 30);
   // Re-render on terminal resize so the page tracks the window size. Full clear:
@@ -333,13 +333,13 @@ export async function runViewer({ sourceId, manga, chapters, chapterIndex, start
         } else {
           return; // ignore other keys without redrawing
         }
-        // Update state synchronously, then coalesce the redraw — rapid repeats
+        // Update state synchronously, then coalesce the redraw - rapid repeats
         // collapse into the fewest draws instead of being dropped mid-draw.
         inputSeq += 1;
         schedule();
       };
 
-      // Enter raw mode *after* the first draw — Ink's unmount restores cooked
+      // Enter raw mode *after* the first draw - Ink's unmount restores cooked
       // mode on a deferred tick, which would otherwise leave stdin line-buffered
       // (so single keypresses never arrive).
       stdin.removeAllListeners('data');

package/src/sources/local/archive.js

@@ -32,7 +32,7 @@ function readZipEntry(filePath, entryName) {
   return entry.getData();
 }
 
-// ---- RAR / CBR (node-unrar-js — WASM, loaded lazily on first use) ----
+// ---- RAR / CBR (node-unrar-js - WASM, loaded lazily on first use) ----
 let unrarPromise = null;
 const getUnrar = () => (unrarPromise ??= import('node-unrar-js'));
 

package/src/sources/local/index.js

@@ -27,7 +27,7 @@ const cleanName = (name) => name.replace(/\.(cbz|zip|cbr|rar)$/i, '');
 const expandHome = (p) => (p.startsWith('~') ? path.join(os.homedir(), p.slice(1)) : p);
 
 // A directory is a manga. Its chapters are: image subfolders, then archive
-// files; or — if neither — the loose images in the folder become one chapter.
+// files; or - if neither - the loose images in the folder become one chapter.
 function buildMangaFromDir(dirPath) {
   const entries = listDir(dirPath);
   const chapters = [];

package/src/sources/mangadex/auth.js

@@ -7,7 +7,7 @@ import { logger } from '../../lib/logger.js';
 // MangaDex auth is OAuth2 "personal clients" (Keycloak). The user registers a
 // client at mangadex.org/settings, then we exchange client id/secret + their
 // username/password for a short-lived (15-min) access token and a rotating
-// refresh token. Reading manga needs none of this — login only unlocks the
+// refresh token. Reading manga needs none of this - login only unlocks the
 // user's follows/library and read-marker sync.
 
 // The access token lives in memory only; the refresh token is the durable
@@ -57,7 +57,7 @@ function applyTokens(creds, json) {
     token: json.access_token,
     expiresAt: Date.now() + (Number(json.expires_in) || 900) * 1000,
   };
-  // The refresh token rotates on each use — persist the latest one.
+  // The refresh token rotates on each use - persist the latest one.
   setCredentials({ ...creds, refreshToken: json.refresh_token || creds.refreshToken });
 }
 
@@ -101,10 +101,10 @@ export async function getAccessToken({ signal, force = false } = {}) {
       } catch (err) {
         // Only drop the saved session when the refresh token is DEFINITIVELY
         // dead (expired/revoked → invalid_grant). Transient or unexpected
-        // failures keep the credentials so the next call — or next launch — can
+        // failures keep the credentials so the next call - or next launch - can
         // recover, instead of silently logging the user out.
         if (err.oauthError === 'invalid_grant') {
-          logger.warn('MangaDex refresh token expired/revoked — logging out', err);
+          logger.warn('MangaDex refresh token expired/revoked - logging out', err);
           logout();
         }
         throw err;

package/src/sources/mangadex/index.js

@@ -121,7 +121,7 @@ export async function loadPageBuffer(page, { signal } = {}) {
 
 // The signed-in user's followed manga, normalized like search results.
 export async function getFollows({ offset = 0, limit = MANGADEX.pageLimit, signal } = {}) {
-  // /user/follows/manga rejects contentRating[] (HTTP 400) — it returns ALL of
+  // /user/follows/manga rejects contentRating[] (HTTP 400) - it returns ALL of
   // the user's follows regardless of rating, which is what we want here anyway.
   const res = await mdGet('/user/follows/manga', {
     limit,

package/src/state/store.js

@@ -13,7 +13,7 @@ function readJson(file, fallback) {
 
 // While the app is uninstalling itself, every writer no-ops so a pending debounced
 // save (or the flushProgress() that quit() runs) can't recreate the data directory
-// we just deleted. Set once, never unset — the process is on its way out.
+// we just deleted. Set once, never unset - the process is on its way out.
 let persistenceDisabled = false;
 export function disablePersistence() {
   persistenceDisabled = true;
@@ -49,7 +49,7 @@ function loadProgress() {
   return progress;
 }
 
-// Debounced save — the reader updates progress on every page turn, so coalesce.
+// Debounced save - the reader updates progress on every page turn, so coalesce.
 let saveTimer = null;
 function scheduleSave() {
   if (persistenceDisabled) return;

package/src/uninstall.js

@@ -6,7 +6,7 @@ import { disablePersistence } from './state/store.js';
 
 // Where install.sh put things. Mirrors the installer's own defaults + env
 // overrides (KOMADO_APP_DIR / KOMADO_BIN_DIR) so an in-app uninstall targets
-// exactly what was installed — and never a dev checkout, which lives elsewhere.
+// exactly what was installed - and never a dev checkout, which lives elsewhere.
 function appDir() {
   if (process.env.KOMADO_APP_DIR) return path.resolve(process.env.KOMADO_APP_DIR);
   const share = process.env.XDG_DATA_HOME || path.join(os.homedir(), '.local', 'share');
@@ -16,13 +16,13 @@ function launcherFile() {
   const bin = process.env.KOMADO_BIN_DIR
     ? path.resolve(process.env.KOMADO_BIN_DIR)
     : path.join(os.homedir(), '.local', 'bin');
-  // The launcher FILE only — never the whole bin dir, which is shared with other tools.
+  // The launcher FILE only - never the whole bin dir, which is shared with other tools.
   return path.join(bin, 'komado');
 }
 
 // The three things a full install creates. `paths.home` is the runtime data dir
 // (~/.komado or KOMADO_HOME) and holds config, reading progress, the MangaDex
-// login, the page cache, and the log — all under one dir, so one delete clears it.
+// login, the page cache, and the log - all under one dir, so one delete clears it.
 export function uninstallTargets() {
   return [
     { label: 'application files', path: appDir() },
@@ -47,7 +47,7 @@ function assertSafe(p) {
   }
 }
 
-// Remove the installed app, its launcher, and all runtime data. Synchronous — a
+// Remove the installed app, its launcher, and all runtime data. Synchronous - a
 // one-shot teardown run right before exit. It first switches off the store's
 // persistence so a pending debounced save (or the flushProgress() that quit()
 // runs) can't recreate the data dir we're deleting. One failing target never