@zalify/cli 0.11.0 → 0.12.0

package/dist/cli.js

@@ -11860,7 +11860,7 @@ var POLL_INTERVAL_MS = 5000;
 var POLL_TIMEOUT_MS = 30 * 60 * 1000;
 var STREAM_BATCH = 20;
 function buildPrompt(manifest, entry) {
-  const style = entry.type === "model" ? manifest.modelStyle ?? manifest.style : manifest.style;
+  const style = entry.type === "model" ? manifest.modelStyle ?? manifest.style : entry.type === "banner" ? manifest.bannerStyle ?? manifest.style : manifest.style;
   return `${style}
 
 ${entry.prompt}`;
@@ -11903,7 +11903,7 @@ async function submitJob(auth, manifest, entries) {
       workspaceId: auth.workspaceId,
       jobs: entries.map((e) => ({
         prompt: buildPrompt(manifest, e),
-        size: "1024x1024",
+        size: e.size ?? "1024x1024",
         count: 1
       }))
     })
@@ -11970,7 +11970,7 @@ async function streamingGenerate(auth, manifest, missing, imagesDir, indexPath,
         jobs: batch.map((e) => ({
           prompt: buildPrompt(manifest, e),
           count: 1,
-          size: "1024x1024"
+          size: e.size ?? "1024x1024"
         }))
       })
     });
@@ -12888,6 +12888,8 @@ async function shopifyUploadImages(storeDir, options = {}) {
   const manifest = readJson(join6(dir2, "images", "manifest.json"), "images/manifest.json");
   console.log(`Uploading images to the Shopify store connected to workspace "${auth.workspaceName}"`);
   for (const entry of manifest.images) {
+    if (entry.type === "banner" || !entry.handle)
+      continue;
     const filePath = join6(dir2, "images", entry.file);
     if (!existsSync6(filePath)) {
       console.log(`  - ${entry.handle}: ${entry.file} not generated yet, skipped`);
@@ -13007,12 +13009,26 @@ alone. Validate anytime with \`zalify brand validate\` (defaults to cwd).
 - \`style\` prefixes packshot/detail prompts; \`modelStyle\` prefixes
   \`type: "model"\` prompts. Keep prompts concrete: materials, colors,
   camera angle, light.
+- **Banner / merchandising entries** (\`"type": "banner"\`, no \`handle\`)
+  are theme imagery, not product shots: hero slides, editorial banners.
+  They are generated and pushed to the asset library like any entry, but
+  never attached to a product — theme templates reference them by their
+  \`images/assets.json\` URL. Conventions:
+  - Naming: \`hero-1.png\` + \`hero-1-mobile.png\`, \`hero-2.png\`…,
+    \`editorial-1.png\`.
+  - \`size\`: hero desktop + editorial \`"1536x1024"\`, hero mobile
+    \`"1024x1536"\` (default is \`"1024x1024"\` — never right for banners).
+  - \`bannerStyle\` prefixes banner prompts (falls back to \`style\`, whose
+    "square 1:1" phrasing is wrong for banners — always set it).
+  - NO text, lettering, or logos inside the image; the theme overlays
+    copy. Leave calm negative space on one side for it.
 - **Prompt safety (gpt-image-2 rejects [sexual] otherwise)** — for
   human-model shots: say "woman"/"man", never "young …"; keep fitted
   garments layered or covered (blazer / cardigan / cover-up); crop at
   the chin or shoot from behind; prefer wider framing. Swimwear: show
   the garment via flat-lay + detail; make the model shot a cover-up
-  scene. Pet/object products: no such constraints.
+  scene. Pet/object products: no such constraints. Applies to banner
+  prompts too.
 
 ## Pipeline (after authoring)
 
@@ -13110,6 +13126,7 @@ var CATALOG_JSON = (vendor, currency) => JSON.stringify({
 var MANIFEST_JSON = JSON.stringify({
   style: "<shared prefix for packshot/detail prompts: photography style, background, light, 'no text, no watermark. Square 1:1 composition.'>",
   modelStyle: "<shared prefix for type:'model' lifestyle prompts — scene, mood, framing. Mind the prompt-safety rules in AUTHORING.md for human models.>",
+  bannerStyle: "<shared prefix for type:'banner' theme imagery — wide cinematic scene, no text or logos, calm negative space on one side for overlaid copy.>",
   images: [
     {
       handle: "example-product",
@@ -13129,6 +13146,20 @@ var MANIFEST_JSON = JSON.stringify({
       type: "model",
       alt: "The Example Product in use",
       prompt: "<lifestyle prompt: who/what uses it, where, light>"
+    },
+    {
+      file: "hero-1.png",
+      type: "banner",
+      size: "1536x1024",
+      alt: "Hero banner: the brand's world in one wide scene",
+      prompt: "<wide hero scene prompt: setting, subject, light — no text, negative space on one side>"
+    },
+    {
+      file: "hero-1-mobile.png",
+      type: "banner",
+      size: "1024x1536",
+      alt: "Hero banner, portrait crop for mobile",
+      prompt: "<same scene, portrait composition — subject centered, negative space above>"
     }
   ]
 }, null, 2) + `
@@ -13155,6 +13186,7 @@ function brandInit(dir2 = ".", opts = {}) {
 Author in this order: brand.md → catalog.json → images/manifest.json` + `
 (rules + worked examples in AUTHORING.md; lint with \`zalify brand validate ${dir2}\`)`);
 }
+var MANIFEST_SIZES = new Set(["1024x1024", "1536x1024", "1024x1536"]);
 function brandValidate(dir2 = ".") {
   const target = resolve6(dir2);
   const problems = [];
@@ -13266,12 +13298,24 @@ function brandValidate(dir2 = ".") {
           problems.push(`${where}: duplicate file`);
         files.add(entry.file);
       }
-      if (entry.handle && handles.size && !handles.has(entry.handle)) {
+      if (entry.type === "banner") {
+        if (entry.handle) {
+          warnings.push(`${where}: banner entries take no handle (ignored by attach)`);
+        }
+      } else if (!entry.handle) {
+        problems.push(`${where}: handle required (only type "banner" entries omit it)`);
+      } else if (handles.size && !handles.has(entry.handle)) {
         problems.push(`${where}: handle "${entry.handle}" not in catalog.json`);
       }
+      if (entry.size && !MANIFEST_SIZES.has(entry.size)) {
+        problems.push(`${where}: size must be one of ${[...MANIFEST_SIZES].join(", ")}`);
+      }
       if (entry.type === "model" && (!manifest.modelStyle || manifest.modelStyle.startsWith("<"))) {
         warnings.push("images/manifest.json: modelStyle prefix not filled in (model shots present)");
       }
+      if (entry.type === "banner" && (!manifest.bannerStyle || manifest.bannerStyle.startsWith("<"))) {
+        warnings.push("images/manifest.json: bannerStyle prefix not filled in (banner entries present)");
+      }
     }
   }
   for (const w of [...new Set(warnings)])

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zalify/cli",
-  "version": "0.11.0",
+  "version": "0.12.0",
   "description": "Zalify CLI - command-line interface for Zalify",
   "type": "module",
   "main": "dist/cli.js",