book-cover-generator 1.6.0 → 1.7.0

package/README.md

@@ -7,7 +7,7 @@
 ![Types](https://img.shields.io/badge/types-included-blue)
 [![License: MIT](https://img.shields.io/badge/license-MIT-blue)](LICENSE)
 
-Generate book covers from a **title** and an **author**. 34 styles, 28 palettes or your own colours, a seeded randomizer, any size, and export to **SVG, PNG, JPEG or WebP**. The library has no dependencies and ships TypeScript types. It's written as plain ES modules, so it runs in the browser and in Node.
+Generate book covers from a **title** and an **author**. 39 styles, 28 palettes or your own colours, a seeded randomizer, any size, and export to **SVG, PNG, JPEG or WebP**. The library has no dependencies and ships TypeScript types. It's written as plain ES modules, so it runs in the browser and in Node.
 
 **[▶ Open the generator](https://covers.otsirh.dev)**
 
@@ -15,9 +15,9 @@ Generate book covers from a **title** and an **author**. 34 styles, 28 palettes
 
 ## Features
 
-- **34 styles in six families.**
+- **39 styles in six families.**
   - Typographic: Big Type, Minimal, Big Letter, Swiss.
-  - Genre: Thriller, Botanical, Noir, Blueprint.
+  - Genre: Thriller, Botanical, Noir, Blueprint, Hollow (horror), Ribbon (romance), Crest (fantasy), Storybook (children's), Big Idea (non-fiction).
   - Vintage: Art Deco, Classic Paperback, Engraved, Sunburst, Typewriter.
   - Scenic: Landscape, Retro Sun, Silhouette, Constellation, Orbit, Waves, Aurora, Bookshelf.
   - Geometric: Bauhaus, Split, Blocks, Concentric, Stripes.
@@ -33,13 +33,13 @@ Generate book covers from a **title** and an **author**. 34 styles, 28 palettes
 
 On [covers.otsirh.dev](https://covers.otsirh.dev) you type a title and author (press Enter in the title to break its line where you want), and if you like a subtitle, a series line ("Book Two of the Ember Cycle"), a credit ("Translated by…") and a badge ("Winner of the Hugo Award", set as a seal in a corner clear of the text). Then you choose:
 
-- **a style**, from a rail that previews your book in all 34 styles. Eleven styles let you pin a choice the variation otherwise makes, such as Silhouette's city or forest, or where Aurora puts the title;
+- **a style**, from a rail that previews your book in all 39 styles (its Genre menu shows only those that suit a genre, and Randomize then stays in it). Fifteen styles let you pin a choice the variation otherwise makes, such as Silhouette's city or forest, or where Aurora puts the title;
 - **title type**: any of the nine fonts instead of the style's, and the title in capitals or as typed. It stays when you change style, so the rail shows every style in your type;
 - **a palette**, from swatches that show the background, text colour and accents, or **Custom** for your own five colours (it starts from the palette on the cover and shows the text contrast);
 - **a variation**, the seed behind the artwork: the strip under the preview shows six others to click;
 - **a format**: paperback, eBook, square, or **Custom** for any size in pixels, typed in or picked from common sizes (Kindle, print trim sizes at 300 dpi, audiobook, social posts).
 
-**Store size** shrinks the preview to the size a store lists covers at, to check the title still reads. **Randomize** reshuffles everything, except what you've locked. Undo and redo step back and forth through your designs, and so do the browser's Back and Forward buttons. **Copy link** shares the exact design, because the URL holds every setting. The export panel tells you which size suits Kindle, print or audiobook covers.
+**Store size** shrinks the preview to the size a store lists covers at, to check the title still reads. **Randomize** reshuffles everything, except what you've locked. Undo and redo step back and forth through your designs, and so do the browser's Back and Forward buttons. **Copy link** shares the exact design, because the URL holds every setting, and **Copy image link** gives the [HTTP API](#http-api) URL that draws it, to put in any page. The export panel tells you which size suits Kindle, print or audiobook covers.
 
 **Mockup** shows and downloads the cover as a 3D book, a flat shot, on an e-reader, or on a social card (a 1200 × 630 link preview, a square post or a story, with a line such as "Out now").
 
@@ -58,6 +58,30 @@ Keyboard shortcuts:
 
 The single-key shortcuts can be turned off under the controls (for example with speech input).
 
+## HTTP API
+
+The site draws covers from a URL too, so a page can show one with nothing installed:
+
+```html
+<img src="https://covers.otsirh.dev/api/cover.svg?title=Dune&author=Frank+Herbert&style=retro" alt="Dune" />
+```
+
+- `GET /api/cover.svg` answers with the cover as SVG.
+- `GET /api/mockup.svg` answers with a [mockup](#mockups) of it. Add `kind` (`book`, `flat`, `ereader`, `card`, `square`, `story`), `text` for the line on a card, square or story, and `background`.
+
+The query takes the options' own names (`title`, `author`, `subtitle`, `series`, `credit`, `badge`, `style`, `palette`, `seed`, `genre`, `font`, `lang`, `width`, `height`) and the app's link parameters, so the part of an app link after `#` draws the same design (the server measures text with the widths of the fonts as macOS draws them, so on another system a line can break a little differently from the app's preview):
+
+| parameter             | value                                                                                          |
+| --------------------- | ---------------------------------------------------------------------------------------------- |
+| `format`              | `paperback`, `ebook`, `square`, or a size in px such as `1600x2560`                            |
+| `case`                | the title `upper`, or `normal` (as typed)                                                      |
+| `texture`             | `1` (on) or `0` (off)                                                                          |
+| `variant`             | pinned choices as `name.value`, joined by `-`: `field.pale-emblem.sun`                         |
+| `palette`             | a palette id, or your own colours as `custom-0b132b-f8f9fa-ff6b6b` (background, text, accents) |
+| `bg`, `ink`, `accent` | your own colours, as hex (the `#` is optional; accents separated by commas)                    |
+
+A title breaks its line at `%0A`. Anyone may embed the answers (CORS and `Cross-Origin-Resource-Policy` allow it), and the headers `X-Cover-Style`, `X-Cover-Palette` and `X-Cover-Version` say what was drawn. The same URL always draws the same cover in a version of the library, so answers are cached for a day. Options the library rejects get a `400` with the reason as plain text.
+
 ## Library usage
 
 ### Browser (no install)
@@ -116,7 +140,7 @@ npx book-cover-generator --batch books.csv --style minimal --seed series --out-d
 npx book-cover-generator "Salt and Static" --count 12 -o ideas/cover.svg
 ```
 
-Options: `-s/--style`, `-p/--palette`, `--bg`, `--ink`, `--accent`, `--subtitle`, `--texture`, `--seed`, `--format` (`paperback`, `ebook` or `square`), `--width`, `--height`, `--size`, `--lang`, `--series`, `--credit`, `--badge`, `--font`, `--case upper|normal`, `--variant name=value` (`--list` shows each style's), `-o/--out`, `--count`, `--batch <file|->`, `--out-dir`, `--json`, `--list`, `--help`.
+Options: `-s/--style`, `-p/--palette`, `--bg`, `--ink`, `--accent`, `--subtitle`, `--texture`, `--seed`, `--format` (`paperback`, `ebook` or `square`), `--width`, `--height`, `--size`, `--genre`, `--lang`, `--series`, `--credit`, `--badge`, `--font`, `--case upper|normal`, `--variant name=value` (`--list` shows each style's), `-o/--out`, `--count`, `--batch <file|->`, `--out-dir`, `--json`, `--list`, `--help`.
 
 ## API
 
@@ -144,9 +168,12 @@ Same as `generateCover`, but also tells you which style and palette were chosen.
 | `height`    | `number`           | `width × 1.5`          | px, 50–10000                                      |
 | `lang`      | `string`           | inferred               | language of the text, such as `'ja'`              |
 | `variants`  | `object`           | `{}`                   | pin a style's choices: `{ scene: 'forest' }`      |
+| `genre`     | `string`           |                        | with a random style, one that suits this genre    |
 | `font`      | `string`           | the style's            | the title's font, one of `FONTS`                  |
 | `titleCase` | `string`           | the style's            | `'upper'` (capitals) or `'normal'` (as typed)     |
 
+Styles, palettes, genres and fonts may be given by id or by name, in any case: `'artdeco'`, `'Art Deco'` and `'ART DECO'` are the same style, and a book list or a link can name them as the app's menus do.
+
 `lang` is set on the cover so Chinese characters get the right glyphs for the language. Without it, text with kana is marked Japanese and text with Hangul Korean; pass `'zh-Hans'`, `'zh-Hant'` or `'ja'` for text in Chinese characters only.
 
 Titles and subtitles longer than 300 characters (authors: 200) are cut. With `'random'`, the style and palette are picked from the seed, so you get the same result every time for the same seed. Some styles prefer dark or light palettes when they pick one themselves. Invalid options throw an error that says what's wrong.
@@ -154,13 +181,16 @@ Titles and subtitles longer than 300 characters (authors: 200) are cut. With `'r
 ### Other exports
 
 - `styles`: array of style ids
-- `listStyles()`: `[{ id, name, description, group, variants }]`. `variants` lists the choices a style lets you pin, as `[{ name, label, values: [{ value, label }] }]`; pin them with `createCover({ variants: { scene: 'forest' } })`, and `createCover` reports the ones it used in `variants`. Names a style lacks are ignored; a value it lacks throws
+- `genres`: `[{ id, name }]`, the genres styles suit: `literary`, `thriller`, `horror`, `romance`, `fantasy`, `children`, `nonfiction`
+- `listStyles()`: `[{ id, name, description, group, variants, genres }]`. `variants` lists the choices a style lets you pin, as `[{ name, label, values: [{ value, label }] }]`; pin them with `createCover({ variants: { scene: 'forest' } })`, and `createCover` reports the ones it used in `variants`. Names a style lacks are ignored. A value no style offers throws; with a style you name, so does a value that style lacks (a style picked at random takes only the pins it can)
 - `palettes`: `[{ id, name, bg, ink, accents, dark? }]`
 - `randomSeed()`: a short random seed string
 - `pickStyle(options)`: the style id `createCover` would use for these options (resolving `'random'` from the seed), without drawing the cover
 - `registerStyle({ id, name, description, group, prefer, render(ctx) })`: add your own style (see below). Replacing a built-in style takes `registerStyle(style, { replace: true })`; `unregisterStyle(id)` removes a style or brings the built-in back
 - `registerPalette({ id, name, bg, ink, accents })`: add a palette to use by id, as `palette: 'brand'` (`{ replace: true }` for a built-in id); `unregisterPalette(id)` removes it. Registered styles and palettes can also be picked by `'random'`, so registering one changes what a seed gives
 - `parseBookList(text)`: a list of books (CSV with commas, semicolons or tabs and a header row naming a `title` column, JSON lines, or one "Title | Author | Subtitle" per line) as cover options, one per book
+- `styleIdFor(name)`: the id of the style a name or id names, in any case (`'Art Deco'` → `'artdeco'`), or `undefined`
+- `optionsForBook(book, defaults)`: the options for one of those books over the options every book shares (its own values win; a genre the shared style doesn't suit picks a style that does)
 - `noteText(x0, y0, x1, y1)` and `recordText(draw)`: note where a custom style writes its own text (so a badge stays clear of it), and collect what `draw` notes
 - `version`: the library's version (artwork for a seed can change between minor versions)
 - `sizeLimits` (`{ min: 50, max: 10000, ratio: 3 }`) and `formats` (`paperback`, `ebook` and `square` as `[width, height]` at 600 px wide): the sizes covers can have, and the app's shapes
@@ -256,7 +286,7 @@ registerStyle({
 
 ## Notes
 
-- **Fonts.** Covers only use system font stacks (Georgia, Helvetica, Futura, Didot, Impact, Courier and others), each with close matches on Windows, Android and Linux. This is because an SVG drawn into a canvas for PNG/JPEG export can't load web fonts. In the browser, text is measured with a canvas, so it fits exactly. In Node, widths are estimated; plug in a real font engine with `setTextMeasurer` if you need exact fits there.
+- **Fonts.** Covers only use system font stacks (Georgia, Helvetica, Futura, Didot, Impact, Courier and others), each with close matches on Windows, Android and Linux. This is because an SVG drawn into a canvas for PNG/JPEG export can't load web fonts. In the browser, text is measured with a canvas, so it fits exactly. In Node (and the CLI and HTTP API), the built-in fonts are measured from their characters' widths as macOS draws them, so text fits much as it does in the app; fonts of your own are estimated. Plug in a real font engine with `setTextMeasurer` if you need exact fits there.
 - **Deterministic.** The same options always give the same artwork. In Node the SVG is identical every time. In the browser, text is measured with the fonts installed on that computer, so line breaks can differ slightly between machines. Registering a custom style changes which style `style: 'random'` picks for a given seed.
 - **Versioning.** Artwork for a given seed can change in minor releases (a style gets better). Pin an exact version if you need byte-identical covers forever.
 - **Browser support.** Current Chrome, Edge, Firefox and Safari. Every release is tested in Chromium, Firefox and WebKit, including PNG and JPEG export.
@@ -285,7 +315,7 @@ Open `examples/contact-sheet.html?palettes=noir,mint&seeds=a,b` on the dev serve
 
 ```
 src/            the library (plain ES modules + .d.ts types)
-  styles/       the 34 styles, one file per family
+  styles/       the 39 styles, in a file per family
 bin/            the CLI
 site/           the web app (index.html is at the root)
 public/         files served at the site root: headers, 404, icons, manifest, service worker
@@ -293,9 +323,10 @@ test/           unit tests (node --test)
 test-d/         type tests (tsc)
 e2e/            browser tests (Playwright)
 scripts/        build, dev server and asset generation
+worker/         the HTTP API (the site's Worker)
 ```
 
-The site is a static [Cloudflare Workers](https://developers.cloudflare.com/workers/static-assets/) deployment configured in `wrangler.jsonc`, with security headers in `public/_headers`.
+The site is a [Cloudflare Workers](https://developers.cloudflare.com/workers/static-assets/) deployment configured in `wrangler.jsonc`: static assets, with security headers in `public/_headers`, and a Worker (`worker/index.js`) that answers `/api/*`. The dev server answers `/api/*` the same way.
 
 ## Contributing
 

package/bin/book-cover.js

@@ -1,14 +1,18 @@
 #!/usr/bin/env node
 import { mkdirSync, readFileSync, writeFileSync } from 'node:fs';
-import { join } from 'node:path';
+import { dirname, join } from 'node:path';
 import { parseArgs } from 'node:util';
-import { createCover, listStyles, palettes, formats, parseBookList } from '../src/index.js';
+import { createCover, listStyles, palettes, formats, parseBookList, optionsForBook, genres } from '../src/index.js';
+import { hex, slug } from '../src/shared.js';
 
 const HELP = `Usage: book-cover "<title>" ["<author>"] [options]
 
 Options:
   -s, --style <id>      style id or "random" (default: random from seed)
   -p, --palette <id>    palette id or "random" (default: random from seed)
+      --genre <id>      with a random style, one that suits this genre:
+                        literary, thriller, horror, romance, fantasy, children
+                        or nonfiction
       --bg <hex>        your own colours instead of a palette: background,
       --ink <hex>       text,
       --accent <hex>    and accents (repeat it, or separate them with commas)
@@ -30,7 +34,7 @@ Options:
       --lang <tag>      language of the text, e.g. ja or zh-Hant (default: inferred)
       --batch <file>    a cover for each book in a list (- reads stdin): CSV or
                         TSV with a header row (title, author, subtitle, series,
-                        credit, badge, style, palette, seed, font, case, lang,
+                        credit, badge, style, genre, palette, seed, font, case, lang,
                         width, height, texture), JSON lines, or one book per
                         line as "Title | Author | Subtitle"; the other options
                         apply to every book the list doesn't say otherwise for
@@ -57,6 +61,7 @@ try {
     options: {
       style: { type: 'string', short: 's' },
       palette: { type: 'string', short: 'p' },
+      genre: { type: 'string' },
       bg: { type: 'string' },
       ink: { type: 'string' },
       accent: { type: 'string', multiple: true },
@@ -103,10 +108,13 @@ function preflight() {
     console.log('Styles:');
     for (const s of listStyles()) {
       console.log(`  ${s.id.padEnd(14)} ${s.description}`);
+      if (s.genres.length) console.log(`  ${''.padEnd(14)}   genres: ${s.genres.join(', ')}`);
       for (const v of s.variants) {
         console.log(`  ${''.padEnd(14)}   --variant ${v.name}=${v.values.map((x) => x.value).join('|')}`);
       }
     }
+    console.log('\nGenres (--genre):');
+    for (const g of genres) console.log(`  ${g.id.padEnd(14)} ${g.name}`);
     console.log('\nPalettes:');
     for (const p of palettes) console.log(`  ${p.id.padEnd(14)} ${p.name}${p.dark ? ' (dark)' : ''}`);
     return false;
@@ -166,9 +174,6 @@ function dimensions() {
   return { width: W, height: Math.round((W * h) / w) };
 }
 
-/** A colour as typed, with the # added (it starts a comment in most shells). @param {string} c */
-const hex = (c) => (c.trim().startsWith('#') ? c.trim() : `#${c.trim()}`);
-
 /** The palette: an id, or your own colours from --bg, --ink and --accent. */
 function palette() {
   const custom = values.bg !== undefined || values.ink !== undefined || values.accent !== undefined;
@@ -231,18 +236,6 @@ function fileFor(out, n, total, seed) {
  */
 const safeName = (seed) => seed.replace(/[^\p{L}\p{N}._-]+/gu, '-').replace(/^[.-]+/, '') || 'cover';
 
-/** A title as part of a file name: lower case, accents off Latin letters, dashes between words. @param {string} title */
-function slug(title) {
-  const words = title
-    .normalize('NFKD')
-    .replace(/(\p{Script=Latin})[\u0300-\u036f]+/gu, '$1')
-    .normalize('NFC')
-    .toLowerCase()
-    .replace(/[^\p{L}\p{M}\p{N}]+/gu, '-')
-    .replace(/^-+/, '');
-  return Array.from(words).slice(0, 60).join('').replace(/-+$/, '') || 'cover';
-}
-
 /**
  * Write a cover for each book in the --batch list into --out-dir; the command line's options
  * apply to every book the list doesn't say otherwise for.
@@ -266,14 +259,9 @@ function batch(defaults) {
   books.forEach((book, i) => {
     const n = i + 1;
     try {
-      // A size in the list replaces the command line's.
-      const sized = book.width !== undefined || book.height !== undefined;
-      const cover = createCover({
-        ...defaults,
-        ...(sized ? { width: undefined, height: undefined } : {}),
-        ...book,
-        seed: book.seed ?? values.seed,
-      });
+      // (The book's own values win, a size in the list replaces the command line's, and a genre
+      // --style doesn't suit picks a style that does: see optionsForBook.)
+      const cover = createCover({ ...optionsForBook(book, defaults), seed: book.seed ?? values.seed });
       const file = join(dir, `${String(n).padStart(digits, '0')}-${slug(cover.title)}.svg`);
       writeFileSync(file, cover.svg);
       const { style, palette: paletteId, seed, width, height } = cover;
@@ -298,6 +286,7 @@ function run() {
         badge: values.badge,
         texture: values.texture,
         style: values.style,
+        genre: values.genre,
         palette: palette(),
         lang: values.lang,
         variants: variants(),
@@ -317,6 +306,7 @@ function run() {
       badge: values.badge,
       texture: values.texture,
       style: values.style,
+      genre: values.genre,
       palette: palette(),
       lang: values.lang,
       variants: variants(),
@@ -332,6 +322,7 @@ function run() {
       const choices = { style, palette: paletteId, seed: cover.seed, width, height, lang, variants: cover.variants };
       if (values.out) {
         const file = fileFor(values.out, n, total, cover.seed);
+        mkdirSync(dirname(file), { recursive: true });
         writeFileSync(file, cover.svg);
         if (values.json) process.stdout.write(JSON.stringify({ file, ...choices }) + '\n');
         else console.error(`Wrote ${file} (style: ${style}, palette: ${paletteId}, ${width}x${height})`);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "book-cover-generator",
-  "version": "1.6.0",
-  "description": "Generate SVG book covers from a title and an author. 34 styles, 28 palettes, seeded randomizer, zero dependencies.",
+  "version": "1.7.0",
+  "description": "Generate SVG book covers from a title and an author. 39 styles, 28 palettes, seeded randomizer, zero dependencies.",
   "keywords": [
     "book",
     "cover",
@@ -60,6 +60,7 @@
     "test:e2e": "playwright test",
     "check": "npm run lint && npm run format:check && npm run typecheck && npm run lint:package && npm test",
     "assets": "node scripts/generate-assets.js",
+    "metrics": "node scripts/generate-metrics.js",
     "deploy": "npm run check && npm run test:e2e && wrangler deploy"
   },
   "devDependencies": {

package/src/books.js

@@ -10,6 +10,7 @@ const COLUMNS = /** @type {const} */ ({
   credit: 'credit',
   badge: 'badge',
   style: 'style',
+  genre: 'genre',
   palette: 'palette',
   seed: 'seed',
   font: 'font',
@@ -21,8 +22,12 @@ const COLUMNS = /** @type {const} */ ({
   texture: 'texture',
 });
 
-/** Separators of a plain line: a tab, or a bar or dash with spaces around it. */
-const LINE_SEPARATOR = /\t| \| | — | – /;
+/**
+ * Separators of a plain line, by precedence: a tab, a bar, or a dash, with spaces around it. A line
+ * is split at the first kind it uses only, so "Harry Potter – The Stone | J. K. Rowling" keeps
+ * its dash in the title.
+ */
+const LINE_SEPARATORS = ['\t', ' | ', ' — ', ' – '];
 
 /**
  * Split CSV (or TSV) text into rows of fields: quoted fields may hold the delimiter, quotes ("")
@@ -84,7 +89,8 @@ function optionsFrom(named) {
     // (Numbers stay numbers for sizes and the seed; any other column is text, a title of 1984 too.)
     const value = typeof raw === 'number' && option !== 'title' ? raw : String(raw).trim();
     if (value === '') continue;
-    if (option === 'width' || option === 'height') out[option] = Number(value);
+    // (A size that isn't a number is kept as written, so the error says what the list says.)
+    if (option === 'width' || option === 'height') out[option] = Number.isFinite(Number(value)) ? Number(value) : value;
     else out[option] = option === 'seed' ? value : String(value);
   }
   return /** @type {import('./index.js').CoverOptions} */ (out);
@@ -94,8 +100,8 @@ function optionsFrom(named) {
  * Read a list of books into cover options, one per book (rows without a title are left out):
  *
  * - CSV or TSV whose first row names its columns (`title`, `author`, `subtitle`, `series`,
- *   `credit`, `badge`, `style`, `palette`, `seed`, `font`, `case`, `lang`, `width`, `height`,
- *   `texture`; others are ignored);
+ *   `credit`, `badge`, `style`, `genre`, `palette`, `seed`, `font`, `case`, `lang`, `width`,
+ *   `height`, `texture`; others are ignored);
  * - JSON lines, one object per book, with the same names;
  * - else one book per line: "Title | Author | Subtitle" (a tab, or " — " or " – ", also separates).
  *
@@ -134,7 +140,8 @@ export function parseBookList(text) {
       books = rows.map((row) => optionsFrom(Object.fromEntries(names.map((name, i) => [name, row[i] ?? '']))));
     } else {
       books = lines.map(({ line }) => {
-        const [title, author, subtitle] = line.split(LINE_SEPARATOR);
+        const separator = LINE_SEPARATORS.find((sep) => line.includes(sep));
+        const [title, author, subtitle] = separator ? line.split(separator) : [line];
         return optionsFrom({ title, author, subtitle });
       });
     }

package/src/index.d.ts

@@ -37,10 +37,20 @@ export interface MockupOptions {
 }
 /**
  * Read a list of books into cover options, one per book with a title: CSV or TSV whose first row
- * names its columns (title, author, subtitle, series, credit, badge, style, palette, seed, font,
- * case, lang, width, height, texture), JSON lines, or one book per line ("Title | Author | Subtitle").
+ * names its columns (title, author, subtitle, series, credit, badge, style, genre, palette, seed,
+ * font, case, lang, width, height, texture), JSON lines, or one book per line ("Title | Author | Subtitle").
  */
 export declare function parseBookList(text: string): CoverOptions[];
+/**
+ * Cover options for a book from a list over `defaults`, the options every book shares: the book's
+ * own values win, a size it gives replaces both sides of the defaults', a book naming another
+ * style than the defaults' drops their pinned variants (with no shared style, it keeps the ones
+ * its own style offers), and one naming a genre the defaults' style doesn't suit gets a style that
+ * suits it. A shared style that doesn't exist throws.
+ */
+export declare function optionsForBook(book: CoverOptions, defaults?: CoverOptions): CoverOptions;
+/** The id of the style that `name` names, by id or name in any case ('Art Deco', 'artdeco'), or undefined. */
+export declare function styleIdFor(name: string): string | undefined;
 /** The cover as a product shot (flat, book, e-reader) or on a social card, as SVG. */
 export declare function createMockup(
   cover: Cover,
@@ -92,7 +102,12 @@ export type StyleId =
   | 'engraved'
   | 'papercut'
   | 'silhouette'
-  | 'blueprint';
+  | 'blueprint'
+  | 'hollow'
+  | 'ribbon'
+  | 'crest'
+  | 'storybook'
+  | 'idea';
 
 export type StyleGroup = 'Typographic' | 'Geometric' | 'Pattern' | 'Scenic' | 'Vintage' | 'Genre';
 
@@ -123,6 +138,8 @@ export interface CoverOptions {
   texture?: boolean;
   /** A style id, a registered custom style, or `'random'` (default; picked from the seed). */
   style?: StyleId | 'random' | (string & {});
+  /** With a random style, pick one that suits this genre (see `genres`). */
+  genre?: GenreId | (string & {});
   /** A palette id, a custom palette, or `'random'` / `'auto'` (default; picked from the seed). */
   palette?: PaletteId | 'random' | 'auto' | CustomPalette | (string & {});
   /** Controls every random choice. Defaults to a hash of title + author. */
@@ -138,8 +155,9 @@ export interface CoverOptions {
   lang?: string;
   /**
    * Choices to pin instead of leaving them to the seed, such as `{ scene: 'forest' }` for
-   * Silhouette (see each style's `variants` in `listStyles()`). Names the style doesn't have
-   * are ignored; a value it doesn't offer throws.
+   * Silhouette (see each style's `variants` in `listStyles()`), in any case. Names the style
+   * doesn't have are ignored. A value no style offers throws; with a style you name, so does a
+   * value that style lacks (a style picked at random takes only the pins it can).
    */
   variants?: Readonly<Record<string, string>>;
   /**
@@ -188,8 +206,14 @@ export interface StyleInfo {
   group: StyleGroup | (string & {});
   /** The choices you can pin with `createCover({ variants })`; empty for styles without any. */
   variants: StyleVariant[];
+  /** The genres the style suits (ids from `genres`). */
+  genres: string[];
 }
 
+export type GenreId = 'literary' | 'thriller' | 'horror' | 'romance' | 'fantasy' | 'children' | 'nonfiction';
+/** The genres styles can suit, as `createCover({ genre })` and `listStyles()` name them. */
+export declare const genres: readonly { readonly id: GenreId; readonly name: string }[];
+
 /** A palette as seen by styles, with derived light/dark colours. */
 export interface ResolvedPalette extends Palette {
   readonly accents: readonly string[];
@@ -241,6 +265,11 @@ export interface CoverStyle {
   group?: StyleGroup | (string & {});
   /** Background preference when the palette is picked automatically. */
   prefer?: 'light' | 'dark';
+  /**
+   * The genres the style suits (ids or names from `genres`), so `createCover({ genre })` can pick it. A
+   * replacement for a built-in style suits the built-in's genres unless it names its own.
+   */
+  genres?: readonly string[];
   /**
    * The choices `render` makes with `ctx.choose(name, values)` that people can pin, with labels:
    * `{ scene: { label: 'Scene', values: { city: 'City', forest: 'Forest' } } }`.
@@ -274,7 +303,9 @@ export declare function unregisterPalette(id: string): boolean;
 /** A short random seed, e.g. for a "randomize" button. */
 export declare function randomSeed(): string;
 /** The style id `createCover` would use for these options (resolving `'random'` from the seed), without drawing. */
-export declare function pickStyle(options?: Pick<CoverOptions, 'title' | 'author' | 'seed' | 'style'>): string;
+export declare function pickStyle(
+  options?: Pick<CoverOptions, 'title' | 'author' | 'seed' | 'style' | 'genre'>,
+): string;
 /** Generate a cover and report the style and palette that were chosen. */
 export declare function createCover(options?: CoverOptions): Cover;
 /** Generate a cover and return the SVG markup. */