@popcraft/kit 0.30.0 → 0.32.0

package/src/templates/print/comic-hero-chase.ts

@@ -0,0 +1,42 @@
+// "Nightstar: Blackout", page two: the chase. Slanted gutters keep the eye running, the way the two of them run over the roofs.
+
+import { Kit, preset } from '../kit'
+import { defineTemplate } from '../build'
+import { caption, folio, FOLIO, comicMeta, comicSetup, pageGrid, panel, rows, say, sfx, slantTier, tier, tierBox } from '../themes/comic-hero-page'
+
+export default defineTemplate({
+  id: 'comic-chase',
+  meta: comicMeta('Chase page', 'Page two of "Nightstar: Blackout": Voltrix tears open a substation, Nightstar watches from a gargoyle, and the chase runs across the rooftops on slanted gutters to a lightning bolt and an exploding water tower', ['chase', 'slanted', 'rooftops', 'sound effects']),
+  stableNumbers: true,
+  build() {
+    const k = new Kit('Chase page', preset('comic-page'))
+    comicSetup(k)
+    drawPage(k)
+    return k.finish()
+  },
+})
+
+/** This page's drawing onto the kit's last sheet: shared with the whole issue (comic-hero-issue). */
+export function drawPage(k: Kit) {
+  const g = 12, { W, H } = pageGrid(k, k.sheet, 36, g)
+    const [h1, h2, h3] = rows(H - FOLIO, g, [30, 34, 36])
+    const t1 = tierBox(k, k.sheet, W, h1, 'Tier 1')
+    const [a] = tier(W, h1, [1], g)
+    panel(k, t1, a, 'chase-1', { ground: 'heroG1', name: 'The substation' })
+    caption(k, t1, 'Midnight. The Eastside substation.', { x: 10, y: 10, width: 200 })
+    say(k, t1, 'The whole grid. All of it. Mine.', { x: W - 180, y: 12, width: 160, to: { x: W * 0.5, y: h1 * 0.36 } })
+    const t2 = tierBox(k, k.sheet, W, h2, 'Tier 2')
+    const [b, c] = slantTier(W, h2, [2, 3], 22, g)
+    panel(k, t2, b, 'chase-2', { ground: 'heroG2', name: 'On the ledge' })
+    panel(k, t2, c, 'chase-3', { ground: 'heroG3', name: 'Through the wall' })
+    say(k, t2, 'Not tonight, Voltrix.', { x: 12, y: 12, width: 110, to: { x: b.width * 0.45, y: h2 * 0.3 }, thought: true })
+    sfx(k, t2, 'Krakk!', { x: W - 210, y: h2 - 110, w: 190, h: 96, deg: -8, seed: 4 })
+    const t3 = tierBox(k, k.sheet, W, h3, 'Tier 3')
+    const [d, e, f] = slantTier(W, h3, [3, 2, 3], -20, g)
+    panel(k, t3, d, 'chase-4', { ground: 'heroG1', name: 'The leap' })
+    panel(k, t3, e, 'chase-5', { ground: 'heroG2', name: 'Voltrix looks back' })
+    panel(k, t3, f, 'chase-6', { ground: 'heroG3', name: 'The bolt' })
+    say(k, t3, 'Keep up, hero!', { x: e.x + 4, y: 12, width: 96, to: { x: e.x + e.width * 0.5, y: h3 * 0.4 } })
+    sfx(k, t3, 'Zzrakk!', { x: f.x + 10, y: h3 - 100, w: 200, h: 90, deg: 6, fill: 'primary', seed: 11 })
+    folio(k, k.sheet, 'Nightstar: Blackout — page 2')
+}

package/src/templates/print/comic-hero-cover-modern.ts

@@ -0,0 +1,34 @@
+// "Nightstar: Blackout", the front cover. One moment, full bleed, the masthead across the top.
+
+import { Kit, preset } from '../kit'
+import { defineTemplate } from '../build'
+import { bleedFrame, foot, rectFrame, comicMeta, comicSetup, display, panel, say, caption, SIZE, tierBox } from '../themes/comic-hero-page'
+
+export default defineTemplate({
+  id: 'comic-cover-modern',
+  meta: comicMeta('Comic cover (modern)', 'The front cover of "Nightstar: Blackout" no. 1: full-bleed art of Nightstar bursting up through the rain with Voltrix looming in green lightning behind him, a red masthead band with the issue box, and the cover line at the foot', ['cover', 'masthead', 'full bleed']),
+  stableNumbers: true,
+  build() {
+    const k = new Kit('Comic cover (modern)', preset('comic-cover'))
+    comicSetup(k)
+    drawPage(k)
+    return k.finish()
+  },
+})
+
+/** This page's drawing onto the kit's last sheet: shared with the whole issue (comic-hero-issue). */
+export function drawPage(k: Kit) {
+    const { w: W, h: H } = SIZE.cover
+    k.flowSheet(k.sheet, 0, 0)
+    const t = tierBox(k, k.sheet, W, H, 'Cover')
+    const b = bleedFrame(k, W, H)
+    panel(k, t, rectFrame(b.x, b.y, b.width, H - 96 - b.y), 'cover', { ground: 'heroG1', name: 'Cover art', edge: false })
+    const band = k.stack(t, { direction: 'HORIZONTAL', align: 'CENTER', gap: 14, width: W - 64, padding: { top: 12, right: 16, bottom: 12, left: 16 }, fill: 'primary', stroke: { color: 'onPrimary', width: 3, align: 'INSIDE', join: 'MITER' }, name: 'Masthead band', absolute: { x: 32, y: 34 } })
+    const box = k.stack(band, { width: 74, align: 'CENTER', fill: 'card', padding: { top: 6, right: 6, bottom: 6, left: 6 }, stroke: { color: 'onCard', width: 2, align: 'INSIDE', join: 'MITER' }, name: 'Issue box' })
+    k.text(box, '{{brand.issue}}', { style: display(k, 'Title'), color: 'onCard', align: 'CENTER', width: 'FILL', name: 'Issue number' })
+    k.text(box, 'OCT', { style: display(k, 'Credit'), color: 'onCard', align: 'CENTER', width: 'FILL', name: 'Month' })
+    k.text(band, '{{brand.title}}', { style: display(k, 'Masthead'), color: 'onPrimary', width: 'FILL', name: 'Masthead' })
+    caption(k, t, "Harbour City's last light is a star.", { x: 20, y: Math.round(H * 0.6), width: 190, name: 'Cover line' })
+    say(k, t, 'Lights out, star boy!', { x: W - 180, y: H * 0.24, width: 128, to: { x: W * 0.62, y: H * 0.3 } })
+    foot(k, t, W, 96, 'The night the city went dark, one star stayed lit.', 'Cover line')
+}

package/src/templates/print/comic-hero-grid-break.ts

@@ -0,0 +1,39 @@
+// "Nightstar: Blackout", page four: the arrival. The hero's frame tilts out of the grid because he does.
+
+import { Kit, preset } from '../kit'
+import { defineTemplate } from '../build'
+import { caption, folio, FOLIO, comicMeta, comicSetup, pageGrid, panel, rows, say, sfx, tier, tierBox, tilted } from '../themes/comic-hero-page'
+
+export default defineTemplate({
+  id: 'comic-grid-break',
+  meta: comicMeta('Grid-break page', 'Page four of "Nightstar: Blackout": Voltrix lifts Rosa off the street, her eyes go wide, and Nightstar breaks the grid feet first on a tilted splash with "KRASH!" before the two of them lock up in the crater', ['grid break', 'splash', 'impact', 'sound effects']),
+  stableNumbers: true,
+  build() {
+    const k = new Kit('Grid-break page', preset('comic-page'))
+    comicSetup(k)
+    drawPage(k)
+    return k.finish()
+  },
+})
+
+/** This page's drawing onto the kit's last sheet: shared with the whole issue (comic-hero-issue). */
+export function drawPage(k: Kit) {
+  const g = 12, { W, H } = pageGrid(k, k.sheet, 36, g)
+    const [h1, h2, h3] = rows(H - FOLIO, g, [28, 42, 30])
+    const t1 = tierBox(k, k.sheet, W, h1, 'Tier 1')
+    const [a, b] = tier(W, h1, [3, 2], g)
+    panel(k, t1, a, 'break-1', { ground: 'heroG1', name: 'Grabbed' })
+    panel(k, t1, b, 'break-2', { ground: 'heroG2', name: 'Her eyes' })
+    say(k, t1, 'You’re coming with me, courier.', { x: 12, y: 12, width: 128, to: { x: a.width * 0.3, y: h1 * 0.3 } })
+    const t2 = tierBox(k, k.sheet, W, h2, 'Tier 2')
+    panel(k, t2, tilted(0, 0, W, h2, 28, -28), 'break-3', { ground: 'heroG3', name: 'Feet first' })
+    sfx(k, t2, 'Krash!', { x: W - 330, y: h2 - 150, w: 300, h: 130, deg: -10, big: true, seed: 21 })
+    say(k, t2, 'Put. Her. Down.', { x: 16, y: 34, width: 96, to: { x: W * 0.32, y: h2 * 0.3 } })
+    const t3 = tierBox(k, k.sheet, W, h3, 'Tier 3')
+    const [c, d] = tier(W, h3, [2, 3], g)
+    panel(k, t3, c, 'break-4', { ground: 'heroG1', name: 'Rosa rolls clear' })
+    panel(k, t3, d, 'break-5', { ground: 'heroG2', name: 'Locked up' })
+    say(k, t3, 'Who—?', { x: 12, y: 12, width: 96, to: { x: c.width * 0.5, y: h3 * 0.4 } })
+    caption(k, t3, 'Nightstar. The one light this city has left.', { x: d.x + 10, y: h3 - 52, width: 220 })
+    folio(k, k.sheet, 'Nightstar: Blackout — page 4')
+}

package/src/templates/print/comic-hero-interrogation.ts

@@ -0,0 +1,41 @@
+// "Nightstar: Blackout", page ten: the questions. Shot, reverse shot, and a grin that says this is not over.
+
+import { Kit, preset } from '../kit'
+import { defineTemplate } from '../build'
+import { caption, folio, FOLIO, comicMeta, comicSetup, pageGrid, panel, rows, say, sfx, tier, tierBox } from '../themes/comic-hero-page'
+
+export default defineTemplate({
+  id: 'comic-interrogation',
+  meta: comicMeta('Interrogation page', 'Page ten of "Nightstar: Blackout": dawn in a warehouse, Voltrix chained to a chair under one bulb, shot and reverse shot as Nightstar asks who sold him the codes, a fist on the table, a grin, and Rosa waiting outside', ['interrogation', 'dialogue', 'shot reverse shot', 'aftermath']),
+  stableNumbers: true,
+  build() {
+    const k = new Kit('Interrogation page', preset('comic-page'))
+    comicSetup(k)
+    drawPage(k)
+    return k.finish()
+  },
+})
+
+/** This page's drawing onto the kit's last sheet: shared with the whole issue (comic-hero-issue). */
+export function drawPage(k: Kit) {
+  const g = 12, { W, H } = pageGrid(k, k.sheet, 36, g)
+    const [h1, h2, h3] = rows(H - FOLIO, g, [32, 34, 34])
+    const t1 = tierBox(k, k.sheet, W, h1, 'Tier 1')
+    panel(k, t1, tier(W, h1, [1], g)[0], 'interro-1', { ground: 'heroG1', name: 'The warehouse' })
+    caption(k, t1, 'Dawn. Pier 9 warehouse.', { x: 10, y: 10, width: 170 })
+    const t2 = tierBox(k, k.sheet, W, h2, 'Tier 2')
+    const [a, b] = tier(W, h2, [1, 1], g)
+    panel(k, t2, a, 'interro-2', { ground: 'heroG2', name: 'Nightstar asks' })
+    panel(k, t2, b, 'interro-3', { ground: 'heroG3', name: 'Voltrix smirks' })
+    say(k, t2, 'Who sold you the substation codes?', { x: 10, y: 10, width: 160, to: { x: a.width * 0.5, y: h2 * 0.35 } })
+    say(k, t2, 'Ask nicely.', { x: W - 108, y: 10, width: 96, to: { x: b.x + b.width * 0.5, y: h2 * 0.45 } })
+    const t3 = tierBox(k, k.sheet, W, h3, 'Tier 3')
+    const [c, d, e] = tier(W, h3, [1, 1, 2], g)
+    panel(k, t3, c, 'interro-4', { ground: 'heroG1', name: 'The table' })
+    panel(k, t3, d, 'interro-5', { ground: 'heroG2', name: 'The grin' })
+    panel(k, t3, e, 'interro-6', { ground: 'heroG3', name: 'Morning' })
+    sfx(k, t3, 'Blam!', { x: 4, y: h3 - 96, w: 150, h: 84, deg: -10, seed: 19 })
+    say(k, t3, 'There’s a lot more where I came from.', { x: d.x - 20, y: 10, width: 128, to: { x: d.x + d.width * 0.5, y: h3 * 0.55 } })
+    caption(k, t3, 'To be continued.', { x: W - 150, y: h3 - 44, width: 140 })
+    folio(k, k.sheet, 'Nightstar: Blackout — page 10')
+}

package/src/templates/print/comic-hero-issue.ts

@@ -0,0 +1,44 @@
+// "Nightstar: Blackout", the whole issue: the cover, nine story pages in facing pages, and the pin-up as the back
+// cover. Every page is the same drawing as its own template (each page file's `drawPage`), so the issue and the
+// single pages never drift apart.
+
+import { Kit, preset } from '../kit'
+import { defineTemplate } from '../build'
+import { comicMeta, comicSetup } from '../themes/comic-hero-page'
+import { drawPage as cover } from './comic-hero-cover-modern'
+import { drawPage as chase } from './comic-hero-chase'
+import { drawPage as widescreen } from './comic-hero-widescreen'
+import { drawPage as gridBreak } from './comic-hero-grid-break'
+import { drawPage as cascade } from './comic-hero-cascade'
+import { drawPage as overlap } from './comic-hero-overlap'
+import { drawPage as nested } from './comic-hero-nested'
+import { drawPage as parallel } from './comic-hero-parallel'
+import { drawPage as mangaAction } from './comic-hero-manga-action'
+import { drawPage as interrogation } from './comic-hero-interrogation'
+import { drawPage as pinup } from './comic-hero-pinup'
+
+const PAGES: [string, (k: Kit) => void][] = [
+  ['Page 1', chase], ['Page 2', widescreen], ['Page 3', gridBreak], ['Page 4', cascade], ['Page 5', overlap],
+  ['Page 6', nested], ['Page 7', parallel], ['Page 8', mangaAction], ['Page 9', interrogation], ['Back cover', pinup],
+]
+
+export default defineTemplate({
+  id: 'comic-hero-issue',
+  meta: comicMeta('Whole comic issue (Nightstar)', '"Nightstar: Blackout", the whole action issue in one file: the cover, nine story pages in facing pages and the pin-up on the back, ready to print as a booklet', ['book', 'issue', 'story', 'action']),
+  sequence: true,
+  stableNumbers: true,
+  build() {
+    const k = new Kit('Whole comic issue (Nightstar)', preset('comic-cover'))
+    comicSetup(k)
+    k.doc = { ...k.doc, settings: { ...k.doc.settings, facingPages: true } }
+    const front = k.sheet
+    k.nameSheet(front, 'Front cover')
+    cover(k)
+    k.setCover(front)
+    for (const [name, draw] of PAGES) {
+      k.addSheet(preset('comic-page'), name)
+      draw(k)
+    }
+    return k.finish()
+  },
+})

package/src/templates/print/comic-hero-manga-action.ts

@@ -0,0 +1,38 @@
+// "Nightstar: Blackout", page nine: the last punch. Steep diagonals and one huge frame for the hit.
+
+import { Kit, preset } from '../kit'
+import { defineTemplate } from '../build'
+import { caption, folio, FOLIO, comicMeta, comicSetup, pageGrid, panel, rows, say, sfx, slantTier, tierBox, tilted } from '../themes/comic-hero-page'
+
+export default defineTemplate({
+  id: 'comic-manga-action',
+  meta: comicMeta('Manga action page', 'Page nine of "Nightstar: Blackout": the finishing blow on steep diagonal frames, Nightstar coming straight at the reader, Voltrix out of power, the punch through his armour with "KRAKKOOM!" and him flying through a truck', ['manga', 'action', 'diagonal', 'speed', 'sound effects']),
+  stableNumbers: true,
+  build() {
+    const k = new Kit('Manga action page', preset('comic-page'))
+    comicSetup(k)
+    drawPage(k)
+    return k.finish()
+  },
+})
+
+/** This page's drawing onto the kit's last sheet: shared with the whole issue (comic-hero-issue). */
+export function drawPage(k: Kit) {
+  const g = 12, { W, H } = pageGrid(k, k.sheet, 36, g)
+    const [h1, h2, h3] = rows(H - FOLIO, g, [38, 34, 28])
+    const t1 = tierBox(k, k.sheet, W, h1, 'Tier 1')
+    const [a, b] = slantTier(W, h1, [3, 2], 44, g)
+    panel(k, t1, a, 'manga-1', { ground: 'heroG1', name: 'Straight at him' })
+    panel(k, t1, b, 'manga-2', { ground: 'heroG2', name: 'No power left' })
+    say(k, t1, 'This one’s for the city.', { x: 10, y: 10, width: 128, to: { x: a.width * 0.4, y: h1 * 0.3 } })
+    say(k, t1, 'W-wait—', { x: W - 108, y: h1 - 80, width: 96, to: { x: b.x + b.width * 0.6, y: h1 * 0.4 } })
+    const t2 = tierBox(k, k.sheet, W, h2, 'Tier 2')
+    panel(k, t2, tilted(0, 0, W, h2, -30, 30), 'manga-3', { ground: 'heroG3', name: 'The hit' })
+    sfx(k, t2, 'Krakkoom!', { x: 20, y: h2 - 150, w: 480, h: 140, deg: -7, big: true, fill: 'primary', seed: 23 })
+    const t3 = tierBox(k, k.sheet, W, h3, 'Tier 3')
+    const [c, d] = slantTier(W, h3, [2, 3], -30, g)
+    panel(k, t3, c, 'manga-4', { ground: 'heroG1', name: 'His eyes' })
+    panel(k, t3, d, 'manga-5', { ground: 'heroG2', name: 'Through the truck' })
+    caption(k, t3, 'Lights out, Voltrix.', { x: W - 170, y: h3 - 44, width: 160 })
+    folio(k, k.sheet, 'Nightstar: Blackout — page 9')
+}

package/src/templates/print/comic-hero-nested.ts

@@ -0,0 +1,39 @@
+// "Nightstar: Blackout", page seven: the overload. Close-ups sit inside the big frame, the way a moment holds smaller ones.
+
+import { Kit, preset } from '../kit'
+import { defineTemplate } from '../build'
+import { caption, folio, FOLIO, comicMeta, comicSetup, pageGrid, panel, rectFrame, rows, say, sfx, tier, tierBox } from '../themes/comic-hero-page'
+
+export default defineTemplate({
+  id: 'comic-nested',
+  meta: comicMeta('Nested page', 'Page seven of "Nightstar: Blackout": Voltrix drinks the whole grid in one big frame, with two inset close-ups nested inside it, while the skyline goes dark block by block and Rosa spots the cable that feeds him', ['nested', 'inset', 'keyline', 'sound effects']),
+  stableNumbers: true,
+  build() {
+    const k = new Kit('Nested page', preset('comic-page'))
+    comicSetup(k)
+    drawPage(k)
+    return k.finish()
+  },
+})
+
+/** This page's drawing onto the kit's last sheet: shared with the whole issue (comic-hero-issue). */
+export function drawPage(k: Kit) {
+  const g = 12, { W, H } = pageGrid(k, k.sheet, 36, g)
+    const [h1, h2] = rows(H - FOLIO, g, [54, 46])
+    const t1 = tierBox(k, k.sheet, W, h1, 'Tier 1')
+    panel(k, t1, rectFrame(0, 0, W, h1), 'nest-1', { ground: 'heroG1', name: 'The overload' })
+    const s = Math.round(W * 0.3)
+    panel(k, t1, rectFrame(16, h1 - s - 16, s, s), 'nest-2', { ground: 'heroG2', name: 'The coils', keyline: 6 })
+    panel(k, t1, rectFrame(W - s - 16, h1 - s - 16, s, s), 'nest-3', { ground: 'heroG3', name: 'The glare', keyline: 6 })
+    caption(k, t1, '11:58 p.m. He doesn’t want power. He wants all of it.', { x: 10, y: 10, width: 230 })
+    sfx(k, t1, 'Vrrmm!', { x: W - 230, y: 14, w: 200, h: 96, deg: 6, seed: 13 })
+    say(k, t1, 'More!', { x: 16 + s - 40, y: h1 - s - 70, width: 96, to: { x: 16 + s * 0.5, y: h1 - s * 0.6 } })
+    say(k, t1, 'Too bright. Can’t get close.', { x: W - s - 120, y: h1 - s - 90, width: 128, to: { x: W - s * 0.5, y: h1 - s * 0.6 }, thought: true })
+    const t2 = tierBox(k, k.sheet, W, h2, 'Tier 2')
+    const [a, b] = tier(W, h2, [3, 2], g)
+    panel(k, t2, a, 'nest-4', { ground: 'heroG2', name: 'The blackout' })
+    panel(k, t2, b, 'nest-5', { ground: 'heroG3', name: 'The cable' })
+    caption(k, t2, 'Block by block, the city goes dark.', { x: 10, y: 10, width: 200 })
+    say(k, t2, 'That cable... it feeds him.', { x: b.x + 6, y: 12, width: 128, to: { x: b.x + b.width * 0.4, y: h2 * 0.35 }, thought: true })
+    folio(k, k.sheet, 'Nightstar: Blackout — page 7')
+}

package/src/templates/print/comic-hero-overlap.ts

@@ -0,0 +1,40 @@
+// "Nightstar: Blackout", page six: the fight. Frames laid over each other on keylines, so each blow lands on top of the last.
+
+import { Kit, preset } from '../kit'
+import { defineTemplate } from '../build'
+import { caption, folio, FOLIO, comicMeta, comicSetup, pageGrid, panel, rectFrame, rows, say, sfx, tier, tierBox } from '../themes/comic-hero-page'
+
+export default defineTemplate({
+  id: 'comic-overlap',
+  meta: comicMeta('Overlapping page', 'Page six of "Nightstar: Blackout": the fist fight, with frames laid over each other on paper keylines: the punch lands, the backhand lands harder, and Nightstar goes through a bus window before standing up again', ['overlap', 'keyline', 'fight', 'sound effects']),
+  stableNumbers: true,
+  build() {
+    const k = new Kit('Overlapping page', preset('comic-page'))
+    comicSetup(k)
+    drawPage(k)
+    return k.finish()
+  },
+})
+
+/** This page's drawing onto the kit's last sheet: shared with the whole issue (comic-hero-issue). */
+export function drawPage(k: Kit) {
+  const g = 12, { W, H } = pageGrid(k, k.sheet, 36, g)
+    const [h1, h2, h3] = rows(H - FOLIO, g, [30, 40, 30])
+    const t1 = tierBox(k, k.sheet, W, h1, 'Tier 1')
+    const [a, b] = tier(W, h1, [3, 2], g)
+    panel(k, t1, a, 'over-1', { ground: 'heroG1', name: 'The charge' })
+    panel(k, t1, rectFrame(b.x - 40, 14, b.width + 40, h1 - 14), 'over-2', { ground: 'heroG2', name: 'The punch', keyline: 7 })
+    caption(k, t1, 'Round two.', { x: 10, y: 10, width: 110 })
+    sfx(k, t1, 'Thwakk!', { x: W - 220, y: h1 - 96, w: 200, h: 86, deg: -8, seed: 5 })
+    const t2 = tierBox(k, k.sheet, W, h2, 'Tier 2')
+    panel(k, t2, rectFrame(0, 0, W, h2), 'over-3', { ground: 'heroG3', name: 'The backhand' })
+    panel(k, t2, rectFrame(Math.round(W * 0.6), 20, Math.round(W * 0.4) - 12, h2 - 40), 'over-4', { ground: 'heroG1', name: 'Through the bus', keyline: 8 })
+    sfx(k, t2, 'Wham!', { x: 14, y: h2 - 120, w: 210, h: 100, deg: -6, fill: 'primary', seed: 8 })
+    const t3 = tierBox(k, k.sheet, W, h3, 'Tier 3')
+    const [c, d] = tier(W, h3, [3, 2], g)
+    panel(k, t3, c, 'over-5', { ground: 'heroG2', name: 'Back up' })
+    panel(k, t3, d, 'over-6', { ground: 'heroG3', name: 'The grin' })
+    say(k, t3, 'That all you’ve got?', { x: 12, y: 12, width: 128, to: { x: c.width * 0.18, y: h3 * 0.4 } })
+    say(k, t3, 'Not even close.', { x: W - 108, y: h3 - 70, width: 96, to: { x: d.x + d.width * 0.5, y: h3 * 0.45 } })
+    folio(k, k.sheet, 'Nightstar: Blackout — page 6')
+}

package/src/templates/print/comic-hero-parallel.ts

@@ -0,0 +1,40 @@
+// "Nightstar: Blackout", page eight: the cross-cut. Him on the left, her on the right, both halves of one move.
+
+import { Kit, preset } from '../kit'
+import { defineTemplate } from '../build'
+import { caption, folio, FOLIO, comicMeta, comicSetup, pageGrid, panel, rows, say, sfx, slantTier, tierBox } from '../themes/comic-hero-page'
+
+export default defineTemplate({
+  id: 'comic-parallel',
+  meta: comicMeta('Parallel page', 'Page eight of "Nightstar: Blackout": two columns side by side, Nightstar holding off the lightning on the left while Rosa runs for the junction box on the right, until she pulls the lever and the storm dies', ['parallel', 'two columns', 'cross-cutting', 'sound effects']),
+  stableNumbers: true,
+  build() {
+    const k = new Kit('Parallel page', preset('comic-page'))
+    comicSetup(k)
+    drawPage(k)
+    return k.finish()
+  },
+})
+
+/** This page's drawing onto the kit's last sheet: shared with the whole issue (comic-hero-issue). */
+export function drawPage(k: Kit) {
+  const g = 12, { W, H } = pageGrid(k, k.sheet, 36, g)
+    const hs = rows(H - FOLIO, g, [1, 1, 1])
+    const pairs = [['para-1', 'para-2', 'Into the glare', 'Rosa runs'], ['para-3', 'para-4', 'Holding on', 'The lever'], ['para-5', 'para-6', 'The storm dies', 'Thumbs up']] as const
+    const ts = hs.map((h, i) => {
+      const t = tierBox(k, k.sheet, W, h, `Tier ${i + 1}`)
+      const [a, b] = slantTier(W, h, [1, 1], i % 2 ? -14 : 14, g)
+      panel(k, t, a, pairs[i][0], { ground: i % 2 ? 'heroG2' : 'heroG1', name: pairs[i][2] })
+      panel(k, t, b, pairs[i][1], { ground: 'heroG3', name: pairs[i][3] })
+      return t
+    })
+    const half = W / 2
+    caption(k, ts[0], 'Him.', { x: 10, y: 10, width: 70 })
+    caption(k, ts[0], 'Her.', { x: half + 20, y: 10, width: 70 })
+    say(k, ts[1], 'Hold... on...', { x: 10, y: 10, width: 96, to: { x: half * 0.6, y: hs[1] * 0.4 } })
+    sfx(k, ts[1], 'Ka-chunk!', { x: W - 280, y: hs[1] - 100, w: 260, h: 90, deg: -8, seed: 6 })
+    say(k, ts[1], 'Lights out, big guy!', { x: half + 24, y: 10, width: 128, to: { x: half + half * 0.3, y: hs[1] * 0.35 } })
+    say(k, ts[2], 'What?! No—', { x: 10, y: 10, width: 96, to: { x: half * 0.5, y: hs[2] * 0.3 } })
+    say(k, ts[2], 'Nice work, courier.', { x: W - 140, y: 10, width: 128, to: { x: half + half * 0.4, y: hs[2] * 0.25 } })
+    folio(k, k.sheet, 'Nightstar: Blackout — page 8')
+}

package/src/templates/print/comic-hero-pinup.ts

@@ -0,0 +1,29 @@
+// "Nightstar: Blackout", the pin-up. One figure, full bleed, the morning after.
+
+import { Kit, preset } from '../kit'
+import { defineTemplate } from '../build'
+import { bleedFrame, foot, rectFrame, comicMeta, comicSetup, panel, say, caption, SIZE, tierBox } from '../themes/comic-hero-page'
+
+export default defineTemplate({
+  id: 'comic-pinup',
+  meta: comicMeta('Pin-up page', 'The pin-up from "Nightstar: Blackout": Nightstar on the edge of a rooftop at sunrise over the city he kept alive, full bleed, with one line for the morning and the series line on a strip at the foot', ['pin-up', 'splash', 'full bleed', 'hero']),
+  stableNumbers: true,
+  build() {
+    const k = new Kit('Pin-up page', preset('comic-page'))
+    comicSetup(k)
+    drawPage(k)
+    return k.finish()
+  },
+})
+
+/** This page's drawing onto the kit's last sheet: shared with the whole issue (comic-hero-issue). */
+export function drawPage(k: Kit) {
+    const { w: W, h: H } = SIZE.page
+    k.flowSheet(k.sheet, 0, 0)
+    const t = tierBox(k, k.sheet, W, H, 'Pin-up')
+    const b = bleedFrame(k, W, H)
+    panel(k, t, rectFrame(b.x, b.y, b.width, H - 84 - b.y), 'pinup', { ground: 'heroG1', name: 'Splash art', edge: false })
+    caption(k, t, 'The night is over. Nightstar stays.', { x: 20, y: 20, width: 190, name: 'Cover line' })
+    say(k, t, 'Morning, city.', { x: 40, y: H * 0.18, width: 96, to: { x: W * 0.5, y: H * 0.13 } })
+    foot(k, t, W, 84, 'Nightstar. Blackout, part one.', 'Pin-up line')
+}

package/src/templates/print/comic-hero-widescreen.ts

@@ -0,0 +1,35 @@
+// "Nightstar: Blackout", page three: the street. Four letterbox frames read like a film running, one beat a frame.
+
+import { Kit, preset } from '../kit'
+import { defineTemplate } from '../build'
+import { caption, folio, FOLIO, comicMeta, comicSetup, pageGrid, panel, rows, say, sfx, tier, tierBox } from '../themes/comic-hero-page'
+
+export default defineTemplate({
+  id: 'comic-widescreen',
+  meta: comicMeta('Widescreen page', 'Page three of "Nightstar: Blackout": four letterbox frames, one under the other like a film, as Rosa rides home, Voltrix lands in the avenue, her bike goes flying and he stands over her', ['widescreen', 'cinematic', 'letterbox', 'sound effects']),
+  stableNumbers: true,
+  build() {
+    const k = new Kit('Widescreen page', preset('comic-page'))
+    comicSetup(k)
+    drawPage(k)
+    return k.finish()
+  },
+})
+
+/** This page's drawing onto the kit's last sheet: shared with the whole issue (comic-hero-issue). */
+export function drawPage(k: Kit) {
+  const g = 12, { W, H } = pageGrid(k, k.sheet, 36, g)
+    const hs = rows(H - FOLIO, g, [1, 1, 1, 1])
+    const pics = ['wide-1', 'wide-2', 'wide-3', 'wide-4'] as const
+    const names = ['Rosa rides home', 'Voltrix lands', 'Thrown', 'Cornered']
+    const tiers = hs.map((h, i) => {
+      const t = tierBox(k, k.sheet, W, h, `Tier ${i + 1}`)
+      panel(k, t, tier(W, h, [1], g)[0], pics[i], { ground: (['heroG1', 'heroG2', 'heroG3', 'heroG1'] as const)[i], name: names[i] })
+      return t
+    })
+    caption(k, tiers[0], 'Rosa Vega. Last delivery of the night.', { x: 10, y: 10, width: 220 })
+    sfx(k, tiers[1], 'Kra-thoom!', { x: W - 330, y: 8, w: 300, h: 110, deg: -6, big: false, seed: 3 })
+    say(k, tiers[2], 'No no no—', { x: W - 120, y: 12, width: 96, to: { x: W * 0.62, y: hs[2] * 0.45 } })
+    say(k, tiers[3], 'Wrong street, kid.', { x: 12, y: 12, width: 128, to: { x: W * 0.38, y: hs[3] * 0.3 } })
+    folio(k, k.sheet, 'Nightstar: Blackout — page 3')
+}

package/src/templates/themes/comic-hero-art.ts

@@ -0,0 +1,66 @@
+// The comic hero pack's own art (./comic-hero-*.ts): one panel each, made with an image model (FLUX.3 through the
+// Vercel AI Gateway) from one fixed style line and one fixed sentence per character, so the series stays on model.
+// Shipped as JPEG under the media store's content hash in public/templates/media, at most 1152 px on the long side.
+// Made for these templates: free to use with them.
+
+/** The style line every panel prompt starts with. */
+export const STYLE = "Gritty energetic modern indie action comic art, rough expressive brush inks, scratchy hatching, explosive motion, raw kinetic linework."
+/** The cast, each a fixed sentence reused word for word in every prompt they appear in. */
+export const CAST = { nightstar: "Nightstar is an original masked hero: a lean athletic man in a sleek midnight-blue bodysuit with a large gold five-pointed star emblem on the chest, a midnight-blue cowl mask covering the upper face, gold gloves and gold boots.", voltrix: "Voltrix is an original villain: a hulking bald man in scorched charcoal-grey armour plating with crackling green electric coils on his shoulders and round glowing green goggles.", rosa: "Rosa is an original young woman bike courier with a curly black ponytail, a bright yellow rain jacket, a red messenger bag and a white cycling helmet." } as const
+
+export const ART = {
+  'cover': { hash: '0520923bafe128b0edbdcc30fd65a023', width: 768, height: 1152, subject: "Low-angle cover shot: Nightstar bursts upward through a shattering neon-lit night sky over a rain-soaked city, fist forward, while the giant shadowy figure of Voltrix looms behind him wreathed in green lightning." },
+  'chase-1': { hash: '5ef8494cf4126515d8fca8060f411195', width: 1152, height: 651, subject: "Establishing wide shot: a city power substation at midnight in the rain, Voltrix tearing a transformer open with his bare hands, green electricity arcing everywhere." },
+  'chase-2': { hash: '1365a184ce73877fc228f8990656c17d', width: 1024, height: 1024, subject: "Medium shot: Nightstar crouched on a gargoyle ledge high above the rainy city, looking down, cape-less, alert." },
+  'chase-3': { hash: 'f1b38bcc56e2f6aa164528c7940fe9a8', width: 1152, height: 651, subject: "Action: Voltrix smashes through a brick wall onto a rooftop and runs, Nightstar sprinting after him across the rooftops, rain and debris flying." },
+  'chase-4': { hash: '40ef203c1fad0b155377653cc3ad6717', width: 1152, height: 651, subject: "Nightstar leaps across a wide gap between two skyscrapers, seen from below, the street far beneath, body stretched, explosive motion." },
+  'chase-5': { hash: '9e5b62ed93b6cf6a76edfbb87e74c09e', width: 1024, height: 1024, subject: "Close-up: Voltrix glancing back over his shoulder with a snarl, green goggles blazing, sparks in the rain." },
+  'chase-6': { hash: 'c4fe9f3ce9be13c97f930513fca1e3bc', width: 1152, height: 651, subject: "Voltrix hurls a crackling bolt of green lightning backward at Nightstar, who twists mid-air to dodge it, a water tower exploding behind them." },
+  'wide-1': { hash: '02e36cd0fde4da676db1d5cbcd97e702', width: 1152, height: 651, subject: "Wide cinematic street shot at night: Rosa riding her bicycle down a wet neon avenue, headlights and reflections, unaware of danger." },
+  'wide-2': { hash: 'd142ece06355008414409995bcc8efbe', width: 1152, height: 651, subject: "Wide shot: Voltrix crashes down from above into the middle of the avenue, the asphalt cracking in a crater, cars flipping, green lightning." },
+  'wide-3': { hash: 'b5819cb6b068143e82a0130c5acfdf96', width: 1152, height: 651, subject: "Rosa flung from her bicycle, tumbling across the wet street, her bike spinning away, shards of glass in the air." },
+  'wide-4': { hash: 'fd743798c2c8ac767c882c54aadfe879', width: 856, height: 1152, subject: "Voltrix towers over Rosa who scrambles backward on the wet street, terrified, the villain reaching for her with crackling hand." },
+  'break-1': { hash: '24864c9ff00eaad797ee689c1edceb68', width: 1024, height: 1024, subject: "Medium shot: Voltrix grabs Rosa, in her bright yellow rain jacket, by the red messenger bag strap, lifting her off the ground, green sparks crackling." },
+  'break-2': { hash: 'db24fc4cb6ad05abf82015ab3808caec', width: 1024, height: 1024, subject: "Extreme close-up of Rosa's frightened eyes reflecting green lightning, rain on her face." },
+  'break-3': { hash: '788a368f7c91115beffba384edd6a8cb', width: 1152, height: 651, subject: "Explosive splash: Nightstar crashes feet-first down onto Voltrix from above, a huge shockwave of rain and debris, the gold star blazing, raw kinetic impact." },
+  'break-4': { hash: 'a58e82a3827c6e8c1be23ad3e815955d', width: 1024, height: 1024, subject: "Rosa dropped free, landing hard on the pavement and rolling clear, debris raining around her." },
+  'break-5': { hash: '2da6d96fbb481845e780cf6240ece2d1', width: 1152, height: 651, subject: "Nightstar and Voltrix grappling in the crater, sparks and rain, faces close, straining." },
+  'cascade-1': { hash: 'ba3f66a4535367034168b1f7c257f23a', width: 1152, height: 651, subject: "Voltrix slams both fists into a street lamp, sending a surge of green electricity up into a neon billboard on a building above." },
+  'cascade-2': { hash: '9c7d695c57cca051f10c4b4d1877c911', width: 856, height: 1152, subject: "Looking up from street level: a huge burning neon billboard and steel scaffolding breaking loose and falling toward Rosa below." },
+  'cascade-3': { hash: '60514687976f160868b3e94a4a57f890', width: 1024, height: 1024, subject: "Close-up: Rosa looking up in horror, arm raised, sparks falling around her." },
+  'cascade-4': { hash: '504c48cf772656d01816a0a0e3288b87', width: 1152, height: 651, subject: "Nightstar dives in and sweeps Rosa out of the way just as the falling billboard smashes into the street behind them, explosion of sparks and glass." },
+  'cascade-5': { hash: '5e76b5ac2000cee5fe5b2c0b5affc1a9', width: 1024, height: 1024, subject: "Nightstar kneels shielding Rosa with his body as burning debris settles, both covered in dust, rain hissing on embers." },
+  'cascade-6': { hash: 'fa7831e2704e9b69b06136766d710406', width: 1152, height: 651, subject: "Wide: Voltrix standing in the flames on the street, laughing, green coils glowing brighter, the city lights flickering out behind him." },
+  'over-1': { hash: 'c92e06d52a7587127ac2396136bfa0ef', width: 1152, height: 651, subject: "Nightstar charges at Voltrix through fire and rain, fist cocked back, heavy motion streaks." },
+  'over-2': { hash: '6569e01fd26e0ec21599d18239beeecb', width: 1024, height: 1024, subject: "Close impact: Nightstar's gold-gloved fist connects with Voltrix's jaw, shockwave, teeth and sparks flying." },
+  'over-3': { hash: 'f18dc474dbb6f05a0ec0a1dd5f035373', width: 1024, height: 1024, subject: "Voltrix backhands Nightstar, sending him spinning backward through the air in a spray of rain." },
+  'over-4': { hash: 'efccaca49150c0ffc3ff4d19751acf4b', width: 1152, height: 651, subject: "Nightstar crashes through the front window of a parked city bus, glass exploding outward, dynamic angle." },
+  'over-5': { hash: '8b715da4ff00f7d65667f4723ce20ed2', width: 1152, height: 651, subject: "Nightstar rising from the wrecked bus, bruised, gold star cracked and glinting, facing Voltrix across the burning street." },
+  'over-6': { hash: '20b922922d145451550a308ef18f058e', width: 1024, height: 1024, subject: "Close-up of Voltrix's grinning face, green goggles glowing, lightning crackling across his armour." },
+  'nest-1': { hash: '49804db37766dd3fbf8815741311bcdb', width: 1152, height: 651, subject: "Wide: Voltrix grabs a high-voltage power line with both hands, absorbing the whole city's electricity, a column of green lightning shooting into the clouds." },
+  'nest-2': { hash: 'd04f29f9b8a27e12512e270abd239548', width: 1024, height: 1024, subject: "Close-up: Voltrix's armour coils overloading, glowing white-green, steam and sparks pouring off them." },
+  'nest-3': { hash: '0ae711478fafb2a9e7445ec561073121', width: 1024, height: 1024, subject: "Close-up: Nightstar shielding his masked eyes against the blinding green glare, wind whipping." },
+  'nest-4': { hash: '3c9ff7ef455e356c4b09fe598b2ca5e9', width: 1152, height: 651, subject: "Wide: the whole city skyline going dark block by block as the lights are drained, one green glow in the middle." },
+  'nest-5': { hash: 'bb84d4f02a8f45c8904d06bb164f92b5', width: 1152, height: 651, subject: "Rosa crouched alone behind a wrecked car, clutching her red messenger bag, eyes fixed on a thick black power cable snaking across the empty wet street, green glow on the horizon. No creatures, no other people." },
+  'para-1': { hash: '58b0040a4025bda6c8fc77f2cf9b7d95', width: 1024, height: 1024, subject: "Nightstar battered and staggering forward into the glare toward Voltrix, who stands in the background wreathed in green lightning, one arm up against the energy storm." },
+  'para-2': { hash: '8252a932560a2e6eb96ce5e178e39063', width: 1024, height: 1024, subject: "Rosa sprinting low along the wet street toward a junction box where the thick power cable connects, yellow jacket bright." },
+  'para-3': { hash: 'e03aca5703774849c89a6223d4bd3691', width: 1024, height: 1024, subject: "Voltrix blasts Nightstar with a beam of green lightning, Nightstar bracing behind crossed arms, being pushed back, feet dragging sparks." },
+  'para-4': { hash: '5e515e2b6f1e7715c17057f908858e09', width: 1024, height: 1024, subject: "Rosa yanking a big red emergency lever on the open junction box, sparks flying in her face, teeth gritted." },
+  'para-5': { hash: '70fdd68ee6f96ea603dede17f979cebf', width: 1024, height: 1024, subject: "Voltrix's lightning suddenly sputtering out, his coils dimming, shock on his face." },
+  'para-6': { hash: '7a7f8d301383756e74caeb6ae8c8ae1f', width: 1024, height: 1024, subject: "Nightstar glances back at Rosa by the junction box, she gives him a thumbs up, rain and smoke between them." },
+  'manga-1': { hash: '533e5dacbce7966d8b537ccb767d1460', width: 856, height: 1152, subject: "Extreme dynamic foreshortening: Nightstar launches himself straight at the viewer, fist leading, speed lines radiating, rain frozen around him." },
+  'manga-2': { hash: '89bf37366fabc1a9ce15b22e70eca072', width: 1024, height: 1024, subject: "Voltrix raising both armoured arms to block, terror in his face, coils dead." },
+  'manga-3': { hash: 'e45832e1da6f3927ab09d0fe31a3aa8b', width: 1152, height: 651, subject: "The final punch: Nightstar's fist smashes through Voltrix's guard into his chest armour, the armour shattering into pieces, enormous radiating impact burst." },
+  'manga-4': { hash: 'e781ad2b37fd73e79755868622eccd21', width: 1024, height: 1024, subject: "Close-up of Nightstar's masked eyes, intense, a trickle of blood, rain." },
+  'manga-5': { hash: 'c6a44369f7251227f7161c5de7d001a1', width: 1152, height: 651, subject: "Voltrix flying backward and crashing through a parked delivery truck, armour pieces scattering, smoke." },
+  'interro-1': { hash: '67578b7d4a3caae86cc4501a7d8f5672', width: 1152, height: 651, subject: "Wide: an abandoned warehouse at dawn lit by one hanging bulb, Voltrix in broken armour chained to a steel chair, Nightstar standing over him." },
+  'interro-2': { hash: '835dd9bf563b21c08f02439d97ab2356', width: 1024, height: 1024, subject: "Close-up: Nightstar leaning in, masked face half in shadow under the bulb, stern." },
+  'interro-3': { hash: '56a8c320e8a651b852abb492a0e35029', width: 1024, height: 1024, subject: "Close-up: Voltrix in his chair, goggles cracked, smirking, a bruise on his cheek." },
+  'interro-4': { hash: '9cf91fa3b2d4853704f7d699b60d49eb', width: 1024, height: 1024, subject: "Nightstar slamming a gold-gloved fist on a metal table, the bulb swinging, shadows lurching." },
+  'interro-5': { hash: '21dd22e30cccfb6bb82925dd46ee7b1c', width: 1024, height: 1024, subject: "Extreme close-up of Voltrix's mouth as he grins, a single green spark on a broken tooth." },
+  'interro-6': { hash: '01d85a8b550d80743fbc01002c800ced', width: 1152, height: 651, subject: "Nightstar walking out of the warehouse doorway into morning light where Rosa waits with her bicycle, backlit silhouettes." },
+  'pinup': { hash: '7f2004bc780c91f788d95e68009147b1', width: 856, height: 1152, subject: "Pin-up: Nightstar standing heroically on the edge of a skyscraper rooftop at sunrise, wind in the scene, the city below washed in orange light, gold star gleaming." },
+} as const
+
+export type ArtId = keyof typeof ART
+export const art = (id: ArtId): string => `media://${ART[id].hash}`