Add scrivener pdf rendering tool

Author: vinniefalco

scrivener/.cursor/rules/scrivener.mdc

@@ -0,0 +1,73 @@
+---
+description: Scrivener coding rules. Applied on every edit to files under scrivener/.
+globs: scrivener/**
+---
+
+# Scrivener Rules
+
+## No Style in Code
+
+Every visual value - colors, sizes, spacing, padding - comes from
+a style YAML file (e.g. `styles/default.yaml`) or is proportional to
+body_size via `sp()`. Zero hardcoded appearance numbers in Python.
+Use `cfg["key"]` not `cfg.get("key", "#hex")` for values that exist
+in the style. No color hex strings as fallback defaults. If a key is
+missing, let it crash - the style is incomplete. Styles are flat YAML
+files in `styles/`; derived styles use `inherits: base` for cascade.
+
+## All Spacing is Proportional
+
+Use `sp(cfg, r)` for every spacing value. Never bare `Spacer(1, 4)` or
+`spaceAfter=6`. The function is in `lib/config.py`:
+
+```python
+def sp(cfg, r):
+    """Spacing proportional to body_size."""
+    return cfg.get("body_size", 11) * r
+```
+
+Ratios use the form `N/11` so the original value is visible:
+`sp(cfg, 4/11)` produces 4pt at body_size 11.
+
+Values already in style.yaml (heading spacing, list indent, etc.) are
+absolute and stay as-is - the user controls them directly.
+
+## No Duplicated Drawing Logic
+
+The accent-bar-plus-background-box pattern lives in `AccentBox`
+(`lib/flowables.py`). Both front-matter and blockquotes use it.
+Do not recreate this pattern elsewhere.
+
+## Do Not Add YAML Keys Without Asking
+
+Adding new keys to style.yaml is a last resort. Before adding a key,
+ask the user. Derive values from existing keys whenever possible.
+Example: the title uses headings.h1.scale - it does not get its own
+font_scale key.
+
+## Short Variable Names
+
+Prefer `bs`, `cfg`, `fm`, `lh`, `cb`, `bq`, `s`, `r`, `w`, `h`.
+Spell out only when meaning is unclear from context.
+
+## File Map
+
+- `scrivener.py` - CLI entry point. Argparse, help text, main().
+  No rendering logic.
+- `lib/__init__.py` - Package marker. `escape_xml()` utility.
+- `lib/builder.py` - `build_pdf()` orchestration. Wires config,
+  fonts, renderer, and ReportLab document.
+- `lib/flowables.py` - `AccentBox`, `AccentRule`, `PageChrome`.
+  Stable drawing primitives.
+- `lib/fonts.py` - Font cache, variable-font instantiation,
+  ReportLab registration. `ensure_lazy()`, `ensure_code_family()`.
+- `lib/colors.py` - Color math. `hex_to_hsl`, `resolve_accent`,
+  `derive_mid`, `resolve_colors`.
+- `lib/config.py` - Style loading with `inherits:` cascade,
+  `deep_merge()`, font manifest with logical IDs,
+  `resolve_font_files()`, option handling, front-matter extraction,
+  config merge, `sp()`, `load_logo`, `list_images()`.
+- `lib/highlight.py` - Syntax highlighting via Pygments. Single
+  `highlight()` function returns ReportLab XML markup.
+- `lib/renderer.py` - `ASTRenderer`. AST-to-flowable conversion.
+  The largest module.

scrivener/.gitignore

@@ -0,0 +1,3 @@
+.fonts/
+__pycache__/
+.out/