@nodaro/prompts 1.53.2 → 1.55.0

package/src/__tests__/video-reference-seatless-assets.test.ts

@@ -0,0 +1,132 @@
+/**
+ * `assetsTakeNoSeat` — the reference walk for a model whose image references
+ * are its FRAMES (a `keyframes` video model, decided 2026-11-11). No asset is
+ * seated: nothing attaches a URL or numbers an `@image_N`. A wired character
+ * gives its name and description in BOTH reference formats (production renders
+ * hybrid), its mentions and `{ref:<id>}` read as its name, and a non-character
+ * extra adds nothing.
+ */
+import { describe, it, expect } from "vitest"
+import type { ConnectedReference } from "@nodaro/shared/types"
+import { resolveVideoReferenceCore } from "../video-reference-resolver.js"
+
+const F1 = "https://cdn/frame-1.png"
+const F2 = "https://cdn/frame-2.png"
+const MAYA = "https://cdn/maya.png"
+const MAYA_SMILE = "https://cdn/maya-smile.png"
+const CAR = "https://cdn/car.png"
+
+const maya: ConnectedReference = {
+  id: "maya-ref",
+  defaultName: "Maya",
+  source: "wired-character",
+  url: MAYA,
+  characterSlug: "maya",
+  characterCanonicalDescription: "Short silver hair, green coat",
+}
+const mayaSmile: ConnectedReference = { ...maya, id: "maya-smile", url: MAYA_SMILE, variantSlug: "smile" }
+
+for (const hybridRoles of [false, true]) {
+  const format = hybridRoles ? "hybrid" : "legacy"
+  describe(`resolveVideoReferenceCore — assetsTakeNoSeat (${format})`, () => {
+    it("a wired character gives its name and description; only the frames go out", () => {
+      const r = resolveVideoReferenceCore({
+        prompt: "she walks to the window",
+        wiredCharRefs: [maya],
+        ordinalOffset: 2,
+        hybridRoles,
+        assetsTakeNoSeat: true,
+      })
+      expect(r.additionalUrls).toEqual([])
+      expect(r.prompt).toContain("Maya — Short silver hair, green coat.")
+      expect(r.prompt).toContain("she walks to the window")
+      expect(r.prompt).not.toMatch(/@image|from @/)
+    })
+
+    it("leading frames come back untouched and nothing joins them", () => {
+      const r = resolveVideoReferenceCore({
+        prompt: "she walks",
+        wiredCharRefs: [maya, mayaSmile],
+        leadingRefUrls: [F1, F2],
+        extraRefs: [{ id: "car", url: CAR, description: "a red car" }],
+        hybridRoles,
+        assetsTakeNoSeat: true,
+      })
+      expect(r.additionalUrls).toEqual([F1, F2])
+      expect(r.prompt).not.toContain("a red car")
+    })
+
+    it("mentions, variant mentions and {ref:<id>} of the character read as its name", () => {
+      const r = resolveVideoReferenceCore({
+        prompt: "@maya:1 smiles at {ref:maya-ref}, then @maya:2:smile waves",
+        wiredCharRefs: [maya, mayaSmile],
+        ordinalOffset: 2,
+        hybridRoles,
+        assetsTakeNoSeat: true,
+      })
+      expect(r.prompt).toContain("Maya smiles at Maya, then Maya waves")
+      expect(r.prompt).toContain("Maya — Short silver hair, green coat.")
+      expect(r.prompt).not.toMatch(/@maya|@image|\{ref:/)
+    })
+
+    it("a character extra speaks for its character once, and its {ref:<id>} reads as the character", () => {
+      const r = resolveVideoReferenceCore({
+        prompt: "look at {ref:x1}",
+        wiredCharRefs: [maya],
+        extraRefs: [{ id: "x1", url: MAYA_SMILE, characterSlug: "maya", variantSlug: "smile", description: "smiling" }],
+        lookupCharacterBySlug: () => ({ characterName: "Maya", canonicalDescription: "Short silver hair, green coat" }),
+        ordinalOffset: 2,
+        hybridRoles,
+        assetsTakeNoSeat: true,
+      })
+      expect(r.prompt).toContain("look at Maya")
+      expect(r.prompt?.match(/Maya — /g)).toHaveLength(1)
+      expect(r.additionalUrls).toEqual([])
+    })
+
+    it("a hidden canonical fallback stays hidden unless the prompt mentions the character", () => {
+      const hidden = resolveVideoReferenceCore({
+        prompt: "an empty room",
+        wiredCharRefs: [maya],
+        suppressedCanonicalCharacterIds: ["maya"],
+        ordinalOffset: 1,
+        hybridRoles,
+        assetsTakeNoSeat: true,
+      })
+      expect(hidden.prompt).toBe("an empty room")
+      const mentioned = resolveVideoReferenceCore({
+        prompt: "@maya:1 in an empty room",
+        wiredCharRefs: [maya],
+        suppressedCanonicalCharacterIds: ["maya"],
+        ordinalOffset: 1,
+        hybridRoles,
+        assetsTakeNoSeat: true,
+      })
+      expect(mentioned.prompt).toContain("Maya in an empty room")
+      expect(mentioned.prompt).toContain("Maya — Short silver hair, green coat.")
+    })
+
+    it("an {image:N} past the frames keeps only its label", () => {
+      const r = resolveVideoReferenceCore({
+        prompt: "between {image:1:the door} and {image:3:Maya}",
+        wiredCharRefs: [maya],
+        ordinalOffset: 2,
+        hybridRoles,
+        assetsTakeNoSeat: true,
+      })
+      expect(r.prompt).toContain("the door from @image_1")
+      expect(r.prompt).not.toContain("@image_3")
+    })
+  })
+}
+
+it("without assetsTakeNoSeat the hybrid walk still seats the character after the frames", () => {
+  const r = resolveVideoReferenceCore({
+    prompt: "she walks",
+    wiredCharRefs: [maya],
+    leadingRefUrls: [F1, F2],
+    hybridRoles: true,
+  })
+  expect(r.additionalUrls).toEqual([F1, F2, MAYA])
+  expect(r.prompt).toMatch(/from @image_3/)
+})

package/src/factory-presets/index.ts

@@ -15,13 +15,17 @@ import { LOTTIE_OVERLAY_PRESETS } from "./lottie-overlay.js"
 
 export type { FactoryPreset, FactoryPresetGroup } from "./types.js"
 export { groupFactoryPresets } from "./types.js"
+export type { PresetShelf } from "./shelves.js"
+export { PRESET_SHELF_ORDER, presetShelf, presetShelfRank } from "./shelves.js"
 export { MAX_PRESET_REFERENCES, presetMinReferences } from "./references.js"
 export {
   FACTORY_PRESET_PREVIEW_FILES,
   FACTORY_PRESET_PREVIEW_LARGE_FILES,
+  FACTORY_PRESET_PREVIEW_SIZES,
   PRESET_PREVIEW_LARGE_WIDTH,
   PRESET_PREVIEW_PATH,
   PRESET_PREVIEW_WIDTH,
+  factoryPresetPreviewSize,
   factoryPresetPreviewSrcSet,
   factoryPresetPreviewUrl,
 } from "./previews.js"

package/src/factory-presets/preview-files.generated.ts

@@ -944,3 +944,475 @@ export const FACTORY_PRESET_PREVIEW_LARGE_FILES: Readonly<Record<string, { reado
   "generate-image/x-statement-card": {"file":"1024/generate-image/x-statement-card.93c12a0c.webp","width":1024},
   "generate-image/youtube-thumbnail": {"file":"1024/generate-image/youtube-thumbnail.fd4d0cf0.webp","width":1024},
 }
+
+// The tile picture's real width and height (the box a client draws it in, before it loads).
+export const FACTORY_PRESET_PREVIEW_SIZES: Readonly<Record<string, readonly [number, number]>> = {
+  "generate-image/3d-icon": [512,288],
+  "generate-image/ad-app-store-screenshot": [512,911],
+  "generate-image/ad-clinic": [512,288],
+  "generate-image/ad-creative": [512,288],
+  "generate-image/ad-facebook-lead": [512,512],
+  "generate-image/ad-gym-offer": [512,683],
+  "generate-image/ad-real-estate-listing": [512,683],
+  "generate-image/ad-restaurant-special": [512,683],
+  "generate-image/ad-salon-promo": [512,683],
+  "generate-image/ad-service-van": [512,288],
+  "generate-image/ad-store-sale": [512,288],
+  "generate-image/add-skin-realism": [512,288],
+  "generate-image/aerial-drone": [512,293],
+  "generate-image/aerial-site": [512,288],
+  "generate-image/age-progression-3": [512,288],
+  "generate-image/age-progression-5": [512,288],
+  "generate-image/age-progression-bw": [512,288],
+  "generate-image/album-cover": [512,512],
+  "generate-image/anime-person-real-bg": [512,288],
+  "generate-image/anime-scene": [512,288],
+  "generate-image/app-icon": [512,288],
+  "generate-image/avatar-pfp": [512,288],
+  "generate-image/background-remove": [512,288],
+  "generate-image/background-replace": [512,288],
+  "generate-image/beauty-hero": [512,288],
+  "generate-image/blueprint": [512,288],
+  "generate-image/book-cover": [512,773],
+  "generate-image/brand-linkedin-banner": [512,219],
+  "generate-image/brand-podcast-cover": [512,512],
+  "generate-image/brand-profile-picture": [512,512],
+  "generate-image/brand-spotify-canvas": [512,911],
+  "generate-image/brand-twitch-banner": [512,219],
+  "generate-image/building-tall": [512,288],
+  "generate-image/bw-portrait": [512,288],
+  "generate-image/candid-snapshot": [512,288],
+  "generate-image/cardboard-diorama": [512,288],
+  "generate-image/caricature-real-photo": [512,288],
+  "generate-image/cartoon-person-real-world": [512,288],
+  "generate-image/cast-mega-grid": [512,288],
+  "generate-image/cast-scene": [512,288],
+  "generate-image/character-action-4": [512,288],
+  "generate-image/character-board": [512,288],
+  "generate-image/character-chibi": [512,288],
+  "generate-image/character-expressions-16": [512,288],
+  "generate-image/character-expressions-6": [512,288],
+  "generate-image/character-fullbody-hero": [512,288],
+  "generate-image/character-outfits": [512,288],
+  "generate-image/character-portrait": [512,288],
+  "generate-image/character-reference-grid": [512,288],
+  "generate-image/character-turnaround": [512,288],
+  "generate-image/character-turnaround-labeled": [512,288],
+  "generate-image/chart-graph": [512,288],
+  "generate-image/cinematic-keyframe": [512,288],
+  "generate-image/cinematic-portrait": [512,288],
+  "generate-image/cinematic-still": [512,288],
+  "generate-image/cinematic-widescreen": [512,219],
+  "generate-image/claymation-figure-real-set": [512,288],
+  "generate-image/claymation-scene": [512,288],
+  "generate-image/colorize": [512,288],
+  "generate-image/comic-panel": [512,288],
+  "generate-image/community-fundraiser": [512,683],
+  "generate-image/community-menu-board": [512,683],
+  "generate-image/concept-art-env": [512,288],
+  "generate-image/corporate-headshot": [512,288],
+  "generate-image/creator-at-home": [512,288],
+  "generate-image/creature-board": [512,288],
+  "generate-image/creature-design": [512,288],
+  "generate-image/cyberpunk-scene": [512,288],
+  "generate-image/decade-timeline": [512,288],
+  "generate-image/device-mockup": [512,288],
+  "generate-image/doodle-overlay": [512,288],
+  "generate-image/doodle-overlay-expressive": [512,288],
+  "generate-image/double-exposure": [512,288],
+  "generate-image/ecom-amazon-hero": [512,512],
+  "generate-image/ecom-etsy-handmade": [512,683],
+  "generate-image/ecom-fashion-ghost": [512,683],
+  "generate-image/ecom-infographic": [512,512],
+  "generate-image/ecom-lifestyle-shot": [512,512],
+  "generate-image/ecom-sale-badge": [512,512],
+  "generate-image/edit-by-name": [512,288],
+  "generate-image/edu-flashcard": [512,683],
+  "generate-image/edu-slide-title": [512,288],
+  "generate-image/edu-worksheet-header": [512,219],
+  "generate-image/embroidered-art": [512,288],
+  "generate-image/emoji-set": [512,288],
+  "generate-image/establishing-shot": [512,219],
+  "generate-image/event-baby-shower": [512,683],
+  "generate-image/event-birthday-invite": [512,683],
+  "generate-image/event-club-flyer": [512,683],
+  "generate-image/event-conference-banner": [512,293],
+  "generate-image/event-holiday-greeting": [512,512],
+  "generate-image/event-poster": [512,288],
+  "generate-image/event-wedding-invite": [512,683],
+  "generate-image/exterior-render": [512,288],
+  "generate-image/faceless-3d-head": [512,288],
+  "generate-image/faux-food-clay": [512,288],
+  "generate-image/fb-event-cover": [512,288],
+  "generate-image/fb-group-cover": [512,288],
+  "generate-image/flat-vector-illustration": [512,288],
+  "generate-image/floor-plan": [512,288],
+  "generate-image/flowchart": [512,288],
+  "generate-image/food-board": [512,288],
+  "generate-image/food-flatlay": [512,288],
+  "generate-image/food-photography": [512,288],
+  "generate-image/four-seasons": [512,288],
+  "generate-image/game-icon": [512,512],
+  "generate-image/ghost-mannequin": [512,288],
+  "generate-image/golden-hour-portrait": [512,288],
+  "generate-image/ig-carousel-cover": [512,683],
+  "generate-image/ig-flatlay": [512,512],
+  "generate-image/ig-giveaway": [512,512],
+  "generate-image/ig-new-drop": [512,683],
+  "generate-image/ig-photo-dump": [512,683],
+  "generate-image/ig-testimonial": [512,512],
+  "generate-image/infographic": [512,288],
+  "generate-image/instagram-post": [512,512],
+  "generate-image/interior-design": [512,288],
+  "generate-image/isometric-illustration": [512,288],
+  "generate-image/knolling": [512,288],
+  "generate-image/label-elements": [512,288],
+  "generate-image/landscape-vista": [512,219],
+  "generate-image/layout-2x2-grid": [512,512],
+  "generate-image/layout-comic-page": [512,683],
+  "generate-image/layout-headless-sheet": [512,288],
+  "generate-image/layout-multi-shot": [512,288],
+  "generate-image/layout-production-storyboard": [512,288],
+  "generate-image/layout-props-sheet": [512,288],
+  "generate-image/layout-sprite-sheet": [512,288],
+  "generate-image/layout-storyboard-6": [512,288],
+  "generate-image/layout-visionary-magazine-cover": [512,910],
+  "generate-image/li-certified": [512,683],
+  "generate-image/li-infographic": [512,512],
+  "generate-image/line-art-coloring": [512,288],
+  "generate-image/location-board": [512,288],
+  "generate-image/logo-emblem": [512,288],
+  "generate-image/logo-mascot": [512,288],
+  "generate-image/logo-wordmark": [512,288],
+  "generate-image/long-exposure": [512,288],
+  "generate-image/low-poly": [512,288],
+  "generate-image/macro-shot": [512,288],
+  "generate-image/macro-skin-study": [512,288],
+  "generate-image/manga-bw": [512,288],
+  "generate-image/mascot-board": [512,288],
+  "generate-image/matte-painting": [512,219],
+  "generate-image/merch-mug": [512,512],
+  "generate-image/merch-standalone-print-art": [512,512],
+  "generate-image/merch-sticker-sheet": [512,512],
+  "generate-image/merch-tshirt-design": [512,683],
+  "generate-image/mirror-selfie": [512,288],
+  "generate-image/monogram": [512,288],
+  "generate-image/moodboard-tile": [512,288],
+  "generate-image/movie-poster": [512,773],
+  "generate-image/natural-photo-finish": [512,288],
+  "generate-image/needle-felt": [512,288],
+  "generate-image/oil-painting": [512,288],
+  "generate-image/outfit-board": [512,288],
+  "generate-image/packaging-mockup": [512,288],
+  "generate-image/paper-cut": [512,288],
+  "generate-image/personal-birthday-card": [512,683],
+  "generate-image/personal-dating-profile": [512,683],
+  "generate-image/personal-family-holiday-card": [512,683],
+  "generate-image/personal-meme-template": [512,512],
+  "generate-image/personal-pet-portrait": [512,683],
+  "generate-image/personal-phone-wallpaper": [512,910],
+  "generate-image/pet-board": [512,288],
+  "generate-image/phone-camera-look": [512,288],
+  "generate-image/phone-selfie": [512,288],
+  "generate-image/pin-home-decor": [512,768],
+  "generate-image/pin-outfit-ideas": [512,768],
+  "generate-image/pin-recipe": [512,768],
+  "generate-image/pixar-3d": [512,288],
+  "generate-image/pixel-art": [512,288],
+  "generate-image/pixel-sprite": [512,288],
+  "generate-image/pop-art": [512,288],
+  "generate-image/pose-board": [512,288],
+  "generate-image/post-big-caption": [512,636],
+  "generate-image/post-carousel-cover": [512,512],
+  "generate-image/post-employee-spotlight": [512,512],
+  "generate-image/post-event-announcement": [512,512],
+  "generate-image/post-hiring": [512,512],
+  "generate-image/post-old-vs-new": [512,636],
+  "generate-image/post-quote-card": [512,512],
+  "generate-image/product-board": [512,288],
+  "generate-image/product-flatlay": [512,288],
+  "generate-image/product-in-hand": [512,288],
+  "generate-image/product-lifestyle": [512,288],
+  "generate-image/product-shot": [512,288],
+  "generate-image/quote-card": [512,288],
+  "generate-image/real-estate-hero": [512,288],
+  "generate-image/real-person-cartoon-world": [512,288],
+  "generate-image/relight": [512,288],
+  "generate-image/remove-faces": [512,288],
+  "generate-image/restore-photo": [512,288],
+  "generate-image/restyle-whole": [512,288],
+  "generate-image/scene-board": [512,288],
+  "generate-image/seamless-pattern": [512,288],
+  "generate-image/seamless-texture": [512,288],
+  "generate-image/short-ai-free-tool": [512,896],
+  "generate-image/short-dance-trend": [512,911],
+  "generate-image/short-fitness-daily": [512,911],
+  "generate-image/short-grwm-outfit": [512,896],
+  "generate-image/short-morning-routine": [512,911],
+  "generate-image/short-pov-hook": [512,911],
+  "generate-image/short-quick-recipe": [512,911],
+  "generate-image/short-side-income": [512,896],
+  "generate-image/short-storytime": [512,910],
+  "generate-image/short-three-steps": [512,896],
+  "generate-image/silhouette": [512,288],
+  "generate-image/skin-detail-sheet": [512,288],
+  "generate-image/sock-puppet": [512,288],
+  "generate-image/sport-match-day": [512,683],
+  "generate-image/sport-player-card": [512,683],
+  "generate-image/sports-jersey-portrait": [512,288],
+  "generate-image/stained-glass": [512,288],
+  "generate-image/sticker-diecut": [512,288],
+  "generate-image/story-countdown": [512,910],
+  "generate-image/story-link-above": [512,911],
+  "generate-image/story-this-or-that": [512,911],
+  "generate-image/story-vertical": [512,910],
+  "generate-image/storyboard-frame": [512,288],
+  "generate-image/studio-portrait": [512,288],
+  "generate-image/tattoo-flash": [512,288],
+  "generate-image/text-80s-synthwave": [512,288],
+  "generate-image/text-anime-title": [512,288],
+  "generate-image/text-art-deco": [512,288],
+  "generate-image/text-balloon-foil": [512,288],
+  "generate-image/text-blockbuster": [512,288],
+  "generate-image/text-botanical-serif": [512,288],
+  "generate-image/text-brutalist-acid": [512,288],
+  "generate-image/text-carved-wood": [512,288],
+  "generate-image/text-chalkboard": [512,288],
+  "generate-image/text-chrome-y2k": [512,288],
+  "generate-image/text-comic-hero": [512,288],
+  "generate-image/text-disco-funk": [512,293],
+  "generate-image/text-embroidered-patch": [512,288],
+  "generate-image/text-film-noir": [512,288],
+  "generate-image/text-fire-embers": [512,288],
+  "generate-image/text-frosted-glass": [512,288],
+  "generate-image/text-glitch": [512,288],
+  "generate-image/text-gold-foil-luxury": [512,288],
+  "generate-image/text-graffiti-drip": [512,288],
+  "generate-image/text-grunge-stamp": [512,288],
+  "generate-image/text-handwritten-marker": [512,293],
+  "generate-image/text-holographic": [512,293],
+  "generate-image/text-horror-poster": [512,293],
+  "generate-image/text-ice": [512,288],
+  "generate-image/text-indie-title-card": [512,288],
+  "generate-image/text-inflated-clay": [512,288],
+  "generate-image/text-kids-party": [512,288],
+  "generate-image/text-liquid-water": [512,288],
+  "generate-image/text-marble-carved": [512,288],
+  "generate-image/text-molten-gold": [512,293],
+  "generate-image/text-neon-sign": [512,288],
+  "generate-image/text-paper-cutout": [512,288],
+  "generate-image/text-pixel-8bit": [512,288],
+  "generate-image/text-psychedelic-60s": [512,288],
+  "generate-image/text-ransom-note": [512,293],
+  "generate-image/text-retro-serif-70s": [512,288],
+  "generate-image/text-rusted-metal": [512,288],
+  "generate-image/text-scifi-chrome": [512,293],
+  "generate-image/text-smoke": [512,288],
+  "generate-image/text-sticker-pop": [512,288],
+  "generate-image/text-typewriter": [512,288],
+  "generate-image/text-varsity-sport": [512,288],
+  "generate-image/text-vhs-glow": [512,288],
+  "generate-image/text-wedding-script": [512,288],
+  "generate-image/text-western": [512,293],
+  "generate-image/thumb-ai-feature-grid": [512,288],
+  "generate-image/thumb-ai-os-icons": [512,288],
+  "generate-image/thumb-ai-tool-reveal": [512,287],
+  "generate-image/thumb-analytics-growth": [512,293],
+  "generate-image/thumb-beauty-makeup": [512,287],
+  "generate-image/thumb-before-after": [512,288],
+  "generate-image/thumb-breaking-news": [512,288],
+  "generate-image/thumb-burning-question": [512,287],
+  "generate-image/thumb-challenge-timer": [512,287],
+  "generate-image/thumb-coding-tutorial": [512,288],
+  "generate-image/thumb-copy-me-arrow": [512,287],
+  "generate-image/thumb-course-launch": [512,288],
+  "generate-image/thumb-creator-milestone": [512,287],
+  "generate-image/thumb-crypto-pump": [512,293],
+  "generate-image/thumb-diet-plan": [512,288],
+  "generate-image/thumb-doctor-health": [512,288],
+  "generate-image/thumb-docu-expose": [512,288],
+  "generate-image/thumb-earnings-proof": [512,288],
+  "generate-image/thumb-editorial-type": [512,287],
+  "generate-image/thumb-finance-shock": [512,288],
+  "generate-image/thumb-fitness-transform": [512,288],
+  "generate-image/thumb-food-feast": [512,288],
+  "generate-image/thumb-founder-story": [512,288],
+  "generate-image/thumb-gaming-golden-item": [512,288],
+  "generate-image/thumb-gaming-rush": [512,287],
+  "generate-image/thumb-hero-object": [512,288],
+  "generate-image/thumb-interview-two-up": [512,287],
+  "generate-image/thumb-language-learning": [512,293],
+  "generate-image/thumb-legal-explainer": [512,288],
+  "generate-image/thumb-listicle-number": [512,288],
+  "generate-image/thumb-live-show": [512,288],
+  "generate-image/thumb-map-pin": [512,293],
+  "generate-image/thumb-minimal-tech": [512,288],
+  "generate-image/thumb-model-vs-model": [512,293],
+  "generate-image/thumb-motivation": [512,288],
+  "generate-image/thumb-mystery-blur": [512,288],
+  "generate-image/thumb-new-model-drop": [512,288],
+  "generate-image/thumb-node-diagram": [512,288],
+  "generate-image/thumb-parenting": [512,288],
+  "generate-image/thumb-pets": [512,288],
+  "generate-image/thumb-playful-cast": [512,287],
+  "generate-image/thumb-quote-highlight": [512,288],
+  "generate-image/thumb-real-estate-agent": [512,288],
+  "generate-image/thumb-red-x-green-check": [512,288],
+  "generate-image/thumb-reel-cover-bold": [512,287],
+  "generate-image/thumb-science-explainer": [512,287],
+  "generate-image/thumb-screen-portals": [512,288],
+  "generate-image/thumb-shocked-reaction": [512,287],
+  "generate-image/thumb-sports-highlight": [512,293],
+  "generate-image/thumb-squad-chaos": [512,288],
+  "generate-image/thumb-stage-talk": [512,293],
+  "generate-image/thumb-stock-call": [512,288],
+  "generate-image/thumb-swiss-collage": [512,288],
+  "generate-image/thumb-tech-glitch": [512,288],
+  "generate-image/thumb-tier-list": [512,288],
+  "generate-image/thumb-travel-wanderlust": [512,293],
+  "generate-image/thumb-true-crime-board": [512,288],
+  "generate-image/thumb-unboxing": [512,293],
+  "generate-image/thumb-versus-battle": [512,293],
+  "generate-image/thumb-vlog-bright": [512,287],
+  "generate-image/tilt-shift": [512,288],
+  "generate-image/timeline": [512,288],
+  "generate-image/times-of-day": [512,288],
+  "generate-image/transparent-faces": [512,288],
+  "generate-image/tshirt-design": [512,288],
+  "generate-image/uc-001-business": [512,384],
+  "generate-image/uc-002-business": [512,683],
+  "generate-image/uc-003-business": [512,683],
+  "generate-image/uc-004-business": [512,636],
+  "generate-image/uc-005-business": [512,636],
+  "generate-image/uc-006-business": [512,288],
+  "generate-image/uc-007-business": [512,636],
+  "generate-image/uc-008-business": [512,288],
+  "generate-image/uc-009-business": [512,683],
+  "generate-image/uc-010-business": [512,636],
+  "generate-image/uc-011-business": [512,683],
+  "generate-image/uc-012-business": [512,683],
+  "generate-image/uc-013-business": [512,636],
+  "generate-image/uc-014-business": [512,636],
+  "generate-image/uc-015-business": [512,288],
+  "generate-image/uc-016-business": [512,288],
+  "generate-image/uc-017-business": [512,636],
+  "generate-image/uc-018-business": [512,288],
+  "generate-image/uc-019-business": [512,683],
+  "generate-image/uc-020-business": [512,288],
+  "generate-image/uc-021-business": [512,288],
+  "generate-image/uc-022-business": [512,288],
+  "generate-image/uc-023-business": [512,636],
+  "generate-image/uc-024-business": [512,683],
+  "generate-image/uc-025-business": [512,636],
+  "generate-image/uc-026-business": [512,384],
+  "generate-image/uc-027-business": [512,683],
+  "generate-image/uc-028-business": [512,636],
+  "generate-image/uc-029-business": [512,384],
+  "generate-image/uc-030-business": [512,768],
+  "generate-image/uc-031-personal": [512,384],
+  "generate-image/uc-032-personal": [512,384],
+  "generate-image/uc-033-personal": [512,384],
+  "generate-image/uc-034-personal": [512,384],
+  "generate-image/uc-035-personal": [512,384],
+  "generate-image/uc-036-personal": [512,683],
+  "generate-image/uc-037-personal": [512,683],
+  "generate-image/uc-038-personal": [512,683],
+  "generate-image/uc-039-personal": [512,384],
+  "generate-image/uc-040-personal": [512,288],
+  "generate-image/uc-041-personal": [512,288],
+  "generate-image/uc-042-personal": [512,683],
+  "generate-image/uc-043-personal": [512,683],
+  "generate-image/uc-044-personal": [512,683],
+  "generate-image/uc-045-personal": [512,911],
+  "generate-image/uc-046-personal": [512,683],
+  "generate-image/uc-047-personal": [512,384],
+  "generate-image/uc-048-personal": [512,683],
+  "generate-image/uc-049-personal": [512,683],
+  "generate-image/uc-050-personal": [512,288],
+  "generate-image/uc-051-products": [512,384],
+  "generate-image/uc-052-products": [512,512],
+  "generate-image/uc-053-products": [512,636],
+  "generate-image/uc-054-products": [512,636],
+  "generate-image/uc-055-products": [512,512],
+  "generate-image/uc-056-products": [512,683],
+  "generate-image/uc-057-products": [512,288],
+  "generate-image/uc-058-products": [512,512],
+  "generate-image/uc-059-products": [512,512],
+  "generate-image/uc-060-products": [512,636],
+  "generate-image/uc-061-products": [512,384],
+  "generate-image/uc-062-products": [512,288],
+  "generate-image/uc-063-products": [512,683],
+  "generate-image/uc-064-products": [512,288],
+  "generate-image/uc-065-products": [512,636],
+  "generate-image/uc-066-products": [512,384],
+  "generate-image/uc-067-products": [512,512],
+  "generate-image/uc-068-products": [512,512],
+  "generate-image/uc-069-products": [512,288],
+  "generate-image/uc-070-products": [512,636],
+  "generate-image/uc-071-creative": [512,512],
+  "generate-image/uc-072-creative": [512,512],
+  "generate-image/uc-073-creative": [512,768],
+  "generate-image/uc-074-creative": [512,768],
+  "generate-image/uc-075-creative": [512,768],
+  "generate-image/uc-076-creative": [512,288],
+  "generate-image/uc-077-creative": [512,512],
+  "generate-image/uc-078-creative": [512,288],
+  "generate-image/uc-079-creative": [512,512],
+  "generate-image/uc-080-creative": [512,288],
+  "generate-image/uc-081-creative": [512,384],
+  "generate-image/uc-082-creative": [512,288],
+  "generate-image/uc-083-creative": [512,683],
+  "generate-image/uc-084-creative": [512,288],
+  "generate-image/uc-085-creative": [512,683],
+  "generate-image/uc-086-creative": [512,288],
+  "generate-image/uc-087-creative": [512,683],
+  "generate-image/uc-088-creative": [512,683],
+  "generate-image/uc-089-creative": [512,768],
+  "generate-image/uc-090-creative": [512,683],
+  "generate-image/uc-091-home": [512,288],
+  "generate-image/uc-092-home": [512,288],
+  "generate-image/uc-093-home": [512,288],
+  "generate-image/uc-094-home": [512,683],
+  "generate-image/uc-095-home": [512,288],
+  "generate-image/uc-096-home": [512,288],
+  "generate-image/uc-097-home": [512,683],
+  "generate-image/uc-098-home": [512,288],
+  "generate-image/uc-099-home": [512,288],
+  "generate-image/uc-100-home": [512,288],
+  "generate-image/uc-101-home": [512,288],
+  "generate-image/uc-102-home": [512,288],
+  "generate-image/uc-103-home": [512,288],
+  "generate-image/uc-104-home": [512,288],
+  "generate-image/uc-105-home": [512,288],
+  "generate-image/uc-106-family": [512,683],
+  "generate-image/uc-107-family": [512,683],
+  "generate-image/uc-108-family": [512,683],
+  "generate-image/uc-109-family": [512,683],
+  "generate-image/uc-110-family": [512,683],
+  "generate-image/uc-111-family": [512,683],
+  "generate-image/uc-112-family": [512,768],
+  "generate-image/uc-113-family": [512,683],
+  "generate-image/uc-114-family": [512,512],
+  "generate-image/uc-115-family": [512,683],
+  "generate-image/uc-116-family": [512,683],
+  "generate-image/uc-117-family": [512,683],
+  "generate-image/uc-118-family": [512,288],
+  "generate-image/uc-119-family": [512,683],
+  "generate-image/uc-120-family": [512,683],
+  "generate-image/ui-mockup": [512,288],
+  "generate-image/undo-beauty-filter": [512,288],
+  "generate-image/unretouched-portrait": [512,288],
+  "generate-image/vaporwave": [512,288],
+  "generate-image/vehicle-board": [512,288],
+  "generate-image/video-call-frame": [512,288],
+  "generate-image/wa-status-offer": [512,910],
+  "generate-image/watercolor": [512,288],
+  "generate-image/web-banner": [512,288],
+  "generate-image/work-email-header": [512,219],
+  "generate-image/work-landing-hero": [512,288],
+  "generate-image/work-report-cover": [512,683],
+  "generate-image/x-chart-take": [512,293],
+  "generate-image/x-ray": [512,288],
+  "generate-image/x-statement-card": [512,288],
+  "generate-image/youtube-thumbnail": [512,288],
+}

package/src/factory-presets/previews.ts

@@ -1,6 +1,21 @@
-import { FACTORY_PRESET_PREVIEW_FILES, FACTORY_PRESET_PREVIEW_LARGE_FILES } from "./preview-files.generated.js"
+import { FACTORY_PRESET_PREVIEW_FILES, FACTORY_PRESET_PREVIEW_LARGE_FILES, FACTORY_PRESET_PREVIEW_SIZES } from "./preview-files.generated.js"
 
-export { FACTORY_PRESET_PREVIEW_FILES, FACTORY_PRESET_PREVIEW_LARGE_FILES }
+export { FACTORY_PRESET_PREVIEW_FILES, FACTORY_PRESET_PREVIEW_LARGE_FILES, FACTORY_PRESET_PREVIEW_SIZES }
+
+/**
+ * The tile picture's real width and height (`previewUrl`'s), or null when the
+ * preset has no committed picture: a client sizes the picture's box from it
+ * before the picture loads, whatever shape the preset itself asks for.
+ *
+ * @param sizes the preset id → [width, height] map; defaults to the committed one
+ */
+export function factoryPresetPreviewSize(
+  presetId: string,
+  sizes: Readonly<Record<string, readonly [number, number]>> = FACTORY_PRESET_PREVIEW_SIZES,
+): { readonly width: number; readonly height: number } | null {
+  const size = Object.prototype.hasOwnProperty.call(sizes, presetId) ? sizes[presetId] : undefined
+  return size ? { width: size[0], height: size[1] } : null
+}
 
 /**
  * Where the factory preset previews live, relative to the app's origin: