Extracted series metadata from EPUB files and remote sync providers to
fold multi-volume series into interactive stacks on the main shelf.
Added a dedicated series view so readers could browse ordered volumes
without cluttering the main library screen.
Signed-off-by: Chmouel Boudjnah <chmouel@chmouel.com>
Added catalog support for liseur-sync servers so readers can browse
remote folders, view book listings, and download files directly.
Adjusted the link storage to let multiple catalog editions resolve to
the same work without database conflicts.
Signed-off-by: Chmouel Boudjnah <chmouel@chmouel.com>
* Bundled the Literata variable font files and exposed them through a new custom
Electron protocol to ensure consistent offline long-form reading typography.
* Configured the reader engine and CSS theme to default to the new font family
with proper ligatures and an increased default font size.
* Centered the library wordmark and book-count pill together beside the artwork
in the top bar.
Signed-off-by: Chmouel Boudjnah <chmouel@chmouel.com>
The panel was part of the library screen, and the library screen is
unmounted while you are reading. Ctrl+, went nowhere, and the only way
to change a setting was to leave the book first.
It belongs to the application shell, which is always there, so it now
opens over whichever screen is showing and closes back onto it. The
screens underneath stop reading the keyboard while it is up: an arrow
key meant for the panel was turning the page behind it.
Ctrl+F is now claimed by whichever screen is on, so it searches the
book while you are reading one instead of doing nothing; the menu item
says "Search" rather than "Search Library". The reader also stops
listening for it when it closes — the shelf's own listener was being
added again on every return from a book and never removed.
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
The hooks ran `pnpm format:check` on push and nothing else, which let a
change that does not compile, does not lint or does not pass its tests
get all the way to CI before anyone heard about it.
Now there are two passes. Committing runs the checks that answer in a
couple of seconds — formatting, lint, and a guard against a test left
focused with `.only`, which is how a whole test file quietly stops
being a test file. Pushing runs those again, so a commit made with
--no-verify still has to face them, and adds the types and the unit
tests. That is the half of CI that needs neither the network nor a
build; what is left to fail on GitHub is `pnpm build` and the
end-to-end suite.
The configuration moves to the name pre-commit looks for by itself, so
installing it no longer needs flags, and it names both hook types it
wants. Run `pre-commit install` once more after pulling this.
While writing the lint hook: the renderer's ban on Node builtins was
documented but never enforced — only `electron` was. The restriction
now says so, and applies to the renderer and to shared code rather
than to everything with an exception list, which is what it always
meant.
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
For people who already navigate everything else with hjkl. Off by
default, and switched on from Settings.
The shelf answers to hjkl with counts, 0/^/$ across a row, gg and G for
the ends, <C-d>/<C-u> by the half screen, / to search, f and s to walk
the filters and sorts, and Enter or o to open what is selected. In a
book: pages with hjkl, chapters with ]] and [[, 50% to jump halfway,
12G for the twelfth chapter, n and N between search matches, m to
bookmark, and q to come back to the shelf. ? shows the whole list
wherever you are.
It is strictly additive. Arrows, space, the page keys, F11, Enter and
the menu shortcuts behave the same whether it is on or off, because a
vim key is only claimed when it is bound and nothing else answers to
it. Escape still belongs to the application: it drops a half-typed
sequence if there is one, then closes what is open, then leaves the
book.
The grammar lives in one pure module that the screens, the key sheet
and the tests all read, so the keys cannot drift from their own
documentation.
Along the way: the Settings panel could not be closed with Escape once
focus had landed on one of its controls.
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Added a pre-commit configuration file to run formatting checks before
every push and updated the development documentation with installation
instructions.
The end-to-end tests open real application windows. On a machine
somebody is working at, they take the focus and the keyboard for the
length of the run, and a stray click lands wherever the mouse happens
to be. The instructions for avoiding that were in the developer notes
only, so agents, which are pointed at AGENTS.md, never saw them and
ran the tests over the top of whatever was on screen.
Add scripts/headless.sh, which starts a hidden desktop of its own,
runs the command inside it and shuts it down afterwards, and say in
AGENTS.md that this is how the tests are to be run.
The old written-out recipe also named a specific screen to use, which
was only ever right on the machine it was written on: the names are
handed out in whatever order, and the name it gave is usually the real
session, so following it did exactly the thing it set out to avoid.
The script asks the hidden desktop its name rather than guessing, and
clears the leftover address that otherwise lets a stray command
rearrange the windows of the person sitting there.
Updates ARCHITECTURE.md with the PositionOrigin contract, the
application-scoped worker position publisher, and the sync service's
signal-driven single-flight drain with monotonic queue versions.
Updates PERFORMANCE.md to note that page turns still never await the
position publish or the network, and that progress reaches a
configured server immediately rather than on the old 2s debounce.
Nothing this app sent to a liseur-sync server was ever filed against the
right book, and on a good day nothing was filed at all. The request asking
the server to identify a book was the wrong shape, so the server rejected
every one of them without the app noticing. A book the server cannot name
cannot have its place saved, cannot collect the place left on the phone,
and cannot count towards the reading statistics.
Books are now described the way the phone describes them: the file's
fingerprint, the library server's own reference, the identifier printed in
the book, and the title and author reduced to a plain form the two apps
agree on. That last one has to be spelled identically on both sides or the
same book quietly becomes two, so the checks here are a translation of the
phone's own.
Each sync now also introduces a batch of unnamed books, most recently read
first, and asks each newly named one where it was left off. Without that
step a book only ever became known by being read on this computer, and
anything the phone had already recorded for it was passed over for good.
Servers added before the statistics screen existed hold only a
position-sync permission, and the server refuses reading history to it.
The only way to get the second permission was to remove the server and
add it back, which unlinks every book from it.
The settings row now offers to ask for it directly: type your password
once and the server grants the statistics permission on its own, leaving
the sync credential and every book link untouched.
Adds a reading statistics screen: total time read, books read from and
finished, a day streak, a chart of the past week, and a list of books by
time spent. It opens from the button beside the theme switch in the
library header.
The figures start with what this computer recorded, so the screen works
offline and with no server at all. When a liseur-sync server is
configured, the reading done on your phone and any other device is folded
in, exactly as the Android app does it: the server counts the same
sittings this computer already reported, so its figure replaces the local
one instead of being added to it.
Those statistics live behind a separate permission on the server, which a
sync token is refused. Signing in now asks for that second permission as
well. A server that declines still syncs your place in a book, and the
settings screen says the totals will stay on this computer.
Created a comprehensive tracking document for planned features and known
missing work by comparing the design specifications against the current
codebase. Updated the agent instructions to require checking this new
document before starting any new features.
Signed-off-by: Chmouel Boudjnah <chmouel@chmouel.com>
Keep only README.md, AGENTS.md and SECURITY.md at the root, where
tooling and GitHub expect to find them, and relocate the longer
reference docs alongside DEVELOPMENT.md. Updated cross-links accordingly.
Every milestone in DESIGN.md's roadmap was done, so the phased-build
scaffolding (roadmap table, milestone rules, per-milestone labels
scattered across AGENTS.md, PERFORMANCE.md and ARCHITECTURE.md) no
longer describes anything in progress. Removed it and the reader-engine
ADR it referenced, leaving the docs as plain descriptions of what the
app is rather than a project-planning artifact.
SECURITY.md explains what is actually at risk here, why fourteen days is the
number, what the lockfile check is for, and how to report a vulnerability. It
also lists the measures deliberately not taken and why, so the argument is
not had twice.
Releases now carry build provenance alongside their checksums. The builds are
still unsigned, but anyone can check that the bytes they downloaded came out
of this workflow at this commit, which a checksum on its own cannot say.
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Extracted setup, test commands, and environment variable details from
README.md into a new docs/DEVELOPMENT.md file to clean up project
documentation.
Signed-off-by: Chmouel Boudjnah <chmouel@chmouel.com>
Added full support for importing, storing, reading, and synchronizing
EPUB books. Parsed book files in a background worker and persisted
library metadata in SQLite to handle large libraries without slowing
down the main interface. Created a custom column-based reader with
themes, typography controls, annotations, and text search. Added
background catalog sync and reading progress reconciliation for remote
servers to keep reading state consistent across devices.
Signed-off-by: Chmouel Boudjnah <chmouel@chmouel.com>
