@dloizides/poster-render 0.2.3 → 0.2.5

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog
 
+## 0.2.5
+
+- Own-key checks: the schema validator and the asset lookup use `Object.hasOwn`, so a `__proto__` key is rejected and an imageId such as `constructor` is reported missing.
+- `placeContain(image, region, { anchor, alignX, scale })` takes an options object (was 5 positional parameters).
+- Named size and gap constants; ESLint now lints tests and `src/testing`.
+- README: install, usage, canvas injection, fonts, type floor, schema version policy.
+
+## 0.2.4
+
+- Type floor: every text run is at least 30px at a 1080 short edge (scaled per format by short edge). When a layout cannot fit its text at the floor, the picture yields space to the body (and a header stacked above it) in 2.5% steps.
+- picture-bottom sizes the picture to the space left once the body holds the floor (about 0.56w for the real tall couple on a story); it stays whole on the bottom edge.
+- Text zones pick two columns when that sets the type at least 15% larger.
+
 ## 0.2.3
 
 - `picture-bottom`: the picture is sized for a tall cut-out (design aspect 0.57): 80% of the width, standing on the bottom edge; the header and body share the top (at least 25% of the height) and shrink to fit. The picture is never cropped.

package/README.md

@@ -7,7 +7,46 @@ One JSON document (`FlierDoc`) in, one poster out. Used by Flier Studio (FLIER-1
 - `render(doc, assets, canvas)`: validates first (throws `FlierDocError` before touching the canvas), resizes the canvas to the format, draws, returns a `RenderReport` (picture rect, text and card boxes).
 - `exportPng(canvas)`: PNG `Blob` of the canvas size.
 - Formats: story 1080x1920, post 1080x1350, square 1080x1080, phone 1170x2532, desktop 2560x1440.
-- Layouts: `picture-right` (E-A), `picture-left` (E-B), `arch` (E-C), `picture-bottom`, `list`, `phone-clock-safe` (P-A, top kept clear for the lock-screen clock), `phone-arch` (P-B), `desktop-safe` (D-A, text clear of desktop icons and the taskbar), `desktop-arch` (D-B). `LAYOUT_CATALOGUE` lists id, design id, label, description and designed formats (for the app picker and the LLM prompt); `defaultLayoutFor(format)` gives E-A / P-A / D-A.
+- Layouts: `picture-right` (E-A "Picture right"), `picture-left` (E-B "Picture left"), `arch` (E-C "Arch"), `picture-bottom`, `list`, `phone-clock-safe` (P-A "Phone, clock clear": top kept clear for the lock-screen clock), `phone-arch` (P-B "Phone arch"), `desktop-safe` (D-A "Desktop, icons clear": text clear of desktop icons and the taskbar), `desktop-arch` (D-B "Desktop arch"). `LAYOUT_CATALOGUE` lists id, design id, label, description and designed formats (for the app picker and the LLM prompt); `defaultLayoutFor(format)` gives E-A "Picture right" / P-A "Phone, clock clear" / D-A "Desktop, icons clear" (D4 "Layouts: keep all").
 - Arch layouts paint a soft arch (palette `arch`, about 4% off the ground) behind the picture only, inside the picture region; prices sit large on either side. The includes block is set at one size for every line. Palettes: `sand`, `night`, `sea`, `rose`. Font sets: `classic`, `modern`, `elegant` (the app loads the web fonts).
 - The picture is placed contain + anchor in its own region: never cropped, never faded, drawn last, and no text or card is laid out in its region. Text shrinks to fit, never overflows.
 - Example: `kizombaWorkshopDocs` (3 workshops + list flier), `kizombaWorkshop` (the list flier).
+
+## Install
+
+```bash
+npm install @dloizides/poster-render
+```
+
+## Usage
+
+```ts
+import { exportPng, kizombaWorkshop, render, validateFlierDoc } from '@dloizides/poster-render';
+
+const checked = validateFlierDoc(kizombaWorkshop);
+if (!checked.ok) {
+  throw new Error(checked.errors.join('\n'));
+}
+const canvas = document.createElement('canvas');
+const report = render(checked.doc, { dancers: pictureImage, logo: logoImage }, canvas);
+const png = await exportPng(canvas);
+```
+
+## Canvas injection
+
+`render` takes any canvas with a 2d context; the package has no canvas dependency.
+
+- Browser: an `HTMLCanvasElement` (or `OffscreenCanvas`); assets are loaded `HTMLImageElement` / `ImageBitmap`.
+- Node: `@napi-rs/canvas` (`createCanvas(1, 1)`, `loadImage(path)`); `render` resizes the canvas to the format.
+
+## Fonts
+
+The font sets name CSS families (`FONT_SETS`). The host loads them before `render`: in a browser with `document.fonts.load(...)` / `@font-face`, in Node with `GlobalFonts.registerFromPath` from `@napi-rs/canvas`. A missing font falls back to the default family and the text still fits.
+
+## Type floor
+
+Every text run is at least 30px at a 1080 short edge (40px on desktop 2560x1440). When a layout cannot fit its text at the floor, the picture gives space to the text.
+
+## Schema version policy
+
+`FlierDoc.version` is `1`. A field added as optional keeps version 1; a removed, renamed or retyped field raises the version and `validateFlierDoc` rejects the other version with `version: must be 1 (got N)`. A package major release goes with a new doc version.

package/dist/index.d.mts

@@ -217,7 +217,7 @@ interface LayoutCatalogueEntry {
     formats: readonly FormatId[];
 }
 declare const LAYOUT_CATALOGUE: readonly LayoutCatalogueEntry[];
-/** The default layout for a format (D4: E-A for posters, P-A for phone, D-A for desktop). */
+/** The default layout for a format (D4 "Layouts: keep all"): E-A "Picture right" for posters, P-A "Phone, clock clear", D-A "Desktop, icons clear". */
 declare function defaultLayoutFor(format: FormatId): LayoutId;
 
 declare const kizombaWorkshop: FlierDoc;

package/dist/index.d.ts

@@ -217,7 +217,7 @@ interface LayoutCatalogueEntry {
     formats: readonly FormatId[];
 }
 declare const LAYOUT_CATALOGUE: readonly LayoutCatalogueEntry[];
-/** The default layout for a format (D4: E-A for posters, P-A for phone, D-A for desktop). */
+/** The default layout for a format (D4 "Layouts: keep all"): E-A "Picture right" for posters, P-A "Phone, clock clear", D-A "Desktop, icons clear". */
 declare function defaultLayoutFor(format: FormatId): LayoutId;
 
 declare const kizombaWorkshop: FlierDoc;

package/dist/index.js

@@ -226,7 +226,7 @@ function checkObject(schema, value, path, errors) {
     }
   }
   for (const [key, child] of Object.entries(value)) {
-    const childSchema = props[key];
+    const childSchema = Object.hasOwn(props, key) ? props[key] : void 0;
     if (childSchema === void 0) {
       if (schema.additionalProperties === false) {
         errors.push(`${join(path, key)}: is not allowed`);
@@ -284,82 +284,15 @@ function validateFlierDoc(input) {
 }
 function missingAssets(doc, assets) {
   const errors = [];
-  if (doc.picture && assets[doc.picture.imageId] === void 0) {
+  if (doc.picture && !Object.hasOwn(assets, doc.picture.imageId)) {
     errors.push(`picture.imageId: no asset named "${doc.picture.imageId}"`);
   }
-  if (doc.logo && assets[doc.logo.imageId] === void 0) {
+  if (doc.logo && !Object.hasOwn(assets, doc.logo.imageId)) {
     errors.push(`logo.imageId: no asset named "${doc.logo.imageId}"`);
   }
   return errors;
 }
 
-// src/layout/blockGroups.ts
-var BOLD = 700;
-var SEMI = 600;
-var MEDIUM = 500;
-var SCRIPT = 400;
-var makers = (p, u) => ({
-  display: (text2, size) => ({ text: text2, role: "display", weight: BOLD, size: size * u, color: p.title }),
-  venue: (text2, size) => ({ text: text2, role: "display", weight: MEDIUM, size: size * u, color: p.ink }),
-  script: (text2, size) => ({ text: text2, role: "script", weight: SCRIPT, size: size * u, color: p.accent }),
-  strong: (text2, size) => ({ text: text2, role: "body", weight: BOLD, size: size * u, color: p.ink }),
-  accent: (text2, size) => ({ text: text2, role: "body", weight: SEMI, size: size * u, color: p.accent }),
-  item: (text2, size) => ({ text: text2, role: "body", weight: SEMI, size: size * u, color: p.ink, bullet: p.accent }),
-  soft: (text2, size) => ({ text: text2, role: "body", weight: MEDIUM, size: size * u, color: p.soft })
-});
-function headerGroups(doc, p, u) {
-  const l = makers(p, u);
-  const b = doc.blocks;
-  const lines = [l.display?.(b.title, 250), b.script ? l.script?.(b.script, 120) : void 0, b.titleBottom ? l.display?.(b.titleBottom, 250) : void 0];
-  return [{ lines: lines.filter((x) => x !== void 0), gapAfter: 0 }];
-}
-function itemGroup(item, l, u) {
-  const lines = [l.script?.(item.date, 67)];
-  item.schedule.forEach((row) => lines.push(l.strong?.(`${row.label}  ${row.time}`, 42)));
-  if (item.price) {
-    lines.push(l.accent?.(item.price, 42));
-  }
-  return { lines, gapAfter: 48 * u };
-}
-function eventGroups(doc, l, u, withPrices) {
-  const b = doc.blocks;
-  const groups = [];
-  b.schedule?.forEach((row) => groups.push({ lines: [l.strong?.(row.label, 66), l.accent?.(row.time, 60)], gapAfter: 30 * u }));
-  const prices = (withPrices ? b.prices : void 0) ?? [];
-  prices.forEach((row, i) => groups.push({ lines: [l.strong?.(row.amount, 66), l.accent?.(row.label, 52)], gapAfter: 30 * u, keepWithNext: i < prices.length - 1 }));
-  return groups;
-}
-function listGroups(doc, l, u) {
-  const groups = (doc.items ?? []).map((item) => itemGroup(item, l, u));
-  const prices = doc.blocks.prices?.map((row) => l.strong?.(`${row.amount} ${row.label}`, 58)) ?? [];
-  if (prices.length > 0) {
-    groups.push({ lines: prices, gapAfter: 30 * u });
-  }
-  return groups;
-}
-function flankPriceGroups(doc, p, u) {
-  const l = makers(p, u);
-  return (doc.blocks.prices ?? []).map((row) => ({ lines: [l.strong?.(row.amount, 110), l.accent?.(row.label, 48)], gapAfter: 30 * u }));
-}
-function bodyGroups(doc, p, u, withPrices = true) {
-  const l = makers(p, u);
-  const b = doc.blocks;
-  const groups = [];
-  const isList = doc.layout === "list" /* List */;
-  if (b.venue) {
-    groups.push({ lines: b.venue.map((v) => l.venue?.(v, isList ? 48 : 58)), gapAfter: 40 * u, rule: { color: p.accent, height: 8 * u }, ruleBelow: true, icon: { color: p.accent, glyph: p.background } });
-  }
-  groups.push(...isList ? listGroups(doc, l, u) : eventGroups(doc, l, u, withPrices));
-  if (b.includes) {
-    const lines = [l.accent?.(b.includes.heading, 38), ...b.includes.items.map((i) => l.item?.(i, 38))];
-    groups.push({ lines, gapAfter: 24 * u, uniform: true });
-  }
-  if (b.footer) {
-    groups.push({ lines: [l.soft?.(b.footer, 38)], gapAfter: 0 });
-  }
-  return groups;
-}
-
 // src/layout/layoutSpecs.ts
 var flanksBeside = (pic, top, bottom2, m) => [
   [m, top, pic[0] - 2 * m, bottom2 - top],
@@ -411,12 +344,13 @@ var HEADER_PORTRAIT = 0.3;
 var HEADER_LANDSCAPE = 0.36;
 var BOTTOM_PICTURE_W = 0.8;
 var BOTTOM_MIN_TOP = 0.25;
-var BOTTOM_HEADER_SHARE = 0.45;
+var BOTTOM_HEADER_SHARE = 0.3;
 var BOTTOM_GAP = 40 / 1080;
 var BOTTOM_ASPECT = 0.57;
+var DEFAULT_SIDE = [0.6, 0.42];
 var PICTURE_SIDE = {
-  ["picture-right" /* PictureRight */]: [0.6, 0.42],
-  ["picture-left" /* PictureLeft */]: [0.6, 0.42],
+  ["picture-right" /* PictureRight */]: DEFAULT_SIDE,
+  ["picture-left" /* PictureLeft */]: DEFAULT_SIDE,
   ["list" /* List */]: [0.5, 0.36]
 };
 var ANCHOR_Y = { ["top" /* Top */]: 0, ["center" /* Center */]: 0.5, ["bottom" /* Bottom */]: 1 };
@@ -442,11 +376,11 @@ function side(w, h, fraction) {
     alignX: 1
   };
 }
-function bottom(w, h) {
+function bottom(w, h, share) {
   const m = r2(Math.min(w, h) * MARGIN);
   const gap = r2(Math.min(w, h) * BOTTOM_GAP);
-  const picW = r2(w * BOTTOM_PICTURE_W);
-  const picH = Math.min(r2(picW / BOTTOM_ASPECT), h - r2(h * BOTTOM_MIN_TOP));
+  const picW = r2(w * share);
+  const picH = Math.min(r2(picW / BOTTOM_ASPECT), r2((h - r2(h * BOTTOM_MIN_TOP)) * share / BOTTOM_PICTURE_W));
   const pic = h - picH;
   const top = m + r2((pic - m) * BOTTOM_HEADER_SHARE);
   return {
@@ -468,21 +402,22 @@ function fromSpec(spec, w, h) {
   };
 }
 var mirror = (rect, w) => ({ ...rect, x: w - rect.x - rect.w });
-function geometry(layout, w, h) {
+function geometry(layout, w, h, give = 0) {
   const oriented = LAYOUT_SPECS[layout];
   if (oriented) {
     return fromSpec(h >= w ? oriented.portrait : oriented.landscape, w, h);
   }
   if (layout === "picture-bottom" /* PictureBottom */) {
-    return bottom(w, h);
+    return bottom(w, h, BOTTOM_PICTURE_W - give);
   }
-  const g = side(w, h, PICTURE_SIDE[layout] ?? [0.6, 0.42]);
+  const g = side(w, h, PICTURE_SIDE[layout] ?? DEFAULT_SIDE);
   if (layout !== "picture-left" /* PictureLeft */) {
     return g;
   }
   return { header: mirror(g.header, w), body: mirror(g.body, w), picture: mirror(g.picture, w), alignX: 1 - g.alignX };
 }
-function placeContain(image, region, anchor, alignX, scale) {
+function placeContain(image, region, fit) {
+  const { anchor, alignX, scale } = fit;
   const s = Math.min(region.w / image.width, region.h / image.height) * scale;
   const w = Math.floor(image.width * s);
   const h = Math.floor(image.height * s);
@@ -494,6 +429,97 @@ function placeContain(image, region, anchor, alignX, scale) {
   };
 }
 
+// src/layout/blockGroups.ts
+var BOLD = 700;
+var SEMI = 600;
+var MEDIUM = 500;
+var SCRIPT = 400;
+var SIZE = {
+  title: 250,
+  headerScript: 120,
+  itemDate: 67,
+  itemRow: 42,
+  scheduleLabel: 66,
+  scheduleTime: 60,
+  priceAmount: 66,
+  priceLabel: 52,
+  listPrice: 58,
+  flankAmount: 110,
+  flankLabel: 48,
+  venue: 58,
+  listVenue: 48,
+  small: 38
+};
+var GAP = {
+  item: 48,
+  row: 30,
+  venue: 40,
+  includes: 24,
+  rule: 8
+};
+var makers = (p, u) => ({
+  display: (text2, size) => ({ text: text2, role: "display", weight: BOLD, size: size * u, color: p.title }),
+  venue: (text2, size) => ({ text: text2, role: "display", weight: MEDIUM, size: size * u, color: p.ink }),
+  script: (text2, size) => ({ text: text2, role: "script", weight: SCRIPT, size: size * u, color: p.accent }),
+  strong: (text2, size) => ({ text: text2, role: "body", weight: BOLD, size: size * u, color: p.ink }),
+  accent: (text2, size) => ({ text: text2, role: "body", weight: SEMI, size: size * u, color: p.accent }),
+  item: (text2, size) => ({ text: text2, role: "body", weight: SEMI, size: size * u, color: p.ink, bullet: p.accent }),
+  soft: (text2, size) => ({ text: text2, role: "body", weight: MEDIUM, size: size * u, color: p.soft })
+});
+function headerGroups(doc, p, u) {
+  const l = makers(p, u);
+  const b = doc.blocks;
+  const lines = [l.display(b.title, SIZE.title), b.script ? l.script(b.script, SIZE.headerScript) : void 0, b.titleBottom ? l.display(b.titleBottom, SIZE.title) : void 0];
+  return [{ lines: lines.filter((x) => x !== void 0), gapAfter: 0 }];
+}
+function itemGroup(item, l, u) {
+  const lines = [l.script(item.date, SIZE.itemDate)];
+  item.schedule.forEach((row) => lines.push(l.strong(`${row.label}  ${row.time}`, SIZE.itemRow)));
+  if (item.price) {
+    lines.push(l.accent(item.price, SIZE.itemRow));
+  }
+  return { lines, gapAfter: GAP.item * u };
+}
+function eventGroups(doc, l, u, withPrices) {
+  const b = doc.blocks;
+  const groups = [];
+  b.schedule?.forEach((row) => groups.push({ lines: [l.strong(row.label, SIZE.scheduleLabel), l.accent(row.time, SIZE.scheduleTime)], gapAfter: GAP.row * u }));
+  const prices = (withPrices ? b.prices : void 0) ?? [];
+  prices.forEach((row, i) => groups.push({ lines: [l.strong(row.amount, SIZE.priceAmount), l.accent(row.label, SIZE.priceLabel)], gapAfter: GAP.row * u, keepWithNext: i < prices.length - 1 }));
+  return groups;
+}
+function listGroups(doc, l, u) {
+  const groups = (doc.items ?? []).map((item) => itemGroup(item, l, u));
+  const prices = doc.blocks.prices?.map((row) => l.strong(`${row.amount} ${row.label}`, SIZE.listPrice)) ?? [];
+  if (prices.length > 0) {
+    groups.push({ lines: prices, gapAfter: GAP.row * u });
+  }
+  return groups;
+}
+function flankPriceGroups(doc, p, u) {
+  const l = makers(p, u);
+  return (doc.blocks.prices ?? []).map((row) => ({ lines: [l.strong(row.amount, SIZE.flankAmount), l.accent(row.label, SIZE.flankLabel)], gapAfter: GAP.row * u }));
+}
+function bodyGroups(doc, p, u, withPrices = true) {
+  const l = makers(p, u);
+  const b = doc.blocks;
+  const groups = [];
+  const isList = doc.layout === "list" /* List */;
+  if (b.venue) {
+    const size = isList ? SIZE.listVenue : SIZE.venue;
+    groups.push({ lines: b.venue.map((v) => l.venue(v, size)), gapAfter: GAP.venue * u, rule: { color: p.accent, height: GAP.rule * u }, ruleBelow: true, icon: { color: p.accent, glyph: p.background } });
+  }
+  groups.push(...isList ? listGroups(doc, l, u) : eventGroups(doc, l, u, withPrices));
+  if (b.includes) {
+    const lines = [l.accent(b.includes.heading, SIZE.small), ...b.includes.items.map((i) => l.item(i, SIZE.small))];
+    groups.push({ lines, gapAfter: GAP.includes * u, uniform: true });
+  }
+  if (b.footer) {
+    groups.push({ lines: [l.soft(b.footer, SIZE.small)], gapAfter: 0 });
+  }
+  return groups;
+}
+
 // src/layout/textFlow.ts
 var LINE_HEIGHT = 1.2;
 var BULLET_INDENT = 1.1;
@@ -501,6 +527,9 @@ var BULLET_RADIUS = 0.2;
 var RULE_GAP = 2.5;
 var RULE_WIDTH = 0.9;
 var WIDE = 1.6;
+var COLUMN_GAP = 0.04;
+var TWO_COLUMN_MIN = 0.75;
+var TWO_COLUMN_GAIN = 1.15;
 var MIN_K = 0.02;
 var STEPS = 22;
 var ICON_SCALE = 1.6;
@@ -521,15 +550,17 @@ function groupRatio(m, k, avail) {
   }
   return Math.min(...m.group.lines.map((line, i) => lineSize(line, m.widths[i] ?? 1, k, avail) / line.size));
 }
-function placeIcon(group, d, x, textTop, textBottom, out) {
+function placeIcon(group, box, out) {
+  const { d, x, top, bottom: bottom2 } = box;
   if (!group.icon || d <= 0) {
-    return textBottom;
+    return bottom2;
   }
-  const textH = textBottom - textTop;
-  out?.icons.push({ rect: { x, y: textTop + Math.max(0, (textH - d) / 2), w: d, h: d }, color: group.icon.color, glyph: group.icon.glyph });
-  return textTop + Math.max(textH, d);
+  const textH = bottom2 - top;
+  out?.icons.push({ rect: { x, y: top + Math.max(0, (textH - d) / 2), w: d, h: d }, color: group.icon.color, glyph: group.icon.glyph });
+  return top + Math.max(textH, d);
 }
-function placeGroup(m, k, col, y0, out) {
+function placeGroup(m, at, out) {
+  const { k, col, y0 } = at;
   const { group } = m;
   let y = y0;
   if (group.rule) {
@@ -554,7 +585,7 @@ function placeGroup(m, k, col, y0, out) {
     }
     y += size * LINE_HEIGHT;
   });
-  y = placeIcon(group, d, col.x + pad, top + pad, y, out);
+  y = placeIcon(group, { d, x: col.x + pad, top: top + pad, bottom: y }, out);
   y += pad;
   if (group.rule && group.ruleBelow) {
     y += group.rule.height * k * (RULE_GAP - 1);
@@ -566,10 +597,11 @@ function placeGroup(m, k, col, y0, out) {
   }
   return y + group.gapAfter * k - y0;
 }
-function placeColumn(groups, k, col, out, spread = 0) {
+function placeColumn(groups, at, out) {
+  const { k, col, spread = 0 } = at;
   let h = 0;
   for (const g of groups) {
-    h += placeGroup(g, k, col, col.y + h, out) + spread;
+    h += placeGroup(g, { k, col, y0: col.y + h }, out) + spread;
   }
   return h - spread;
 }
@@ -596,12 +628,9 @@ function keepTogether(groups, heights, cut) {
   return candidates.reduce((best, c) => tallest(heights, c) < tallest(heights, best) ? c : best);
 }
 function splitColumns(groups, zone) {
-  if (zone.w / Math.max(zone.h, 1) <= WIDE || groups.length < 2) {
-    return [{ col: zone, groups }];
-  }
-  const gap = Math.round(zone.w * 0.04);
+  const gap = Math.round(zone.w * COLUMN_GAP);
   const w = (zone.w - gap) / 2;
-  const heights = groups.map((g) => placeGroup(g, 1, { ...zone, w }, 0, null));
+  const heights = groups.map((g) => placeGroup(g, { k: 1, col: { ...zone, w }, y0: 0 }, null));
   const total = columnSum(heights, 0, heights.length);
   let cut = 1;
   for (let c = 2; c < groups.length; c++) {
@@ -615,16 +644,8 @@ function splitColumns(groups, zone) {
     { col: { ...zone, x: zone.x + w + gap, w }, groups: groups.slice(cut) }
   ];
 }
-function flow(ctx, groups, zone, fonts) {
-  const measured = groups.map((group) => ({
-    group,
-    widths: group.lines.map((line) => {
-      ctx.font = fontOf(line, line.size, fonts);
-      return ctx.measureText(line.text).width;
-    })
-  }));
-  const columns = splitColumns(measured, zone);
-  const fits = (k) => columns.every((c) => placeColumn(c.groups, k, c.col, null) <= zone.h);
+function largestK(columns, zoneH) {
+  const fits = (k) => columns.every((c) => placeColumn(c.groups, { k, col: c.col }, null) <= zoneH);
   let lo = MIN_K;
   let hi = 1;
   if (fits(1)) {
@@ -638,10 +659,32 @@ function flow(ctx, groups, zone, fonts) {
       hi = mid;
     }
   }
+  return lo;
+}
+function bestColumns(measured, zone) {
+  const single = [{ col: zone, groups: measured }];
+  const k1 = largestK(single, zone.h);
+  if (measured.length < 2 || zone.w / Math.max(zone.h, 1) < TWO_COLUMN_MIN) {
+    return { columns: single, k: k1 };
+  }
+  const split = splitColumns(measured, zone);
+  const k2 = largestK(split, zone.h);
+  const forced = zone.w / Math.max(zone.h, 1) > WIDE;
+  return forced || k2 > k1 * TWO_COLUMN_GAIN ? { columns: split, k: k2 } : { columns: single, k: k1 };
+}
+function flow(ctx, groups, zone, fonts) {
+  const measured = groups.map((group) => ({
+    group,
+    widths: group.lines.map((line) => {
+      ctx.font = fontOf(line, line.size, fonts);
+      return ctx.measureText(line.text).width;
+    })
+  }));
+  const { columns, k: lo } = bestColumns(measured, zone);
   const out = emptyFlow();
-  const heights = columns.map((c) => placeColumn(c.groups, lo, c.col, null));
+  const heights = columns.map((c) => placeColumn(c.groups, { k: lo, col: c.col }, null));
   const end = Math.max(...heights);
-  columns.forEach((c, i) => placeColumn(c.groups, lo, c.col, out, c.groups.length > 1 && columns.length > 1 ? (end - (heights[i] ?? end)) / (c.groups.length - 1) : 0));
+  columns.forEach((c, i) => placeColumn(c.groups, { k: lo, col: c.col, spread: c.groups.length > 1 && columns.length > 1 ? (end - (heights[i] ?? end)) / (c.groups.length - 1) : 0 }, out));
   const lines = groups.flatMap((g) => g.lines);
   out.texts.forEach((t, i) => {
     const line = lines[i];
@@ -659,36 +702,99 @@ function flowFlanks(ctx, groups, flanks, fonts) {
 }
 function smallestPerLine(groups, results) {
   const sizes = results.flatMap((r3) => r3.texts.map((t) => t.box.h / LINE_HEIGHT2));
-  const smallest = [];
+  const smallest2 = [];
   let i = 0;
   groups.forEach(
     (g) => g.lines.forEach((_line, j) => {
-      smallest[j] = Math.min(smallest[j] ?? Infinity, sizes[i] ?? Infinity);
+      smallest2[j] = Math.min(smallest2[j] ?? Infinity, sizes[i] ?? Infinity);
       i++;
     })
   );
-  return smallest;
+  return smallest2;
 }
 function equalFlanks(ctx, groups, flanks, fonts) {
-  const smallest = smallestPerLine(groups, flowFlanks(ctx, groups, flanks, fonts));
-  const sized = groups.map((g) => ({ ...g, lines: g.lines.map((line, j) => ({ ...line, size: Math.min(line.size, smallest[j] ?? line.size) })) }));
+  const smallest2 = smallestPerLine(groups, flowFlanks(ctx, groups, flanks, fonts));
+  const sized = groups.map((g) => ({ ...g, lines: g.lines.map((line, j) => ({ ...line, size: Math.min(line.size, smallest2[j] ?? line.size) })) }));
   return flowFlanks(ctx, sized, flanks, fonts);
 }
 function measuredEnd(f, fallback) {
   const bottoms = [...f.texts.map((t) => t.box), ...f.rules.map((r3) => r3.rect), ...f.icons.map((i) => i.rect)].map((r3) => r3.y + r3.h);
   return bottoms.length > 0 ? Math.max(...bottoms) : fallback;
 }
-function pictureRegion(layout, geo, body, u, frame) {
+function pictureRegion(layout, geo, body, frame) {
   if (layout !== "picture-bottom" /* PictureBottom */) {
     return geo.picture;
   }
-  const y = Math.min(geo.picture.y, Math.ceil(measuredEnd(body, geo.body.y) + BODY_GAP * u));
+  const y = Math.min(geo.picture.y, Math.ceil(measuredEnd(body, geo.body.y) + BODY_GAP * frame.u));
   return { x: geo.picture.x, y, w: geo.picture.w, h: frame.height - y };
 }
 
-// src/render/render.ts
+// src/render/yieldToText.ts
+function yieldToText(geo, give) {
+  const { picture: p, body: b } = geo;
+  if (give <= 0) {
+    return geo;
+  }
+  if (p.x >= b.x + b.w) {
+    const d = Math.round(p.w * give);
+    return { ...geo, picture: { ...p, x: p.x + d, w: p.w - d }, body: { ...b, w: b.w + d } };
+  }
+  if (p.x + p.w <= b.x) {
+    const d = Math.round(p.w * give);
+    return { ...geo, picture: { ...p, w: p.w - d }, body: { ...b, x: b.x - d, w: b.w + d } };
+  }
+  if (p.y >= b.y + b.h) {
+    const d = Math.round(p.h * give);
+    const stacked = geo.header.y + geo.header.h <= b.y;
+    const toHeader = stacked ? Math.round(d / 2) : 0;
+    return {
+      ...geo,
+      header: { ...geo.header, h: geo.header.h + toHeader },
+      picture: { ...p, y: p.y + d, h: p.h - d },
+      body: { ...b, y: b.y + toHeader, h: b.h + d - toHeader },
+      flanks: geo.flanks?.map((f) => ({ ...f, y: f.y + d, h: f.h - d }))
+    };
+  }
+  return geo;
+}
+
+// src/render/fitToFloor.ts
+var FLOOR_PX = 30;
 var BASE = 1080;
+var LINE_HEIGHT3 = 1.2;
 var LOGO_SHARE = 0.26;
+var GIVE_STEP = 0.025;
+var GIVE_STEPS = 32;
+function splitHeader(header, hasLogo) {
+  const logoW = hasLogo ? Math.round(header.w * LOGO_SHARE) : 0;
+  return { text: { ...header, w: header.w - logoW * 1.1 }, logo: { ...header, x: header.x + header.w - logoW, w: logoW } };
+}
+function flowAll(ctx, input, geo, u) {
+  const { doc, palette, fonts } = input;
+  const zones = geo.logo ? { text: geo.header, logo: geo.logo } : splitHeader(geo.header, doc.logo !== void 0);
+  const head = flow(ctx, headerGroups(doc, palette, u), zones.text, fonts);
+  const flanks = geo.flanks ?? [];
+  const body = flow(ctx, bodyGroups(doc, palette, u, flanks.length === 0), geo.body, fonts);
+  const sides = flanks.length > 0 ? equalFlanks(ctx, flankPriceGroups(doc, palette, u), flanks, fonts) : [emptyFlow()];
+  return { geo, zones, head, body, sides };
+}
+var smallest = (t) => Math.min(Infinity, ...[t.head, t.body, ...t.sides].flatMap((f) => f.texts.map((x) => x.box.h / LINE_HEIGHT3)));
+function geometryWithGive(layout, width, height, give) {
+  return layout === "picture-bottom" /* PictureBottom */ ? geometry(layout, width, height, give) : yieldToText(geometry(layout, width, height), give);
+}
+function fitToFloor(ctx, input) {
+  const { doc, width, height } = input;
+  const u = Math.min(width, height) / BASE;
+  const floor = FLOOR_PX * u;
+  let fitted = flowAll(ctx, input, geometryWithGive(doc.layout, width, height, 0), u);
+  for (let step = 1; step <= GIVE_STEPS && smallest(fitted) < floor; step++) {
+    fitted = flowAll(ctx, input, geometryWithGive(doc.layout, width, height, step * GIVE_STEP), u);
+  }
+  return fitted;
+}
+
+// src/render/render.ts
+var BASE2 = 1080;
 var CARD_RADIUS = 0.035;
 var CAP_TOP = 0.15;
 var PIN_HEAD_Y = 0.08;
@@ -783,10 +889,6 @@ function capAligned(zone, head) {
   const shift = first ? Math.min(Math.max(0, Math.round(first.y + first.h * CAP_TOP) - zone.y), Math.round(zone.h / 2)) : 0;
   return { ...zone, y: zone.y + shift, h: zone.h - shift };
 }
-function splitHeader(header, hasLogo) {
-  const logoW = hasLogo ? Math.round(header.w * LOGO_SHARE) : 0;
-  return { text: { ...header, w: header.w - logoW * 1.1 }, logo: { ...header, x: header.x + header.w - logoW, w: logoW } };
-}
 function render(input, assets, canvas) {
   const doc = checked(input, assets);
   const { width, height } = FORMAT_SIZES[doc.format];
@@ -798,8 +900,8 @@ function render(input, assets, canvas) {
   }
   const palette = PALETTES[doc.palette];
   const fonts = FONT_SETS[doc.fonts];
-  const geo = geometry(doc.layout, width, height);
-  const u = Math.min(width, height) / BASE;
+  const u = Math.min(width, height) / BASE2;
+  const { geo, zones, head, body, sides } = fitToFloor(ctx, { doc, palette, fonts, width, height });
   ctx.globalAlpha = 1;
   ctx.fillStyle = palette.background;
   ctx.fillRect(0, 0, width, height);
@@ -807,15 +909,10 @@ function render(input, assets, canvas) {
     ctx.fillStyle = palette.tint;
     [geo.header, geo.body].forEach((r3) => ctx.fillRect(r3.x, r3.y, r3.w, r3.h));
   }
-  const zones = geo.logo ? { text: geo.header, logo: geo.logo } : splitHeader(geo.header, doc.logo !== void 0);
-  const head = flow(ctx, headerGroups(doc, palette, u), zones.text, fonts);
-  const flanks = geo.flanks ?? [];
-  const body = flow(ctx, bodyGroups(doc, palette, u, flanks.length === 0), geo.body, fonts);
-  const sides = flanks.length > 0 ? equalFlanks(ctx, flankPriceGroups(doc, palette, u), flanks, fonts) : [emptyFlow()];
   const radius = Math.min(width, height) * CARD_RADIUS;
   [head, body, ...sides].forEach((f) => drawFlow(ctx, f, radius));
   const logoImage = doc.logo ? assets[doc.logo.imageId] : void 0;
-  const logo = logoImage ? placeContain(logoImage, geo.logo ? zones.logo : capAligned(zones.logo, head), "top" /* Top */, 1, 1) : null;
+  const logo = logoImage ? placeContain(logoImage, geo.logo ? zones.logo : capAligned(zones.logo, head), { anchor: "top" /* Top */, alignX: 1, scale: 1 }) : null;
   if (logoImage && logo) {
     ctx.drawImage(logoImage, logo.x, logo.y, logo.w, logo.h);
   }
@@ -824,8 +921,8 @@ function render(input, assets, canvas) {
   if (backdrop) {
     drawArch(ctx, backdrop, palette.arch);
   }
-  const region = pictureRegion(doc.layout, geo, body, u, { height });
-  const picture = image && doc.picture ? placeContain(image, region, doc.picture.anchor, geo.alignX, doc.picture.scale) : null;
+  const region = pictureRegion(doc.layout, geo, body, { height, u });
+  const picture = image && doc.picture ? placeContain(image, region, { anchor: doc.picture.anchor, alignX: geo.alignX, scale: doc.picture.scale }) : null;
   if (image && picture) {
     ctx.drawImage(image, picture.x, picture.y, picture.w, picture.h);
   }