studio-lumiere-cli 0.1.6 → 0.1.8

package/dist/studio/promptBuilder.js

@@ -1,21 +1,164 @@
-import { ETHNICITY_REGIONS, getRandomBackgroundValue, getRandomBackgroundTreatment, getRandomBlazerValue } from './constants.js';
-export const buildLLMPrompt = (template, detail, secondaryDetail, tertiaryDetail, quaternaryDetail, ethnicity, skinTone, hairColor, background, backgroundType, vibe, imageCount, occasion, styleHint, isBypassMode = false) => {
+import { ETHNICITY_REGIONS, getRandomBackgroundValue, getRandomBackgroundTreatment, getRandomBlazerValue, JEWELRY_MACRO_QUALITY_PROMPT, JEWELRY_MACRO_QUALITY_PROMPT_2 } from './constants.js';
+export const buildLLMPrompt = (template, detail, secondaryDetail, tertiaryDetail, quaternaryDetail, quinaryDetail, ethnicity, skinTone, hairColor, background, backgroundType, vibe, photographyStyle, imageCount, occasion, backgroundReference, styleHint, uploadMode = 'stacking', editorialMuseCloseUp, editorialMuseUltraCloseUp, flatlayCloseUp, flatlayUltraCloseUp, jewelerInsight, campaignStyle, guidelineReferences, hasMuseReferences = false) => {
     const needsBothHands = template.id === 'hand_model' && imageCount >= 3;
-    const quantityConstraint = imageCount > 1
-        ? `The model is wearing ALL the provided pieces together. Do NOT add any other jewelry.${needsBothHands ? ' IMPORTANT: Show BOTH hands with the pieces distributed naturally and elegantly across both hands — do NOT cram all pieces onto a single hand.' : ''}`
-        : 'The model is wearing ONLY the single piece of jewelry shown in the reference. Do NOT add matching earrings, necklaces, or other rings.';
+    const isEditorialMuse = template.id === 'half_body_muse';
+    const useEditorialCloseUp = isEditorialMuse && !!editorialMuseCloseUp;
+    const useEditorialUltraCloseUp = isEditorialMuse && !!editorialMuseUltraCloseUp;
+    const useFlatlayCloseUp = template.id === 'flatlay_creative' && !!flatlayCloseUp;
+    const useFlatlayUltraCloseUp = template.id === 'flatlay_creative' && !!flatlayUltraCloseUp;
+    let quantityConstraint = '';
+    if (uploadMode === 'multi_angle') {
+        if (template.hasModel) {
+            quantityConstraint = 'The attached image(s) show the EXACT SAME single piece of jewelry (from different angles/perspectives). The model is wearing ONLY this single piece. Render EXACTLY ONE physical instance of that piece. Do NOT duplicate, pair, stack, mirror, or show multiple copies. Do NOT show multiple angles of the piece within the same image. Synthesize the views into a single coherent piece and choose ONE viewpoint for the output.';
+        }
+        else {
+            quantityConstraint = 'The attached image(s) show the EXACT SAME single piece of jewelry (from different angles/perspectives). Render EXACTLY ONE physical instance of that piece. Do NOT duplicate, pair, stack, mirror, or show multiple copies. Do NOT show multiple angles of the piece within the same image. Synthesize the views into a single coherent piece and choose ONE viewpoint for the output.';
+        }
+    }
+    else if (uploadMode === 'multi_item_single') {
+        if (template.hasModel) {
+            quantityConstraint = `The attached image shows MULTIPLE distinct jewelry pieces in a single photo. The model is wearing ALL visible pieces together. Each distinct piece must appear EXACTLY ONCE. Do NOT duplicate, mirror, or multiply any piece. Do NOT add any other jewelry.${needsBothHands ? ' IMPORTANT: Show BOTH hands with the pieces distributed naturally and elegantly across both hands -- do NOT cram all pieces onto a single hand.' : ''}`;
+        }
+        else {
+            quantityConstraint = 'The attached image shows MULTIPLE distinct jewelry pieces in a single photo. Include ALL visible pieces together in the final image. Each distinct piece must appear EXACTLY ONCE. Do NOT duplicate, mirror, or multiply them. Do NOT add any other pieces.';
+        }
+    }
+    else if (imageCount > 1) {
+        if (template.hasModel) {
+            quantityConstraint = `The model is wearing ALL the provided pieces together. Each distinct piece must appear EXACTLY ONCE. Do NOT duplicate, mirror, or multiply any piece. Do NOT add any other jewelry.${needsBothHands ? ' IMPORTANT: Show BOTH hands with the pieces distributed naturally and elegantly across both hands � do NOT cram all pieces onto a single hand.' : ''}`;
+        }
+        else {
+            quantityConstraint = 'The attached image(s) show the EXACT SAME single piece of jewelry (potentially from different angles/perspectives). Render ONLY this single piece in the scene. Synthesize the view(s) to accurately recreate its details. Do NOT generate multiple pieces of jewelry.';
+        }
+    }
+    else {
+        if (template.hasModel) {
+            quantityConstraint = 'The model is wearing ONLY the single piece of jewelry shown in the reference. Do NOT add matching earrings, necklaces, or other rings.';
+        }
+        else {
+            quantityConstraint = 'The scene includes ONLY the single piece of jewelry shown in the reference. Do NOT add matching earrings, necklaces, or other rings.';
+        }
+    }
     // Dynamic Base Concept
     let ethnicityLabel = (ethnicity && ethnicity.id !== 'none') ? ethnicity.name : "professional female";
+    const extraModelNotes = [];
+    const framingNotes = [];
+    if (isEditorialMuse) {
+        if (useEditorialUltraCloseUp) {
+            framingNotes.push('Framing: extreme close-up crop with jewelry dominating the frame and filling most of the image. Push the camera much closer. It is acceptable to crop out most of the face, head, and torso to prioritize the jewelry. Background and decor may be minimal or out of frame.');
+        }
+        else if (useEditorialCloseUp) {
+            framingNotes.push('Framing: tight close-up with jewelry prominent and larger in frame. It is acceptable to crop out parts of the face, head, and torso to prioritize the jewelry. Background and decor may be minimal or out of frame.');
+        }
+        else {
+            framingNotes.push('Framing: waist-up portrait with face, head, and shoulders visible. Hands may appear but must not be the primary subject. Do NOT crop to hands only.');
+        }
+        extraModelNotes.push('High-fashion beauty, not girl-next-door; unconventional, memorable, magazine-cover presence.');
+    }
+    if (isEditorialMuse && ethnicity?.id === 'african') {
+        ethnicityLabel = 'Black American (modern, cosmopolitan)';
+        extraModelNotes.push('Aesthetic: modern Black American editorial; cosmopolitan, upscale, contemporary.');
+        extraModelNotes.push('Avoid traditional/tribal styling, costumes, or regional stereotypes.');
+    }
     // Diversity Injection: Pick a specific region if available
-    if (ethnicity && ethnicity.id && ETHNICITY_REGIONS[ethnicity.id]) {
+    if (ethnicity && ethnicity.id && ETHNICITY_REGIONS[ethnicity.id] && !(isEditorialMuse && ethnicity.id === 'african')) {
         const regions = ETHNICITY_REGIONS[ethnicity.id];
         const randomRegion = regions[Math.floor(Math.random() * regions.length)];
         ethnicityLabel = `${randomRegion} (${ethnicity.name})`;
     }
     let basePrompt = template.basePrompt;
+    if (useEditorialUltraCloseUp) {
+        basePrompt = 'An extreme close-up editorial photograph of a [ETHNICITY] female model wearing the specific jewelry piece(s) shown. Jewelry should dominate the frame and fill most of the image. It is acceptable to crop out most of the face, head, and torso to prioritize the jewelry. High-fashion editorial mood, beauty-grade skin refinement with smooth even tone, reduced pores, minimal blemishes, still realistic (no plastic skin), cinematic lighting, shot on film.';
+    }
+    else if (useEditorialCloseUp) {
+        basePrompt = 'A tight close-up editorial photograph of a [ETHNICITY] female model wearing the specific jewelry piece(s) shown. Jewelry should be visually dominant. It is acceptable to crop the face, head, or torso to prioritize the jewelry. High-fashion editorial mood, beauty-grade skin refinement with smooth even tone, reduced pores, minimal blemishes, still realistic (no plastic skin), cinematic lighting, shot on film.';
+    }
     basePrompt = basePrompt.replace(/\[ETHNICITY\]/g, ethnicityLabel);
     const hairColorLabel = (hairColor && hairColor.id !== 'none') ? hairColor.name.toLowerCase() : "natural colored";
     basePrompt = basePrompt.replace(/\[HAIR_COLOR\]/g, hairColorLabel);
+    const sceneDetails = [];
+    const modelDetails = [];
+    if (!template.hasModel) {
+        if (useFlatlayUltraCloseUp) {
+            sceneDetails.push('Framing: extreme close-up crop with the jewelry dominating the frame and filling most of the image; push the camera much closer; minimize negative space and background; allow props/material edges to be cropped; emphasize jewelry scale and detail.');
+        }
+        else if (useFlatlayCloseUp) {
+            sceneDetails.push('Framing: tight close-up crop with jewelry filling more of the frame; minimize background and allow props/material edges to be partially cropped; emphasize jewelry scale.');
+        }
+        if (detail && template.customizationLabel) {
+            const detailValue = detail.value.replace(/\[HAIR_COLOR\]/g, hairColorLabel);
+            sceneDetails.push(`${template.customizationLabel}: ${detailValue}`);
+        }
+        if (secondaryDetail && template.secondaryCustomizationLabel) {
+            sceneDetails.push(`${template.secondaryCustomizationLabel}: ${secondaryDetail.value}`);
+        }
+        if (tertiaryDetail && template.tertiaryCustomizationLabel) {
+            sceneDetails.push(`${template.tertiaryCustomizationLabel}: ${tertiaryDetail.value}`);
+        }
+        if (quaternaryDetail && template.quaternaryCustomizationLabel) {
+            sceneDetails.push(`${template.quaternaryCustomizationLabel}: ${quaternaryDetail.value}`);
+        }
+        if (quinaryDetail && template.quinaryCustomizationLabel) {
+            sceneDetails.push(`${template.quinaryCustomizationLabel}: ${quinaryDetail.value}`);
+        }
+    }
+    else {
+        if (ethnicity && ethnicity.id !== 'none') {
+            modelDetails.push(`Model Ethnicity: ${ethnicityLabel}`);
+        }
+        if (detail) {
+            let detailValue = detail.value.replace(/\[HAIR_COLOR\]/g, hairColorLabel);
+            if (detail.id === 'outfit_blazer') {
+                detailValue = getRandomBlazerValue();
+            }
+            if (occasion && template.id === 'half_body_muse') {
+                detailValue = `${detailValue}. Adapt any outfit to the selected occasion while preserving the original silhouette and styling direction.`;
+            }
+            modelDetails.push(`${template.customizationLabel}: ${detailValue}`);
+        }
+        else if (template.customizationLabel?.toLowerCase().includes('makeup')) {
+            modelDetails.push(`${template.customizationLabel}: completely bare faced, no makeup, fresh natural skin`);
+        }
+        else if (template.customizationLabel?.toLowerCase().includes('nail')) {
+            modelDetails.push(`${template.customizationLabel}: natural unpainted nails with a clear healthy coat`);
+        }
+        if (secondaryDetail) {
+            modelDetails.push(`${template.secondaryCustomizationLabel}: ${secondaryDetail.value}`);
+        }
+        else if (template.secondaryCustomizationLabel?.toLowerCase().includes('makeup')) {
+            modelDetails.push(`${template.secondaryCustomizationLabel}: completely bare faced, no makeup, fresh natural skin`);
+        }
+        else if (template.secondaryCustomizationLabel?.toLowerCase().includes('nail')) {
+            modelDetails.push(`${template.secondaryCustomizationLabel}: natural unpainted nails with a clear healthy coat`);
+        }
+        if (tertiaryDetail) {
+            modelDetails.push(`${template.tertiaryCustomizationLabel}: ${tertiaryDetail.value}`);
+        }
+        else if (template.tertiaryCustomizationLabel?.toLowerCase().includes('makeup')) {
+            modelDetails.push(`${template.tertiaryCustomizationLabel}: completely bare faced, no makeup, fresh natural skin`);
+        }
+        else if (template.tertiaryCustomizationLabel?.toLowerCase().includes('nail')) {
+            modelDetails.push(`${template.tertiaryCustomizationLabel}: natural unpainted nails with a clear healthy coat`);
+        }
+        if (quaternaryDetail) {
+            modelDetails.push(`${template.quaternaryCustomizationLabel}: ${quaternaryDetail.value}`);
+        }
+        if (quinaryDetail) {
+            modelDetails.push(`${template.quinaryCustomizationLabel}: ${quinaryDetail.value}`);
+        }
+        if (skinTone && skinTone.id !== 'none' && !['flatlay_creative', 'floating_minimal', 'museum_exhibit', 'romantic_mood'].includes(template.id)) {
+            modelDetails.push(`Model Skin Tone: ${skinTone.value}`);
+        }
+        if (hairColor && hairColor.id !== 'none' && !['hand_model', 'flatlay_creative', 'floating_minimal', 'romantic_mood'].includes(template.id)) {
+            modelDetails.push(`Model Hair Color: ${hairColor.value}`);
+        }
+        if (extraModelNotes.length > 0) {
+            modelDetails.push(...extraModelNotes);
+        }
+        if (framingNotes.length > 0) {
+            modelDetails.push(...framingNotes);
+        }
+    }
     const CAMERAS = [
         'Hasselblad X2D 100C, 120mm Macro lens, f/2.8',
         'Fujifilm GFX 100II, 110mm f/2 lens',
@@ -31,146 +174,163 @@ export const buildLLMPrompt = (template, detail, secondaryDetail, tertiaryDetail
         'Ilford HP5 (if black and white)'
     ];
     const randomFilm = FILM_STOCKS[Math.floor(Math.random() * FILM_STOCKS.length)];
-    let instruction = isBypassMode ?
-        `A highly detailed, photorealistic photograph featuring the specific jewelry shown in the attached reference images.
-
-══════════════════════════════════
-📸 PHOTOGRAPHY SPECIFICATION
-══════════════════════════════════
-Base Concept: ${basePrompt}
-Camera: ${randomCamera}
-Film Stock: ${randomFilm}
-Target: Authentic, high-end editorial photography. Cinematic, naturalistic, slightly imperfect.
-
-══════════════════════════════════
-💎 SUBJECT & JEWELRY (HIGHEST PRIORITY)
-══════════════════════════════════
-${quantityConstraint}
-The jewelry matches the reference images EXACTLY in all details: metal type, stone cuts, chain style, settings, etc.
-No additional jewelry pieces or embellishments.
-No sparkles, glitter, or magical glow effects.
-` : `Write a highly detailed, structured photorealistic prompt for the specific jewelry shown in the attached images.
+    let instruction = 'A highly detailed, photorealistic photograph featuring the specific jewelry shown in the attached reference image(s).';
+    instruction += `
+  ${JEWELRY_MACRO_QUALITY_PROMPT}
+  `;
+    instruction += `
 
-══════════════════════════════════
+----------------------------------
 📸 PHOTOGRAPHY SPECIFICATION
-══════════════════════════════════
-Base Concept: ${basePrompt}
-Camera: ${randomCamera}
-Film Stock: ${randomFilm}
-Target: Authentic, high-end editorial photography. Cinematic, naturalistic, slightly imperfect.
+----------------------------------
+- Base Concept: ${basePrompt}
+- Camera: ${randomCamera}
+- Film Stock: ${randomFilm}
+- Target: Authentic, high-end editorial photography. Cinematic, refined, naturalistic.
 
-══════════════════════════════════
+----------------------------------
 💎 SUBJECT & JEWELRY (HIGHEST PRIORITY)
-══════════════════════════════════
-${quantityConstraint}
-CRITICAL: Describe the jewelry EXACTLY as seen in the reference images. Preserve all details: metal type, stone cuts, chain style, settings, etc.
-Do NOT invent additional jewelry pieces or embellishments.
-Do NOT add sparkles, glitter, or magical glow effects.
+----------------------------------
+- ${quantityConstraint}
+- The jewelry matches the reference images EXACTLY in all details: metal type, stone cuts, chain style, settings, colors, etc.
+- The jewelry MUST be razor-sharp and micro-detailed (tack-sharp edges, crisp facets, ultra-clear metal and stone texture).
+- If the reference image is blurry or low quality, reconstruct the jewelry at higher fidelity; do NOT inherit blur.
+- Absolutely NO blur, soft focus, motion blur, or depth-of-field blur on the jewelry itself (background can be soft).
+- No additional jewelry pieces or embellishments.
+- No sparkles, glitter, or magical glow effects.
 `;
-    // OCCASION CONTEXT - Give this prominence if selected
-    if (occasion?.promptDetails) {
+    if (jewelerInsight) {
         instruction += `
-══════════════════════════════════
-🎭 OCCASION CONTEXT: ${occasion.name.toUpperCase()}
-══════════════════════════════════
-${occasion.description}
-
-🏛️ SETTING & ENVIRONMENT:
-${occasion.promptDetails.setting}
+----------------------------------
+🔍 JEWELER INSIGHT
+----------------------------------
+Pay special attention to the brand specific details, if any are provided.
 
-✨ ATMOSPHERE & MOOD:
-${occasion.promptDetails.atmosphere}
-
-🎨 COLOR PALETTE:
-${occasion.promptDetails.colorPalette}
-
-🌟 CULTURAL & THEMATIC ELEMENTS:
-${occasion.promptDetails.culturalElements}
-
-💄 MODEL STYLING & AESTHETIC:
-${occasion.promptDetails.styling}
+${jewelerInsight}
 `;
     }
-    // MODEL CUSTOMIZATIONS
-    let modelDetails = [];
-    if (ethnicity && ethnicity.id !== 'none') {
-        modelDetails.push(`Model Ethnicity: ${ethnicityLabel}`);
-    }
-    if (detail) {
-        // Replace [HAIR_COLOR] in the detail value (e.g. Hairstyle Context)
-        let detailValue = detail.value.replace(/\[HAIR_COLOR\]/g, hairColorLabel);
-        // Dynamic override for Blazer outfits to add variety
-        if (detail.id === 'outfit_blazer') {
-            detailValue = getRandomBlazerValue();
-        }
-        modelDetails.push(`${template.customizationLabel}: ${detailValue}`);
-    }
-    else if (template.customizationLabel?.toLowerCase().includes('makeup')) {
-        modelDetails.push(`${template.customizationLabel}: completely bare faced, no makeup, fresh natural skin`);
-    }
-    else if (template.customizationLabel?.toLowerCase().includes('nail')) {
-        modelDetails.push(`${template.customizationLabel}: natural unpainted nails with a clear healthy coat`);
-    }
-    if (secondaryDetail) {
-        modelDetails.push(`${template.secondaryCustomizationLabel}: ${secondaryDetail.value}`);
-    }
-    else if (template.secondaryCustomizationLabel?.toLowerCase().includes('makeup')) {
-        modelDetails.push(`${template.secondaryCustomizationLabel}: completely bare faced, no makeup, fresh natural skin`);
-    }
-    else if (template.secondaryCustomizationLabel?.toLowerCase().includes('nail')) {
-        modelDetails.push(`${template.secondaryCustomizationLabel}: natural unpainted nails with a clear healthy coat`);
-    }
-    if (tertiaryDetail) {
-        modelDetails.push(`${template.tertiaryCustomizationLabel}: ${tertiaryDetail.value}`);
-    }
-    else if (template.tertiaryCustomizationLabel?.toLowerCase().includes('makeup')) {
-        modelDetails.push(`${template.tertiaryCustomizationLabel}: completely bare faced, no makeup, fresh natural skin`);
-    }
-    else if (template.tertiaryCustomizationLabel?.toLowerCase().includes('nail')) {
-        modelDetails.push(`${template.tertiaryCustomizationLabel}: natural unpainted nails with a clear healthy coat`);
-    }
-    if (quaternaryDetail) {
-        modelDetails.push(`${template.quaternaryCustomizationLabel}: ${quaternaryDetail.value}`);
-    }
-    if (skinTone && skinTone.id !== 'none' && !template.id.includes('flatlay')) {
-        modelDetails.push(`Model Skin Tone: ${skinTone.value}`);
+    if (campaignStyle) {
+        instruction += `
+----------------------------------
+💫 CAMPAIGN MODE (PREMIUM)
+----------------------------------
+- Campaign Direction: ${campaignStyle.name}
+- ${campaignStyle.prompt}
+- Goal: billboard-level impact. Bold, cinematic, unforgettable.
+- Do NOT override user selections (background, vibe, styling). Amplify them.
+`;
     }
-    if (hairColor && hairColor.id !== 'none' && !['hand_model', 'flatlay_creative', 'floating_minimal'].includes(template.id)) {
-        modelDetails.push(`Model Hair Color: ${hairColor.value}`);
+    const occasionCultural = occasion?.promptDetails?.culturalElements?.length
+        ? occasion.promptDetails.culturalElements[Math.floor(Math.random() * occasion.promptDetails.culturalElements.length)]
+        : null;
+    const occasionDecor = occasion?.promptDetails?.decor?.length
+        ? occasion.promptDetails.decor[Math.floor(Math.random() * occasion.promptDetails.decor.length)]
+        : null;
+    if (occasion?.promptDetails) {
+        instruction += `
+----------------------------------
+🎭 OCCASION CONTEXT: ${occasion.name.toUpperCase()}
+----------------------------------
+- ${occasion.description}
+- 🌟 CULTURAL & THEMATIC ELEMENTS: ${occasionCultural}
+${occasionDecor ? `- OCCASION DECOR: ${occasionDecor}` : ''}
+`;
     }
     if (modelDetails.length > 0) {
         instruction += `
-══════════════════════════════════
+----------------------------------
 👤 MODEL SPECIFICATIONS
-══════════════════════════════════
-${modelDetails.join('\n')}
-The model should look like a natural, real human.
+----------------------------------
+${modelDetails.map(detailLine => `- ${detailLine}`).join('\n')}
+- The model should look like a natural, real human.
 `;
     }
-    // SETTING & BACKGROUND (if not overridden by occasion)
-    if (!occasion && (background || backgroundType || vibe)) {
+    if (guidelineReferences && guidelineReferences.length > 0) {
+        const guidelineLines = guidelineReferences.map((ref, index) => `- Guideline Reference #${index + 1} = "${ref.name}"`).join('\n');
         instruction += `
-══════════════════════════════════
+----------------------------------
+📌 GUIDELINE REFERENCES
+----------------------------------
+- These appear immediately AFTER the ${imageCount} jewelry reference image(s), and BEFORE any background reference image.
+${guidelineLines}
+- When a guideline includes [[ref:Name]], use the matching Guideline Reference image above.
+- Use these ONLY when referenced in the user's guidelines.
+- Treat them as style/lighting/pose/composition cues; do NOT alter jewelry design from the reference.
+`;
+    }
+    const isSolidBg = !!(background && background.value && background.value.includes('[SOLID_BG]'));
+    const hasSettingContext = !!(background || backgroundType || vibe || photographyStyle || backgroundReference);
+    const shouldRenderSettingBlock = hasSettingContext || sceneDetails.length > 0;
+    if (shouldRenderSettingBlock) {
+        const allowCampaignAccent = !(background && background.value && background.value.includes('[USER_BRAND_COLOR]'));
+        instruction += `
+----------------------------------
 🎬 SETTING & ENVIRONMENT
-══════════════════════════════════
+----------------------------------
 `;
-        if (backgroundType) {
-            const bgValue = getRandomBackgroundValue(backgroundType.id, backgroundType.value);
-            instruction += `Setting Type: ${bgValue}\n`;
-        }
-        if (background && background.value) {
-            if (template.id === 'flatlay_creative') {
-                instruction += `Secondary accent color/texture element to complement the main surface: ${background.value}\n`;
+        if (isSolidBg) {
+            // Extract just the color specification
+            const colorValue = background.value.replace('[USER_BRAND_COLOR]', '').replace('[SOLID_BG]', '').trim();
+            instruction += `- BACKGROUND: A single, perfectly uniform, PURE SOLID COLOR filling the entire background � ${colorValue}.
+- The background MUST be completely flat and uniform: absolutely NO gradients, NO textures, NO patterns, NO shadows on the background, NO objects, NO surfaces, NO environmental elements.
+- Think of it as a perfectly even studio backdrop paper of exactly this color.
+- The ONLY non-background elements in the image are the subject (jewelry and model if applicable).
+`;
+            // Still include non-background scene details (e.g. surface for flatlay)
+            if (sceneDetails.length > 0) {
+                instruction += `${sceneDetails.map(detailLine => `- ${detailLine}`).join('\n')}\n`;
             }
-            else {
-                instruction += `Color Palette & Texture: ${background.value}\n`;
+            // Skip: backgroundReference, backgroundType, backgroundTreatment
+            // Keep photography style and vibe as they affect lighting/mood, not background content
+            if (photographyStyle) {
+                instruction += `- Overall Photography Style: ${photographyStyle.value}\n`;
             }
         }
-        if (vibe) {
-            instruction += `Photography Style & Mood: ${vibe.value}\n`;
+        else {
+            if (sceneDetails.length > 0) {
+                instruction += `${sceneDetails.map(detailLine => `- ${detailLine}`).join('\n')}\n`;
+            }
+            if (backgroundReference) {
+                const referenceLabel = backgroundReference.name ? ` ("${backgroundReference.name}")` : '';
+                const orderingNote = hasMuseReferences
+                    ? 'The background reference image is provided after the jewelry and guideline reference images, and BEFORE the final 3 Muse reference images.'
+                    : 'The background reference image is provided after the jewelry and guideline reference images.';
+                instruction += `- Background Image Reference${referenceLabel}: Use the provided background image as the exact background. Preserve its colors, textures, and lighting. Place the jewelry composition on top of that background. ${orderingNote}\n`;
+            }
+            if (backgroundType && !occasion && !backgroundReference) {
+                const bgValue = getRandomBackgroundValue(backgroundType.id, backgroundType.value, !!campaignStyle, allowCampaignAccent);
+                instruction += `- Setting Type: ${bgValue}\n`;
+            }
+            if (background && background.value) {
+                const isUserBrandColor = background.value.includes('[USER_BRAND_COLOR]');
+                const colorValue = isUserBrandColor ? background.value.replace('[USER_BRAND_COLOR] ', '') : background.value;
+                if (template.id === 'flatlay_creative') {
+                    instruction += isUserBrandColor
+                        ? `- MANDATORY Accent Color: ${colorValue}. The dominant accent tone in the scene MUST match this exact color.\n`
+                        : `- Secondary accent color/texture element to complement the main material: ${colorValue}\n`;
+                }
+                else {
+                    instruction += isUserBrandColor
+                        ? `- MANDATORY Background/Accent Color: ${colorValue}. The background and environment tones MUST prominently feature this exact color.\n`
+                        : `- Color Palette & Texture: ${colorValue}\n`;
+                }
+            }
+            if (vibe) {
+                let vibeValue = vibe.value;
+                if (!template.hasModel) {
+                    vibeValue = vibeValue.replace(/,?\s*shot on [^,]+ lens/gi, '').replace(/\s{2,}/g, ' ').trim();
+                }
+                if (vibeValue) {
+                    instruction += `- Mood & Vibes: ${vibeValue}\n`;
+                }
+            }
+            if (photographyStyle) {
+                instruction += `- Overall Photography Style: ${photographyStyle.value}\n`;
+            }
+            if (hasSettingContext && !backgroundReference) {
+                instruction += `\n- Background Treatment: ${getRandomBackgroundTreatment()}\n`;
+            }
         }
-        instruction += `\nBackground Treatment: ${getRandomBackgroundTreatment()}
-`;
     }
     const LIGHTING_MODES = [
         'Natural light reflections on jewelry (NO artificial sparkles or glow)',
@@ -179,77 +339,110 @@ The model should look like a natural, real human.
         'Gentle overhead diffused studio lighting for authentic material representation',
         'Dramatic chiaroscuro lighting with deep, natural shadows'
     ];
-    const randomLighting = LIGHTING_MODES[Math.floor(Math.random() * LIGHTING_MODES.length)];
-    // TECHNICAL REQUIREMENTS
+    let randomLighting = LIGHTING_MODES[Math.floor(Math.random() * LIGHTING_MODES.length)];
+    if (photographyStyle?.id === 'sculptural_light') {
+        randomLighting = 'Single hard key light from a high angle, crisp shadow edge, controlled specular highlights, studio-grade product lighting';
+    }
     instruction += `
-══════════════════════════════════
+----------------------------------
 ⚙️ TECHNICAL REQUIREMENTS
-══════════════════════════════════
+----------------------------------
 - ${randomLighting}
-- Sharp focus on jewelry with shallow depth of field
+- Ultra-sharp focus on jewelry; depth-of-field blur applies ONLY to the background
+- Lighting should feel natural with gentle falloff and imperfect shadow edges
+- Optional subtle lens character (light vignetting, mild edge softness) when appropriate
 - Authentic photographic quality (film grain acceptable)
 - Professional color grading
 - 2K resolution output quality
 `;
-    // STYLE & POSE DIRECTION (for diversity in batch generation)
+    if (template.hasModel) {
+        instruction += `- Beauty-retouched skin finish: smooth even tone, reduced pores, minimal blemishes, still realistic (no plastic skin)`;
+    }
     if (styleHint) {
         instruction += `
-══════════════════════════════════
+
+----------------------------------
 🎭 STYLE & POSE DIRECTION
-══════════════════════════════════
-${styleHint}
-IMPORTANT: Follow this specific direction to ensure variety across generated images.
+----------------------------------
+- ${styleHint}
 `;
     }
     instruction += `
-══════════════════════════════════
+----------------------------------
 🚫 STRICT PROHIBITIONS
-══════════════════════════════════
-DO NOT add: fake sparkles, glitter particles, magical glows, lens flares, additional jewelry not in reference;
-DO NOT change: the jewelry design, metal type, stone cuts, or any jewelry characteristics;
-DO NOT use: artificial effects, over-processing, unrealistic elements;
-DO NOT generate nudity, semi-nudity or scandalous imagery. The model should be elegantly styled and tastefully posed;
-`;
-    if (!isBypassMode) {
-        instruction += `
-OUTPUT: A structured JSON-like prompt with distinct sections. Do not use a single block of text. Use the following format:
-
-{
-  "Subject": "Detailed description of the jewelry and model...",
-  "Environment": "Setting, background, and atmosphere...",
-  "Lighting": "Lighting details...",
-  "Photography": "Camera and technical specs..."
-}
-
-Ensure the content of each section is rich, dense, and highly descriptive.
+----------------------------------
+- DO NOT add: fake sparkles, glitter particles, magical glows, lens flares, additional jewelry not in reference.
+- DO NOT change: the jewelry design, metal type, stone cuts, or any jewelry characteristics.
+- DO NOT add: scratches, chips, patina, damage, or wear to the jewelry.
+- DO NOT use: artificial effects, over-processing, unrealistic elements.
+- DO NOT generate nudity, semi-nudity or scandalous imagery. The model should be elegantly styled and tastefully posed.
 `;
+    if (uploadMode === 'multi_angle') {
+        instruction += `- CRITICAL: Do NOT duplicate the jewelry or show multiple instances (no pairs, stacks, or mirrored copies).`;
     }
+    instruction += `
+  ${JEWELRY_MACRO_QUALITY_PROMPT_2}
+  `;
     return instruction;
 };
-export const buildSystemInstruction = (template, ethnicity) => {
+export const buildSystemInstruction = (template, ethnicity, imageCount = 1, uploadMode = 'stacking', userGuidelines, hasBackgroundReference = false, hasGuidelineReferences = false, hasMuseReferences = false) => {
     const isFloating = template.id === 'floating_minimal';
     const isFlatlay = template.id === 'flatlay_creative';
+    const isSolidColorStudio = template.id === 'solid_color_studio';
     const isHandModel = template.id === 'hand_model';
     const isMuseumExhibit = template.id === 'museum_exhibit';
     const isRomance = template.id === 'romance_proposal';
     const isRomanticMood = template.id === 'romantic_mood';
     let llmSystemInstruction = '';
+    let fidelityRule = '';
+    if (uploadMode === 'multi_angle') {
+        fidelityRule = template.hasModel
+            ? `1. **JEWELRY FIDELITY (TOP PRIORITY)**: The attached image(s) show the EXACT SAME single piece of jewelry (from different angles).
+       - The model must wear ONLY this single piece.
+       - Render EXACTLY ONE physical instance of the piece (no duplicates, pairs, stacks, mirrors).
+       - Do NOT show multiple angles of the piece within the same image.
+       - Synthesize the views into a single coherent piece and choose ONE viewpoint for the output.
+       - Do NOT invent new pieces or modify the design.`
+            : `1. **JEWELRY FIDELITY (TOP PRIORITY)**: The attached image(s) show the EXACT SAME single piece of jewelry (from different angles).
+       - Render EXACTLY ONE physical instance of the piece (no duplicates, pairs, stacks, mirrors).
+       - Do NOT show multiple angles of the piece within the same image.
+       - Synthesize the views into a single coherent piece and choose ONE viewpoint for the output.
+       - Do NOT invent new pieces or modify the design.
+       - The jewelry must match the reference images EXACTLY in all details: shape, metal type, stone cuts, chain style, settings, colors, etc. Do NOT change any aspect of the jewelry's appearance.`;
+    }
+    else if (uploadMode === 'multi_item_single') {
+        fidelityRule = `1. **JEWELRY FIDELITY (TOP PRIORITY)**: The attached image shows MULTIPLE distinct jewelry pieces in a single photo.
+       - The final image must contain ALL visible pieces together.
+       - Each distinct piece must appear EXACTLY ONCE. Do NOT duplicate, mirror, or multiply any piece.
+       - Do NOT invent new pieces.
+       - Do NOT modify the design of the existing jewelry.
+       - THIS IS THE MOST IMPORTANT RULE: The jewelry must match the reference image EXACTLY in all details: shape, metal type, stone cuts, chain style, settings, colors, etc. Do NOT change any aspect of the jewelry's appearance.`;
+    }
+    else if (imageCount > 1) {
+        fidelityRule = `1. **JEWELRY FIDELITY (TOP PRIORITY)**: The final image must contain ALL the jewelry pieces visible in the reference images, styled together.
+       - Each distinct piece must appear EXACTLY ONCE. Do NOT duplicate, mirror, or multiply any piece.
+       - Do NOT invent new pieces.
+       - Do NOT modify the design of the existing jewelry.
+       - THIS IS THE MOST IMPORTANT RULE: The jewelry must match the reference images EXACTLY in all details: shape, metal type, stone cuts, chain style, settings, colors, etc. Do NOT change any aspect of the jewelry's appearance.`;
+    }
+    else {
+        fidelityRule = `1. **JEWELRY FIDELITY (TOP PRIORITY)**: The final image must contain ONLY the jewelry piece visible in the reference image.
+       - Do NOT invent new pieces (e.g. do not add a necklace if only a ring is provided).
+       - Do NOT modify the design of the existing jewelry.
+    THIS IS THE MOST IMPORTANT RULE: The jewelry must match the reference image EXACTLY in all details: shape, metal type, stone cuts, chain style, settings, colors, etc. Do NOT change any aspect of the jewelry's appearance.`;
+    }
     if (isRomanticMood) {
         llmSystemInstruction = `You are a world-renowned still-life photographer and prop stylist for luxury jewelry and lifestyle brands.
     Generate a DREAMY, INTIMATE STILL-LIFE PHOTOGRAPH of jewelry in a romantic setting.
 
     CRITICAL GUIDELINES:
-    1. **JEWELRY FIDELITY (TOP PRIORITY)**: The final image must contain ONLY the jewelry pieces visible in the reference images.
-       - Do NOT invent new pieces.
-       - Do NOT modify the design of the existing jewelry.
+    ${fidelityRule}
     2. **PROP DISCIPLINE (CRITICAL)**: Use ONLY the specific prop/scene described in the user's customization choice. Do NOT add other props.
        - If the user chose "candles", the scene is ONLY candles and the jewelry. Do NOT add roses, letters, or other objects.
        - If the user chose "rose petals", the scene is ONLY rose petals and the jewelry. Do NOT add candles, letters, or other objects.
-       - Keep the scene focused and minimal — one prop theme, not a cluttered collection of romantic clichés.
+       - Keep the scene focused and minimal � one prop theme, not a cluttered collection of romantic clich�s.
     3. **Subject**: NO human model, NO body parts, NO mannequins, NO hands.
-    4. **NO FAKE EFFECTS**: Strictly FORBID "sparkles", "glitter particles", "magical glow". Use natural light and genuine material textures.
-    5. **Realism**: Product photography quality (Hasselblad X2D 100C, 120mm Macro, f/2.8, shallow depth of field). Props must look real and tactile.
-    6. **Vibe**: Romantic, intimate, dreamy, feminine.`;
+    4. **NO FAKE EFFECTS**: Strictly FORBID "sparkles", "glitter particles", "magical glow". Use natural light and genuine material textures.`;
     }
     else if (isRomance) {
         const ethnicityPrompt = (ethnicity && ethnicity.id !== 'none') ? ethnicity.value : "Professional couple";
@@ -257,66 +450,56 @@ export const buildSystemInstruction = (template, ethnicity) => {
     Generate an INTIMATE, EMOTIONALLY POWERFUL photograph based on the reference jewelry images.
 
     CRITICAL GUIDELINES:
-    1. **JEWELRY FIDELITY (TOP PRIORITY)**: The final image must contain ONLY the jewelry pieces visible in the reference images.
-       - Do NOT invent new pieces (e.g. do not add a necklace if only a ring is provided).
-       - Do NOT modify the design of the existing jewelry.
+    ${fidelityRule}
     2. **Subject**: Focus on the emotional authenticity of the moment. The jewelry (especially rings) should be prominently visible but feel naturally integrated.
        - Hands, fingers, and body language are critical storytelling elements.
        - Ethnicity context: ${ethnicityPrompt}
-    3. **NO FAKE EFFECTS**: Strictly FORBID "sparkles", "glitter particles", "magical glow". Natural light reflection only.
-    4. **Realism**: Photography quality (Contax 645, Zeiss Planar 80mm f/2, Kodak Portra 400).
-    5. **Vibe**: Tender, authentic, emotionally powerful, intimate. Real love story energy.`;
+    3. **NO FAKE EFFECTS**: Strictly FORBID "sparkles", "glitter particles", "magical glow". Natural light reflection only.`;
     }
     else if (isMuseumExhibit) {
         llmSystemInstruction = `You are a world-renowned museum photographer and exhibition designer.
     Generate a MUSEUM-QUALITY photograph of jewelry displayed as a priceless exhibit.
 
     CRITICAL GUIDELINES:
-    1. **JEWELRY FIDELITY (TOP PRIORITY)**: The final image must contain ONLY the jewelry pieces visible in the reference images.
-       - Do NOT invent new pieces.
-       - Do NOT modify the design of the existing jewelry.
+    ${fidelityRule}
     2. **Subject**: The jewelry should be displayed as a priceless artifact worthy of the world's greatest museums.
        - NO human model, NO body parts, NO mannequins.
-    3. **NO FAKE EFFECTS**: Strictly FORBID "sparkles", "glitter particles", "magical glow". Professional museum lighting only.
-    4. **Realism**: Professional museum photography equipment and lighting quality.
-    5. **Vibe**: Reverent, prestigious, archival quality, awe-inspiring.`;
+    3. **NO FAKE EFFECTS**: Strictly FORBID "sparkles", "glitter particles", "magical glow". Professional museum lighting only.`;
     }
     else if (isFloating) {
         llmSystemInstruction = `You are a world-renowned product photographer and creative director for luxury jewelry campaigns.
     Generate a HYPER-REALISTIC product photograph based on the reference images.
 
     CRITICAL GUIDELINES:
-    1. **JEWELRY FIDELITY (TOP PRIORITY)**: The final image must contain ONLY the jewelry pieces visible in the reference images.
-       - Do NOT invent new pieces (e.g. do not add earrings if only a necklace is provided).
-       - Do NOT modify the design of the existing jewelry.
+    ${fidelityRule}
     2. **Subject**: The jewelry should appear to be SUSPENDED in mid-air, floating, with NO human model, NO body parts, and NO mannequins. Focus on dramatic lighting, shadows, and a clean, minimalist composition.
-    3. **NO FAKE EFFECTS**: Strictly FORBID "sparkles", "glitter particles", "magical glow". Natural light reflection only.
-    4. **Realism**: Photography quality (Hasselblad X2D 100C, Macro Lens 120mm, f/2.8).
-    5. **Vibe**: Old money, elegant, classy, expensive, minimalist.`;
+    3. **NO FAKE EFFECTS**: Strictly FORBID "sparkles", "glitter particles", "magical glow". Natural light reflection only.`;
+    }
+    else if (isSolidColorStudio) {
+        llmSystemInstruction = `You are a world-renowned product photographer and creative director for luxury jewelry campaigns.
+    Generate a HYPER-REALISTIC product photograph based on the reference images.
+
+    CRITICAL GUIDELINES:
+    ${fidelityRule}
+    2. **Subject**: The jewelry is the ONLY subject. NO human model, NO body parts, NO mannequins, NO props, NO surfaces or platforms.
+    3. **Background**: Must be a perfectly uniform solid color exactly as specified by the user prompt. NO gradients, NO textures, NO environmental elements.
+    4. **NO FAKE EFFECTS**: Strictly FORBID "sparkles", "glitter particles", "magical glow". Natural light reflection only.`;
     }
     else if (isFlatlay) {
         llmSystemInstruction = `You are a world-renowned product photographer and creative director for luxury jewelry campaigns.
     Generate a HYPER-REALISTIC product photograph based on the reference images.
 
     CRITICAL GUIDELINES:
-    1. **JEWELRY FIDELITY (TOP PRIORITY)**: The final image must contain ONLY the jewelry pieces visible in the reference images.
-       - Do NOT invent new pieces (e.g. do not add earrings if only a necklace is provided).
-       - Do NOT modify the design of the existing jewelry.
+    ${fidelityRule}
     2. **Subject**: The jewelry should be displayed as a creative still-life composition, with NO human model, NO body parts, and NO mannequins.
-       - The jewelry may be laid flat on a surface, OR elevated on geometric pedestals, cubes, stone risers, plinths, or sculptural props.
-       - Lighting should always look natural and photographic — soft studio light, window light, or gentle directional light. Shadows should feel organic, not artificial.
-    3. **NO FAKE EFFECTS**: Strictly FORBID "sparkles", "glitter particles", "magical glow", neon lighting, overly stylized color gels. Natural light reflection only.
-    4. **Realism**: Photography quality (Hasselblad X2D 100C, Macro Lens 120mm, f/2.8).
-    5. **Vibe**: Old money, elegant, classy, expensive, artistic.`;
+    3. **NO FAKE EFFECTS**: Strictly FORBID "sparkles", "glitter particles", "magical glow", neon lighting, overly stylized color gels. Natural light reflection only.`;
     }
     else if (isHandModel) {
         llmSystemInstruction = `You are a world-renowned product photographer and creative director for luxury jewelry campaigns.
     Generate a HYPER-REALISTIC hand model photograph based on the reference images.
 
     CRITICAL GUIDELINES:
-    1. **JEWELRY FIDELITY (TOP PRIORITY)**: The final image must contain ONLY the jewelry pieces visible in the reference images.
-       - Do NOT invent new pieces (e.g. do not add earrings if only a ring is provided).
-       - Do NOT modify the design of the existing jewelry.
+    ${fidelityRule}
     2. **FRAMING (CRITICAL)**: The image focuses on the hand, wrist, and forearm area.
        - NO face, head, or shoulders visible.
        - The forearm may be bare OR elegantly sleeved (luxurious fabrics like silk, cashmere, lace, velvet).
@@ -324,24 +507,42 @@ export const buildSystemInstruction = (template, ethnicity) => {
     3. **Subject**: A model's hand(s) (age 20-30) with elegant, relaxed pose wearing the jewelry. Focus on authentic skin texture and natural nail appearance.
        - If 3 or more jewelry pieces are provided, show BOTH hands to distribute the pieces naturally and elegantly across both hands. Avoid cramming all pieces onto a single hand.
        - If 1-2 pieces, a single hand is fine.
-    4. **NO FAKE EFFECTS**: Strictly FORBID "sparkles", "glitter particles", "magical glow". Natural light reflection only.
-    5. **Realism**: Photography quality (Hasselblad X2D 100C, Macro Lens 120mm, f/2.8).
-    6. **Vibe**: Old money, elegant, classy, expensive, feminine.`;
+    4. **NO FAKE EFFECTS**: Strictly FORBID "sparkles", "glitter particles", "magical glow". Natural light reflection only.`;
     }
     else {
         const ethnicityPrompt = (ethnicity && ethnicity.id !== 'none') ? ethnicity.value : "Professional female model";
         llmSystemInstruction = `You are a world-renowned fashion photographer and creative director for Vogue Arabia and High Jewelry campaigns.
-    Generate an AUTHENTIC, CINEMATIC photograph based on the reference images. Skin texture should look natural and smooth.
+    Generate an AUTHENTIC, CINEMATIC photograph based on the reference images. Beauty retouching is desired: smooth even complexion, reduced pores, minimal blemishes; keep a realistic finish and avoid plastic skin.
 
     CRITICAL GUIDELINES:
-    1. **JEWELRY FIDELITY (TOP PRIORITY)**: The final image must contain ONLY the jewelry pieces visible in the reference images.
-       - Do NOT invent new pieces (e.g. do not add earrings if only a necklace is provided).
-       - Do NOT modify the design of the existing jewelry.
-       - If one ring is provided, the model wears ONE ring.
+    ${fidelityRule}
     2. **Subject**: ALWAYS a ${ethnicityPrompt} (age 20-30).
-    3. **NO FAKE EFFECTS**: Strictly FORBID "sparkles", "glitter particles", "magical glow". Natural light reflection only.
-    4. **Realism**: Photography quality (Hasselblad X2D 100C, Macro Lens 120mm, f/2.8).
-    5. **Vibe**: Old money, elegant, classy, expensive, feminine.`;
+    3. **NO FAKE EFFECTS**: Strictly FORBID "sparkles", "glitter particles", "magical glow". Natural light reflection only.`;
+    }
+    if (userGuidelines && userGuidelines.trim()) {
+        llmSystemInstruction += `
+
+USER-SPECIFIC GUIDELINES (MUST RESPECT IF ANY ARE PROVIDED):
+${userGuidelines.trim()}
+`;
+    }
+    llmSystemInstruction += `
+IMPORTANT:
+1. Follow and prioritize the "SETTING & ENVIRONMENT" directives from the user prompt.
+2. Follow and prioritize the "MODEL SPECIFICATIONS" directives from the user prompt.
+3. If an "Overall Photography Style" directive is provided, treat it as a required style constraint.
+4. Only override these style directives if they conflict with jewelry fidelity or explicit prohibitions above.`;
+    if (hasGuidelineReferences || hasBackgroundReference || hasMuseReferences) {
+        llmSystemInstruction += `
+5. Image reference ordering (important):
+   - Jewelry reference images come first.
+   - Guideline reference images (if any) come next.
+   - Background reference image (if any) comes after guideline references.
+   - If Muse images are provided, they are the final 3 images.`;
+    }
+    if (hasBackgroundReference) {
+        llmSystemInstruction += `
+6. The background reference image must be used as the exact background.`;
     }
     return llmSystemInstruction;
 };