# ComicForge configuration example.
#
# Copy this file to config.yaml and adjust the values you want to override.
# Command-line flags always take precedence over config values.

provider:
  # Supported today: gemini.
  # Future providers can be added here when ComicForge grows new backends.
  text: gemini
  image: gemini
  tts: gemini

api:
  # Required for Gemini-backed providers.
  google_api_key: ""

models:
  text: gemini-2.5-flash
  image: gemini-3.1-flash-image-preview
  image_text: gemini-2.5-flash
  tts: gemini-2.5-flash-preview-tts

comic:
  story_pages: 5
  gallery_pages: 5
  # 4 panels → prompt asks for ≥3 horizontal rows (not a 2×2-only layout).
  panels_per_page: 4
  # Gemini image aspect ratio. CLI: --aspect-ratio wins. With pdf.presentation print|book, defaults to 3:4 (A4-class) unless --aspect-ratio is set.
  aspect_ratio: "16:9"
  prompt_max_chars: 900
  page_max_retries: 5
  page_retry_base_seconds: 15

language:
  input: Vocabulary
  output: Story
  # Language used for story and narration prompts. Must match the script of visible text
  # (e.g. English story + Latin script for English vocab; Cyrillic for Bulgarian).
  # Env: COMICFORGE_LANGUAGE_STORY_LANGUAGE, COMICFORGE_LANGUAGE_SCRIPT
  story_language: Bulgarian
  script: Latin

story:
  genres:
    - a warm slice-of-life story
    - a heartfelt family drama
    - an exciting science-fiction adventure
  realistic_weight: 0.4

styles:
  comic:
    - classic comic book with bold ink outlines
    - graphic novel with dramatic shadows
  realistic:
    - ultra-realistic DSLR photography, cinematic 35mm lens
    - cinematic realism with natural light
  cartoon:
    - extremely cartoonish 1930s rubber-hose funny-animal comic style, original mouse-and-duck-era mascot energy, pie-cut eyes, button noses or beaks, white gloves, oversized shoes, noodle arms, squash-and-stretch bodies, round heads, huge expressions, flat candy colors, absolutely no realism
    - vintage theatrical funny-animal cartoon comic style, redesign people as original anthropomorphic mascot characters with beaks or round snouts, pie-cut eyes, white gloves, oversized shoes, elastic limbs, slapstick poses, no realistic anatomy
  action_90s:
    - 1990s superhero comic splash-page style like a bold caped hero punching a masked villain in a city, huge muscles, spandex costumes, explosions, halftone print texture
    - classic 90s action superhero cover style, oversized yellow masthead energy, caped spandex hero, armored villain, city skyline, speech balloons, Ben-Day dots
  manga:
    - true monochrome Japanese shonen manga page, black ink only with grey screentone, no western color rendering, large expressive anime eyes, sharp spiky hair silhouettes, sweat drops, impact bursts, speed-line backgrounds, exaggerated emotion close-ups, dynamic diagonal manga panel language
    - authentic serialized manga action art, crisp black linework, dense screentone gradients, white paper highlights, hand-drawn Japanese comic energy, chibi reaction inset, dramatic sound-effect shapes, cinematic close-ups, no painterly western comic coloring
  horror:
    - vintage horror comic style, eerie shadows, gothic atmosphere, unsettling monsters
    - creepy supernatural horror comic style, fog, haunted architecture, heavy inks
  watercolor:
    - pure transparent watercolor storybook comic style, visible cold-press paper grain, watery pigment blooms, uneven wash edges, granulation, soft bleeding colors, pale layered washes, loose pencil underdrawing, no digital airbrush, no oil-paint texture, no glossy comic coloring
    - hand-painted watercolor children's adventure style, translucent pastel washes, wet-on-wet skies, dry-brush texture, white paper highlights, delicate ink-and-pencil outlines, puddled pigment edges, airy negative space, gentle low-contrast rendering
  pulp:
    - retro pulp adventure cover style, painted poster energy, dramatic rim light, saturated inks, worn paper grain, bold composition, vintage print imperfections
    - mid-century pulp sci-fi comic style, chromatic airbrushed highlights, atomic-age props, bold diagonals, distressed halftone texture, high adventure mood
  mecha:
    - high-detail mecha comic style, hard-surface armor plates, mechanical joints, cockpit glass reflections, technical line art, industrial lighting
    - anime mecha action page style, towering robots, dynamic perspective, panel-like motion energy, sparks and smoke, crisp cel-shaded rendering
  pixel_art:
    - 16-bit pixel-art comic scene, limited palette, clean pixel clusters, deliberate dithering, retro game-era perspective, sharp pixel edges
    - retro pixel-art storyboard style, chunky sprites, high-contrast palette ramps, tiled-environment texture, no anti-aliasing, classic console look
  ink_wash:
    - ink-wash brush painting style, sumi-e inspired strokes, expressive black ink gradients, controlled bleed on paper, minimal but dramatic composition
    - monochrome ink-and-wash comic style, calligraphic brush lines, soft gray washes, negative-space storytelling, textured rice-paper feel
  clay:
    - stop-motion clay diorama style, hand-sculpted clay characters, thumbprint texture, miniature set lighting, tactile handcrafted look
    - plasticine comic tableau style, sculpted figures, soft studio shadows, practical miniature props, playful clay surface detail

narration:
  voices:
    - Charon
    - Fenrir
  chunk_words: 100

# Final PDF assembly (ImageMagick `convert` on PATH). CLI: --pdf-jpeg-quality, --pdf-presentation.
# Env: COMICFORGE_PDF_DENSITY, COMICFORGE_PDF_JPEG_QUALITY, COMICFORGE_PDF_PRESENTATION
pdf:
  density: 150
  # 0 = default; 1–100 = JPEG inside PDF (smaller file).
  jpeg_quality: 0
  # none | print | book — print/book output ISO A4 portrait PDF pages; book also ages, tilts, shadows, thick edge.
  presentation: none

# Directory that ComicForge uses for prompt templates.
prompts_dir: ./prompts