v0.2.0

Changelog

[v0.2.0] — 2025-11-12

Added

• Multi-skin output with --skin at generate time:

  • console (default), vite-breeze, docs-reader, cards-tabs, kiosk, typefolio, typescatter.

• CLI alias prae for all commands (praetorius still works).

• Authoring & management commands:

  • prae edit (guided edits), prae rm, prae order, prae list.
  • prae import <file.json|csv>, prae export [--format json|csv].

• Validation & diagnostics: prae doctor now performs schema, mapping, and link checks with actionable output.

• Deep linking docs: explicit support for #work-<slug>?t=<seconds> (e.g. ?t=630 for 10:30).

• Cues flexibility: cues[] items may be either { label, t } (seconds) or string timestamps like @mm:ss.

• Skins documentation & previews: added section with example GIFs and brief descriptions for each skin.

Changed

• Quick start and examples now prefer the short alias: prae init, prae add, prae generate.
• Data model docs show score.pdfDelta explicitly (still optional, no schema bump).
• Docs restructured: “Key features” → “What it does”; clearer “Embedding & hosting” section.
• Media/PDF guidance tightened: recommend PDF.js (?file=<url>) over Drive previews for reliable page control.
• Example assets: static image replaced with a short demo GIF.

Improved

• Troubleshooting: new entry for dev-server 404s when testing embeds (style.css, main.js) and clearer PDF page-follow checklist.
• Accessibility notes: ARIA usage, keyboard behavior (arrows for selection, Esc to close) called out.
• Performance notes: reaffirm lazy audio hydration and isolated PDF iframes.

Fixed

• Documentation mismatches between CLI help and README (aliases, command names, options).

Removed/Deprecated

• Node version badge moved to an optional snippet in comments. (Runtime expectation remains Node ≥ 18.)

---

Migration notes (v0.1.0 → v0.2.0)

• No breaking changes to the DB. .prae/works.json remains schema v1. pdfDelta is optional; leave it unset unless you need a constant PDF page shift.

• CLI: you can keep using praetorius …; the docs now show the prae alias:

  # equivalent to prior commands
  prae init --out dist
  prae add
  prae generate --out dist

• Skins: to adopt a skin, regenerate with:

  prae generate --skin vite-breeze --out dist
  # or emit a single pasteable snippet:
  prae generate --skin docs-reader --embed > embed.html

• Cues: your existing { label, t } entries continue to work. You may optionally author new cues as @mm:ss.

• PDF page-follow: if you were using Drive preview URLs, switch to a PDF.js viewer URL (.../viewer.html?file=<encoded-pdf-url>) for page control.

---

Upgrade checklist

• Run prae doctor on your project and address any hints/warnings.
• Decide on a skin (or keep console) and regenerate assets/snippet.
• If embedding in a site builder, prefer --embed > embed.html and paste the output verbatim.
• If hosting static assets, upload dist/script.js and dist/styles.css, and update your page to point to those hosted URLs.
• If using Drive for PDFs, migrate links to a PDF.js viewer with ?file=.

---

v0.2.0 vs. v0.1.0

• v0.1.0 is the praetorius core (page-follow, works DB, basic generate, embed).
• v0.2.0 ships skins, a fuller CLI (edit/rm/order/import/export/list), a stronger doctor, clarified deep linking, and tighter PDF hosting guidance — all without changing the DB schema.

v0.1.4

Update template.html