@ai-matrx/print 0.7.1 → 0.8.0

package/CHANGELOG.md

@@ -1,5 +1,54 @@
 # Changelog
 
+## 0.8.0
+
+- **Citations through a real CSL processor.** citeproc-js (the engine Zotero
+  uses) over the official Citation Style Language styles replaces the three
+  hand-written formatters. `csl:` takes any style in the CSL repository by name
+  (`apa`, `mla`, `chicago`, `chicago-notes`, `ieee`, `harvard` ship inside the
+  package; `nature`, `vancouver`, … are fetched at export time, a dependent
+  style follows its parent) or a `.csl` URL. Note styles turn every citation
+  into a numbered note; numeric styles number by first use. Locales follow
+  `lang`. New `prepareDocument(source, { resolveReferences, cslFetcher })`
+  loads what a document needs; `exportDocument` uses it.
+- **Host-resolved references.** `resolveReferences(keys)` receives citation
+  keys the frontmatter does not define (e.g. `[@research:<id>]`,
+  `[@file:<id>]`) and returns CSL-JSON items. `DocumentPrintPreview` takes the
+  same prop.
+- **PDF hyphenation.** Knuth–Liang patterns (the `hyphen` package, ~30
+  languages, chosen by `lang`; `hyphenate: false` turns it off) with lines
+  broken by the package using the embedded font's own metrics, so every split
+  word carries its hyphen. An unsupported language is announced.
+- **Font fallback in PDF.** Characters the body font cannot draw go to Noto
+  Emoji (emoji, including skin tones, ZWJ sequences and flags) and then Noto
+  Sans Math (arrows, math, box drawing), loaded only when the document needs
+  them (`fonts: { emoji, symbols }` loaders; default jsDelivr). Anything no face
+  can draw is left out and announced — never an empty box.
+- **Math, typeset in every format.** `$…$`, `$$…$$`, `\(…\)`, `\[…\]` are
+  lifted out before markdown parsing by the core's shared rules
+  (`@ai-matrx/content-ir/source`: a stray prose `$$` never pairs with a
+  formula; `$5` stays money; `\,` survives) and typeset with MathJax: PDF
+  display math is drawn as vector SVG and inline math is set as text with real
+  super/subscripts; Word gets native editable equations (OMML); HTML and EPUB
+  carry MathML (EPUB declares `properties="mathml"`). A formula that does not
+  parse is announced (`math-error`) and prints as marked source.
+- **Fixed (PDF, lost content):** a table row taller than a page vanished with
+  the header row and no notice. Rows now split when any row cannot fit a page,
+  and a **loss guard** checks every PDF: any text pdfmake did not place is
+  counted and announced (`content-lost`).
+- **PDF tables:** content-aware column widths (min/max content, like a
+  browser's automatic table layout) — a 10-column landscape table fits in 3
+  pages instead of 13.
+- **Fixed (EPUB):** footnote back-links point into the chapter holding the
+  reference; epubcheck clean (the tests run epubcheck when it is installed).
+- **Fixed:** an author's own heading above `<!-- bibliography -->` is used —
+  no second "References" heading.
+- **Breaking:** `formatCitation` / `formatBibliography` are removed (use the
+  CSL engine: `CitationEngine`, `prepareDocument`); `DocumentSettings.citationStyle`
+  is now a CSL style id string.
+- Consumer action: pass `resolveReferences` where your app has source records;
+  nothing else.
+
 ## 0.7.1
 
 - **Fixed (PDF):** a heading followed by a table taller than a page vanished

package/README.md

@@ -230,6 +230,18 @@ In the body: `<!-- pagebreak -->`, `<!-- section landscape columns=2 -->`,
 `[[toc]]`, `![Caption](url){#fig:chart}`, `Table: Caption {#tbl:sales}`,
 `## Methods {#sec:methods}`, `see @fig:chart`, `[@smith2020, p. 4]`.
 All four formats come from one parsed tree (`parseDocument`), so they agree.
+
+Citations are formatted by **citeproc-js** over the official **CSL styles**:
+`csl:` accepts any style name from the CSL repository (zotero.org/styles) or a
+`.csl` URL; `apa`, `mla`, `chicago`, `chicago-notes`, `ieee` and `harvard` are
+bundled (offline). References come from the frontmatter and from your app via
+`exportDocument(md, fmt, { resolveReferences: async (keys) => cslItems })`.
+PDFs are hyphenated with Knuth–Liang patterns for the document's `lang`, and
+emoji / symbols print through Noto Emoji and Noto Sans Math.
+
+CSL styles and locales © the Citation Style Language project, CC BY-SA 3.0.
+Noto Emoji and Noto Sans Math are SIL Open Font License fonts (loaded at
+export time from jsDelivr).
 `DocumentPrintPreview` (in `/react`) shows the real PDF pages with Print and
 every download.