1 files changed, 26 insertions, 5 deletions
diff --git a/docs/superpowers/plans/2026-09-16-conky-lua-dashboard.md b/docs/superpowers/plans/2026-09-16-conky-lua-dashboard.md
index 7d7573c..a77c30b 100644
--- a/docs/superpowers/plans/2026-09-16-conky-lua-dashboard.md
+++ b/docs/superpowers/plans/2026-09-16-conky-lua-dashboard.md
@@ -396,11 +396,31 @@ function M.text(cr, x, y, s)
   cairo_show_text(cr, s)
 end
 
--- Measured width and height of a string under the current font.
+-- One reused extents struct for every measurement, allocated at load.
+--
+-- Not per call: cairo_text_extents_t:create() leaks. 5000 allocations grow
+-- Lua's heap by ~182KB that collectgarbage() never reclaims, and calling
+-- :destroy() on each one does NOT help (measured: same 182KB either way).
+-- Reusing a single struct costs 0KB.
+local extents = cairo_text_extents_t:create()
+
+-- Ink size of a string: how much space the glyphs actually cover.
+-- Use this to CENTRE or RIGHT-ALIGN text, never to advance a cursor.
 function M.measure(cr, s)
-  local e = cairo_text_extents_t:create()
-  cairo_text_extents(cr, s, e)
-  return e.width, e.height
+  cairo_text_extents(cr, s, extents)
+  return extents.width, extents.height
+end
+
+-- How far the cursor moves after drawing a string. Use this to lay out runs of
+-- text left to right.
+--
+-- Not measure(): that returns the INK width, which ignores leading and
+-- trailing spaces because a space carries no ink. " / " measures 6px of ink
+-- against a 14px advance, so stepping a cursor by the ink width renders a
+-- segmented date as "16 /SEP /2026", each slash jammed into the next glyph.
+function M.advance(cr, s)
+  cairo_text_extents(cr, s, extents)
+  return extents.x_advance
 end
 
 -- Right-aligned text: x is the RIGHT edge.
@@ -974,7 +994,8 @@ function M.draw(cr, rect, colors)
   for _, p in ipairs(parts) do
     card.rgba(cr, p[2])
     card.text(cr, dx, dy, p[1])
-    dx = dx + card.measure(cr, p[1])
+    -- advance(), not measure(): the ink width of ' / ' omits its spaces.
+    dx = dx + card.advance(cr, p[1])
   end
 end