book-kit 0.0.0-stage → 0.6.0

package/commands/release-files.js

@@ -0,0 +1,89 @@
+#!/usr/bin/env node
+
+/**
+ * Stage a release: copy the built formats to version-named files and write
+ * their checksums.
+ *
+ * Downloads all named book.epub look alike, so a stale one is easy to upload
+ * by mistake. The copies carry the version, e.g. dist/release/book-v1.2.0.epub
+ * and book-kindle-v1.2.0.epub, beside a sha256sum-compatible checksums.txt.
+ * dist/ keeps its plain names for local builds and scripts.
+ *
+ * The version comes from paths.version, the same file the build stamps on the
+ * copyright page. Pass the release tag with --tag and a tag that disagrees
+ * with it fails, so a file can't be named for one version and stamped with
+ * another.
+ *
+ * Usage: book-kit release-files [--tag vX.Y.Z] [--out DIR]
+ * Prints the output directory.
+ */
+
+import { copyFileSync, existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
+import { createHash } from 'node:crypto';
+import { basename, extname, join, resolve } from 'node:path';
+import { loadConfig, outputFile, pathFor } from '../lib/config.js';
+import { readVersion } from '../lib/revision.js';
+import { isMain } from '../lib/is-main.js';
+
+// The retail formats, in the order checksums.txt lists them. A book that
+// doesn't build one (no Kindle, no PDF/X) just ships the rest.
+export function releaseSources(config) {
+  return [
+    outputFile('.epub', config),
+    outputFile('-kindle.epub', config),
+    outputFile('.pdf', config),
+    outputFile(`${config.output.pdfx_suffix}.pdf`, config),
+  ];
+}
+
+// book-kindle.epub + v1.2.0 -> book-kindle-v1.2.0.epub
+export function versionedName(file, label) {
+  const ext = extname(file);
+  return `${basename(file, ext)}-${label}${ext}`;
+}
+
+export function stageRelease({ config = loadConfig(), tag, out } = {}) {
+  const versionFile = pathFor('version', config);
+  if (!existsSync(versionFile)) {
+    throw new Error(`no ${versionFile}: a release needs the version the build stamps`);
+  }
+  const label = `v${readVersion(versionFile)}`;
+  if (tag && tag !== label) {
+    throw new Error(`tag ${tag} doesn't match ${basename(versionFile)} (${label}); bump it in the tagged commit`);
+  }
+
+  const sources = releaseSources(config).filter((f) => existsSync(f));
+  if (sources.length === 0) throw new Error('nothing to release: build the formats first');
+
+  const dir = out ? resolve(config.root, out) : join(pathFor('dist', config), 'release');
+  rmSync(dir, { recursive: true, force: true });
+  mkdirSync(dir, { recursive: true });
+
+  const lines = sources.map((src) => {
+    const name = versionedName(src, label);
+    copyFileSync(src, join(dir, name));
+    const hash = createHash('sha256').update(readFileSync(src)).digest('hex');
+    return `${hash}  ${name}`;
+  });
+  writeFileSync(join(dir, 'checksums.txt'), `${lines.join('\n')}\n`);
+  return { dir, label, files: lines.map((l) => l.split('  ')[1]) };
+}
+
+function main(argv) {
+  const opt = (flag) => {
+    const i = argv.indexOf(flag);
+    return i === -1 ? undefined : argv[i + 1];
+  };
+  try {
+    const { dir, files } = stageRelease({ tag: opt('--tag') || undefined, out: opt('--out') });
+    for (const f of files) console.error(`  ${f}`);
+    console.log(dir);
+  } catch (e) {
+    console.error(`book-kit release-files: ${e.message}`);
+    process.exit(1);
+  }
+}
+
+if (isMain(import.meta.url)) {
+  main(process.argv.slice(2));
+}

package/commands/reorder-print-frontmatter.js

@@ -0,0 +1,79 @@
+#!/usr/bin/env node
+
+/**
+ * Move the print front matter (copyright page + dedication) ahead of the
+ * auto-generated table of contents.
+ *
+ * Why: copyright.md and dedication.md are the first `input-files` in
+ * index.yml, so pandoc renders them as the first body content — which lands
+ * *after* the template's auto-inserted TOC. That order (Title → TOC →
+ * Copyright → Dedication → body) is nonstandard for a printed book, where the
+ * copyright page belongs on the verso of the title page, before the TOC.
+ *
+ * The TOC is emitted by pandoc's template at a fixed position before `$body$`,
+ * so it can't be repositioned in Markdown. Instead, the `pdf` recipe renders
+ * standalone HTML, runs this script to splice the two front-matter blocks in
+ * front of the `<nav id="TOC">`, then hands the HTML to WeasyPrint — which
+ * recomputes the TOC page numbers against the new order.
+ *
+ * Print-only: the EPUB/Kindle builds (nav-first, by convention) are untouched.
+ *
+ * Usage: book-kit reorder-print-frontmatter <file.html>
+ */
+
+import { readFileSync, writeFileSync } from 'node:fs';
+
+const file = process.argv[2];
+if (!file) {
+  console.error('Usage: book-kit reorder-print-frontmatter <file.html>');
+  process.exit(1);
+}
+
+/**
+ * Extract a balanced <div>…</div> block starting at the open tag that matches
+ * `needle`. Counts nested <div> opens/closes so inner containers don't end the
+ * match early.
+ * @param {string} html
+ * @param {string} needle - literal start of the opening tag, e.g. '<div id="copyright-page"'
+ * @returns {string|null} the full block, including its opening and closing
+ *   tags, or null when the book has no such block
+ */
+function extractBalancedDiv(html, needle) {
+  const start = html.indexOf(needle);
+  if (start === -1) return null;
+
+  const tag = /<\/?div\b[^>]*>/g;
+  tag.lastIndex = start;
+  let depth = 0;
+  let match;
+  while ((match = tag.exec(html)) !== null) {
+    depth += match[0].startsWith('</') ? -1 : 1;
+    if (depth === 0) return html.slice(start, match.index + match[0].length);
+  }
+  throw new Error(`Unbalanced <div> for anchor: ${needle}`);
+}
+
+let html = readFileSync(file, 'utf8');
+
+// Either page is optional: a book without a dedication (or a copyright page)
+// just has less to move.
+const blocks = [
+  ['copyright page', extractBalancedDiv(html, '<div id="copyright-page"')],
+  ['dedication', extractBalancedDiv(html, '<div class="dedication"')],
+].filter(([, block]) => block !== null);
+
+if (blocks.length === 0) {
+  console.log('No copyright page or dedication to move ahead of the table of contents.');
+  process.exit(0);
+}
+
+const tocAnchor = '<nav id="TOC"';
+if (!html.includes(tocAnchor)) throw new Error(`Anchor not found: ${tocAnchor}`);
+
+// Remove the blocks from their current (post-TOC) position…
+for (const [, block] of blocks) html = html.replace(block, '');
+// …and re-insert them, in reading order, immediately before the TOC.
+html = html.replace(tocAnchor, `${blocks.map(([, block]) => block).join('\n')}\n${tocAnchor}`);
+
+writeFileSync(file, html);
+console.log(`Moved ${blocks.map(([name]) => name).join(' and ')} ahead of the table of contents.`);