@nodaro/prompts 1.48.0 → 1.50.0

package/src/__tests__/style-media.test.ts

@@ -0,0 +1,141 @@
+/**
+ * A style's medium, tones and media (`Style.medium` / `tones` / `media`):
+ * - every style classifies itself; the 49 styles offered for images and video
+ *   keep exactly the medium and tones Nodaro Motion's art-style line has read
+ *   them with so far (its own id lists), so moving them into the catalog
+ *   changes no prompt;
+ * - the video-only styles are rendered 3D looks, offered for video alone;
+ * - image style lists leave them out, and the wire carries `media` so a thin
+ *   client can do the same.
+ */
+import { afterEach, describe, expect, it } from "vitest"
+import {
+  STYLES,
+  STYLE_MEDIUMS,
+  getStyleMedium,
+  getStyleTones,
+  styleOffersMedia,
+  stylesForMedia,
+  styleOffersRestyle,
+  stylesForRestyle,
+  getPickerCatalog,
+  projectPickerCatalog,
+  registerCatalogPack,
+  resetCatalogPacks,
+} from "../index.js"
+
+afterEach(() => resetCatalogPacks())
+
+/** Nodaro Motion's lists as they read the 49 styles before the catalog carried a medium. */
+const PHOTOGRAPHIC = ["photorealistic", "cinematic", "noir", "early-color-photo", "retro-vintage", "cyberpunk", "steampunk", "glitch-art"]
+const RENDERED = ["3d-render", "low-poly", "isometric", "pixar-3d", "claymation"]
+const BLACK_AND_WHITE = ["noir", "manga", "pencil-sketch", "charcoal", "etching", "woodcut", "ink-wash"]
+const ONE_COLOUR = ["blueprint", "ascii-art", "chalkboard"]
+const VIDEO_ONLY = ["felt-puppet", "knitted-yarn", "toy-figure-3d", "painterly-3d", "painted-clay"]
+/** Left out of restyle lists: in tests each came out as the same plain 2D cartoon, without its own look. */
+const NOT_FOR_RESTYLE = ["fantasy", "concept-art", "surrealism"]
+
+const both = STYLES.filter((s) => s.media === undefined)
+
+describe("medium and tones", () => {
+  it("every style declares a known medium", () => {
+    for (const s of STYLES) expect(STYLE_MEDIUMS, s.id).toContain(s.medium)
+  })
+
+  it("the 49 styles for images and video keep the medium Nodaro Motion read them with", () => {
+    expect(both).toHaveLength(49)
+    for (const s of both) {
+      const expected = PHOTOGRAPHIC.includes(s.id) ? "photo" : RENDERED.includes(s.id) ? "3d" : "2d"
+      expect(getStyleMedium(s.id), s.id).toBe(expected)
+    }
+  })
+
+  it("tones: black and white, one colour, or none", () => {
+    for (const s of STYLES) {
+      const expected = BLACK_AND_WHITE.includes(s.id) ? "black-and-white" : ONE_COLOUR.includes(s.id) ? "one-colour" : undefined
+      expect(getStyleTones(s.id), s.id).toBe(expected)
+    }
+  })
+
+  it("an unknown id has no medium and no tones", () => {
+    expect(getStyleMedium("no-such-style")).toBeUndefined()
+    expect(getStyleMedium(undefined)).toBeUndefined()
+    expect(getStyleTones("no-such-style")).toBeUndefined()
+  })
+})
+
+describe("media", () => {
+  it("the video-only styles are rendered 3D looks, offered for video alone", () => {
+    const videoOnly = STYLES.filter((s) => s.media !== undefined)
+    expect(videoOnly.map((s) => s.id)).toEqual(VIDEO_ONLY)
+    for (const s of videoOnly) {
+      expect(s.media, s.id).toEqual(["video"])
+      expect(getStyleMedium(s.id), s.id).toBe("3d")
+      expect(styleOffersMedia(s, "video"), s.id).toBe(true)
+      expect(styleOffersMedia(s, "image"), s.id).toBe(false)
+    }
+  })
+
+  it("an image list leaves out the video-only styles; a video list has every style, in catalog order", () => {
+    expect(stylesForMedia(STYLES, "image").map((s) => s.id)).toEqual(both.map((s) => s.id))
+    expect(stylesForMedia(STYLES, "video").map((s) => s.id)).toEqual(STYLES.map((s) => s.id))
+  })
+
+  it("a style with no media is offered for both", () => {
+    expect(styleOffersMedia({}, "image")).toBe(true)
+    expect(styleOffersMedia({}, "video")).toBe(true)
+  })
+})
+
+describe("restyle", () => {
+  it("exactly the styles that do not hold up as a restyle say so", () => {
+    expect(STYLES.filter((s) => !styleOffersRestyle(s)).map((s) => s.id)).toEqual(NOT_FOR_RESTYLE)
+    for (const id of NOT_FOR_RESTYLE) expect(STYLES.find((s) => s.id === id)!.restyle, id).toBe(false)
+  })
+
+  it("a restyle list is the video list without them, in catalog order", () => {
+    expect(stylesForRestyle(STYLES).map((s) => s.id)).toEqual(STYLES.filter((s) => !NOT_FOR_RESTYLE.includes(s.id)).map((s) => s.id))
+  })
+
+  it("video generation still offers them", () => {
+    for (const id of NOT_FOR_RESTYLE) expect(stylesForMedia(STYLES, "video").some((s) => s.id === id), id).toBe(true)
+  })
+
+  it("a style that says nothing is offered for restyle", () => {
+    expect(styleOffersRestyle({})).toBe(true)
+  })
+})
+
+describe("the style catalog", () => {
+  const catalog = () => getPickerCatalog("style")!
+
+  it("carries media on the video-only options only", () => {
+    for (const o of catalog().options!) {
+      expect(o.media, o.id).toEqual(VIDEO_ONLY.includes(o.id) ? ["video"] : undefined)
+    }
+  })
+
+  it("the wire carries media at both detail levels", () => {
+    for (const detail of ["compact", "full"] as const) {
+      const options = projectPickerCatalog(catalog(), { detail }).options!
+      const felt = options.find((o) => o.id === "felt-puppet")!
+      expect(felt.media, detail).toEqual(["video"])
+      expect(options.find((o) => o.id === "anime")!.media, detail).toBeUndefined()
+    }
+  })
+
+  it("the catalog and the wire carry restyle: false on exactly those options, at both detail levels", () => {
+    for (const o of catalog().options!) expect(o.restyle, o.id).toBe(NOT_FOR_RESTYLE.includes(o.id) ? false : undefined)
+    for (const detail of ["compact", "full"] as const) {
+      const options = projectPickerCatalog(catalog(), { detail }).options!
+      expect(options.find((o) => o.id === "fantasy")!.restyle, detail).toBe(false)
+      expect(options.find((o) => o.id === "vaporwave")!.restyle, detail).toBeUndefined()
+    }
+  })
+
+  it("a catalog pack that removes a video-only style takes away its medium too", () => {
+    registerCatalogPack({ id: "t-deny", catalogId: "style", mode: "deny", denyIds: ["felt-puppet"] })
+    expect(getStyleMedium("felt-puppet")).toBeUndefined()
+    expect(getPickerCatalog("style")!.options!.some((o) => o.id === "felt-puppet")).toBe(false)
+  })
+})

package/src/__tests__/style-video-wording.test.ts

@@ -33,8 +33,13 @@ afterEach(() => resetCatalogPacks())
 
 const LOW_POLY_VIDEO =
   "Stylised low poly 3D animation, computer-generated: every person, face, vehicle and room built from large flat-shaded triangles, visible facets on every surface, flat untextured colours, crisp shadow edges between facets."
-/** The three wordings tested on video (Seedance 2.5), word for word. */
+/** The wordings tested on video (Seedance 2.5), word for word. */
 const TESTED_ON_VIDEO: Readonly<Record<string, string>> = {
+  "felt-puppet": "Needle-felted stop-motion puppet animation, handmade: every person a felt puppet with soft fuzzy wool-felt skin, simple stitched features, small bead-like eyes and hair of felted wool strands, clothes sewn from real fabric with visible weave. The whole set is a handmade felt miniature: every car a fuzzy felt-covered model with felt seats, every wall, floor, curtain, table, chair and plant made of felt or wool fabric with visible fibres, the street and sky felt too; warm soft studio light on a tabletop miniature set, a slight stop-motion step to the motion.",
+  "knitted-yarn": "Knitted yarn stop-motion animation, handmade: every person a knitted doll with yarn skin in visible knit loops, hair of chunky yarn strands, clothes knitted in cable and rib stitch; every car, building, road, tree and sky knitted from wool yarn with visible stitches; soft warm studio light on a tabletop miniature set, a slight stop-motion step to the motion.",
+  "toy-figure-3d": "Stylised 3D toy animation, computer-generated: every person a rounded vinyl toy figure with smooth glossy plastic skin, a simplified oversized head, small dot eyes and moulded plastic hair, clothes as moulded painted plastic; every car, room and prop a chunky rounded toy model with soft bevelled edges; bright clean colours, soft studio lighting.",
+  "painterly-3d": "Painterly 3D animation, computer-generated with a hand-painted finish: every person a stylised 3D character with soft rounded features and expressive eyes, skin, hair and clothes textured with visible painted brush strokes; every room and landscape a 3D set painted like a storybook illustration; warm glowing light, rich soft colours.",
+  "painted-clay": "Sculpted clay animation with a painted finish, handmade: every person sculpted from matte clay with visible thumbprints and tool marks, painted in soft gouache colour; every car, room and prop sculpted and hand-painted the same way; warm painterly light, a slight stop-motion step to the motion.",
   "pop-art": "Flat 2D cel-shaded comic illustration, hand-drawn: thick uniform black ink outlines, flat colour fills, Ben-Day dot shading, bold saturated primary colours, high contrast.",
   claymation: "Stop-motion claymation, handmade: every person, vehicle and set sculpted from matte plasticine clay with visible fingerprints and tool marks, rounded simplified forms, miniature handcrafted diorama sets, soft warm studio lighting.",
   anime: "2D Japanese anime, hand-drawn cel animation: clean thin ink line art, flat cel shading with one hard shadow tone, large expressive eyes, hair drawn as solid shapes, saturated colours, painted backgrounds.",
@@ -58,9 +63,19 @@ const LOW_POLY_IMAGE =
 
 const styleNode = (style: string) => ({ id: "s1", type: "style", data: { style } })
 
+/** The styles offered for video alone (`media: ["video"]`). */
+const VIDEO_ONLY = ["felt-puppet", "knitted-yarn", "toy-figure-3d", "painterly-3d", "painted-clay"]
+/**
+ * A video wording's length cap. A style offered for images too names its medium and its techniques in one short line;
+ * a video-only style also names what the whole set is made of (cars, rooms, props), and the felt line that felted
+ * the whole set of a live-action clip on Seedance 2.5 (people, car, street and curtains) is 562 characters.
+ */
+const capOf = (id: string) => (VIDEO_ONLY.includes(id) ? 600 : 240)
+
 describe("the catalog", () => {
-  it("has 49 styles, and every one carries its own video wording, different from its image wording", () => {
-    expect(STYLES).toHaveLength(49)
+  it("has 54 styles (49 for images and video, 5 for video alone), and every one carries its own video wording, different from its image wording", () => {
+    expect(STYLES).toHaveLength(54)
+    expect(STYLES.filter((s) => s.media?.length === 1 && s.media[0] === "video").map((s) => s.id)).toEqual(VIDEO_ONLY)
     for (const s of STYLES) {
       expect(s.videoPromptHint, s.id).toEqual(expect.any(String))
       expect(s.videoPromptHint, s.id).not.toBe(s.promptHint)
@@ -71,11 +86,11 @@ describe("the catalog", () => {
     for (const s of STYLES) {
       const v = s.videoPromptHint!
       expect(v, s.id).toMatch(/^[^:]+: \S[^\n]*\.$/)
-      expect(v.length, s.id).toBeLessThanOrEqual(240)
+      expect(v.length, s.id).toBeLessThanOrEqual(capOf(s.id))
     }
   })
 
-  it("the three wordings tested on video are word for word", () => {
+  it("the wordings tested on video are word for word", () => {
     for (const [id, wording] of Object.entries(TESTED_ON_VIDEO)) expect(getStyleVideoPromptHint(id), id).toBe(wording)
   })
 
@@ -106,7 +121,7 @@ describe("the catalog", () => {
   })
 })
 
-describe("image surfaces read only promptHint, for all 49 styles", () => {
+describe("image surfaces read only promptHint, for every style (a video-only one wired into an image included)", () => {
   it("the direction fold on image", () => {
     for (const s of STYLES) {
       expect(renderDirectionHints({ style: s.id }, { surface: "image" }), s.id).toEqual([s.promptHint])
@@ -185,7 +200,7 @@ describe("catalog packs", () => {
 
   it("the composed catalog carries every style's video wording", () => {
     const options = styleCatalog().options!
-    expect(options).toHaveLength(49)
+    expect(options).toHaveLength(54)
     for (const o of options) expect(o.videoPromptHint, o.id).toBe(videoOf(o.id))
   })
 

package/src/factory-presets/generate-image.ts

@@ -1117,7 +1117,7 @@ export const GENERATE_IMAGE_PRESETS: readonly FactoryPreset[] = [
   },
   {
     id: "generate-image/pixar-3d",
-    name: "3D Animated (Pixar-style)",
+    name: "3D Animated Film",
     description: "Polished CG character look.",
     group: "Illustration & Art Styles",
     data: {

package/src/factory-presets/generate-video.ts

@@ -591,7 +591,7 @@ export const GENERATE_VIDEO_PRESETS: readonly FactoryPreset[] = [
   {
     id: "generate-video/cartoon-3d",
     name: "3D Cartoon",
-    description: "Playful Pixar-like motion.",
+    description: "Playful animated-film motion.",
     group: "Animation & Style",
     data: {
       provider: "kling-3.0",

package/src/picker-analyzer-registry.ts

@@ -50,11 +50,18 @@ import { VOICE_PACES, VOICE_EMOTIONS, VOICE_ARCHETYPES } from "./voice-delivery.
 interface AnalyzerEntry {
   readonly id: string
   readonly label: string
+  /** What the analyzers' list calls this entry where it differs from `label` (`Style.promptLabel`). */
+  readonly promptLabel?: string
   readonly description: string
   readonly dimension?: string
   readonly category?: string
 }
 
+/** An entry's row in the system-prompt legend: a list only models read. */
+function legendRow(e: AnalyzerEntry): { id: string; label: string; description: string } {
+  return { id: e.id, label: e.promptLabel ?? e.label, description: e.description }
+}
+
 export type PickerApplyMode = "override" | "overwrite-detected" | "fill-empty"
 type ApplyCleanup = (patch: Record<string, unknown>, mode: PickerApplyMode) => void
 
@@ -362,7 +369,7 @@ export function buildPickerAnalyzerSpec(pickerType: PickerType): PickerAnalyzerS
           label: d.label,
           limit: 1,
           entryIds: d.entries.map((e) => e.id),
-          legend: d.entries.map((e) => ({ id: e.id, label: e.label, description: e.description })),
+          legend: d.entries.map(legendRow),
         },
       ],
     }
@@ -379,7 +386,7 @@ export function buildPickerAnalyzerSpec(pickerType: PickerType): PickerAnalyzerS
       label: d.labels[key] ?? key,
       limit: d.limitFn(key),
       entryIds: entries.map((e) => e.id),
-      legend: entries.map((e) => ({ id: e.id, label: e.label, description: e.description })),
+      legend: entries.map(legendRow),
     }
   })
   return { pickerType, toolName: d.toolName, dimensions, cleanup: d.cleanup }

package/src/picker-art/images.ts

@@ -41,11 +41,12 @@ function originOf(baseUrl: string): string | undefined {
 
 /**
  * A still, 480px-wide picture of a rendered look preview: the image resized by
- * the CDN, or — for a clip (camera motion) — a frame taken 1s in. The same
- * transforms the editor's tiles use. A URL off the transforming CDN is kept
- * as is for an image, and dropped for a clip (no still to offer).
+ * the CDN, or — for a clip (camera motion) — a frame taken 1s in (or at
+ * `clipSeconds`). The same transforms the editor's tiles use. A URL off the
+ * transforming CDN is kept as is for an image, and dropped for a clip (no still
+ * to offer).
  */
-export function lookPreviewStillUrl(url: string, width = STILL_WIDTH): string | undefined {
+export function lookPreviewStillUrl(url: string, width = STILL_WIDTH, clipSeconds = 1): string | undefined {
   let parsed: URL
   try {
     parsed = new URL(url)
@@ -55,7 +56,7 @@ export function lookPreviewStillUrl(url: string, width = STILL_WIDTH): string |
   const clip = /\.(mp4|webm|mov)$/i.test(parsed.pathname)
   if (!TRANSFORM_HOSTS.has(parsed.hostname)) return clip ? undefined : url
   return clip
-    ? `${parsed.origin}/cdn-cgi/media/mode=frame,time=1s,width=${width}${parsed.pathname}`
+    ? `${parsed.origin}/cdn-cgi/media/mode=frame,time=${clipSeconds}s,width=${width}${parsed.pathname}`
     : `${parsed.origin}/cdn-cgi/image/width=${width},format=auto,quality=80${parsed.pathname}`
 }
 

package/src/picker-art/index.ts

@@ -9,6 +9,7 @@ export { SOUND_ART } from "./sound-art-map.js"
 export { SOUND_ART_FILES } from "./sound-art-files.generated.js"
 export { CHARACTER_ART_FILES } from "./character-art-files.generated.js"
 export { LOOK_PREVIEW_SETS, type LookPreviewSet, type LookPreviewSets } from "./look-preview-sets.js"
+export { RESTYLE_PREVIEWS, restylePreviewStillUrl, type RestylePreview } from "./restyle-previews.js"
 export { SOUND_RENDER_SETS } from "./sound-render-sets.js"
 export * from "./paths.js"
 export * from "./images.js"

package/src/picker-art/look-preview-sets.ts

@@ -70,6 +70,11 @@ export const LOOK_PREVIEW_SETS = {
     "mixed-media": "https://cdn.nodaro.ai/picker-renders/d36ab150-9cd6-47ac-bdd9-3b26990a4fa9.png",
     "early-color-photo": "https://cdn.nodaro.ai/picker-renders/1bf61f3d-c174-466f-9092-5de72dc7abea.png",
     manga: "https://cdn.nodaro.ai/picker-renders/3d6bbfd8-8c62-4769-b62e-11d2a7e43b4b.png",
+    "felt-puppet": "https://cdn.nodaro.ai/picker-renders/31ad3b39-d501-4b76-9c1c-2f87fc374333.png",
+    "knitted-yarn": "https://cdn.nodaro.ai/picker-renders/b80b6a96-2221-4c68-8e0c-4beaa5a6ce56.png",
+    "toy-figure-3d": "https://cdn.nodaro.ai/picker-renders/add81127-a005-4f9a-a002-780768238715.png",
+    "painterly-3d": "https://cdn.nodaro.ai/picker-renders/6aec1d80-be9f-4f2e-a1b7-fa38a61131d1.png",
+    "painted-clay": "https://cdn.nodaro.ai/picker-renders/daedee18-c034-4b98-80bb-7bef7e05c547.png",
   },
   "color-look": {
     warm: "https://cdn.nodaro.ai/picker-renders/8511a1bc-3d3b-46a8-adc0-26fcc9e93a4b.png",

package/src/picker-art/restyle-previews.ts

@@ -0,0 +1,47 @@
+// Restyle previews: for each art style, a short clip of real footage wiping
+// into that style, for a picker that restyles a video. Keyed by the `style`
+// catalog's option id. An entry exists only for an approved clip: a style
+// without one has no preview here.
+//
+// Each approved style keeps the URLs of its source shot and its generated clip
+// (no wipe) in a comment beside its entry, so the clip can be composed again if
+// the switch animation changes.
+//
+// Separate from LOOK_PREVIEW_SETS.style, whose stills every other art style
+// picker keeps showing. Like every render, a clip lives under picker-renders/
+// on the CDN, a key no user owns; a test holds this.
+import { lookPreviewStillUrl } from "./images.js"
+
+/** One style's preview clip. */
+export interface RestylePreview {
+  readonly url: string
+  /** The moment of the clip its still is cut from, for a clip whose usual moment frames it badly. Absent: the usual moment (`lookPreviewStillUrl`). */
+  readonly stillAtSeconds?: number
+}
+
+/** Art style id → its restyle preview clip. */
+export const RESTYLE_PREVIEWS: Readonly<Record<string, RestylePreview>> = {
+  // Source shot: https://cdn.nodaro.ai/picker-renders/4054a0e1-af60-47f9-86bd-a78ab93f3800.mp4
+  // Generated, no wipe: https://cdn.nodaro.ai/picker-renders/9dc6b337-58b4-4a63-889f-70561a8f1f00.mp4
+  anime: { url: "https://cdn.nodaro.ai/picker-renders/7fbad6e4-023f-4282-ac3d-d186f2cbb37b.mp4", stillAtSeconds: 7 },
+  // Source shot: https://cdn.nodaro.ai/picker-renders/4ffff922-e807-42cc-a2a0-c66c3a8d492c.mp4
+  // Generated, no wipe: https://cdn.nodaro.ai/picker-renders/fca5d96d-ee9c-430e-ba82-2795c0adb8d6.mp4
+  claymation: { url: "https://cdn.nodaro.ai/picker-renders/2916a2f7-114c-4c7e-9be0-5bf229d76133.mp4" },
+  // Source shot: https://cdn.nodaro.ai/picker-renders/41faaa51-5e77-4097-aa9b-bef6738328b7.mp4
+  // Generated, no wipe: https://cdn.nodaro.ai/picker-renders/5a28da72-f3ee-49a8-b732-f73e79741b62.mp4
+  "comic-book": { url: "https://cdn.nodaro.ai/picker-renders/7a2cd17c-b02f-4ae4-9723-ef48d0eda52a.mp4" },
+  // Source shot: https://cdn.nodaro.ai/picker-renders/4a70c22d-04f0-4b5a-90d4-e9dd7ddb01c4.mp4
+  // Generated, no wipe: https://cdn.nodaro.ai/picker-renders/5ab33529-ef2a-42bc-a625-d6b1abfeef1c.mp4
+  "felt-puppet": { url: "https://cdn.nodaro.ai/picker-renders/3aa3c81b-ba19-4776-becc-e0c47c700699.mp4" },
+  // Source shot: https://cdn.nodaro.ai/picker-renders/d9e12a4a-677e-4e36-8f44-8503f14dd6b8.mp4
+  // Generated, no wipe: https://cdn.nodaro.ai/picker-renders/d4dad451-802a-4795-9cc3-71ff3ed70c69.mp4
+  "pixar-3d": { url: "https://cdn.nodaro.ai/picker-renders/c5ea2111-3283-4f80-ab05-8ab4450946ce.mp4" },
+  // Source shot: https://cdn.nodaro.ai/picker-renders/789f4330-660b-42bd-8d11-6e638e8c7c88.mp4
+  // Generated, no wipe: https://cdn.nodaro.ai/picker-renders/10471107-b26a-42e9-a3a5-068a42436d3c.mp4
+  watercolor: { url: "https://cdn.nodaro.ai/picker-renders/61a26588-d09a-4959-b677-ee8b32e3281a.mp4" },
+}
+
+/** A preview clip's still, a frame the CDN cuts from it at the clip's own moment. */
+export function restylePreviewStillUrl(preview: RestylePreview, width?: number): string | undefined {
+  return lookPreviewStillUrl(preview.url, width, preview.stillAtSeconds)
+}

package/src/picker-catalogs.ts

@@ -140,6 +140,15 @@ export interface PickerOption {
    * does not carry it.
    */
   readonly videoPromptHint?: string
+  /**
+   * Style only: the outputs the style is offered for. Present only on a style
+   * offered for one of them (`["video"]`: a look that only works in motion);
+   * absent means both. Carried to the wire (`projectPickerCatalog`). An image style list leaves out an option without
+   * "image".
+   */
+  readonly media?: ReadonlyArray<"image" | "video">
+  /** Style only: `false` on a style restyle lists leave out (`Style.restyle`); absent means offered. Carried to the wire. */
+  readonly restyle?: false
   /**
    * Transitions only: present (`true`) on a row whose mechanism is a CUT, so
    * it takes no duration and no intensity — see `Transition.instant` /
@@ -231,6 +240,10 @@ interface BaseCatalogEntry {
   readonly term?: string
   /** Style: see `Style.videoPromptHint`. Propagated verbatim into the flattened option. */
   readonly videoPromptHint?: string
+  /** Style: see `Style.media`. Propagated verbatim into the flattened option. */
+  readonly media?: ReadonlyArray<"image" | "video">
+  /** Style: see `Style.restyle`. Propagated verbatim into the flattened option. */
+  readonly restyle?: false
   /** W1-a: see Person.adultOnly. Propagated verbatim into the flattened option. */
   readonly adultOnly?: true
   /** Transitions: see `Transition.instant`. Propagated into the flattened option as `instant: true`. */
@@ -278,6 +291,8 @@ function toOptions<T extends BaseCatalogEntry>(
     }
     if (e.description) opt.description = e.description
     if (e.videoPromptHint) opt.videoPromptHint = e.videoPromptHint
+    if (e.media) opt.media = e.media
+    if (e.restyle === false) opt.restyle = false
     if (categoryField) opt.category = e[categoryField] as unknown as string
     if (e.adultOnly) opt.adultOnly = true
     if (e.instant) opt.instant = true
@@ -1077,6 +1092,10 @@ function projectOptionFields(o: PickerOption, detail: PickerCatalogDetail, image
   // present only when the option has a picture (a srcset only for a CDN render).
   const extras = {
     ...(o.motion ? { motion: o.motion } : {}),
+    // A style's media rides at both detail levels: a thin client filters its image style list by it.
+    ...(o.media ? { media: [...o.media] } : {}),
+    // A style restyle lists leave out says so at both detail levels too.
+    ...(o.restyle === false ? { restyle: false as const } : {}),
     ...(image ? { imageUrl: image.url } : {}),
     ...(image?.srcSet ? { imageSrcSet: image.srcSet } : {}),
   }

package/src/setting.ts

@@ -5,7 +5,7 @@
  * shop, forest clearing, cyberpunk alley, cathedral, etc.). Orthogonal to the
  * other cinematography dimensions:
  *
- *  - Style      = artistic medium (Oil Painting, Pixar 3D, Photorealistic)
+ *  - Style      = artistic medium (Oil Painting, 3D Animated Film, Photorealistic)
  *  - Atmosphere = what's in the air (Fog, Rain, God rays, Dust)
  *  - Lighting   = direction / quality of light
  *  - Setting    = *where* (this file)