diff --git a/README.md b/README.md
index 4364e8c..423846c 100644
--- a/README.md
+++ b/README.md
@@ -605,8 +605,8 @@ The compound-collision contract prop pipelines (engines generally,
 FiveM/GTA-style prop workflows specifically) ingest: one convex hull piece
 per part group, built with `bmesh.ops.convex_hull` from a coarse
 `sec(π/n)`-inflated cage — never the dense render mesh, whose hull measures
-368 faces, over the 255-face per-piece engine budget. Closed-form plane
-tests prove containment (5.9e-08), convexity, watertightness, outward
+380 faces, over the 255-face per-piece engine budget. Closed-form plane
+tests prove containment (4.4e-08), convexity, watertightness, outward
 winding, and Euler characteristic 2 per piece. Proud details cost cage rows;
 concave grooves are free.
 
diff --git a/ROADMAP.md b/ROADMAP.md
index fec7d2c..af86ff6 100644
--- a/ROADMAP.md
+++ b/ROADMAP.md
@@ -112,7 +112,7 @@ Not committed; target list for the next content version. (v0.3.0 shipped the smo
 - Degenerate-bevel weld hazard (snippet or rule): bevel width ≥ half a box dimension creates zero-area faces whose loops weld on glTF export (found authoring `gltf-export-roundtrip`, where the count check caught a 36-vertex weld)
 - ~~GAMMA_CROSS blend-curve witness~~ **SHIPPED** as `examples/vse-gamma-cross/` — the cross blends in a gamma-0.5 space: `((1-t)·√A + t·√B)²` with `t = (frame − start)/duration`, never 1 inside the effect; mid-cross dips 0.115 below the sRGB lerp from crimson/teal (closed form (0.341, 0.349, 0.463) confirmed per frame); AgX-default sampling poisons the fit (0.146 red-channel error, `view_transform='Standard'` mandatory); deleting a consumed input orphans-and-deletes the effect — follow-up to `vse-cut-list`
 - Falsy `bpy_prop_collection` trap snippet: an empty collection is falsy, so `editor.strips or editor.sequences` silently falls through to the legacy accessor on an empty timeline — always branch on `hasattr`; likely generalizes across the API (found authoring `vse-cut-list`)
-- ~~Collision compound witness~~ **SHIPPED** as `examples/collision-hull-proxy/` — game-prop collision as a compound of convex pieces, each a `bmesh.ops.convex_hull` of a coarse `sec(π/n)`-inflated cage (containment 5.9e-08, watertight, positive signed volume, Euler 2, per-piece 255-face budget: body 70, caps 60×3, compound 250); a hull of the dense render mesh measures 374 faces — over budget — which is why pipelines hull cages; proud details cost cage rows, concave grooves are free; byte-identical on 4.5.11 and 5.1.2
+- ~~Collision compound witness~~ **SHIPPED** as `examples/collision-hull-proxy/` — game-prop collision as a compound of convex pieces, each a `bmesh.ops.convex_hull` of a coarse `sec(π/n)`-inflated cage (containment 4.4e-08, watertight, positive signed volume, Euler 2, per-piece 255-face budget: body 70, caps 60×3, compound 250); a hull of the dense render mesh measures 380 faces — over budget — which is why pipelines hull cages; proud details cost cage rows, concave grooves are free; byte-identical on 4.5.11 and 5.1.2
 - ~~Custom-normals / shade-by-angle witness~~ **SHIPPED** as `examples/custom-normals-shade/` — the post-4.1 shading contract: `use_auto_smooth`/`use_custom_normals`/`calc_normals` are AttributeError on BOTH 4.5.11 and 5.1.2; `set_sharp_from_angle` sharp sets match an independent dihedral recompute exactly (188/388 edges, 3 meshes); evaluated normal welds/splits exact (0.0 dev); custom split normals survive depsgraph evaluation within int16 quantization (1.407e-04, not float-exact); **divergence**: the legacy `shade_auto_smooth` operator CANCELS headless on 4.5 ("Asset loading is unfinished", mesh untouched, no exception) while 5.1 FINISHES with the Smooth-by-Angle NODES modifier — the data API is the portable path
 - prop-origin-transform witness — origin to base center, `transform_apply` through the data API, delta transforms, `matrix_parent_inverse` so parented children do not teleport; closed forms: post-apply scale exactly (1,1,1), local bbox min Z == 0, world bbox unchanged (builds on `parent-inverse-orrery`, does not duplicate it)
 - mesh-hygiene-audit witness — the engine-ingest checklist as executable contract: no ngons, no loose vertices, no non-manifold edges, no zero-area faces, consistent outward winding; closed forms via Euler characteristic and exact edge-face incidence counts
diff --git a/docs/gallery/assets/collision-hull-proxy-hero.webp b/docs/gallery/assets/collision-hull-proxy-hero.webp
index ed5dcc1..82a49b2 100644
Binary files a/docs/gallery/assets/collision-hull-proxy-hero.webp and b/docs/gallery/assets/collision-hull-proxy-hero.webp differ
diff --git a/docs/gallery/assets/custom-normals-shade-hero.webp b/docs/gallery/assets/custom-normals-shade-hero.webp
index 93500a8..81ffa59 100644
Binary files a/docs/gallery/assets/custom-normals-shade-hero.webp and b/docs/gallery/assets/custom-normals-shade-hero.webp differ
diff --git a/docs/gallery/collision-hull-proxy/index.html b/docs/gallery/collision-hull-proxy/index.html
index 8f468ec..5c84f2d 100644
--- a/docs/gallery/collision-hull-proxy/index.html
+++ b/docs/gallery/collision-hull-proxy/index.html
@@ -4,18 +4,18 @@
   <meta charset="utf-8" />
   <meta name="viewport" content="width=device-width, initial-scale=1" />
   <title>collision-hull-proxy — Examples — Blender Developer Tools</title>
-  <meta name="description" content="A fire hydrant street prop inside its compound collision shell: four convex pieces hulled by bmesh.ops.convex_hull from a coarse inflated cage. The dense render mesh is never hulled - its hull would measure 368 faces, over the 255-face per-piece engine budget. Closed-form plane tests prove containment, convexity, watertightness, outward winding, and Euler characteristic 2 per piece." />
+  <meta name="description" content="A fire hydrant street prop inside its compound collision shell: four convex pieces hulled by bmesh.ops.convex_hull from a coarse inflated cage. The dense render mesh is never hulled - its hull would measure 380 faces, over the 255-face per-piece engine budget. Closed-form plane tests prove containment, convexity, watertightness, outward winding, and Euler characteristic 2 per piece." />
   <link rel="canonical" href="https://tmhsdigital.github.io/Blender-Developer-Tools/gallery/collision-hull-proxy/" />
   <link rel="icon" href="../../assets/favicon.svg" type="image/svg+xml" />
   <meta name="theme-color" content="#1a1b1e" />
   <meta property="og:type" content="website" />
   <meta property="og:title" content="collision-hull-proxy — Examples — Blender Developer Tools" />
-  <meta property="og:description" content="A fire hydrant street prop inside its compound collision shell: four convex pieces hulled by bmesh.ops.convex_hull from a coarse inflated cage. The dense render mesh is never hulled - its hull would measure 368 faces, over the 255-face per-piece engine budget. Closed-form plane tests prove containment, convexity, watertightness, outward winding, and Euler characteristic 2 per piece." />
+  <meta property="og:description" content="A fire hydrant street prop inside its compound collision shell: four convex pieces hulled by bmesh.ops.convex_hull from a coarse inflated cage. The dense render mesh is never hulled - its hull would measure 380 faces, over the 255-face per-piece engine budget. Closed-form plane tests prove containment, convexity, watertightness, outward winding, and Euler characteristic 2 per piece." />
   <meta property="og:url" content="https://tmhsdigital.github.io/Blender-Developer-Tools/gallery/collision-hull-proxy/" />
   <meta property="og:image" content="https://tmhsdigital.github.io/Blender-Developer-Tools/gallery/assets/collision-hull-proxy-hero.webp" />
   <meta name="twitter:card" content="summary_large_image" />
   <meta name="twitter:title" content="collision-hull-proxy — Examples — Blender Developer Tools" />
-  <meta name="twitter:description" content="A fire hydrant street prop inside its compound collision shell: four convex pieces hulled by bmesh.ops.convex_hull from a coarse inflated cage. The dense render mesh is never hulled - its hull would measure 368 faces, over the 255-face per-piece engine budget. Closed-form plane tests prove containment, convexity, watertightness, outward winding, and Euler characteristic 2 per piece." />
+  <meta name="twitter:description" content="A fire hydrant street prop inside its compound collision shell: four convex pieces hulled by bmesh.ops.convex_hull from a coarse inflated cage. The dense render mesh is never hulled - its hull would measure 380 faces, over the 255-face per-piece engine budget. Closed-form plane tests prove containment, convexity, watertightness, outward winding, and Euler characteristic 2 per piece." />
   <meta name="twitter:image" content="https://tmhsdigital.github.io/Blender-Developer-Tools/gallery/assets/collision-hull-proxy-hero.webp" />
   <style>
     /* fonts are deployed by the landing build (docs/fonts/) */
@@ -170,14 +170,14 @@
   </div>
   <header class="hero">
     <h1>collision-hull-proxy</h1>
-    <p>A fire hydrant street prop inside its compound collision shell: four convex pieces hulled by bmesh.ops.convex_hull from a coarse inflated cage. The dense render mesh is never hulled - its hull would measure 368 faces, over the 255-face per-piece engine budget. Closed-form plane tests prove containment, convexity, watertightness, outward winding, and Euler characteristic 2 per piece.</p>
+    <p>A fire hydrant street prop inside its compound collision shell: four convex pieces hulled by bmesh.ops.convex_hull from a coarse inflated cage. The dense render mesh is never hulled - its hull would measure 380 faces, over the 255-face per-piece engine budget. Closed-form plane tests prove containment, convexity, watertightness, outward winding, and Euler characteristic 2 per piece.</p>
   </header>
   <main id="main">
     <button class="detail-hero" id="heroZoom" type="button" aria-label="Zoom collision-hull-proxy render">
       <img src="../assets/collision-hull-proxy-hero.webp" alt="collision-hull-proxy render" width="1280" height="720" />
     </button>
     <p class="zoom-hint">Rendered headless by the example itself — click to zoom.</p>
-    <div class="callout"><span class="tag">witnesses</span> A hull of the dense render mesh measures 368 faces, over the 255-face per-piece budget - the cage is a coarser lathe with rings inflated by sec(pi/n) so each cage ring circumscribes its render ring exactly (containment 5.9e-08). Proud details cost cage rows; concave grooves are free under the hull. Piece budgets: body 70, caps 60+60+60, compound 250.</div>
+    <div class="callout"><span class="tag">witnesses</span> A hull of the dense render mesh measures 380 faces, over the 255-face per-piece budget - the cage is a coarser lathe with rings inflated by sec(pi/n) so each cage ring circumscribes its render ring exactly (containment 4.4e-08). Proud details cost cage rows; concave grooves are free under the hull. Piece budgets: body 70, caps 60+60+60, compound 250.</div>
     <div class="runline">
       <pre id="runCmd">blender --background --python examples/collision-hull-proxy/collision_hull_proxy.py --</pre>
       <button class="copy-btn" id="copyRun" type="button">Copy</button>
@@ -187,8 +187,8 @@ <h1>collision-hull-proxy</h1>
 <p><strong>Pipeline arc neighbor:</strong> LODs in <a href="https://github.com/TMHSDigital/Blender-Developer-Tools/tree/main/examples/lod-decimate-chain"><code>lod-decimate-chain</code></a>, tangent space in <a href="https://github.com/TMHSDigital/Blender-Developer-Tools/tree/main/examples/triangulate-tangents"><code>triangulate-tangents</code></a>, export in <a href="https://github.com/TMHSDigital/Blender-Developer-Tools/tree/main/examples/gltf-export-roundtrip"><code>gltf-export-roundtrip</code></a> — collision bounds are the piece an engine&#x27;s physics ingest checks first, and the piece whose failure rejects the whole prop.</p>
 <p><strong>Scope:</strong> this witnesses the bpy-level contract a prop pipeline relies on (watertight convex pieces that enclose the render mesh within budget). It is not an engine exporter and does not produce a shippable FiveM/engine asset — it proves the geometry properties such an asset must have.</p>
 <p><strong>What it witnesses:</strong> engines (GTA/FiveM-style prop workflows included) ingest collision as a *compound of convex pieces*, each piece under a per-piece face limit (255 is the common cap). The example builds that structure and derives every property from closed forms, per piece:</p>
-<ul><li><strong>Containment.</strong> Every render-mesh vertex lies on the inner side of every face plane of its piece&#x27;s hull — max excursion <strong>5.9e-08</strong> (tol 2e-4). This holds by construction, not luck: the cage is a coarse lathe whose rings are inflated by <code>sec(π/n)</code>, so each n-gon cage ring *circumscribes* its render ring exactly. Proud details (a rim, a nut) must be paid for in cage rows; concave details (the grooves) are free — the hull bridges over them. That trade-off is the collision-authoring lesson.</li><li><strong>Convexity.</strong> The same plane test restricted to the hull&#x27;s own vertices (5.0e-08) — what a convex solver assumes when it uploads the piece.</li><li><strong>Watertight + manifold.</strong> Every hull edge borders exactly two faces, and V − E + F = 2: a convex hull is a topological sphere.</li><li><strong>Outward winding.</strong> Positive signed volume by the divergence theorem (body piece 0.968858) — inverted collision is a physics no-op.</li><li><strong>Budget.</strong> Every piece ≤ 255 faces: body 70, pumper 60, side caps 60+60; the compound totals 250. The naive approach fails this — a hull of the *dense render mesh* measures <strong>368 faces</strong>, over budget, which is why real pipelines hull a cage, never the render mesh.</li></ul>
-<p><strong>What each check catches on failure:</strong> an artist editing the render mesh after the hull was generated (probe: pumper lug stretched 2×, exit 3, measured escape 0.730000); inverted hull winding (probe: polygons flipped, exit 5, signed volume −0.968858, the exact negation); a non-watertight piece (probe: one face deleted, exit 4, three border edges).</p>
+<ul><li><strong>Containment.</strong> Every render-mesh vertex lies on the inner side of every face plane of its piece&#x27;s hull — max excursion <strong>4.4e-08</strong> (tol 2e-4). This holds by construction, not luck: the cage is a coarse lathe whose rings are inflated by <code>sec(π/n)</code>, so each n-gon cage ring *circumscribes* its render ring exactly. Proud details (a rim, a nut) must be paid for in cage rows; concave details (the grooves) are free — the hull bridges over them. That trade-off is the collision-authoring lesson.</li><li><strong>Convexity.</strong> The same plane test restricted to the hull&#x27;s own vertices (4.8e-08) — what a convex solver assumes when it uploads the piece.</li><li><strong>Watertight + manifold.</strong> Every hull edge borders exactly two faces, and V − E + F = 2: a convex hull is a topological sphere.</li><li><strong>Outward winding.</strong> Positive signed volume by the divergence theorem (body piece 1.022381) — inverted collision is a physics no-op.</li><li><strong>Budget.</strong> Every piece ≤ 255 faces: body 70, pumper 60, side caps 60+60; the compound totals 250. The naive approach fails this — a hull of the *dense render mesh* measures <strong>380 faces</strong>, over budget, which is why real pipelines hull a cage, never the render mesh.</li></ul>
+<p><strong>What each check catches on failure:</strong> an artist editing the render mesh after the hull was generated (probe: pumper lug stretched 2×, exit 3, measured escape 0.730000); inverted hull winding (probe: polygons flipped, exit 5, signed volume −1.022381, the exact negation); a non-watertight piece (probe: one face deleted, exit 4, three border edges).</p>
 <p><strong>Version witness:</strong> output is byte-identical on Blender 4.5.11 LTS and 5.1.2 — same piece counts, same volumes, same excursions. <code>bmesh.ops.convex_hull</code> and <code>foreach_get</code> are stable across the pair.</p>
 <p>The render shows the prop inside its four faceted translucent hull pieces: if any piece failed to enclose its geometry, painted metal would poke through the shell in frame.</p>
 <h2>Run</h2>
@@ -270,8 +270,8 @@ <h2>Source</h2>
     (<span class="n">0.37</span>, <span class="n">0.205</span>),   <span class="c"># neck</span>
     (<span class="n">0.35</span>, <span class="n">0.320</span>),   <span class="c"># barrel</span>
     (<span class="n">0.346</span>, <span class="n">0.545</span>),
-    (<span class="n">0.334</span>, <span class="n">0.555</span>),  <span class="c"># barrel groove (concave)</span>
-    (<span class="n">0.334</span>, <span class="n">0.575</span>),
+    (<span class="n">0.328</span>, <span class="n">0.555</span>),  <span class="c"># barrel groove (concave)</span>
+    (<span class="n">0.328</span>, <span class="n">0.575</span>),
     (<span class="n">0.346</span>, <span class="n">0.590</span>),
     (<span class="n">0.345</span>, <span class="n">0.880</span>),  <span class="c"># barrel top</span>
     (<span class="n">0.348</span>, <span class="n">0.930</span>),
@@ -279,6 +279,8 @@ <h2>Source</h2>
     (<span class="n">0.336</span>, <span class="n">1.000</span>),
     (<span class="n">0.348</span>, <span class="n">1.030</span>),
     (<span class="n">0.36</span>, <span class="n">1.090</span>),   <span class="c"># shoulder under bonnet</span>
+    (<span class="n">0.388</span>, <span class="n">1.110</span>),  <span class="c"># bonnet brim (proud — paid for with a cage row)</span>
+    (<span class="n">0.362</span>, <span class="n">1.132</span>),  <span class="c"># under-brim tuck (concave)</span>
     (<span class="n">0.35</span>, <span class="n">1.150</span>),   <span class="c"># bonnet dome (concave curve — cage keeps every row)</span>
     (<span class="n">0.30</span>, <span class="n">1.220</span>),
     (<span class="n">0.21</span>, <span class="n">1.280</span>),
@@ -295,6 +297,7 @@ <h2>Source</h2>
     (<span class="n">0.37</span>, <span class="n">0.205</span>),
     (<span class="n">0.345</span>, <span class="n">0.880</span>),
     (<span class="n">0.36</span>, <span class="n">1.090</span>),
+    (<span class="n">0.388</span>, <span class="n">1.110</span>),  <span class="c"># the brim is proud: it must appear in the cage</span>
     (<span class="n">0.35</span>, <span class="n">1.150</span>),
     (<span class="n">0.30</span>, <span class="n">1.220</span>),
     (<span class="n">0.21</span>, <span class="n">1.280</span>),
@@ -302,7 +305,7 @@ <h2>Source</h2>
     (<span class="n">0.00</span>, <span class="n">1.325</span>),
 ]
 
-NUT_PROFILE = [(<span class="n">0.09</span>, <span class="n">1.325</span>), (<span class="n">0.072</span>, <span class="n">1.40</span>), (<span class="n">0.0</span>, <span class="n">1.40</span>)]
+NUT_PROFILE = [(<span class="n">0.115</span>, <span class="n">1.325</span>), (<span class="n">0.095</span>, <span class="n">1.44</span>), (<span class="n">0.0</span>, <span class="n">1.44</span>)]
 
 <span class="c"># Side caps at z=0.76, pumper (bigger) at z=0.66. A cap&#x27;s outlet direction</span>
 <span class="c"># equals its azimuth (degrees from +X); the camera sits near azimuth 292, so</span>
@@ -406,6 +409,7 @@ <h2>Source</h2>
     red = make_material(<span class="s">&quot;EnamelRed&quot;</span>, (<span class="n">0.48</span>, <span class="n">0.035</span>, <span class="n">0.022</span>), <span class="n">0.15</span>, <span class="n">0.30</span>)
     yellow = make_material(<span class="s">&quot;EnamelYellow&quot;</span>, (<span class="n">0.82</span>, <span class="n">0.53</span>, <span class="n">0.05</span>), <span class="n">0.15</span>, <span class="n">0.32</span>)
     iron = make_material(<span class="s">&quot;CastIron&quot;</span>, (<span class="n">0.05</span>, <span class="n">0.052</span>, <span class="n">0.06</span>), <span class="n">0.9</span>, <span class="n">0.48</span>)
+    iron_light = make_material(<span class="s">&quot;CastIronLight&quot;</span>, (<span class="n">0.14</span>, <span class="n">0.145</span>, <span class="n">0.16</span>), <span class="n">0.85</span>, <span class="n">0.42</span>)
 
     inflate_body = <span class="n">1.0</span> / math.cos(math.pi / CAGE_SEG_BODY)
     inflate_cap = <span class="n">1.0</span> / math.cos(math.pi / CAGE_SEG_CAP)
@@ -419,7 +423,7 @@ <h2>Source</h2>
         <span class="k">if</span> p.center.z &gt; <span class="n">1.09</span>:
             p.material_index = <span class="n">1</span>
     nut = lathe_object(<span class="s">&quot;Nut&quot;</span>, NUT_PROFILE, <span class="n">5</span>)
-    nut.data.materials.append(iron)
+    nut.data.materials.append(iron_light)
     body_cage = lathe_object(<span class="s">&quot;BodyCage&quot;</span>, CAGE_BODY_PROFILE, CAGE_SEG_BODY, inflate_body)
     nut_cage = lathe_object(<span class="s">&quot;NutCage&quot;</span>, NUT_PROFILE, CAGE_SEG_NUT, inflate_nut)
     groups = [{<span class="s">&quot;name&quot;</span>: <span class="s">&quot;body&quot;</span>, <span class="s">&quot;render&quot;</span>: [body, nut], <span class="s">&quot;cage&quot;</span>: [body_cage, nut_cage]}]
@@ -647,7 +651,7 @@ <h2>Source</h2>
 
     <span class="c"># key/fill/rim/wedge per docs/VISUAL-STYLE.md</span>
     light(<span class="s">&quot;Key&quot;</span>, (-<span class="n">3.5</span>, -<span class="n">4.5</span>, <span class="n">5.5</span>), <span class="n">500.0</span>, <span class="n">4.5</span>, (<span class="n">1.0</span>, <span class="n">0.96</span>, <span class="n">0.9</span>), (<span class="n">48</span>, <span class="n">0</span>, -<span class="n">35</span>))
-    light(<span class="s">&quot;Fill&quot;</span>, (<span class="n">5.0</span>, -<span class="n">3.5</span>, <span class="n">2.5</span>), <span class="n">110.0</span>, <span class="n">9.0</span>, (<span class="n">0.75</span>, <span class="n">0.85</span>, <span class="n">1.0</span>), (<span class="n">65</span>, <span class="n">0</span>, <span class="n">50</span>))
+    light(<span class="s">&quot;Fill&quot;</span>, (<span class="n">5.0</span>, -<span class="n">3.5</span>, <span class="n">2.5</span>), <span class="n">130.0</span>, <span class="n">9.0</span>, (<span class="n">0.75</span>, <span class="n">0.85</span>, <span class="n">1.0</span>), (<span class="n">65</span>, <span class="n">0</span>, <span class="n">50</span>))
     light(<span class="s">&quot;Rim&quot;</span>, (<span class="n">1.5</span>, <span class="n">4.5</span>, <span class="n">3.5</span>), <span class="n">300.0</span>, <span class="n">3.0</span>, (<span class="n">0.6</span>, <span class="n">0.78</span>, <span class="n">1.0</span>), (-<span class="n">55</span>, <span class="n">0</span>, <span class="n">170</span>))
     light(<span class="s">&quot;Wedge&quot;</span>, (<span class="n">2.5</span>, <span class="n">5.5</span>, <span class="n">4.0</span>), <span class="n">380.0</span>, <span class="n">6.0</span>, (<span class="n">1.0</span>, <span class="n">0.76</span>, <span class="n">0.5</span>), (-<span class="n">68</span>, <span class="n">0</span>, <span class="n">190</span>))
     <span class="c"># small warm glint off the camera-left shoulder: lifts the pumper cap face</span>
@@ -667,7 +671,7 @@ <h2>Source</h2>
 
     scene.render.engine = <span class="s">&#x27;CYCLES&#x27;</span> <span class="k">if</span> engine == <span class="s">&#x27;cycles&#x27;</span> <span class="k">else</span> eevee_engine_id()
     <span class="k">if</span> engine == <span class="s">&#x27;cycles&#x27;</span>:
-        scene.cycles.samples = <span class="n">48</span>
+        scene.cycles.samples = <span class="n">64</span>
     <span class="k">else</span>:
         <span class="k">try</span>:
             scene.eevee.taa_render_samples = <span class="n">64</span>
diff --git a/docs/gallery/contact-sheets/collision-hull-proxy-contact-sheet.webp b/docs/gallery/contact-sheets/collision-hull-proxy-contact-sheet.webp
index 52fff97..d90a0ab 100644
Binary files a/docs/gallery/contact-sheets/collision-hull-proxy-contact-sheet.webp and b/docs/gallery/contact-sheets/collision-hull-proxy-contact-sheet.webp differ
diff --git a/docs/gallery/contact-sheets/custom-normals-shade-contact-sheet.webp b/docs/gallery/contact-sheets/custom-normals-shade-contact-sheet.webp
index de7f469..29b627f 100644
Binary files a/docs/gallery/contact-sheets/custom-normals-shade-contact-sheet.webp and b/docs/gallery/contact-sheets/custom-normals-shade-contact-sheet.webp differ
diff --git a/docs/gallery/custom-normals-shade/index.html b/docs/gallery/custom-normals-shade/index.html
index bbab0b9..f9193f1 100644
--- a/docs/gallery/custom-normals-shade/index.html
+++ b/docs/gallery/custom-normals-shade/index.html
@@ -659,7 +659,7 @@ <h2>Source</h2>
     <span class="c"># semi-gloss painted steel: rough enough to read as paint, glossy enough</span>
     <span class="c"># that a highlight exposes every normal discontinuity — matte would hide</span>
     <span class="c"># the very shading differences this render exists to show</span>
-    steel = make_material(<span class="s">&quot;OliveDrab&quot;</span>, (<span class="n">0.31</span>, <span class="n">0.35</span>, <span class="n">0.15</span>), <span class="n">0.8</span>, <span class="n">0.26</span>)
+    steel = make_material(<span class="s">&quot;OliveDrab&quot;</span>, (<span class="n">0.30</span>, <span class="n">0.345</span>, <span class="n">0.13</span>), <span class="n">0.8</span>, <span class="n">0.26</span>)
     accent = make_material(<span class="s">&quot;FuelMarker&quot;</span>, (<span class="n">0.55</span>, <span class="n">0.06</span>, <span class="n">0.03</span>), <span class="n">0.3</span>, <span class="n">0.30</span>)
 
     <span class="c"># the checked base can IS the by-angle variant; the two failure modes are</span>
@@ -712,16 +712,16 @@ <h2>Source</h2>
 
     <span class="c"># key/fill/rim/wedge per docs/VISUAL-STYLE.md</span>
     light(<span class="s">&quot;Key&quot;</span>, (-<span class="n">4.0</span>, -<span class="n">5.0</span>, <span class="n">6.0</span>), <span class="n">520.0</span>, <span class="n">4.5</span>, (<span class="n">1.0</span>, <span class="n">0.96</span>, <span class="n">0.9</span>), (<span class="n">50</span>, <span class="n">0</span>, -<span class="n">38</span>))
-    light(<span class="s">&quot;Fill&quot;</span>, (<span class="n">5.5</span>, -<span class="n">3.5</span>, <span class="n">2.5</span>), <span class="n">120.0</span>, <span class="n">9.0</span>, (<span class="n">0.75</span>, <span class="n">0.85</span>, <span class="n">1.0</span>), (<span class="n">65</span>, <span class="n">0</span>, <span class="n">55</span>))
+    light(<span class="s">&quot;Fill&quot;</span>, (<span class="n">5.5</span>, -<span class="n">3.5</span>, <span class="n">2.5</span>), <span class="n">150.0</span>, <span class="n">9.0</span>, (<span class="n">0.75</span>, <span class="n">0.85</span>, <span class="n">1.0</span>), (<span class="n">65</span>, <span class="n">0</span>, <span class="n">55</span>))
     light(<span class="s">&quot;Rim&quot;</span>, (<span class="n">1.5</span>, <span class="n">4.5</span>, <span class="n">4.0</span>), <span class="n">340.0</span>, <span class="n">3.0</span>, (<span class="n">0.6</span>, <span class="n">0.78</span>, <span class="n">1.0</span>), (-<span class="n">58</span>, <span class="n">0</span>, <span class="n">170</span>))
     light(<span class="s">&quot;Wedge&quot;</span>, (<span class="n">2.5</span>, <span class="n">5.5</span>, <span class="n">4.0</span>), <span class="n">400.0</span>, <span class="n">6.0</span>, (<span class="n">1.0</span>, <span class="n">0.76</span>, <span class="n">0.5</span>), (-<span class="n">68</span>, <span class="n">0</span>, <span class="n">190</span>))
     <span class="c"># the shading audit light: a tall strip whose reflection runs down each</span>
     <span class="c"># can face — it stair-steps on flat shading, warps at the rim on</span>
     <span class="c"># smooth-everything, and stays straight with crisp edges on by-angle</span>
     ld = bpy.data.lights.new(<span class="s">&quot;Strip&quot;</span>, <span class="s">&#x27;AREA&#x27;</span>)
-    ld.energy = <span class="n">460.0</span>
+    ld.energy = <span class="n">400.0</span>
     ld.shape = <span class="s">&#x27;RECTANGLE&#x27;</span>
-    ld.size = <span class="n">1.0</span>
+    ld.size = <span class="n">1.35</span>
     ld.size_y = <span class="n">8.0</span>
     ld.color = (<span class="n">0.9</span>, <span class="n">0.95</span>, <span class="n">1.0</span>)
     strip = bpy.data.objects.new(<span class="s">&quot;Strip&quot;</span>, ld)
@@ -743,7 +743,7 @@ <h2>Source</h2>
 
     scene.render.engine = <span class="s">&#x27;CYCLES&#x27;</span> <span class="k">if</span> engine == <span class="s">&#x27;cycles&#x27;</span> <span class="k">else</span> eevee_engine_id()
     <span class="k">if</span> engine == <span class="s">&#x27;cycles&#x27;</span>:
-        scene.cycles.samples = <span class="n">48</span>
+        scene.cycles.samples = <span class="n">64</span>
     <span class="k">else</span>:
         <span class="k">try</span>:
             scene.eevee.taa_render_samples = <span class="n">64</span>
diff --git a/docs/gallery/index.html b/docs/gallery/index.html
index 7725177..daa75ec 100644
--- a/docs/gallery/index.html
+++ b/docs/gallery/index.html
@@ -541,8 +541,8 @@ <h2><a href="light-link-studio/">light-link-studio</a></h2>
         </a>
         <div class="card-body">
           <h2><a href="collision-hull-proxy/">collision-hull-proxy</a></h2>
-          <p class="teaches">A fire hydrant street prop inside its compound collision shell: four convex pieces hulled by bmesh.ops.convex_hull from a coarse inflated cage. The dense render mesh is never hulled - its hull would measure 368 faces, over the 255-face per-piece engine budget. Closed-form plane tests prove containment, convexity, watertightness, outward winding, and Euler characteristic 2 per piece.</p>
-          <p class="witnesses"><span class="tag">witnesses</span> A hull of the dense render mesh measures 368 faces, over the 255-face per-piece budget - the cage is a coarser lathe with rings inflated by sec(pi/n) so each cage ring circumscribes its render ring exactly (containment 5.9e-08). Proud details cost cage rows; concave grooves are free under the hull. Piece budgets: body 70, caps 60+60+60, compound 250.</p>
+          <p class="teaches">A fire hydrant street prop inside its compound collision shell: four convex pieces hulled by bmesh.ops.convex_hull from a coarse inflated cage. The dense render mesh is never hulled - its hull would measure 380 faces, over the 255-face per-piece engine budget. Closed-form plane tests prove containment, convexity, watertightness, outward winding, and Euler characteristic 2 per piece.</p>
+          <p class="witnesses"><span class="tag">witnesses</span> A hull of the dense render mesh measures 380 faces, over the 255-face per-piece budget - the cage is a coarser lathe with rings inflated by sec(pi/n) so each cage ring circumscribes its render ring exactly (containment 4.4e-08). Proud details cost cage rows; concave grooves are free under the hull. Piece budgets: body 70, caps 60+60+60, compound 250.</p>
           <a class="card-link" href="collision-hull-proxy/">View example <span aria-hidden="true">&rarr;</span></a>
         </div>
       </article>
diff --git a/examples/collision-hull-proxy/README.md b/examples/collision-hull-proxy/README.md
index 4980503..9fd4d81 100644
--- a/examples/collision-hull-proxy/README.md
+++ b/examples/collision-hull-proxy/README.md
@@ -24,27 +24,27 @@ per-piece face limit (255 is the common cap). The example builds that
 structure and derives every property from closed forms, per piece:
 
 - **Containment.** Every render-mesh vertex lies on the inner side of every
-  face plane of its piece's hull — max excursion **5.9e-08** (tol 2e-4). This
+  face plane of its piece's hull — max excursion **4.4e-08** (tol 2e-4). This
   holds by construction, not luck: the cage is a coarse lathe whose rings are
   inflated by `sec(π/n)`, so each n-gon cage ring *circumscribes* its render
   ring exactly. Proud details (a rim, a nut) must be paid for in cage rows;
   concave details (the grooves) are free — the hull bridges over them. That
   trade-off is the collision-authoring lesson.
 - **Convexity.** The same plane test restricted to the hull's own vertices
-  (5.0e-08) — what a convex solver assumes when it uploads the piece.
+  (4.8e-08) — what a convex solver assumes when it uploads the piece.
 - **Watertight + manifold.** Every hull edge borders exactly two faces, and
   V − E + F = 2: a convex hull is a topological sphere.
 - **Outward winding.** Positive signed volume by the divergence theorem
-  (body piece 0.968858) — inverted collision is a physics no-op.
+  (body piece 1.022381) — inverted collision is a physics no-op.
 - **Budget.** Every piece ≤ 255 faces: body 70, pumper 60, side caps 60+60;
   the compound totals 250. The naive approach fails this — a hull of the
-  *dense render mesh* measures **368 faces**, over budget, which is why real
+  *dense render mesh* measures **380 faces**, over budget, which is why real
   pipelines hull a cage, never the render mesh.
 
 **What each check catches on failure:** an artist editing the render mesh
 after the hull was generated (probe: pumper lug stretched 2×, exit 3,
 measured escape 0.730000); inverted hull winding (probe: polygons flipped,
-exit 5, signed volume −0.968858, the exact negation); a non-watertight piece
+exit 5, signed volume −1.022381, the exact negation); a non-watertight piece
 (probe: one face deleted, exit 4, three border edges).
 
 **Version witness:** output is byte-identical on Blender 4.5.11 LTS and
diff --git a/examples/collision-hull-proxy/collision_hull_proxy.py b/examples/collision-hull-proxy/collision_hull_proxy.py
index 49884af..5b27568 100644
--- a/examples/collision-hull-proxy/collision_hull_proxy.py
+++ b/examples/collision-hull-proxy/collision_hull_proxy.py
@@ -62,8 +62,8 @@
     (0.37, 0.205),   # neck
     (0.35, 0.320),   # barrel
     (0.346, 0.545),
-    (0.334, 0.555),  # barrel groove (concave)
-    (0.334, 0.575),
+    (0.328, 0.555),  # barrel groove (concave)
+    (0.328, 0.575),
     (0.346, 0.590),
     (0.345, 0.880),  # barrel top
     (0.348, 0.930),
@@ -71,6 +71,8 @@
     (0.336, 1.000),
     (0.348, 1.030),
     (0.36, 1.090),   # shoulder under bonnet
+    (0.388, 1.110),  # bonnet brim (proud — paid for with a cage row)
+    (0.362, 1.132),  # under-brim tuck (concave)
     (0.35, 1.150),   # bonnet dome (concave curve — cage keeps every row)
     (0.30, 1.220),
     (0.21, 1.280),
@@ -87,6 +89,7 @@
     (0.37, 0.205),
     (0.345, 0.880),
     (0.36, 1.090),
+    (0.388, 1.110),  # the brim is proud: it must appear in the cage
     (0.35, 1.150),
     (0.30, 1.220),
     (0.21, 1.280),
@@ -94,7 +97,7 @@
     (0.00, 1.325),
 ]
 
-NUT_PROFILE = [(0.09, 1.325), (0.072, 1.40), (0.0, 1.40)]
+NUT_PROFILE = [(0.115, 1.325), (0.095, 1.44), (0.0, 1.44)]
 
 # Side caps at z=0.76, pumper (bigger) at z=0.66. A cap's outlet direction
 # equals its azimuth (degrees from +X); the camera sits near azimuth 292, so
@@ -198,6 +201,7 @@ def build_hydrant():
     red = make_material("EnamelRed", (0.48, 0.035, 0.022), 0.15, 0.30)
     yellow = make_material("EnamelYellow", (0.82, 0.53, 0.05), 0.15, 0.32)
     iron = make_material("CastIron", (0.05, 0.052, 0.06), 0.9, 0.48)
+    iron_light = make_material("CastIronLight", (0.14, 0.145, 0.16), 0.85, 0.42)
 
     inflate_body = 1.0 / math.cos(math.pi / CAGE_SEG_BODY)
     inflate_cap = 1.0 / math.cos(math.pi / CAGE_SEG_CAP)
@@ -211,7 +215,7 @@ def build_hydrant():
         if p.center.z > 1.09:
             p.material_index = 1
     nut = lathe_object("Nut", NUT_PROFILE, 5)
-    nut.data.materials.append(iron)
+    nut.data.materials.append(iron_light)
     body_cage = lathe_object("BodyCage", CAGE_BODY_PROFILE, CAGE_SEG_BODY, inflate_body)
     nut_cage = lathe_object("NutCage", NUT_PROFILE, CAGE_SEG_NUT, inflate_nut)
     groups = [{"name": "body", "render": [body, nut], "cage": [body_cage, nut_cage]}]
@@ -439,7 +443,7 @@ def light(name, loc, energy, size, col, rot):
 
     # key/fill/rim/wedge per docs/VISUAL-STYLE.md
     light("Key", (-3.5, -4.5, 5.5), 500.0, 4.5, (1.0, 0.96, 0.9), (48, 0, -35))
-    light("Fill", (5.0, -3.5, 2.5), 110.0, 9.0, (0.75, 0.85, 1.0), (65, 0, 50))
+    light("Fill", (5.0, -3.5, 2.5), 130.0, 9.0, (0.75, 0.85, 1.0), (65, 0, 50))
     light("Rim", (1.5, 4.5, 3.5), 300.0, 3.0, (0.6, 0.78, 1.0), (-55, 0, 170))
     light("Wedge", (2.5, 5.5, 4.0), 380.0, 6.0, (1.0, 0.76, 0.5), (-68, 0, 190))
     # small warm glint off the camera-left shoulder: lifts the pumper cap face
@@ -459,7 +463,7 @@ def light(name, loc, energy, size, col, rot):
 
     scene.render.engine = 'CYCLES' if engine == 'cycles' else eevee_engine_id()
     if engine == 'cycles':
-        scene.cycles.samples = 48
+        scene.cycles.samples = 64
     else:
         try:
             scene.eevee.taa_render_samples = 64
diff --git a/examples/collision-hull-proxy/preview.webp b/examples/collision-hull-proxy/preview.webp
index 20923e1..8e781f6 100644
Binary files a/examples/collision-hull-proxy/preview.webp and b/examples/collision-hull-proxy/preview.webp differ
diff --git a/examples/custom-normals-shade/custom_normals_shade.py b/examples/custom-normals-shade/custom_normals_shade.py
index 8df6b01..6507863 100644
--- a/examples/custom-normals-shade/custom_normals_shade.py
+++ b/examples/custom-normals-shade/custom_normals_shade.py
@@ -451,7 +451,7 @@ def render_still(can, path, engine):
     # semi-gloss painted steel: rough enough to read as paint, glossy enough
     # that a highlight exposes every normal discontinuity — matte would hide
     # the very shading differences this render exists to show
-    steel = make_material("OliveDrab", (0.31, 0.35, 0.15), 0.8, 0.26)
+    steel = make_material("OliveDrab", (0.30, 0.345, 0.13), 0.8, 0.26)
     accent = make_material("FuelMarker", (0.55, 0.06, 0.03), 0.3, 0.30)
 
     # the checked base can IS the by-angle variant; the two failure modes are
@@ -504,16 +504,16 @@ def light(name, loc, energy, size, col, rot):
 
     # key/fill/rim/wedge per docs/VISUAL-STYLE.md
     light("Key", (-4.0, -5.0, 6.0), 520.0, 4.5, (1.0, 0.96, 0.9), (50, 0, -38))
-    light("Fill", (5.5, -3.5, 2.5), 120.0, 9.0, (0.75, 0.85, 1.0), (65, 0, 55))
+    light("Fill", (5.5, -3.5, 2.5), 150.0, 9.0, (0.75, 0.85, 1.0), (65, 0, 55))
     light("Rim", (1.5, 4.5, 4.0), 340.0, 3.0, (0.6, 0.78, 1.0), (-58, 0, 170))
     light("Wedge", (2.5, 5.5, 4.0), 400.0, 6.0, (1.0, 0.76, 0.5), (-68, 0, 190))
     # the shading audit light: a tall strip whose reflection runs down each
     # can face — it stair-steps on flat shading, warps at the rim on
     # smooth-everything, and stays straight with crisp edges on by-angle
     ld = bpy.data.lights.new("Strip", 'AREA')
-    ld.energy = 460.0
+    ld.energy = 400.0
     ld.shape = 'RECTANGLE'
-    ld.size = 1.0
+    ld.size = 1.35
     ld.size_y = 8.0
     ld.color = (0.9, 0.95, 1.0)
     strip = bpy.data.objects.new("Strip", ld)
@@ -535,7 +535,7 @@ def light(name, loc, energy, size, col, rot):
 
     scene.render.engine = 'CYCLES' if engine == 'cycles' else eevee_engine_id()
     if engine == 'cycles':
-        scene.cycles.samples = 48
+        scene.cycles.samples = 64
     else:
         try:
             scene.eevee.taa_render_samples = 64
diff --git a/examples/custom-normals-shade/preview.webp b/examples/custom-normals-shade/preview.webp
index 5b35022..9697776 100644
Binary files a/examples/custom-normals-shade/preview.webp and b/examples/custom-normals-shade/preview.webp differ
diff --git a/examples/gallery.json b/examples/gallery.json
index 8d6af53..9157213 100644
--- a/examples/gallery.json
+++ b/examples/gallery.json
@@ -373,8 +373,8 @@
     {
       "name": "collision-hull-proxy",
       "dir": "examples/collision-hull-proxy",
-      "teaches": "A fire hydrant street prop inside its compound collision shell: four convex pieces hulled by bmesh.ops.convex_hull from a coarse inflated cage. The dense render mesh is never hulled - its hull would measure 368 faces, over the 255-face per-piece engine budget. Closed-form plane tests prove containment, convexity, watertightness, outward winding, and Euler characteristic 2 per piece.",
-      "witnessesFix": "A hull of the dense render mesh measures 368 faces, over the 255-face per-piece budget - the cage is a coarser lathe with rings inflated by sec(pi/n) so each cage ring circumscribes its render ring exactly (containment 5.9e-08). Proud details cost cage rows; concave grooves are free under the hull. Piece budgets: body 70, caps 60+60+60, compound 250.",
+      "teaches": "A fire hydrant street prop inside its compound collision shell: four convex pieces hulled by bmesh.ops.convex_hull from a coarse inflated cage. The dense render mesh is never hulled - its hull would measure 380 faces, over the 255-face per-piece engine budget. Closed-form plane tests prove containment, convexity, watertightness, outward winding, and Euler characteristic 2 per piece.",
+      "witnessesFix": "A hull of the dense render mesh measures 380 faces, over the 255-face per-piece budget - the cage is a coarser lathe with rings inflated by sec(pi/n) so each cage ring circumscribes its render ring exactly (containment 4.4e-08). Proud details cost cage rows; concave grooves are free under the hull. Piece budgets: body 70, caps 60+60+60, compound 250.",
       "hero": "docs/gallery/assets/collision-hull-proxy-hero.webp",
       "preview": "examples/collision-hull-proxy/preview.webp",
       "tags": [