@popcraft/kit 0.25.0 → 0.26.0

package/src/templates/print/holidays-christmas-church-newsletter.ts

@@ -0,0 +1,246 @@
+// A parish newsletter for Advent and Christmas, two sides of US Letter to print back to back and leave at the door.
+// Side one: a night-blue banner across the top with the star over the stable and the hills cut like a woodcut,
+// the masthead, the vicar's letter beside a box of every Christmas service, and the giving tree. Side two: the
+// month's diary, the Christmas Day lunch for neighbours who would otherwise eat alone, carol singing round the
+// streets, a children's corner and the notices. The banner and the second side's band run into the bleed; every
+// word sits inside the half-inch margin. Service times and diary dates are components, so a new row is one instance.
+
+import { Kit, preset } from '../kit'
+import { defineTemplate } from '../build'
+import { SERIF } from '../shared/type'
+import type { VectorPath } from '@/lib/document/types'
+import { disc, draw, rng, flame, flourishComponent, pine, polyP, rectPath, specksIn, starPath, type Drawn, type P } from '../themes/holidays-shared'
+
+const NAME = 'Christmas church newsletter'
+const W = 816, H = 1056, B = 12, M = 48
+
+const SERVICES = [
+  ['Sun 29 Nov', '10:00', 'Advent Sunday Eucharist, with the lighting of the first candle'],
+  ['Sun 13 Dec', '18:00', 'Nine Lessons and Carols by candlelight, with the choir'],
+  ['Sun 20 Dec', '16:00', 'Christingle for families, with oranges and candles'],
+  ['Thu 24 Dec', '16:00', 'Crib service. Come dressed as a shepherd, a sheep or a star'],
+  ['Thu 24 Dec', '23:30', 'Midnight Mass'],
+  ['Fri 25 Dec', '10:00', 'Christmas Day family communion (about 50 minutes)'],
+] as const
+
+const DIARY = [
+  ['Wed 2', 'Giving tree goes up in the porch: take a tag, bring the gift back by 13 Dec'],
+  ['Sat 5', 'Christmas fair, 10–2 in the hall. Cakes, books, a raffle and Santa'],
+  ['Tue 8', 'Wreath-making with the flower team, 7 pm, greenery and cookies provided'],
+  ['Fri 11', 'Riverside Elementary nativity in church, 2 pm (all welcome)'],
+  ['Sat 19', 'Carol singing round the streets, meet on the church steps at 5 pm'],
+  ['Mon 21', 'Hall decorated for Christmas Day lunch, 10 am, many hands needed'],
+  ['Sun 27', 'One said service at 10:00, then the hall is closed until 4 Jan'],
+] as const
+
+/** The night banner: rays from the star, the star, the stable's roof and the hills, cut like a woodcut. */
+function banner(w: number, top: number, h: number): Drawn[] {
+  const sx = w * 0.82, sy = top + h * 0.28
+  const rays: VectorPath[] = []
+  for (let i = 0; i < 16; i++) {
+    const a = (i * Math.PI) / 8, long = i === 4 ? h * 0.4 : i === 12 ? h * 0.6 : i % 4 === 0 ? h * 0.3 : h * 0.2
+    const p = (r: number, da: number): P => ({ x: sx + Math.cos(a + da) * r, y: sy + Math.sin(a + da) * r })
+    rays.push(polyP([p(8, -0.18), p(long, 0), p(8, 0.18)]))
+  }
+  const ground = top + h
+  const hills = (y: number, amp: number, phase: number) => polyP([{ x: -B, y: ground }, ...Array.from({ length: 21 }, (_, i) => ({ x: -B + ((w + 2 * B) * i) / 20, y: y + Math.sin(i * 0.55 + phase) * amp + Math.sin(i * 1.3 + phase) * amp * 0.3 })), { x: w + B, y: ground }])
+  // The stable: a low roof on posts, its door a warm square of light.
+  const st = { x: w * 0.82 - w * 0.065, y: ground - h * 0.3, w: w * 0.13 }
+  const stable = [polyP([{ x: st.x - 14, y: st.y }, { x: st.x + st.w / 2, y: st.y - h * 0.13 }, { x: st.x + st.w + 14, y: st.y }]), rectPath(st.x, st.y, st.w, h * 0.22)]
+  const door = [rectPath(st.x + st.w * 0.36, st.y + h * 0.06, st.w * 0.28, h * 0.16)]
+  const star = (list: number[][]) => list.map(([x, y], i) => starPath(w * x, top + h * y, i % 3 ? 3.2 : 5, i % 3 ? 1.3 : 2))
+  const trees = [0.08, 0.12, 0.9, 0.94].map((x, i) => polyP([{ x: w * x, y: ground - h * (0.36 + (i % 2) * 0.06) }, { x: w * x + 16, y: ground - h * 0.12 }, { x: w * x - 16, y: ground - h * 0.12 }]))
+  return [
+    { name: 'Night', paths: [rectPath(-B, -B, w + 2 * B, top + h + B - B)], color: 'night' },
+    { name: 'Rays', paths: rays, color: 'gold', o: { opacity: 0.85 } },
+    { name: 'Star', paths: [starPath(sx, sy, 20, 7, 8)], color: 'cream' },
+    { name: 'Stars', paths: star([[0.88, 0.18], [0.95, 0.46], [0.62, 0.1], [0.82, 0.6], [0.58, 0.5], [0.66, 0.66]]), color: 'cream', o: { opacity: 0.8 } },
+    { name: 'Stars', paths: star([[0.06, 0.05], [0.22, 0.07], [0.42, 0.04], [0.32, 0.09]]), color: 'cream', o: { opacity: 0.8 } },
+    { name: 'Stars', paths: star([[0.06, 0.6], [0.24, 0.56], [0.38, 0.62], [0.48, 0.54]]), color: 'cream', o: { opacity: 0.8 } },
+    { name: 'Far hills', paths: [hills(ground - h * 0.3, 10, 0.4)], color: 'hillFar' },
+    { name: 'Trees', paths: trees, color: 'hillNear' },
+    { name: 'Stable', paths: stable, color: 'hillNear' },
+    { name: 'Door light', paths: door, color: 'gold' },
+    { name: 'Near hills', paths: [hills(ground - h * 0.12, 7, 2.1)], color: 'hillNear' },
+  ]
+}
+
+/** An Advent wreath seen a little from above, centred on (cx, cy): the evergreen ring, three purple candles and a rose one, the white one in the middle, the first lit. */
+function wreath(cx: number, cy: number): Drawn[] {
+  const rx = 84, ry = 26
+  const ring = Array.from({ length: 22 }, (_, i) => {
+    const a = (i * 2 * Math.PI) / 22, p = { x: cx + Math.cos(a) * rx, y: cy + Math.sin(a) * ry }
+    return pine({ x: p.x - Math.sin(a) * 14, y: p.y + Math.cos(a) * 5 }, { x: p.x, y: p.y - 4 }, { x: p.x + Math.sin(a) * 16, y: p.y - Math.cos(a) * 6 }, { needle: 11, seed: 60 + i, density: 0.35 })
+  })
+  const candle = (a: number, hgt: number) => { const x = cx + Math.cos(a) * rx * 0.86, y = cy + Math.sin(a) * ry * 0.86; return { body: rectPath(x - 7, y - hgt, 14, hgt), x, top: y - hgt } }
+  const back = [candle(-Math.PI * 0.88, 56), candle(-Math.PI * 0.38, 54)], front = [candle(Math.PI * 0.62, 62), candle(Math.PI * 0.12, 60)]
+  const centre = { body: rectPath(cx - 8, cy - 86, 16, 86), x: cx, top: cy - 86 }
+  return [
+    { name: 'Wreath back', paths: ring.slice(11).flatMap(r => [...r.dark, ...r.light]), color: 'pine', o: { strokeWidth: 2 } },
+    { name: 'Candles back', paths: back.map(c => c.body), color: 'purple' },
+    { name: 'Christ candle', paths: [centre.body], color: 'wax', o: { stroke: { color: 'line', width: 1 } } },
+    { name: 'Wreath front', paths: ring.slice(0, 11).flatMap(r => [...r.dark, ...r.light]), color: 'pineLight', o: { strokeWidth: 2 } },
+    { name: 'Candles front', paths: [front[1].body], color: 'purple' },
+    { name: 'Rose candle', paths: [front[0].body], color: 'rose' },
+    { name: 'Berries', paths: [0.3, 1.1, 1.9, 2.6, 3.5, 4.4, 5.2].map(a => disc(cx + Math.cos(a) * rx, cy + Math.sin(a) * ry + 2, 3.2)), color: 'primary' },
+    { name: 'Flame', paths: [flame(front[1].x, front[1].top - 2, 10, 22)], color: 'gold' },
+  ]
+}
+
+/** Riverside at night: rooftops with snow on them and lit windows, the church's spire with its star, from `top` down past the trim. */
+function street(w: number, top: number, h: number): Drawn[] {
+  const r = rng(77)
+  const houses: VectorPath[] = [], snow: VectorPath[] = [], windows: VectorPath[] = []
+  let x = -B
+  while (x < w + B) {
+    const hw = 70 + r() * 60, hh = h * (0.32 + r() * 0.16), roof = 26 + r() * 22, y = top + h - hh
+    if (Math.abs(x + hw / 2 - w * 0.5) < 80) { x += 90; continue }
+    houses.push(polyP([{ x, y: top + h + B }, { x, y }, { x: x + hw / 2, y: y - roof }, { x: x + hw, y }, { x: x + hw, y: top + h + B }]))
+    snow.push(polyP([{ x: x - 4, y: y + 2 }, { x: x + hw / 2, y: y - roof - 3 }, { x: x + hw + 4, y: y + 2 }, { x: x + hw / 2, y: y - roof + 6 }]))
+    for (let i = 0; i < 2; i++) if (r() > 0.3) windows.push(rectPath(x + hw * (0.22 + i * 0.36), y + hh * 0.22, hw * 0.18, hw * 0.2))
+    x += hw + 6 + r() * 10
+  }
+  const cx = w * 0.5, base = top + h + B
+  const church = [rectPath(cx - 70, top + h * 0.42, 140, h * 0.58 + B), polyP([{ x: cx - 80, y: top + h * 0.43 }, { x: cx, y: top + h * 0.2 }, { x: cx + 80, y: top + h * 0.43 }]), rectPath(cx - 20, top - h * 0.02, 40, h * 0.5), polyP([{ x: cx - 24, y: top }, { x: cx, y: top - h * 0.3 }, { x: cx + 24, y: top }])]
+  const glass = [{ closed: true, points: [{ x: cx - 16, y: base - B - 10 }, { x: cx - 16, y: top + h * 0.62 }, { x: cx, y: top + h * 0.52 }, { x: cx + 16, y: top + h * 0.62 }, { x: cx + 16, y: base - B - 10 }] } as VectorPath, rectPath(cx - 6, top + h * 0.04, 12, 22)]
+  return [
+    { name: 'Street sky', paths: [rectPath(-B, top - h * 0.36, w + 2 * B, h * 1.36 + B)], color: 'night' },
+    { name: 'Street stars', paths: [0.6, 0.7, 0.8, 0.9, 0.96].map((f, i) => starPath(w * f, top - h * (0.22 - (i % 2) * 0.1), 4, 1.6)), color: 'cream', o: { opacity: 0.8 } },
+    { name: 'Spire star', paths: [starPath(cx, top - h * 0.36 + 2, 9, 3.4, 8)], color: 'gold' },
+    { name: 'Houses', paths: houses, color: 'hillFar' },
+    { name: 'Roof snow', paths: snow, color: 'cream', o: { opacity: 0.85 } },
+    { name: 'Windows', paths: windows, color: 'gold' },
+    { name: 'Church', paths: church, color: 'hillNear' },
+    { name: 'Church windows', paths: glass, color: 'gold' },
+  ]
+}
+
+export default defineTemplate({
+  id: 'print-holidays-christmas-church-newsletter',
+  meta: {
+    name: NAME,
+    description: 'A two-sided parish newsletter for Advent and Christmas on US Letter: a woodcut night banner of the star over the stable, the vicar’s letter beside every Christmas service, the giving tree, the month’s diary, a Christmas Day lunch for neighbours, carol singing, a children’s corner and notices. Service times and diary dates are components; the banner runs into the bleed',
+    category: 'newspaper', tags: ['christmas', 'advent', 'church', 'parish', 'newsletter', 'services', 'carols', 'nativity', 'community', 'congregation', 'bulletin', 'print'],
+    platforms: ['print'], formats: ['document'], useCases: ['newsletter', 'event'],
+    created: '2026-10-10', updated: '2026-10-10',
+  },
+  sequence: true,
+  stableNumbers: true,
+  build() {
+    const k = new Kit(NAME, preset('us-letter'))
+    k.quantizeGeometry = true
+    k.brand(
+      { paper: '#F6F0E3', text: '#1D2433', onPaper: '#8C2B2B', primary: '#8C2B2B', onPrimary: '#FFF8EC', line: '#CBBFA6', card: '#EDE3CF', onCard: '#1D2433' },
+      { name: 'St Columba’s, Riverside', site: 'stcolumbariverside.org', phone: '(503) 555-0172' },
+    )
+    k.palette({ wax: '#FFFDF6', purple: '#5B3A7A', rose: '#D88FA6', pine: '#2F5A43', pineLight: '#4F7D5E', night: '#18233A', gold: '#E2B95A', cream: '#FFF8EC', hillFar: '#2A3A5A', hillNear: '#0F1626', tint: '#EDE3CF', fibre: '#B9A984' })
+    k.textStyle('Mast 64', { ...SERIF, size: 64, fontWeight: 700, letterSpacing: -1.6, lineHeight: 64 })
+    k.textStyle('Mast sub 12', { size: 12, fontWeight: 600, letterSpacing: 2.4, lineHeight: 16 })
+    k.textStyle('Parish 17', { ...SERIF, size: 17, fontWeight: 400, fontStyle: 'italic', lineHeight: 22 })
+    k.textStyle('Head 24', { ...SERIF, size: 24, fontWeight: 700, letterSpacing: -0.3, lineHeight: 28 })
+    k.textStyle('Head 18', { ...SERIF, size: 18, fontWeight: 700, lineHeight: 22 })
+    k.textStyle('Kicker 10', { size: 10, fontWeight: 700, letterSpacing: 2, lineHeight: 14 })
+    k.textStyle('Body 12', { ...SERIF, size: 12, fontWeight: 400, lineHeight: 17.5 })
+    k.textStyle('Body i 12', { ...SERIF, size: 12, fontWeight: 400, fontStyle: 'italic', lineHeight: 17.5 })
+    k.textStyle('Row 11', { size: 11, fontWeight: 600, lineHeight: 15, fontFeatures: { tnum: 1 } })
+    k.textStyle('Row text 11', { ...SERIF, size: 11.5, fontWeight: 400, lineHeight: 15 })
+    k.textStyle('Foot 10', { size: 10, fontWeight: 500, letterSpacing: 0.6, lineHeight: 14 })
+
+    flourishComponent(k, 'Star rule', 'primary', starPath(0, 0, 10, 4.2), { rule: 40 })
+    // A service: day, time, and what it is.
+    k.component('Service', { direction: 'HORIZONTAL', gap: 10, width: 300, padding: { top: 7, right: 0, bottom: 7, left: 0 }, props: { Day: 'Sun 1 Dec', Time: '10:00', What: 'Service' } }, id => {
+      const when = k.stack(id, { width: 74, gap: 1, name: 'When' })
+      k.propText(when, 'Day', { style: 'Row 11', color: 'onCard', name: 'Day' })
+      k.propText(when, 'Time', { style: 'Row 11', color: 'onCard', name: 'Time' })
+      k.propText(id, 'What', { style: 'Row text 11', color: 'onCard', width: 'FILL', name: 'What' })
+    })
+    // A diary date.
+    k.component('Diary date', { direction: 'HORIZONTAL', gap: 12, width: 440, padding: { top: 6, right: 0, bottom: 6, left: 0 }, props: { Date: 'Mon 1', What: 'What is on' } }, id => {
+      k.propText(id, 'Date', { style: 'Row 11', color: 'onPaper', width: 52, name: 'Date' } as never)
+      k.propText(id, 'What', { style: 'Row text 11', color: 'text', width: 'FILL', name: 'What' })
+    })
+    const sectionHead = (parent: string, kicker: string, title: string, style = 'Head 24', on: 'paper' | 'card' = 'paper') => {
+      k.text(parent, kicker, { style: 'Kicker 10', color: on === 'card' ? 'onCard' : 'onPaper', width: 'FILL', name: 'Kicker' })
+      k.text(parent, title, { style, color: on === 'card' ? 'onCard' : 'text', width: 'FILL', name: 'Heading' })
+    }
+
+    // ── Side one ──
+    const one = k.sheet
+    k.nameSheet(one, 'Side one')
+    const BANNER = 300
+    k.flowSheet(one, 18, { top: 36, right: M, bottom: M, left: M }, 'paper', 'MIN', 'MIN')
+    draw(k, one, banner(W, 0, BANNER))
+    const mast = k.stack(one, { width: 'FILL', height: BANNER - 36, gap: 6, name: 'Masthead' })
+    k.text(mast, 'ADVENT & CHRISTMAS 2026 · ISSUE 48', { style: 'Mast sub 12', color: 'gold', autoWidth: true, name: 'Issue' })
+    k.text(mast, 'The Lamplighter', { style: 'Mast 64', color: 'cream', autoWidth: true, name: 'Title' })
+    k.text(mast, 'News and services from {{brand.name}}', { style: 'Parish 17', color: 'cream', autoWidth: true, name: 'Parish' })
+    const cols = k.stack(one, { direction: 'HORIZONTAL', gap: 30, width: 'FILL', name: 'Columns' })
+    const left = k.stack(cols, { width: 'FILL', gap: 10, name: 'Letter' })
+    sectionHead(left, 'FROM THE RECTORY', 'Make room')
+    for (const [i, p] of [
+      'Every year somebody asks me why we bother with Advent when the shops have had Christmas since Halloween. My answer is that Advent is the season of making room: in the diary, in the house, in ourselves, for a child who arrived to a town with no space for him.',
+      'This December, I want to ask each of us to make a little room for someone else. Take a tag from the giving tree. Bring a neighbour to the carol service, especially one who has not set foot in church since their own school nativity. Come and peel potatoes on Christmas morning, and stay for lunch.',
+      'The candle we light on Advent Sunday is small. By Christmas there are five, and the church is full of light. That is how it works: one at a time, and together. I look forward to seeing you, and to meeting whoever you bring.',
+    ].entries()) k.text(left, p, { style: i === 2 ? 'Body 12' : 'Body 12', color: 'text', width: 'FILL', name: 'Paragraph' })
+    k.text(left, 'The Rev. Ruth Adeyemi, Rector', { style: 'Body i 12', color: 'text', width: 'FILL', name: 'Signature' })
+    k.instance(left, 'Star rule', {}, { name: 'Divider' })
+    sectionHead(left, 'THE GIVING TREE', 'Two hundred tags, two hundred gifts', 'Head 18')
+    k.text(left, 'Each tag on the tree in the porch names a gift asked for by a family the Riverside Food Bank supports: a winter coat, a football, a set of felt-tips. Take a tag, wrap the gift, tie the tag on, and bring it back by Sunday 13 December. Last year all 184 went.', { style: 'Body 12', color: 'text', width: 'FILL', name: 'Paragraph' })
+
+    const right = k.stack(cols, { width: 300, gap: 4, padding: 18, fill: 'card', name: 'Services box' })
+    sectionHead(right, 'COME AND CELEBRATE', 'Christmas services', 'Head 18', 'card')
+    k.stack(right, { height: 4, name: 'Gap' })
+    for (const [day, time, what] of SERVICES) {
+      k.instance(right, 'Service', { Day: day, Time: time, What: what }, { name: 'Service', width: 'FILL' })
+      k.rect(right, 'FILL', 1, 'line', { name: 'Hairline' })
+    }
+    k.stack(right, { height: 6, name: 'Gap' })
+    k.text(right, 'Every service has a step-free way in by the north door, a loop for hearing aids and large-print sheets. Children are always welcome, noise and all.', { style: 'Body i 12', color: 'onCard', width: 'FILL', name: 'Access' })
+
+    // The Advent wreath: the first candle lit, and what each one stands for.
+    const wr = k.stack(one, { direction: 'HORIZONTAL', gap: 26, width: 'FILL', padding: { top: 16, right: 20, bottom: 16, left: 12 }, align: 'CENTER', stroke: { color: 'line', width: 1 }, name: 'Wreath feature' })
+    const wa = k.stack(wr, { width: 210, height: 150, name: 'Wreath art' })
+    draw(k, wa, wreath(105, 112))
+    const wt = k.stack(wr, { width: 'FILL', gap: 6, name: 'Wreath text' })
+    k.text(wt, 'THE ADVENT WREATH', { style: 'Kicker 10', color: 'onPaper', width: 'FILL', name: 'Kicker' })
+    k.text(wt, 'One more candle each Sunday', { style: 'Head 18', color: 'text', width: 'FILL', name: 'Heading' })
+    k.text(wt, 'Hope on 29 November, peace on 6 December, joy on the 13th (the rose-pink one), love on the 20th, and the white Christ candle in the middle at midnight on Christmas Eve. Children who would like to light one, see the sacristan before the service.', { style: 'Body 12', color: 'text', width: 'FILL', name: 'Paragraph' })
+
+    // ── Side two ──
+    const two = k.addSheet(preset('us-letter'), 'Side two')
+    k.flowSheet(two, 18, { top: 76, right: M, bottom: M, left: M }, 'paper', 'MIN', 'MIN')
+    draw(k, two, [
+      { name: 'Band', paths: [rectPath(-B, -B, W + 2 * B, 40 + B)], color: 'night' },
+      { name: 'Band stars', paths: [0.1, 0.3, 0.5, 0.7, 0.9].map(x => starPath(W * x, 20, 6, 2.4, 8)), color: 'gold' },
+      ...[0, 1].map(i => ({ name: 'Fibre', paths: specksIn({ x: -B, y: 940 + i * 60, w: W + 2 * B, h: 60 }, 900, 30 + i, 1.6), color: 'fibre', o: { opacity: 0.4 } })),
+    ])
+    const row = k.stack(two, { direction: 'HORIZONTAL', gap: 30, width: 'FILL', name: 'Columns' })
+    const diary = k.stack(row, { width: 'FILL', gap: 2, name: 'Diary' })
+    sectionHead(diary, 'DECEMBER AT ST COLUMBA’S', 'Diary')
+    k.stack(diary, { height: 6, name: 'Gap' })
+    for (const [d, what] of DIARY) { k.instance(diary, 'Diary date', { Date: d, What: what }, { name: 'Diary date', width: 'FILL' }); k.rect(diary, 'FILL', 1, 'line', { name: 'Hairline' }) }
+    const side = k.stack(row, { width: 250, gap: 10, padding: 18, fill: 'primary', name: 'Lunch box' })
+    k.text(side, 'CHRISTMAS DAY', { style: 'Kicker 10', color: 'onPrimary', width: 'FILL', name: 'Kicker' })
+    k.text(side, 'Lunch for anyone on their own', { style: 'Head 18', color: 'onPrimary', width: 'FILL', name: 'Heading' })
+    k.text(side, 'Turkey or nut roast with everything, pie, crackers and carols round the tree, in the hall from 12:30. It is free, and there is a lift there and back. Tell Margaret by 18 December, or tell us about a neighbour and we will ask them.', { style: 'Body 12', color: 'onPrimary', width: 'FILL', name: 'Paragraph' })
+    k.text(side, 'Margaret Holt · (503) 555-0139', { style: 'Row 11', color: 'onPrimary', width: 'FILL', name: 'Contact' })
+
+    k.instance(two, 'Star rule', {}, { name: 'Divider' })
+    const row2 = k.stack(two, { direction: 'HORIZONTAL', gap: 30, width: 'FILL', name: 'Columns' })
+    const carols = k.stack(row2, { width: 'FILL', gap: 8, name: 'Carols' })
+    sectionHead(carols, 'SATURDAY 19 DECEMBER', 'Carols round Riverside', 'Head 18')
+    k.text(carols, 'We sing our way down Alder Street to the care home on Birch Lane, where the residents choose the next three. Torches and tambourines welcome. Collecting for the Riverside Food Bank; hot chocolate in the hall afterwards.', { style: 'Body 12', color: 'text', width: 'FILL', name: 'Paragraph' })
+    const kids = k.stack(row2, { width: 'FILL', gap: 8, name: 'Kids' })
+    sectionHead(kids, 'CHILDREN’S CORNER', 'Find the five stars', 'Head 18')
+    k.text(kids, 'Five paper stars are hiding in church this Advent, one on each Sunday. Find them all, tell Mrs. Okoro at the door, and collect a chocolate coin and a sticker for your Christingle.', { style: 'Body 12', color: 'text', width: 'FILL', name: 'Paragraph' })
+    const notices = k.stack(two, { width: 'FILL', gap: 6, padding: 16, fill: 'card', name: 'Notices' })
+    k.text(notices, 'NOTICES', { style: 'Kicker 10', color: 'onCard', width: 'FILL', name: 'Kicker' })
+    k.text(notices, 'The office is closed from 24 December to 4 January; for funerals and emergencies call the rectory. Flowers in memory of loved ones can be given for Christmas: $10 in an envelope marked with their name. The hall heating is fixed, thank you to all who gave.', { style: 'Body 12', color: 'onCard', width: 'FILL', name: 'Paragraph' })
+    // The street at night along the foot of the page, the church among the houses, and the footer on it.
+    draw(k, two, street(W, H - 250, 250))
+    const foot = k.stack(two, { width: 'FILL', height: 'FILL', justify: 'MAX', align: 'MIN', gap: 6, padding: { top: 0, right: 0, bottom: 150, left: 0 }, name: 'Foot' })
+    k.text(foot, 'All are welcome, whoever and wherever you are.', { style: 'Parish 17', color: 'cream', width: 320, name: 'Welcome' })
+    k.text(foot, '{{brand.name}} · 220 Alder Street, Portland OR 97202\n{{brand.phone}} · {{brand.site}}', { style: 'Foot 10', color: 'cream', width: 320, name: 'Footer' })
+    return k.finish()
+  },
+})

package/src/templates/print/holidays-christmas-eve-invitation.ts

@@ -0,0 +1,121 @@
+// A printed invitation to a family's Christmas Eve open house: gold and red baubles hang on threads from a pine
+// garland that runs off the top edge, over a deep forest-green card dusted with snow, and the invitation is set
+// below in a cream serif with gold small capitals, ending on a sprig of holly. 5 × 7 inches with the garland and
+// threads running into the eighth-inch bleed, and an A6 copy with the drawing worked out again at that size.
+
+import { Kit, preset } from '../kit'
+import { defineTemplate } from '../build'
+import { SERIF } from '../shared/type'
+import { bandsAround, bauble, disc, doubleRule, draw, flourishComponent, holly, perBand, pine, printVariant, snowflake, specksIn, sprig, starPath, type Drawn } from '../themes/holidays-shared'
+
+const NAME = 'Christmas Eve open house invitation'
+const PAD = { top: 292, right: 48, bottom: 84, left: 48 }
+
+/** The garland, baubles, snow and holly for a `w` × `h` card (a 480 px wide card is scale 1). */
+function art(w: number, h: number): Drawn[] {
+  const s = w / 480, B = 14 * s
+  const garland = [
+    pine({ x: -B - 10 * s, y: 18 * s }, { x: w * 0.25, y: 58 * s }, { x: w * 0.52, y: 26 * s }, { needle: 30 * s, seed: 3, density: 1.4 }),
+    pine({ x: w + B + 10 * s, y: 14 * s }, { x: w * 0.74, y: 62 * s }, { x: w * 0.46, y: 30 * s }, { needle: 30 * s, seed: 5, density: 1.4 }),
+    pine({ x: w * 0.3, y: -B - 6 * s }, { x: w * 0.4, y: 40 * s }, { x: w * 0.6, y: 18 * s }, { needle: 22 * s, seed: 9, density: 0.9 }),
+    pine({ x: -B, y: 50 * s }, { x: w * 0.12, y: 76 * s }, { x: w * 0.3, y: 54 * s }, { needle: 24 * s, seed: 12, density: 0.8 }),
+    pine({ x: w + B, y: 52 * s }, { x: w * 0.86, y: 80 * s }, { x: w * 0.68, y: 56 * s }, { needle: 24 * s, seed: 14, density: 0.8 }),
+  ]
+  // Red berries and gold beads caught in the garland.
+  const beads = [0.06, 0.2, 0.35, 0.5, 0.64, 0.8, 0.94].map((x, i) => disc(w * x, (44 + (i % 2 ? 14 : 2)) * s, (i % 3 ? 4.5 : 6) * s))
+  // Baubles on threads of different lengths, big and small, gold and red.
+  const hang: [number, number, number, 'gold' | 'red'][] = [[0.13, 70, 34, 'red'], [0.27, 128, 26, 'gold'], [0.42, 64, 22, 'gold'], [0.58, 150, 38, 'red'], [0.74, 82, 28, 'gold'], [0.88, 136, 22, 'red']]
+  const gold = hang.filter(b => b[3] === 'gold').map(([x, l, r]) => bauble(w * x, 30 * s, r * s, { string: l * s }))
+  const red = hang.filter(b => b[3] === 'red').map(([x, l, r]) => bauble(w * x, 30 * s, r * s, { string: l * s }))
+  const all = [...gold, ...red]
+  const flake = (list: number[][]) => list.flatMap(([x, y, r], i) => snowflake(w * x, h * y, r * s, i * 0.3))
+  const keep = { x: 40 * s, y: 286 * s, w: w - 80 * s, h: h - 330 * s }
+  const foot = h - 30 * s
+  const hl = [holly({ x: w / 2 - 6 * s, y: foot }, 50 * s, Math.PI + 0.12), holly({ x: w / 2 + 6 * s, y: foot }, 50 * s, -0.12), holly({ x: w / 2 - 4 * s, y: foot + 4 * s }, 36 * s, Math.PI - 0.45), holly({ x: w / 2 + 4 * s, y: foot + 4 * s }, 36 * s, 0.45)]
+  const berries = [disc(w / 2 - 7 * s, foot - 2 * s, 6 * s), disc(w / 2 + 7 * s, foot - 3 * s, 6 * s), disc(w / 2, foot + 7 * s, 6 * s)]
+  const mist = sprig({ x: -B, y: h * 0.99 }, { x: w * 0.02, y: h * 0.95 }, { x: w * 0.08, y: h * 0.955 }, { leaves: 5, size: 18 * s, seed: 2 })
+  const mist2 = sprig({ x: w + B, y: h * 0.99 }, { x: w * 0.98, y: h * 0.95 }, { x: w * 0.92, y: h * 0.955 }, { leaves: 5, size: 18 * s, seed: 4 })
+  return [
+    ...perBand('Snow', 'snow', bandsAround(w, h, keep, B), (b, i) => specksIn(b, 700 * s * s, 7 + i, 2.4 * s), { opacity: 0.35 }),
+    { name: 'Snowflakes', paths: flake([[0.05, 0.5, 9], [0.06, 0.74, 7]]), color: 'snow', o: { strokeWidth: 1.2 * s, opacity: 0.5 } },
+    { name: 'Snowflakes', paths: flake([[0.95, 0.56, 8], [0.94, 0.8, 10]]), color: 'snow', o: { strokeWidth: 1.2 * s, opacity: 0.5 } },
+    { name: 'Threads', paths: all.flatMap(b => b.string), color: 'gold', o: { strokeWidth: 1 * s, opacity: 0.9 } },
+    { name: 'Gold baubles', paths: gold.flatMap(b => b.body), color: 'gold' },
+    { name: 'Red baubles', paths: red.flatMap(b => b.body), color: 'red' },
+    { name: 'Bauble shade', paths: all.flatMap(b => b.shade), color: 'ink', o: { opacity: 0.22 } },
+    { name: 'Bauble bands', paths: all.flatMap(b => b.band), color: 'cream', o: { strokeWidth: 1.4 * s, opacity: 0.75 } },
+    { name: 'Bauble shine', paths: all.flatMap(b => b.shine), color: 'snow', o: { opacity: 0.55 } },
+    { name: 'Bauble caps', paths: all.flatMap(b => b.cap), color: 'goldDeep' },
+    { name: 'Pine stems', paths: garland.map(g => g.stem), color: 'bark', o: { strokeWidth: 2.4 * s } },
+    { name: 'Pine dark', paths: garland.flatMap(g => g.dark), color: 'pine', o: { strokeWidth: 2.2 * s } },
+    { name: 'Pine light', paths: garland.flatMap(g => g.light), color: 'pineLight', o: { strokeWidth: 2 * s } },
+    { name: 'Garland beads', paths: beads, color: 'red' },
+    { name: 'Frame', paths: doubleRule(w, h, 16 * s, 5 * s), color: 'gold', o: { strokeWidth: 0.8 * s, opacity: 0.7 } },
+    { name: 'Corner leaves', paths: mist.dark, color: 'pineLight', o: { opacity: 0.8 } },
+    { name: 'Corner leaves', paths: mist2.dark, color: 'pineLight', o: { opacity: 0.8 } },
+    { name: 'Holly', paths: hl, color: 'pineLight' },
+    { name: 'Holly berries', paths: berries, color: 'red' },
+  ]
+}
+
+export default defineTemplate({
+  id: 'print-holidays-christmas-eve-invitation',
+  meta: {
+    name: NAME,
+    description: 'A printed invitation to a family Christmas Eve open house: gold and red baubles hang from a pine garland over a forest-green card dusted with snow, with the invitation set below in a cream serif, gold small capitals and a sprig of holly. 5 × 7 inches with bleed, and an A6 copy',
+    category: 'invitation', tags: ['christmas', 'christmas eve', 'holiday party', 'open house', 'family', 'baubles', 'ornaments', 'pine', 'holly', 'invitation', 'print', 'card', 'winter'],
+    platforms: ['print'], formats: ['card'], useCases: ['invitation', 'event'],
+    created: '2026-10-10', updated: '2026-10-10',
+  },
+  stableNumbers: true,
+  build() {
+    const k = new Kit(NAME, preset('invitation-5x7'))
+    k.quantizeGeometry = true
+    k.brand(
+      { paper: '#163A2E', text: '#F8F0DE', onPaper: '#E2C47A', primary: '#B83A30', onPrimary: '#FFF6E8' },
+      { name: 'The Okafor family' },
+    )
+    k.palette({ gold: '#D8B356', goldDeep: '#9C7A2E', red: '#B83A30', cream: '#F8F0DE', pine: '#2D6247', pineLight: '#5E9470', bark: '#5A4632', snow: '#FFFFFF', ink: '#06140F' })
+    k.textStyle('Kicker 11', { size: 11, fontWeight: 600, letterSpacing: 3.6, lineHeight: 16 })
+    k.textStyle('Title 60', { ...SERIF, size: 60, fontWeight: 400, fontStyle: 'italic', letterSpacing: -1.4, lineHeight: 60 })
+    k.textStyle('Host 22', { ...SERIF, size: 22, fontWeight: 400, lineHeight: 28 })
+    k.textStyle('When 15', { ...SERIF, size: 15, fontWeight: 700, letterSpacing: 0.2, lineHeight: 21 })
+    k.textStyle('Body 12', { ...SERIF, size: 12, fontWeight: 400, lineHeight: 17 })
+    k.textStyle('Rsvp 10', { size: 10, fontWeight: 600, letterSpacing: 1.6, lineHeight: 15 })
+
+    const sheet = k.sheet
+    const { width: W, height: H } = k.node(sheet)
+    k.flowSheet(sheet, 0, PAD, 'paper', 'MIN', 'CENTER')
+    // A warm glow behind the baubles, over the bound green: depth without taking the ground from a kit.
+    k.rect(sheet, W + 28, 300, [k.gradient({ from: 'gold', to: 'gold', kind: 'RADIAL', fromOpacity: 0.2, toOpacity: 0, handles: [{ x: 0.5, y: 0.45 }, { x: 1, y: 0.45 }, { x: 0.5, y: 1.1 }] })], { name: 'Glow', absolute: { x: -14, y: -14 } })
+    draw(k, sheet, art(W, H))
+
+    const c = { align: 'CENTER' as const, width: 'FILL' as const }
+    k.text(sheet, 'YOU’RE INVITED TO SPEND', { style: 'Kicker 11', color: 'onPaper', ...c, name: 'Kicker' })
+    k.stack(sheet, { height: 8, name: 'Gap' })
+    k.text(sheet, 'Christmas Eve', { style: 'Title 60', color: 'text', ...c, name: 'Title' })
+    k.text(sheet, 'with {{brand.name}}', { style: 'Host 22', color: 'text', ...c, name: 'Host' })
+    k.stack(sheet, { height: 12, name: 'Gap' })
+    flourishComponent(k, 'Star rule', 'onPaper', starPath(0, 0, 10, 4.2), { rule: 34 })
+    k.instance(sheet, 'Star rule', {}, { name: 'Divider' })
+    k.stack(sheet, { height: 12, name: 'Gap' })
+    k.text(sheet, 'Thursday 24 December · from 6 pm', { style: 'When 15', color: 'onPaper', ...c, name: 'When' })
+    k.text(sheet, '418 Linden Avenue, Oak Park', { style: 'Body 12', color: 'text', ...c, name: 'Where' })
+    k.stack(sheet, { height: 12, name: 'Gap' })
+    k.text(sheet, 'Carols round the piano at eight, jollof, mince pies and mulled cider all evening. Bring the little ones, and a jumper you’re not proud of.', { style: 'Body 12', color: 'text', ...c, name: 'Body' })
+    k.stack(sheet, { height: 12, name: 'Gap' })
+    k.text(sheet, 'RSVP TO NGOZI BY 18 DECEMBER · (708) 555-0148', { style: 'Rsvp 10', color: 'onPaper', ...c, name: 'Rsvp' })
+
+    k.textStyle('Title 50', { ...SERIF, size: 50, fontWeight: 400, fontStyle: 'italic', letterSpacing: -1.2, lineHeight: 50 })
+    k.textStyle('Host 18', { ...SERIF, size: 18, fontWeight: 400, lineHeight: 23 })
+    k.textStyle('When 13', { ...SERIF, size: 13, fontWeight: 700, lineHeight: 18 })
+    k.textStyle('Body 10.5', { ...SERIF, size: 10.5, fontWeight: 400, lineHeight: 15 })
+    k.textStyle('Rsvp 8.5', { size: 8.5, fontWeight: 600, letterSpacing: 1.2, lineHeight: 13 })
+    k.textStyle('Kicker 9.5', { size: 9.5, fontWeight: 600, letterSpacing: 3, lineHeight: 14 })
+    k.variants(sheet, [printVariant('a6', {
+      art, pad: PAD, masterWidth: W,
+      styles: [['Title', 'Title 50'], ['Host', 'Host 18'], ['When', 'When 13'], ['Where', 'Body 10.5'], ['Body', 'Body 10.5'], ['Rsvp', 'Rsvp 8.5'], ['Kicker', 'Kicker 9.5']],
+    })])
+    return k.finish()
+  },
+})

package/src/templates/print/holidays-christmas-gift-tags.ts

@@ -0,0 +1,117 @@
+// A sheet of twelve round Christmas gift tags to print on sticker paper or card and cut out: four designs (a
+// layered pine tree under a star, a striped bauble, a snowflake, a sprig of holly) in red, green and cream, each
+// with a stitched ring and "To" and "From" to fill in. Every tag is an instance of one component set, so the names
+// are typed once per tag and a colour change reaches all twelve. US Letter on a kraft-paper ground that runs into
+// the bleed, and an A4 copy.
+
+import { Kit, preset } from '../kit'
+import { defineTemplate } from '../build'
+import { SERIF } from '../shared/type'
+import type { VectorPath } from '@/lib/document/types'
+import { bauble, disc, draw, holly, polyP, printVariant, snowflake, specksIn, starPath, type Drawn } from '../themes/holidays-shared'
+
+const NAME = 'Christmas gift tags sticker sheet'
+const PAD = { top: 54, right: 60, bottom: 40, left: 60 }
+const D = 196
+
+type Motif = 'Tree' | 'Bauble' | 'Snowflake' | 'Holly'
+const MOTIFS: readonly Motif[] = ['Tree', 'Bauble', 'Snowflake', 'Holly']
+/** Each design's disc, its drawing and its words. */
+const LOOK: Record<Motif, { ground: string; ink: string; art: string; art2: string; words: string }> = {
+  Tree: { ground: 'tagGreen', ink: 'cream', art: 'pineLight', art2: 'gold', words: 'cream' },
+  Bauble: { ground: 'tagRed', ink: 'cream', art: 'gold', art2: 'cream', words: 'cream' },
+  Snowflake: { ground: 'tagCream', ink: 'red', art: 'red', art2: 'green', words: 'red' },
+  Holly: { ground: 'tagCream', ink: 'green', art: 'green', art2: 'red', words: 'green' },
+}
+
+/** The picture on a tag, centred at (cx, cy) in a tag `D` across. */
+function motif(m: Motif, cx: number, cy: number): Drawn[] {
+  const L = LOOK[m]
+  if (m === 'Tree') {
+    const tiers: VectorPath[] = [0, 1, 2].map(i => polyP([{ x: cx, y: cy - 38 + i * 17 }, { x: cx + 22 + i * 10, y: cy - 8 + i * 19 }, { x: cx - 22 - i * 10, y: cy - 8 + i * 19 }]))
+    return [
+      { name: 'Tree', paths: tiers, color: L.art },
+      { name: 'Trunk', paths: [polyP([{ x: cx - 5, y: cy + 30 }, { x: cx + 5, y: cy + 30 }, { x: cx + 5, y: cy + 40 }, { x: cx - 5, y: cy + 40 }])], color: 'bark' },
+      { name: 'Top star', paths: [starPath(cx, cy - 40, 9, 3.8)], color: L.art2 },
+      { name: 'Lights', paths: [[-8, -18], [9, -10], [-16, 2], [8, 8], [-4, 20], [20, 24], [-24, 26], [2, -2]].map(([x, y]) => disc(cx + x, cy + y, 2.8)), color: L.art2 },
+      { name: 'Garland', paths: [[-14, -4, 16, -12], [-22, 14, 26, 6], [-30, 34, 32, 26]].map(([a, b, c, d]) => ({ closed: false, points: [{ x: cx + a, y: cy + b }, { x: cx + c, y: cy + d, handleIn: { x: cx + (a + c) / 2, y: cy + (b + d) / 2 + 7 } }] })), color: L.ink, o: { strokeWidth: 1.2, opacity: 0.8 } },
+    ]
+  }
+  if (m === 'Bauble') {
+    const b = bauble(cx, cy - 48, 34, { string: 2 })
+    return [
+      { name: 'Bauble', paths: b.body, color: L.art },
+      { name: 'Bauble shade', paths: b.shade, color: 'goldDeep', o: { opacity: 0.5 } },
+      { name: 'Bauble bands', paths: b.band, color: L.art2, o: { strokeWidth: 2 } },
+      { name: 'Bauble cap', paths: b.cap, color: 'goldDeep' },
+      { name: 'Bauble shine', paths: b.shine, color: L.art2, o: { opacity: 0.7 } },
+    ]
+  }
+  if (m === 'Snowflake') return [
+    { name: 'Snowflake', paths: snowflake(cx, cy, 40), color: L.art, o: { strokeWidth: 3.2 } },
+    { name: 'Snow dots', paths: [0, 1, 2, 3, 4, 5].map(i => disc(cx + Math.cos(i * Math.PI / 3 + Math.PI / 6) * 30, cy + Math.sin(i * Math.PI / 3 + Math.PI / 6) * 30, 2.6)), color: L.art2 },
+    { name: 'Snowflake heart', paths: [disc(cx, cy, 5)], color: L.art2 },
+  ]
+  return [
+    { name: 'Holly', paths: [holly({ x: cx - 4, y: cy + 4 }, 48, Math.PI + 0.45), holly({ x: cx + 4, y: cy + 4 }, 48, -0.45), holly({ x: cx, y: cy + 6 }, 34, Math.PI / 2 + 0.1)], color: L.art },
+    { name: 'Berries', paths: [disc(cx - 7, cy - 2, 7), disc(cx + 7, cy - 3, 7), disc(cx, cy + 9, 7)], color: L.art2 },
+  ]
+}
+
+/** The kraft paper's fibre, round the edges and between the tags (a full sheet of specks, in four bands). */
+function paper(w: number, h: number): Drawn[] {
+  const B = 12
+  return [0, 1, 2, 3].map(i => {
+    const band = { x: -B, y: -B + ((h + 2 * B) * i) / 4, w: w + 2 * B, h: (h + 2 * B) / 4 }
+    return { name: 'Fibre', paths: specksIn(band, 260, 21 + i, 2.2), color: 'fibre', o: { opacity: 0.45 } }
+  })
+}
+
+export default defineTemplate({
+  id: 'print-holidays-christmas-gift-tags',
+  meta: {
+    name: NAME,
+    description: 'Twelve round Christmas gift tags on one sheet, to print on sticker paper or card and cut out: a layered pine tree, a striped bauble, a snowflake and a sprig of holly in red, green and cream, each with a stitched ring and “To” and “From” lines. One component set, so a colour change reaches every tag. US Letter on kraft paper with bleed, and an A4 copy',
+    category: 'sticker', tags: ['christmas', 'gift tags', 'labels', 'stickers', 'sticker sheet', 'presents', 'wrapping', 'printable', 'holly', 'snowflake', 'kraft', 'diy', 'print'],
+    platforms: ['print'], formats: ['card'], useCases: ['greeting'],
+    created: '2026-10-10', updated: '2026-10-10',
+  },
+  stableNumbers: true,
+  build() {
+    const k = new Kit(NAME, preset('us-letter'))
+    k.quantizeGeometry = true
+    k.brand(
+      { paper: '#E6D6BC', text: '#4A2B1E', onPaper: '#7A2E25', primary: '#A3312A', onPrimary: '#FFF6E8' },
+      { name: 'From the Lindqvist house' },
+    )
+    k.palette({ tagRed: '#A3312A', tagGreen: '#2F5A43', tagCream: '#FBF4E6', red: '#A3312A', green: '#2F5A43', cream: '#FBF4E6', gold: '#D9B356', goldDeep: '#8E6C25', pineLight: '#7FAE86', bark: '#6B4A33', fibre: '#9C7F57' })
+    k.textStyle('Head 30', { ...SERIF, size: 30, fontWeight: 600, fontStyle: 'italic', letterSpacing: -0.4, lineHeight: 34 })
+    k.textStyle('Note 11', { size: 11, fontWeight: 500, letterSpacing: 0.4, lineHeight: 16 })
+    k.textStyle('Tag 13', { ...SERIF, size: 13, fontWeight: 600, fontStyle: 'italic', lineHeight: 17 })
+    k.textStyle('Tag word 9', { size: 9, fontWeight: 700, letterSpacing: 2.2, lineHeight: 12 })
+
+    // One tag, four designs: a disc with a stitched ring, the picture, a greeting and "To" / "From" lines.
+    k.variantSet('Gift tag', 'Design', MOTIFS, { width: D, height: D, radius: D / 2, padding: { top: 110, right: 30, bottom: 18, left: 30 }, gap: 4, align: 'CENTER', props: { Greeting: 'Merry Christmas', To: 'To: ____________', From: 'From: __________' } }, (m, id) => {
+      const L = LOOK[m as Motif]
+      k.vector(id, D - 16, D - 16, [disc((D - 16) / 2, (D - 16) / 2, (D - 16) / 2)], [], { name: 'Stitch', absolute: { x: 8, y: 8 }, stroke: { color: L.words, width: 1.4, dash: [5, 4] }, opacity: 0.8 })
+      draw(k, id, motif(m as Motif, D / 2, 64))
+      k.propText(id, 'Greeting', { style: 'Tag 13', color: L.words, align: 'CENTER', width: 'FILL', name: 'Greeting' })
+      k.propText(id, 'To', { style: 'Tag word 9', color: L.words, align: 'CENTER', width: 'FILL', name: 'To' })
+      k.propText(id, 'From', { style: 'Tag word 9', color: L.words, align: 'CENTER', width: 'FILL', name: 'From' })
+    }, m => ({ fill: LOOK[m as Motif].ground }))
+
+    const sheet = k.sheet
+    const { width: W, height: H } = k.node(sheet)
+    k.flowSheet(sheet, 18, PAD, 'paper', 'MIN', 'CENTER')
+    draw(k, sheet, paper(W, H))
+    k.text(sheet, 'Merry & bright gift tags', { style: 'Head 30', color: 'text', align: 'CENTER', width: 'FILL', name: 'Title' })
+    const grid = k.stack(sheet, { direction: 'HORIZONTAL', wrap: true, gap: 22, width: 'FILL', justify: 'CENTER', name: 'Tags' })
+    k.patch(grid, { counterAxisSpacing: 22 })
+    const greet = ['Merry Christmas', 'Joy to you', 'Ho ho ho', 'Season’s greetings', 'Peace & joy', 'Merry Christmas', 'With love', 'Don’t peek!', 'Happy holidays', 'Be merry', 'Noel', 'For you, with love']
+    greet.forEach((g, i) => k.instance(grid, `Gift tag/${MOTIFS[i % 4]}`, { Greeting: g }, { name: 'Gift tag' }))
+    k.text(sheet, 'Print on full-sheet sticker paper or card and cut round the stitched ring · {{brand.name}}', { style: 'Note 11', color: 'text', align: 'CENTER', width: 'FILL', name: 'Note' })
+
+    k.variants(sheet, [printVariant('a4', { art: paper, pad: PAD, masterWidth: W })])
+    return k.finish()
+  },
+})

package/src/templates/print/holidays-diwali-party-invitation.ts

@@ -0,0 +1,98 @@
+// A printed invitation to a family's Diwali evening: a toran of marigolds and mango leaves hangs across the top of a
+// deep aubergine card, a rangoli in pink, saffron and teal rises from the foot with a row of lit clay diyas before it,
+// and between them "Shubh Deepavali" in a gold serif over the evening's details (Lakshmi puja, dinner, sparklers in the
+// garden). 5 × 7 inches with the toran and rangoli running into the eighth-inch bleed, and an A6 copy.
+
+import { Kit, preset } from '../kit'
+import { defineTemplate } from '../build'
+import { SERIF } from '../shared/type'
+import { blurred } from '../shared/texture'
+import { bandsAround, disc, diya, draw, flourishComponent, perBand, printVariant, rangoli, specksIn, toran, type Drawn } from '../themes/holidays-shared'
+
+const NAME = 'Diwali party invitation'
+const PAD = { top: 150, right: 46, bottom: 214, left: 46 }
+
+function art(w: number, h: number): Drawn[] {
+  const s = w / 480, B = 14 * s, cx = w / 2
+  const t = toran(-B, w + B, -2 * s, 14 * s, 7, 15 * s, 3)
+  const r = rangoli(cx, h + 26 * s, 210 * s, 8)
+  const diyas = [0.14, 0.32, 0.5, 0.68, 0.86].map((x, i) => diya(w * x - 10 * s, h - 22 * s - (i === 2 ? 14 * s : i % 2 ? 6 * s : 0), (i === 2 ? 64 : 52) * s))
+  const keep = { x: 30 * s, y: 100 * s, w: w - 60 * s, h: h - 330 * s }
+  return [
+    ...perBand('Glitter', 'gold', bandsAround(w, h, keep, B).slice(0, 1).concat(bandsAround(w, h, keep, B).slice(2)), (b, i) => specksIn(b, 420 * s * s, 60 + i, 2.2 * s), { opacity: 0.5 }),
+    { name: 'Rangoli outer', paths: r.outer, color: 'pink' },
+    { name: 'Rangoli middle', paths: r.middle, color: 'saffron' },
+    { name: 'Rangoli inner', paths: r.inner, color: 'teal' },
+    { name: 'Rangoli dots', paths: r.dots, color: 'cream' },
+    { name: 'Rangoli heart', paths: r.heart, color: 'gold' },
+    { name: 'Diya glow', paths: diyas.map(d => d.flame[0]).map(f => ({ ...f })), color: 'saffron', o: { opacity: 0.6, effects: [blurred(10 * s)] } },
+    { name: 'Diyas', paths: diyas.flatMap(d => d.bowl), color: 'clay' },
+    { name: 'Diya rims', paths: diyas.flatMap(d => d.rim), color: 'gold' },
+    { name: 'Flames', paths: diyas.flatMap(d => d.flame), color: 'saffron' },
+    { name: 'Flame cores', paths: diyas.flatMap(d => d.core), color: 'cream' },
+    { name: 'Toran string', paths: t.string, color: 'gold', o: { strokeWidth: 1.6 * s } },
+    { name: 'Mango leaves', paths: t.leaves, color: 'leaf' },
+    { name: 'Marigolds', paths: t.blooms.outer, color: 'marigold' },
+    { name: 'Marigold hearts', paths: t.blooms.inner, color: 'saffron' },
+    { name: 'Bells', paths: [0.07, 0.93].map(x => disc(w * x, 70 * s, 6 * s)), color: 'gold' },
+  ]
+}
+
+export default defineTemplate({
+  id: 'print-holidays-diwali-party-invitation',
+  meta: {
+    name: NAME,
+    description: 'A printed invitation to a family Diwali evening: a toran of marigolds and mango leaves across the top of a deep aubergine card, a rangoli in pink, saffron and teal rising from the foot behind a row of lit clay diyas, and “Shubh Deepavali” in a gold serif over the details: Lakshmi puja, dinner and sparklers in the garden. 5 × 7 inches with bleed, and an A6 copy',
+    category: 'invitation', tags: ['diwali', 'deepavali', 'festival of lights', 'diya', 'rangoli', 'marigold', 'toran', 'lakshmi puja', 'hindu', 'family', 'party', 'invitation', 'print', 'card'],
+    platforms: ['print'], formats: ['card'], useCases: ['invitation', 'event'],
+    created: '2026-10-10', updated: '2026-10-10',
+  },
+  stableNumbers: true,
+  build() {
+    const k = new Kit(NAME, preset('invitation-5x7'))
+    k.quantizeGeometry = true
+    k.brand(
+      { paper: '#3B0F3D', text: '#FFF1D6', onPaper: '#F3C969', primary: '#F3C969', onPrimary: '#3B0F3D' },
+      { name: 'the Mehta family' },
+    )
+    k.palette({ gold: '#E9B949', saffron: '#FFA41B', marigold: '#F57C14', cream: '#FFF1D6', pink: '#E0457B', teal: '#1E9C93', leaf: '#3F8F45', clay: '#B9572B' })
+    k.textStyle('Kicker 11', { size: 11, fontWeight: 700, letterSpacing: 3.6, lineHeight: 16 })
+    k.textStyle('Title 50', { ...SERIF, size: 50, fontWeight: 600, fontStyle: 'italic', letterSpacing: -1, lineHeight: 52 })
+    k.textStyle('Sub 18', { ...SERIF, size: 18, fontWeight: 400, lineHeight: 24 })
+    k.textStyle('When 15', { size: 15, fontWeight: 700, lineHeight: 21 })
+    k.textStyle('Body 12', { ...SERIF, size: 12, fontWeight: 400, lineHeight: 17 })
+    k.textStyle('Rsvp 10', { size: 10, fontWeight: 700, letterSpacing: 1.6, lineHeight: 15 })
+
+    const sheet = k.sheet
+    const { width: W, height: H } = k.node(sheet)
+    k.flowSheet(sheet, 0, PAD, 'paper', 'MIN', 'CENTER')
+    draw(k, sheet, art(W, H))
+    const c = { align: 'CENTER' as const, width: 'FILL' as const }
+    k.text(sheet, 'A FESTIVAL OF LIGHTS', { style: 'Kicker 11', color: 'onPaper', ...c, name: 'Kicker' })
+    k.stack(sheet, { height: 6, name: 'Gap' })
+    k.text(sheet, 'Shubh Deepavali', { style: 'Title 50', color: 'onPaper', ...c, name: 'Title' })
+    k.text(sheet, 'Celebrate Diwali with {{brand.name}}', { style: 'Sub 18', color: 'text', ...c, name: 'Sub' })
+    k.stack(sheet, { height: 14, name: 'Gap' })
+    flourishComponent(k, 'Lamp rule', 'primary', disc(0, 0, 5, 7), { rule: 30, size: 7 })
+    k.instance(sheet, 'Lamp rule', {}, { name: 'Divider' })
+    k.stack(sheet, { height: 14, name: 'Gap' })
+    k.text(sheet, 'Sunday 8 November · 6:30 pm', { style: 'When 15', color: 'text', ...c, name: 'When' })
+    k.text(sheet, '31 Juniper Court, Edison', { style: 'Body 12', color: 'text', ...c, name: 'Where' })
+    k.stack(sheet, { height: 10, name: 'Gap' })
+    k.text(sheet, 'Lakshmi puja at seven, then dinner, mithai and sparklers in the garden. Wear your brightest; the kids will be judging.', { style: 'Body 12', color: 'text', ...c, name: 'Body' })
+    k.stack(sheet, { height: 10, name: 'Gap' })
+    k.text(sheet, 'RSVP TO PRIYA · (732) 555-0186', { style: 'Rsvp 10', color: 'onPaper', ...c, name: 'Rsvp' })
+
+    k.textStyle('Title 42', { ...SERIF, size: 42, fontWeight: 600, fontStyle: 'italic', letterSpacing: -0.8, lineHeight: 44 })
+    k.textStyle('Sub 15', { ...SERIF, size: 15, fontWeight: 400, lineHeight: 20 })
+    k.textStyle('When 13', { size: 13, fontWeight: 700, lineHeight: 18 })
+    k.textStyle('Body 10.5', { ...SERIF, size: 10.5, fontWeight: 400, lineHeight: 15 })
+    k.textStyle('Rsvp 8.5', { size: 8.5, fontWeight: 700, letterSpacing: 1.2, lineHeight: 13 })
+    k.textStyle('Kicker 9.5', { size: 9.5, fontWeight: 700, letterSpacing: 3, lineHeight: 14 })
+    k.variants(sheet, [printVariant('a6', {
+      art, pad: PAD, masterWidth: W,
+      styles: [['Title', 'Title 42'], ['Sub', 'Sub 15'], ['When', 'When 13'], ['Where', 'Body 10.5'], ['Body', 'Body 10.5'], ['Rsvp', 'Rsvp 8.5'], ['Kicker', 'Kicker 9.5']],
+    })])
+    return k.finish()
+  },
+})