zer0-image-generator 0.2.1 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 36da81ce0baf2b37bb861a7fe2f03d62c37c667d8a0754a9cc1ee95ee6afc827
-  data.tar.gz: a18923ae9adf0a2b38e2dca873bfaaba9e1e1437249e68ca5b70cc7dc59c6588
+  metadata.gz: 24975e688896196e8e883c15ed17d09e5856a9b68f18b47b347bc61d701cc265
+  data.tar.gz: da2d123ed3067f36c2e5962bd3a351a9d1ae48e1fd97bfe6dbcccb23aac53e52
 SHA512:
-  metadata.gz: 63b595b05dddeaf526df975f62ad5d8644b4d9e8571398a717b2207a5927a1c5f1216db0ec71aab7c00f2f7077d14e9a430b57ea1650ee882c35d7c2579c3382
-  data.tar.gz: dfe915ca69f2bb13a3023c63641755e96498634eb07d4779721158361e871a7433b701fa775f8ecfba358a9c4a73a2c5698c46dcacc8231968b15f1d5857df7b
+  metadata.gz: 2add913663a1f13bfebc00746b3ace4ebf5c4e096fd34ee1db89754245762d011e1a2ca8173ed2f0aefbf46abdacb041625f9ac916f9b8e48aa13c6c38c87467
+  data.tar.gz: e275f913cfeb197728138bc154a6963e31b1cdf0a1b11081a8526ef002667dfa504b1c7a0e55bac799a5977a599995012f2fe0f66aa28a3e5b28d599244c16a1

data/CHANGELOG.md

@@ -5,6 +5,27 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.3.0] - 2026-07-14
+
+### Added
+
+- Per-collection style/theme overrides: a `collection_styles:` map under
+  `preview_images:` lets each collection (`posts`, `docs`, `hacks`, …) carry
+  its own `style`, `style_modifiers`, `size`, `quality`, and `model` — so
+  field notes, docs, and hacks render with distinct visual identities. A
+  file's collection is derived from its `_<name>` directory; precedence is
+  author overrides → collection styles → CLI flags → env → config → defaults.
+
+## [0.2.2] - 2026-07-14
+
+### Fixed
+
+- `jekyll preview-images` CLI flags were silently dropped: Mercenary keys the
+  options hash by the symbol given to `c.option`, but the argv translator
+  looked up the string form — so `--dry-run`, `--list-missing`,
+  `--provider`, etc. never reached the engine. Added a Ruby unit test for the
+  translation and a CI assertion that `--dry-run` writes nothing.
+
 ## [0.2.1] - 2026-07-13
 
 ### Fixed

data/README.md

@@ -93,12 +93,13 @@ preview_images:
   collections_dir: ''         # falls back to Jekyll's top-level collections_dir
   front_matter_key: preview   # key to read/write (jekyll-seo-tag sites: image)
   authors_file: _data/authors.yml  # per-author style overrides ('' disables)
+  collection_styles: {}       # per-collection style/theme overrides (below)
   assets_prefix: /assets      # written paths omit this prefix ...
   auto_prefix: true           # ... and it is re-added for existence checks
 ```
 
-Priority per file: author overrides → CLI flags → environment variables →
-`_config.yml` → built-in defaults.
+Priority per file: author overrides → collection styles → CLI flags →
+environment variables → `_config.yml` → built-in defaults.
 
 Jekyll's own top-level `source:` key is honored automatically: on a site with
 `source: pages` (content, assets, and `_data` under `pages/`), every disk path
@@ -129,6 +130,27 @@ preview_images:
   # front_matter_key/preview + /assets prefixing are already the defaults
 ```
 
+### Per-collection styles
+
+Give each collection its own visual identity — tutorials render differently
+from field notes, docs differently from reviews. Any of `style`,
+`style_modifiers`, `size`, `quality`, and `model` can be set per collection;
+everything else inherits the global config. A file's collection comes from its
+`_<name>` directory; author overrides still win over collection styles.
+
+```yaml
+preview_images:
+  style: "retro pixel art"          # global fallback
+  collection_styles:
+    posts:
+      style: "hand-inked editorial illustration, warm print tones"
+    docs:
+      style: "clean isometric technical diagram"
+      style_modifiers: "matte surfaces, labeled parts, blueprint accents"
+    hacks:
+      style: "circuit-board schematic, glowing traces"
+```
+
 ### Per-author style overrides
 
 If `authors_file` points at a YAML map, an author's `preview:` block overrides

data/lib/zer0_image_generator/command.rb

@@ -72,7 +72,9 @@ module Zer0ImageGenerator
 
     def build_argv(options)
       SWITCHES.each_with_object([]) do |(flag, merc), argv|
-        value = options[merc.first.to_s]
+        # Mercenary keys the options hash by the symbol given to c.option.
+        value = options[merc.first]
+        value = options[merc.first.to_s] if value.nil?
         next if value.nil? || value == false
 
         if BOOLEANS.include?(flag)

data/lib/zer0_image_generator/preview_generator.py

@@ -17,6 +17,9 @@ knob with zer0-compatible defaults:
     author overrides    authors_file ("" disables)           _data/authors.yml
     collections         collections (list, or "auto" to      [posts]
                         discover from Jekyll's collections:)
+    collection styles   collection_styles (map of            {} (global style)
+                        collection → style/style_modifiers/
+                        size/quality/model overrides)
 
 Architecture — Claude ORCHESTRATES, an image model RENDERS:
 
@@ -573,6 +576,22 @@ def read_authors(project_root: Path, authors_file: str) -> Dict[str, Any]:
     return load_yaml_file(project_root / authors_file.strip().lstrip("/"))
 
 
+# Settings fields an override block (author preview: / collection_styles:)
+# may replace per file.
+OVERRIDE_KEYS = ("style", "style_modifiers", "size", "quality", "model")
+
+
+def _filter_override_block(block: Any) -> Dict[str, str]:
+    """Keep only the recognized override keys with non-empty values."""
+    if not isinstance(block, dict):
+        return {}
+    return {
+        key: str(value).strip()
+        for key, value in block.items()
+        if key in OVERRIDE_KEYS and value is not None and str(value).strip()
+    }
+
+
 def author_preview_overrides(authors: Dict[str, Any], author_key: Any) -> Dict[str, str]:
     """`preview:` override block for an author key (style/style_modifiers/size/
     quality/model). `author:` may be a list or mapping in some posts — only a
@@ -582,15 +601,27 @@ def author_preview_overrides(authors: Dict[str, Any], author_key: Any) -> Dict[s
     author = authors.get(author_key)
     if not isinstance(author, dict):
         return {}
-    preview = author.get("preview")
-    if not isinstance(preview, dict):
+    return _filter_override_block(author.get("preview"))
+
+
+def collection_of(path: Path) -> str:
+    """The file's collection, from the nearest `_<name>` ancestor directory
+    (Jekyll's collection layout) — '' for files outside any collection."""
+    for parent in Path(path).resolve().parents:
+        name = parent.name
+        if name.startswith("_") and len(name) > 1:
+            return name[1:]
+    return ""
+
+
+def collection_preview_overrides(
+    collection_styles: Dict[str, Any], collection: str
+) -> Dict[str, str]:
+    """`collection_styles:` override block for a collection — same keys as
+    author overrides, so each collection can carry its own visual theme."""
+    if not collection or not isinstance(collection_styles, dict):
         return {}
-    return {
-        key: str(value).strip()
-        for key, value in preview.items()
-        if key in ("style", "style_modifiers", "size", "quality", "model")
-        and value is not None and str(value).strip()
-    }
+    return _filter_override_block(collection_styles.get(collection))
 
 
 def _env_flag(name: str) -> bool:
@@ -613,6 +644,7 @@ class Settings:
     enabled: bool = True
     collections: List[str] = field(default_factory=lambda: list(DEFAULTS["collections"]))
     collections_dir: str = DEFAULTS["collections_dir"]
+    collection_styles: Dict[str, Any] = field(default_factory=dict)
     front_matter_key: str = DEFAULTS["front_matter_key"]
     authors_file: str = DEFAULTS["authors_file"]
     prompt_engine: str = DEFAULTS["prompt_engine"]
@@ -703,6 +735,10 @@ def resolve_settings(args: argparse.Namespace, config: Dict[str, Any]) -> Settin
         ),
         enabled=bool(cfg("enabled", True)),
         collections=[str(c) for c in collections],
+        collection_styles=(
+            cfg("collection_styles", {})
+            if isinstance(cfg("collection_styles", {}), dict) else {}
+        ),
         collections_dir=str(collections_dir or "").strip().strip("/"),
         front_matter_key=(
             args.front_matter_key
@@ -748,20 +784,38 @@ def resolve_settings(args: argparse.Namespace, config: Dict[str, Any]) -> Settin
     return settings
 
 
-def apply_author_overrides(settings: Settings, overrides: Dict[str, str]) -> Settings:
-    """Per-file settings copy with the author's preview block applied on top."""
-    if not overrides:
+def apply_preview_overrides(
+    settings: Settings, *override_blocks: Dict[str, str]
+) -> Settings:
+    """Per-file settings copy with override blocks applied in order — later
+    blocks win (pass collection styles first, author overrides on top)."""
+    merged: Dict[str, str] = {}
+    for block in override_blocks:
+        merged.update(block or {})
+    if not merged:
         return settings
     return replace(
         settings,
-        style=overrides.get("style", settings.style),
-        style_modifiers=overrides.get("style_modifiers", settings.style_modifiers),
-        size=overrides.get("size", settings.size),
-        quality=overrides.get("quality", settings.quality),
-        model=overrides.get("model", settings.model),
+        **{key: merged.get(key, getattr(settings, key)) for key in OVERRIDE_KEYS},
     )
 
 
+def file_preview_settings(settings: Settings, cf: "ContentFile",
+                          authors: Dict[str, Any]) -> Settings:
+    """The per-file settings: global → collection_styles[collection] →
+    author preview: block (most specific wins)."""
+    coll_overrides = collection_preview_overrides(
+        settings.collection_styles, collection_of(cf.path))
+    author_overrides = author_preview_overrides(authors, cf.author)
+    result = apply_preview_overrides(settings, coll_overrides, author_overrides)
+    if coll_overrides:
+        info(f"  ↳ Collection '{collection_of(cf.path)}' preview style applied")
+    if author_overrides:
+        info(f"  ↳ Author '{cf.author}' preview overrides applied "
+             f"({settings.authors_file})")
+    return result
+
+
 def model_family(model: str) -> Optional[str]:
     m = (model or "").strip().lower()
     for prefix, family in MODEL_FAMILIES.items():
@@ -2025,13 +2079,8 @@ class Runner:
             return
         out_base = self.root / settings.output_dir / slug
 
-        # Author overrides apply only once an image/prompt is actually built.
-        file_settings = apply_author_overrides(
-            settings, author_preview_overrides(self.authors, cf.author)
-        )
-        if file_settings is not settings:
-            info(f"  ↳ Author '{cf.author}' preview overrides applied "
-                 f"({settings.authors_file})")
+        # Style overrides apply only once an image/prompt is actually built.
+        file_settings = file_preview_settings(settings, cf, self.authors)
 
         # ---- Analyze: Claude reads the article and writes the art brief ----
         base_prompt = build_prompt(cf, file_settings)
@@ -2114,9 +2163,7 @@ class Runner:
             return
 
         info(f"Enhancing preview for: {cf.title}")
-        file_settings = apply_author_overrides(
-            settings, author_preview_overrides(self.authors, cf.author)
-        )
+        file_settings = file_preview_settings(settings, cf, self.authors)
         prompt = build_enhance_prompt(cf, file_settings)
         debug(f"Enhancement prompt: {prompt[:400]}...")
 

data/lib/zer0_image_generator/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Zer0ImageGenerator
-  VERSION = "0.2.1"
+  VERSION = "0.3.0"
 end

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: zer0-image-generator
 version: !ruby/object:Gem::Version
-  version: 0.2.1
+  version: 0.3.0
 platform: ruby
 authors:
 - Amr Abdel
-autorequire: 
 bindir: bin
 cert_chain: []
-date: 2026-07-14 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: jekyll
@@ -60,7 +59,6 @@ metadata:
   changelog_uri: https://github.com/bamr87/zer0-image-generator/blob/main/CHANGELOG.md
   bug_tracker_uri: https://github.com/bamr87/zer0-image-generator/issues
   rubygems_mfa_required: 'true'
-post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
@@ -76,8 +74,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements:
 - Python 3.9+ with PyYAML (python3 -m pip install pyyaml)
-rubygems_version: 3.0.3.1
-signing_key: 
+rubygems_version: 4.0.11
 specification_version: 4
 summary: AI preview/social images for any Jekyll site — Claude directs and reviews,
   an image model renders.