Merge pull request 'docs: citation audit (8 mis-citations fixed) + Phases 12/13' (#28) from docs/citation-audit-phases-12-13 into main

Reviewed-on: #28

doc/reviewer/briefing.md

@@ -46,12 +46,12 @@ research-only phases the reader can shape at design stage.
 | **Canonical Delaunay tessellations of decorated hyperbolic surfaces** (Lutz 2023, *Geom. Dedicata*; Lutz 2024 PhD thesis) | cut-graph + period matrix + hyperbolic-disk layout as scaffolding; canonical-tessellation algorithm itself outlined | **10c** planned |
 | **Hyperideal polyhedra rigidity** (Bowers–Bowers–Lutz 2026) | HyperIdeal functional + analytic Hessian derivation (805-line LaTeX note) | **9b-analytic** derived; **10c′** KAT planned |
 | **Optimal cone placement / non-Euclidean cone metrics** (Crane et al. 2018) | Cone-singularity port via `ConesUtility` scoped; the *non-Euclidean* extension is the research delta | **9d.1** port + **9d.2** RESEARCH |
-| **Polygon Laplacian on general meshes** (Alexa–Wardetzky 2011; Alexa 2020) | *no Java parent* — first phase a reviewer can shape at design stage | **9f** RESEARCH (planned) |
+| **Polygon Laplacian on general meshes** (Alexa–Wardetzky 2011; Bunge et al. 2020) | *no Java parent* — first phase a reviewer can shape at design stage | **9f** RESEARCH (planned) |
 | **Quasi-isothermic maps** (generalising conformality where exact conformality is impossible — Lawson-correspondence parameterisation) | scoped as a 6-class port (~800 lines) from the Java original: `QuasiisothermicLayout`, `DBFSolution` (discrete Beltrami field), `SinConditionApplication`, `QuasiisothermicDelaunay`, `QuasiisothermicUtility`, `ConformalStructureUtility` | **10e** planned |
-| **Higher-genus + hyperelliptic surfaces** (Bobenko–Bücking 2009 on polyhedral surfaces; period matrices with block-diagonal Z₂ structure) | port of `HyperellipticUtility` + `HyperIdealHyperellipticUtility` scoped; existing period-matrix code as scaffolding | **10b** planned |
+| **Higher-genus + hyperelliptic surfaces** (Bobenko–Mercat–Schmies 2011 / Bobenko–Bücking 2021 on polyhedral period matrices; block-diagonal Z₂ structure) | port of `HyperellipticUtility` + `HyperIdealHyperellipticUtility` scoped; existing period-matrix code as scaffolding | **10b** planned |
 | **Möbius centring for Poincaré-disk layouts** as a variational problem (Lorentz geometry: `E = Σ log(−⟨x,p⟩/√(−⟨x,x⟩))`) | currently we use iterative Fréchet mean in `normalise_hyperbolic()`; the principled variational alternative is scoped via the Java `MobiusCenteringFunctional` port (full gradient + Hessian) | **9d.4** planned |
-| **Boundary-First / interactive flattening** (Crane et al. 2017 BFF; Bonneel et al. 2015 *Stripe Patterns on Surfaces*) | not on the roadmap as ports; documented in [`references.md`](../math/references.md) as comparison points / inspiration for future API design | — |
-| **Schläfli-based variational machinery** (Rivin–Springborn 1999) | derivation done, implementation gated on your view of whether the ~6× speedup over our block-FD path matters at your mesh sizes | **9b-analytic** ready to implement |
+| **Boundary-First / interactive flattening** (Sawhney–Crane 2017 BFF; Knöppel–Crane–Pinkall–Schröder 2015 *Stripe Patterns on Surfaces*) | not on the roadmap as ports; documented in [`references.md`](../math/references.md) as comparison points / inspiration for future API design | — |
+| **Schläfli-based variational machinery** (Rivin–Schlenker 1999) | derivation done, implementation gated on your view of whether the ~6× speedup over our block-FD path matters at your mesh sizes | **9b-analytic** ready to implement |
 
 See [`doc/roadmap/phases.md`](../roadmap/phases.md) for the per-phase
 porting plan, [`doc/roadmap/research-track.md`](../roadmap/research-track.md)
@@ -71,11 +71,12 @@ rationale).
   Tier-1/2.  Decorated-DCE / canonical-tessellation / hyperideal line:
   Bobenko–Lutz 2024 IMRN; Bobenko–Lutz 2025 *DCG*; Lutz 2023
   *Geom. Dedicata*; Lutz 2024 PhD; Bowers–Bowers–Lutz 2026.  Cones,
-  polyhedra, period matrices: Crane et al. 2018; Springborn 2019
-  (hyperbolic polyhedra); Bobenko–Bücking 2009; Rivin–Springborn 1999.
-  Polygon Laplacians: Alexa–Wardetzky 2011; Alexa 2020.  Integrable +
-  practical-flattening context: Springborn–Veselov 2015 (cluster
-  dynamics); Crane et al. 2017 (BFF); Bonneel et al. 2015 (Stripe
+  polyhedra, period matrices: Soliman–Slepčev–Crane 2018; Pinkall–Springborn
+  2021 (discrete Liouville); Bobenko–Mercat–Schmies 2011 / Bobenko–Bücking
+  2021; Rivin–Schlenker 1999.
+  Polygon Laplacians: Alexa–Wardetzky 2011; Bunge et al. 2020.  Integrable +
+  practical-flattening context: Born–Bücking–Springborn 2015 (quasiconformal
+  distortion); Sawhney–Crane 2017 (BFF); Knöppel et al. 2015 (Stripe
   Patterns).
 - **Phase 9f** (polygon Laplacian on non-triangular meshes) added as
   RESEARCH-only — no Java parent — so you can influence its design

doc/reviewer/hub.html

@@ -250,16 +250,16 @@ per-phase entry in <code>doc/roadmap/</code>.</p>
 <tr><td>Quasi-isothermic maps (Lawson correspondence, ~800 lines, discrete Beltrami-field solver)</td>
     <td>scoped as a 6-class Java port: <code>QuasiisothermicLayout</code>, <code>DBFSolution</code>, <code>SinConditionApplication</code>, <code>QuasiisothermicDelaunay</code>, <code>QuasiisothermicUtility</code>, <code>ConformalStructureUtility</code></td>
     <td><span class="pill new">10e</span> planned</td></tr>
-<tr><td>Higher-genus + hyperelliptic surfaces (Bobenko–Bücking 2009; block-diagonal period matrices with Z₂ symmetry)</td>
+<tr><td>Higher-genus + hyperelliptic surfaces (Bobenko–Mercat–Schmies 2011 / Bobenko–Bücking 2021 period matrices; block-diagonal Z₂ symmetry)</td>
     <td>port of <code>HyperellipticUtility</code> + <code>HyperIdealHyperellipticUtility</code> scoped; existing period-matrix code as scaffolding</td>
     <td><span class="pill new">10b</span> planned</td></tr>
 <tr><td>Möbius centring as a variational problem (Lorentz energy, full gradient + Hessian)</td>
     <td>currently iterative Fréchet mean in <code>normalise_hyperbolic()</code>; the principled variational alternative is scoped via the Java <code>MobiusCenteringFunctional</code> port</td>
     <td><span class="pill new">9d.4</span> planned</td></tr>
-<tr><td>Boundary-First / interactive flattening (Crane et al. 2017 BFF; Bonneel et al. 2015 <i>Stripe Patterns</i>)</td>
+<tr><td>Boundary-First / interactive flattening (Sawhney–Crane 2017 BFF; Knöppel–Crane–Pinkall–Schröder 2015 <i>Stripe Patterns</i>)</td>
     <td>not on the roadmap as ports; documented in <code>references.md</code> as comparison points / inspiration</td>
     <td>—</td></tr>
-<tr><td>Schläfli-based variational machinery (Rivin–Springborn 1999)</td>
+<tr><td>Schläfli-based variational machinery (Rivin–Schlenker 1999)</td>
     <td>derivation done; implementation gated on the reader's view of whether the ~6× speedup over our block-FD path matters at their mesh sizes</td>
     <td><span class="pill new">9b-analytic</span> ready</td></tr>
 </tbody>
@@ -320,15 +320,16 @@ sufficient answer.</p>
       Decorated-DCE / canonical-tessellation / hyperideal line:
       Bobenko–Lutz 2024 IMRN; Bobenko–Lutz 2025 <i>DCG</i>; Lutz 2023
       <i>Geom. Dedicata</i>; Lutz 2024 PhD; Bowers–Bowers–Lutz 2026.
-      Cones, polyhedra, period matrices: Crane et al. 2018;
-      Springborn 2019; Bobenko–Bücking 2009; Rivin–Springborn 1999.
-      Polygon Laplacians: Alexa–Wardetzky 2011; Alexa 2020.  Integrable
-      and practical-flattening context: Springborn–Veselov 2015;
-      Crane et al. 2017 (BFF); Bonneel et al. 2015 (Stripe Patterns).
+      Cones, polyhedra, period matrices: Soliman–Slepčev–Crane 2018;
+      Pinkall–Springborn 2021 (discrete Liouville); Bobenko–Mercat–Schmies
+      2011 / Bobenko–Bücking 2021; Rivin–Schlenker 1999.
+      Polygon Laplacians: Alexa–Wardetzky 2011; Bunge et al. 2020.  Integrable
+      and practical-flattening context: Born–Bücking–Springborn 2015;
+      Sawhney–Crane 2017 (BFF); Knöppel et al. 2015 (Stripe Patterns).
   </li>
   <li><span class="pill research">+1 RESEARCH phase</span> with no Java
       parent — Phase 9f (polygon Laplacian on non-triangular meshes,
-      Alexa-Wardetzky 2011 / Alexa 2020) — the first phase a reviewer
+      Alexa-Wardetzky 2011 / Bunge et al. 2020) — the first phase a reviewer
       can shape at design stage.</li>
   <li><span class="pill new">output_uv_map</span> now covers 4 of 5 DCE
       solvers (Inversive-Distance added; CP-Euclidean deferred to
@@ -427,9 +428,9 @@ folder for the per-document table.</p>
 <table>
 <tr><th>Document</th><th>What it covers</th></tr>
 <tr><td><a href="https://codeberg.org/TMoussa/ConformalLabpp/src/branch/main/doc/math/references.md"><code>references.md</code></a> <span class="pill new">+13 refs</span></td>
-    <td>Per-phase literature index.  13 new citations added: decorated DCE in non-Euclidean geometries (Bobenko–Lutz 2025); canonical tessellations (Lutz 2023 / 2024); hyperideal polyhedra rigidity (Bowers–Bowers–Lutz 2026); polygon Laplacians (Alexa–Wardetzky 2011 / Alexa 2020); optimal cone placement (Crane et al. 2018); Schläfli identity (Rivin–Springborn 1999); hyperbolic polyhedra (Springborn 2019); polyhedral period matrices (Bobenko–Bücking 2009); integrable cluster dynamics (Springborn–Veselov 2015); BFF (Crane et al. 2017); stripe patterns (Bonneel et al. 2015).</td></tr>
+    <td>Per-phase literature index.  13 new citations added: decorated DCE in non-Euclidean geometries (Bobenko–Lutz 2025); canonical tessellations (Lutz 2023 / 2024); hyperideal polyhedra rigidity (Bowers–Bowers–Lutz 2026); polygon Laplacians (Alexa–Wardetzky 2011 / Bunge et al. 2020); optimal cone placement (Soliman–Slepčev–Crane 2018); Schläfli identity (Rivin–Schlenker 1999); discrete Liouville theorem (Pinkall–Springborn 2021); polyhedral period matrices (Bobenko–Mercat–Schmies 2011 / Bobenko–Bücking 2021); quasiconformal distortion (Born–Bücking–Springborn 2015); BFF (Sawhney–Crane 2017); stripe patterns (Knöppel–Crane–Pinkall–Schröder 2015).</td></tr>
 <tr><td><a href="https://codeberg.org/TMoussa/ConformalLabpp/src/branch/main/doc/math/hyperideal-hessian-derivation.md"><code>hyperideal-hessian-derivation.md</code></a></td>
-    <td>Full LaTeX-formatted derivation of the analytic HyperIdeal Hessian via the Schläfli identity (805 lines, 8 sections + 2 appendices).  Cited sources: Schläfli 1858, Milnor 1982, Vinberg 1993, Cho–Kim 1999, Glickenstein 2011, Rivin–Springborn 1999, Springborn 2020.</td></tr>
+    <td>Full LaTeX-formatted derivation of the analytic HyperIdeal Hessian via the Schläfli identity (805 lines, 8 sections + 2 appendices).  Cited sources: Schläfli 1858, Milnor 1982, Vinberg 1993, Cho–Kim 1999, Glickenstein 2011, Rivin–Schlenker 1999, Springborn 2020.</td></tr>
 </table>
 
 </details>

doc/reviewer/questions.md

@@ -35,7 +35,7 @@ phases whose existence is settled but whose priority is open:
 | **9f** | RESEARCH | Discrete Laplace–Beltrami on **non-triangular** polygonal meshes (virtual-node / generalised cotangent), making DCE work on quad / Voronoi tessellations without re-triangulation | Polygon Laplacians (2011 *SIGGRAPH* + 2020 *TOG*) |
 | **10c + 10c′** | planned | Canonical Delaunay tessellations of decorated hyperbolic surfaces; Koebe polyhedron realisation (KAT) with rigidity-aware Newton | Canonical tessellations of decorated hyperbolic surfaces (2023, *Geom. Dedicata*); rigidity of circle / hyperideal polyhedra (2026, preprint) |
 | **10e** | planned | Quasi-isothermic maps (~800 lines Lawson-correspondence) — generalises conformality to meshes where exact conformality is impossible.  Six new classes including a discrete Beltrami-field solver. | Java original `QuasiisothermicUtility` line; no obvious single-paper reference in the existing literature index |
-| **10b** | planned | Hyperelliptic surfaces (genus g ≥ 2 with Z₂ symmetry); period matrices with block-diagonal structure; Penner-coordinate variant via `HyperIdealHyperellipticUtility` | Bobenko–Bücking 2009 *Conformal Structures and Period Matrices of Polyhedral Surfaces* |
+| **10b** | planned | Hyperelliptic surfaces (genus g ≥ 2 with Z₂ symmetry); period matrices with block-diagonal structure; Penner-coordinate variant via `HyperIdealHyperellipticUtility` | Bobenko–Mercat–Schmies 2011 *Period Matrices of Polyhedral Surfaces* / Bobenko–Bücking 2021 *Convergence of discrete period matrices* |
 | **9d.4** | planned | Möbius centring of Poincaré-disk layouts as a *variational* problem (Lorentz energy with full gradient + Hessian), replacing today's iterative Fréchet-mean fallback in `normalise_hyperbolic()` | Java original `MobiusCenteringFunctional`; closest published context: decorated-DCE Möbius normalisation, also used in canonical-tessellation post-processing |
 
 **Question A:** which of these (if any) would unblock concrete
@@ -104,7 +104,7 @@ We have:
   [`doc/math/hyperideal-hessian-derivation.md`](../math/hyperideal-hessian-derivation.md)
   (805 lines, all sign pitfalls covered, references Schläfli 1858,
   Milnor 1982, Vinberg 1993, Cho–Kim 1999, Glickenstein 2011,
-  Springborn 2020, Rivin–Springborn 1999).
+  Springborn 2020, Rivin–Schlenker 1999).
 
 **Question:**