@popcraft/kit 0.30.0 → 0.32.0

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

@@ -0,0 +1,318 @@
+/** The style line every panel prompt starts with. */
+export declare 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 declare const CAST: {
+    readonly 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.";
+    readonly 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.";
+    readonly 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.";
+};
+export declare const ART: {
+    readonly cover: {
+        readonly hash: "0520923bafe128b0edbdcc30fd65a023";
+        readonly width: 768;
+        readonly height: 1152;
+        readonly 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.";
+    };
+    readonly 'chase-1': {
+        readonly hash: "5ef8494cf4126515d8fca8060f411195";
+        readonly width: 1152;
+        readonly height: 651;
+        readonly 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.";
+    };
+    readonly 'chase-2': {
+        readonly hash: "1365a184ce73877fc228f8990656c17d";
+        readonly width: 1024;
+        readonly height: 1024;
+        readonly subject: "Medium shot: Nightstar crouched on a gargoyle ledge high above the rainy city, looking down, cape-less, alert.";
+    };
+    readonly 'chase-3': {
+        readonly hash: "f1b38bcc56e2f6aa164528c7940fe9a8";
+        readonly width: 1152;
+        readonly height: 651;
+        readonly subject: "Action: Voltrix smashes through a brick wall onto a rooftop and runs, Nightstar sprinting after him across the rooftops, rain and debris flying.";
+    };
+    readonly 'chase-4': {
+        readonly hash: "40ef203c1fad0b155377653cc3ad6717";
+        readonly width: 1152;
+        readonly height: 651;
+        readonly subject: "Nightstar leaps across a wide gap between two skyscrapers, seen from below, the street far beneath, body stretched, explosive motion.";
+    };
+    readonly 'chase-5': {
+        readonly hash: "9e5b62ed93b6cf6a76edfbb87e74c09e";
+        readonly width: 1024;
+        readonly height: 1024;
+        readonly subject: "Close-up: Voltrix glancing back over his shoulder with a snarl, green goggles blazing, sparks in the rain.";
+    };
+    readonly 'chase-6': {
+        readonly hash: "c4fe9f3ce9be13c97f930513fca1e3bc";
+        readonly width: 1152;
+        readonly height: 651;
+        readonly 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.";
+    };
+    readonly 'wide-1': {
+        readonly hash: "02e36cd0fde4da676db1d5cbcd97e702";
+        readonly width: 1152;
+        readonly height: 651;
+        readonly subject: "Wide cinematic street shot at night: Rosa riding her bicycle down a wet neon avenue, headlights and reflections, unaware of danger.";
+    };
+    readonly 'wide-2': {
+        readonly hash: "d142ece06355008414409995bcc8efbe";
+        readonly width: 1152;
+        readonly height: 651;
+        readonly subject: "Wide shot: Voltrix crashes down from above into the middle of the avenue, the asphalt cracking in a crater, cars flipping, green lightning.";
+    };
+    readonly 'wide-3': {
+        readonly hash: "b5819cb6b068143e82a0130c5acfdf96";
+        readonly width: 1152;
+        readonly height: 651;
+        readonly subject: "Rosa flung from her bicycle, tumbling across the wet street, her bike spinning away, shards of glass in the air.";
+    };
+    readonly 'wide-4': {
+        readonly hash: "fd743798c2c8ac767c882c54aadfe879";
+        readonly width: 856;
+        readonly height: 1152;
+        readonly subject: "Voltrix towers over Rosa who scrambles backward on the wet street, terrified, the villain reaching for her with crackling hand.";
+    };
+    readonly 'break-1': {
+        readonly hash: "24864c9ff00eaad797ee689c1edceb68";
+        readonly width: 1024;
+        readonly height: 1024;
+        readonly 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.";
+    };
+    readonly 'break-2': {
+        readonly hash: "db24fc4cb6ad05abf82015ab3808caec";
+        readonly width: 1024;
+        readonly height: 1024;
+        readonly subject: "Extreme close-up of Rosa's frightened eyes reflecting green lightning, rain on her face.";
+    };
+    readonly 'break-3': {
+        readonly hash: "788a368f7c91115beffba384edd6a8cb";
+        readonly width: 1152;
+        readonly height: 651;
+        readonly 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.";
+    };
+    readonly 'break-4': {
+        readonly hash: "a58e82a3827c6e8c1be23ad3e815955d";
+        readonly width: 1024;
+        readonly height: 1024;
+        readonly subject: "Rosa dropped free, landing hard on the pavement and rolling clear, debris raining around her.";
+    };
+    readonly 'break-5': {
+        readonly hash: "2da6d96fbb481845e780cf6240ece2d1";
+        readonly width: 1152;
+        readonly height: 651;
+        readonly subject: "Nightstar and Voltrix grappling in the crater, sparks and rain, faces close, straining.";
+    };
+    readonly 'cascade-1': {
+        readonly hash: "ba3f66a4535367034168b1f7c257f23a";
+        readonly width: 1152;
+        readonly height: 651;
+        readonly subject: "Voltrix slams both fists into a street lamp, sending a surge of green electricity up into a neon billboard on a building above.";
+    };
+    readonly 'cascade-2': {
+        readonly hash: "9c7d695c57cca051f10c4b4d1877c911";
+        readonly width: 856;
+        readonly height: 1152;
+        readonly subject: "Looking up from street level: a huge burning neon billboard and steel scaffolding breaking loose and falling toward Rosa below.";
+    };
+    readonly 'cascade-3': {
+        readonly hash: "60514687976f160868b3e94a4a57f890";
+        readonly width: 1024;
+        readonly height: 1024;
+        readonly subject: "Close-up: Rosa looking up in horror, arm raised, sparks falling around her.";
+    };
+    readonly 'cascade-4': {
+        readonly hash: "504c48cf772656d01816a0a0e3288b87";
+        readonly width: 1152;
+        readonly height: 651;
+        readonly 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.";
+    };
+    readonly 'cascade-5': {
+        readonly hash: "5e76b5ac2000cee5fe5b2c0b5affc1a9";
+        readonly width: 1024;
+        readonly height: 1024;
+        readonly subject: "Nightstar kneels shielding Rosa with his body as burning debris settles, both covered in dust, rain hissing on embers.";
+    };
+    readonly 'cascade-6': {
+        readonly hash: "fa7831e2704e9b69b06136766d710406";
+        readonly width: 1152;
+        readonly height: 651;
+        readonly subject: "Wide: Voltrix standing in the flames on the street, laughing, green coils glowing brighter, the city lights flickering out behind him.";
+    };
+    readonly 'over-1': {
+        readonly hash: "c92e06d52a7587127ac2396136bfa0ef";
+        readonly width: 1152;
+        readonly height: 651;
+        readonly subject: "Nightstar charges at Voltrix through fire and rain, fist cocked back, heavy motion streaks.";
+    };
+    readonly 'over-2': {
+        readonly hash: "6569e01fd26e0ec21599d18239beeecb";
+        readonly width: 1024;
+        readonly height: 1024;
+        readonly subject: "Close impact: Nightstar's gold-gloved fist connects with Voltrix's jaw, shockwave, teeth and sparks flying.";
+    };
+    readonly 'over-3': {
+        readonly hash: "f18dc474dbb6f05a0ec0a1dd5f035373";
+        readonly width: 1024;
+        readonly height: 1024;
+        readonly subject: "Voltrix backhands Nightstar, sending him spinning backward through the air in a spray of rain.";
+    };
+    readonly 'over-4': {
+        readonly hash: "efccaca49150c0ffc3ff4d19751acf4b";
+        readonly width: 1152;
+        readonly height: 651;
+        readonly subject: "Nightstar crashes through the front window of a parked city bus, glass exploding outward, dynamic angle.";
+    };
+    readonly 'over-5': {
+        readonly hash: "8b715da4ff00f7d65667f4723ce20ed2";
+        readonly width: 1152;
+        readonly height: 651;
+        readonly subject: "Nightstar rising from the wrecked bus, bruised, gold star cracked and glinting, facing Voltrix across the burning street.";
+    };
+    readonly 'over-6': {
+        readonly hash: "20b922922d145451550a308ef18f058e";
+        readonly width: 1024;
+        readonly height: 1024;
+        readonly subject: "Close-up of Voltrix's grinning face, green goggles glowing, lightning crackling across his armour.";
+    };
+    readonly 'nest-1': {
+        readonly hash: "49804db37766dd3fbf8815741311bcdb";
+        readonly width: 1152;
+        readonly height: 651;
+        readonly 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.";
+    };
+    readonly 'nest-2': {
+        readonly hash: "d04f29f9b8a27e12512e270abd239548";
+        readonly width: 1024;
+        readonly height: 1024;
+        readonly subject: "Close-up: Voltrix's armour coils overloading, glowing white-green, steam and sparks pouring off them.";
+    };
+    readonly 'nest-3': {
+        readonly hash: "0ae711478fafb2a9e7445ec561073121";
+        readonly width: 1024;
+        readonly height: 1024;
+        readonly subject: "Close-up: Nightstar shielding his masked eyes against the blinding green glare, wind whipping.";
+    };
+    readonly 'nest-4': {
+        readonly hash: "3c9ff7ef455e356c4b09fe598b2ca5e9";
+        readonly width: 1152;
+        readonly height: 651;
+        readonly subject: "Wide: the whole city skyline going dark block by block as the lights are drained, one green glow in the middle.";
+    };
+    readonly 'nest-5': {
+        readonly hash: "bb84d4f02a8f45c8904d06bb164f92b5";
+        readonly width: 1152;
+        readonly height: 651;
+        readonly 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.";
+    };
+    readonly 'para-1': {
+        readonly hash: "58b0040a4025bda6c8fc77f2cf9b7d95";
+        readonly width: 1024;
+        readonly height: 1024;
+        readonly 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.";
+    };
+    readonly 'para-2': {
+        readonly hash: "8252a932560a2e6eb96ce5e178e39063";
+        readonly width: 1024;
+        readonly height: 1024;
+        readonly subject: "Rosa sprinting low along the wet street toward a junction box where the thick power cable connects, yellow jacket bright.";
+    };
+    readonly 'para-3': {
+        readonly hash: "e03aca5703774849c89a6223d4bd3691";
+        readonly width: 1024;
+        readonly height: 1024;
+        readonly subject: "Voltrix blasts Nightstar with a beam of green lightning, Nightstar bracing behind crossed arms, being pushed back, feet dragging sparks.";
+    };
+    readonly 'para-4': {
+        readonly hash: "5e515e2b6f1e7715c17057f908858e09";
+        readonly width: 1024;
+        readonly height: 1024;
+        readonly subject: "Rosa yanking a big red emergency lever on the open junction box, sparks flying in her face, teeth gritted.";
+    };
+    readonly 'para-5': {
+        readonly hash: "70fdd68ee6f96ea603dede17f979cebf";
+        readonly width: 1024;
+        readonly height: 1024;
+        readonly subject: "Voltrix's lightning suddenly sputtering out, his coils dimming, shock on his face.";
+    };
+    readonly 'para-6': {
+        readonly hash: "7a7f8d301383756e74caeb6ae8c8ae1f";
+        readonly width: 1024;
+        readonly height: 1024;
+        readonly subject: "Nightstar glances back at Rosa by the junction box, she gives him a thumbs up, rain and smoke between them.";
+    };
+    readonly 'manga-1': {
+        readonly hash: "533e5dacbce7966d8b537ccb767d1460";
+        readonly width: 856;
+        readonly height: 1152;
+        readonly subject: "Extreme dynamic foreshortening: Nightstar launches himself straight at the viewer, fist leading, speed lines radiating, rain frozen around him.";
+    };
+    readonly 'manga-2': {
+        readonly hash: "89bf37366fabc1a9ce15b22e70eca072";
+        readonly width: 1024;
+        readonly height: 1024;
+        readonly subject: "Voltrix raising both armoured arms to block, terror in his face, coils dead.";
+    };
+    readonly 'manga-3': {
+        readonly hash: "e45832e1da6f3927ab09d0fe31a3aa8b";
+        readonly width: 1152;
+        readonly height: 651;
+        readonly 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.";
+    };
+    readonly 'manga-4': {
+        readonly hash: "e781ad2b37fd73e79755868622eccd21";
+        readonly width: 1024;
+        readonly height: 1024;
+        readonly subject: "Close-up of Nightstar's masked eyes, intense, a trickle of blood, rain.";
+    };
+    readonly 'manga-5': {
+        readonly hash: "c6a44369f7251227f7161c5de7d001a1";
+        readonly width: 1152;
+        readonly height: 651;
+        readonly subject: "Voltrix flying backward and crashing through a parked delivery truck, armour pieces scattering, smoke.";
+    };
+    readonly 'interro-1': {
+        readonly hash: "67578b7d4a3caae86cc4501a7d8f5672";
+        readonly width: 1152;
+        readonly height: 651;
+        readonly 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.";
+    };
+    readonly 'interro-2': {
+        readonly hash: "835dd9bf563b21c08f02439d97ab2356";
+        readonly width: 1024;
+        readonly height: 1024;
+        readonly subject: "Close-up: Nightstar leaning in, masked face half in shadow under the bulb, stern.";
+    };
+    readonly 'interro-3': {
+        readonly hash: "56a8c320e8a651b852abb492a0e35029";
+        readonly width: 1024;
+        readonly height: 1024;
+        readonly subject: "Close-up: Voltrix in his chair, goggles cracked, smirking, a bruise on his cheek.";
+    };
+    readonly 'interro-4': {
+        readonly hash: "9cf91fa3b2d4853704f7d699b60d49eb";
+        readonly width: 1024;
+        readonly height: 1024;
+        readonly subject: "Nightstar slamming a gold-gloved fist on a metal table, the bulb swinging, shadows lurching.";
+    };
+    readonly 'interro-5': {
+        readonly hash: "21dd22e30cccfb6bb82925dd46ee7b1c";
+        readonly width: 1024;
+        readonly height: 1024;
+        readonly subject: "Extreme close-up of Voltrix's mouth as he grins, a single green spark on a broken tooth.";
+    };
+    readonly 'interro-6': {
+        readonly hash: "01d85a8b550d80743fbc01002c800ced";
+        readonly width: 1152;
+        readonly height: 651;
+        readonly subject: "Nightstar walking out of the warehouse doorway into morning light where Rosa waits with her bicycle, backlit silhouettes.";
+    };
+    readonly pinup: {
+        readonly hash: "7f2004bc780c91f788d95e68009147b1";
+        readonly width: 856;
+        readonly height: 1152;
+        readonly 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.";
+    };
+};
+export type ArtId = keyof typeof ART;
+export declare const art: (id: ArtId) => string;

package/types/templates/src/themes/comic-hero-page.d.ts

@@ -0,0 +1,177 @@
+import type { Kit } from '../kit.js';
+import { type ArtId } from './comic-hero-art.js';
+export interface Pt {
+    x: number;
+    y: number;
+}
+export interface Frame {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    points: Pt[];
+}
+/** The story's title and issue, as brand fields a kit or a person can change. */
+export declare const STORY: {
+    readonly title: "Nightstar";
+    readonly series: "Blackout";
+    readonly issue: "No. 1";
+};
+/** A comic page's brand, its style's palette, its type and its lettering components. */
+export declare function comicSetup(k: Kit, o?: {
+    paper?: string;
+}): void;
+/** The display styles, each made the first time a page sets type in it (a style nobody uses is clutter). */
+declare const DISPLAY: {
+    SFX: {
+        size: number;
+        fontWeight: number;
+        fontStyle: "italic";
+        lineHeight: number;
+        letterSpacing: number;
+        textAlign: "CENTER";
+    };
+    'SFX big': {
+        size: number;
+        fontWeight: number;
+        fontStyle: "italic";
+        lineHeight: number;
+        letterSpacing: number;
+        textAlign: "CENTER";
+    };
+    Masthead: {
+        size: number;
+        fontWeight: number;
+        lineHeight: number;
+        letterSpacing: number;
+        textAlign: "CENTER";
+    };
+    Title: {
+        size: number;
+        fontWeight: number;
+        lineHeight: number;
+        letterSpacing: number;
+    };
+    Credit: {
+        size: number;
+        fontWeight: number;
+        lineHeight: number;
+        letterSpacing: number;
+    };
+};
+/** `name`, one of the display styles, made on first use. */
+export declare function display(k: Kit, name: keyof typeof DISPLAY): string;
+export declare const rectFrame: (x: number, y: number, width: number, height: number) => Frame;
+/** A frame from corners in tier space: its box, and the corners made panel-local. */
+export declare function frameOf(corners: Pt[]): Frame;
+/** Widths filling `total` in the proportions `parts`, with `gutter` between them. */
+export declare function shares(total: number, gutter: number, parts: number[]): number[];
+/** A plain tier: rectangles side by side. */
+export declare function tier(width: number, height: number, parts: number[], gutter?: number, y?: number): Frame[];
+/** A tier cut by SLANTED gutters (each leans `lean` px): frames that share a diagonal edge read as motion. */
+export declare function slantTier(width: number, height: number, parts: number[], lean?: number, gutter?: number, y?: number): Frame[];
+/** A frame whose top and bottom edges tilt: `dy0` / `dy1` px down at the right end of each (a Dutch tier). */
+export declare function tilted(x: number, y: number, w: number, h: number, dyTop: number, dyBot: number): Frame;
+/** A slice of a ring around (cx, cy): the radial page. */
+export declare function wedgeRing(cx: number, cy: number, rIn: number, rOut: number, from: number, to: number): Frame;
+/** A circle (n-gon) frame: the radial page's hub. */
+export declare function disc(cx: number, cy: number, r: number): Frame;
+/** Grow a polygon from its centroid: the paper keyline an inset frame sits on. */
+export declare function inflate(points: Pt[], by: number): Pt[];
+/** A sheet as a column of tiers with `gutter` between them, inside `margin`. Returns the live area. */
+export declare function pageGrid(k: Kit, sheet: string, margin: number, gutter: number): {
+    W: number;
+    H: number;
+};
+/** A tier: a fixed box in the sheet's column. */
+export declare const tierBox: (k: Kit, sheet: string, W: number, h: number, name: string) => string;
+/** Tier heights that fill `H` in proportion to `parts`, with `gutter` between. */
+export declare const rows: (H: number, gutter: number, parts: number[]) => number[];
+/**
+ * A panel at frame `f` in `tierId`: a mask group of [the frame's shape as mask, its ground, picture `pic`, the ink
+ * edge]. `ground` is the panel's own ground (touching panels must differ). Returns the group.
+ */
+export declare function panel(k: Kit, tierId: string, f: Frame, pic: ArtId, o: {
+    ground: Ground;
+    name?: string;
+    keyline?: number;
+    edge?: boolean;
+}): string;
+/** The panel grounds: touching panels take different ones. */
+export type Ground = 'heroG1' | 'heroG2' | 'heroG3';
+/**
+ * A speech balloon at (x, y) in the tier, `width` wide, its tail running from inside the balloon to `to` (the
+ * speaker's mouth, in tier space). The tail is drawn first, so the balloon covers its root and only the point shows.
+ */
+export declare function say(k: Kit, tierId: string, words: string, o: {
+    x: number;
+    y: number;
+    width?: number;
+    to?: Pt;
+    thought?: boolean;
+    name?: string;
+}): string;
+/** A caption box at (x, y): the narrator, in the corner where the reader's eye enters the panel. */
+export declare function caption(k: Kit, tierId: string, words: string, o: {
+    x: number;
+    y: number;
+    width?: number;
+    name?: string;
+}): string;
+/**
+ * A sound effect drawn into the art: the word on an impact star (accent, inked, on a hard ink shadow), tilted.
+ * `big` for the one hit a page is built round.
+ */
+export declare function sfx(k: Kit, tierId: string, words: string, o: {
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+    deg?: number;
+    big?: boolean;
+    fill?: 'accent' | 'primary';
+    seed?: number;
+    name?: string;
+}): string;
+/** The folio: the series and page number in the foot margin, on paper (the one line read off the art). */
+export declare const FOLIO = 24;
+export declare function folio(k: Kit, sheet: string, words: string): void;
+/** A full-bleed sheet's foot: a paper strip under the art with the line in it, so the line is read on paper. */
+export declare function foot(k: Kit, tierId: string, w: number, h: number, words: string, name: string): string;
+/** The meta every comic page shares: a print page in the comic category. */
+export declare function comicMeta(name: string, description: string, tags: string[]): {
+    name: string;
+    description: string;
+    category: string;
+    tags: string[];
+    platforms: "print"[];
+    formats: "page"[];
+    useCases: "comic"[];
+    created: string;
+    updated: string;
+};
+/** A frame the size of the sheet plus its bleed on every side, for a tier at the sheet's origin. */
+export declare function bleedFrame(k: Kit, w: number, h: number): Frame;
+/** The comic page and spread sizes in px. */
+export declare const SIZE: {
+    readonly page: {
+        readonly w: number;
+        readonly h: number;
+    };
+    readonly cover: {
+        readonly w: number;
+        readonly h: number;
+    };
+    readonly spread: {
+        readonly w: number;
+        readonly h: number;
+    };
+};
+/** A polygon (tier space) cut to the tier's box, as a frame. */
+export declare function clipFrame(pts: Pt[], w: number, h: number): Frame;
+/**
+ * A slice of the page around a hub at (cx, cy): from angle `from` to `to` (degrees, clockwise from +x), starting
+ * `rIn` out, with gutters of even width `g` along both radial edges, running out to the tier's edges.
+ */
+export declare function radialSlice(cx: number, cy: number, rIn: number, from: number, to: number, g: number, w: number, h: number): Frame;
+export {};