imdhemy-jekyll-theme 1.2.2 → 1.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 50c76c388dec9fe274dcc46260a08128270c6af8b704976dd8f6533cd8a2ce35
-  data.tar.gz: f10e6dd11fb0deaaa7f3b33da00480c66c25fd41c4f11c724bbefbe6a400b1c3
+  metadata.gz: 69e9d0e1c1d690401607c1367a5bc466299ad39b138bec2da357e728051de11b
+  data.tar.gz: fadd0e06e18d3555ceabba16456bfcae609feea59ac9d60e60d311c8ccf53b0f
 SHA512:
-  metadata.gz: 57973fec87dd5ee464ca42b973d392cac994f3929489906d111a98b8795d6c699944b41e52d20dfa6666cff734e3b1cde9cfa7494bde1631bdfe9eb15b2e767b
-  data.tar.gz: 1596774bef060733b074cc218c5a6990c09300cbe34f1d0330fc49f505ab47fbeb5eb6b4671d98395048ee5122c2b65a337aa6b1fbb05043b9498f173d8e957a
+  metadata.gz: bcb7c70dcd2aa0c7a7455a15f5c5cf75a4e473a63ff16539825c2651cf25397d7011f95315cf2f80bf5307d6a8ba1f08af5075e76a321a8ee54bcc56a389e1fa
+  data.tar.gz: bbe0c712aa2bce20a32a6ba998a29dccf93be925dd9427da01b4413fde456305f83363201a1a983a162b85bdf5c8b6ea64affd7c86b1459c43468b24181526f1

data/README.md

@@ -10,10 +10,23 @@ All documentation lives in the [`docs/`](./docs) directory.
 - [Getting Started](./docs/getting-started.md)
 - [Configuration Reference](./docs/configuration.md)
 - [Customization Guide](./docs/customization.md)
+- [AI Design System Guide](./docs/ai-design-guide.md)
 - [Components and Layouts](./docs/components.md)
 - [Content Elements](./docs/content-elements.md)
 - [Upgrade Guide](./UPGRADE.md)
 
+## Optional Tooling
+
+The gem also ships an optional image optimization executable for downstream sites:
+
+```bash
+bundle exec imdhemy-image path/to/image.jpg
+bundle exec imdhemy-image --recursive assets/images
+bundle exec imdhemy-image --dry-run path/to/images
+```
+
+The tool is opt-in and intended for projects using the theme. It is not part of the theme render pipeline.
+
 ## Example Site
 
 A complete runnable example is available in [`example/`](./example).

data/_includes/post-header.html

@@ -2,13 +2,13 @@
 {% assign back_to_posts_label = site.theme_text.back_to_posts_label | default: "Back to all posts" %}
 <div class="post-header">
     <a class="post-back-link" href="{{ site.baseurl }}/blog">&larr; {{ back_to_posts_label }}</a>
-    {% include post-series.html %}
     <h1 class="post-title">{{ page.title }}</h1>
     {% include post-meta.html date=page.date reading_minutes=read_minutes class_name="post-header__meta post-meta" %}
     <div class="post-header__tags">
         {% assign tags = page.tags %}
         {% include post-tags.html %}
     </div>
+    {% include post-series.html %}
 
     {% if page.image %}
     <div class="post-image-wrap">

data/_includes/post-navigation.html

@@ -1,17 +1,40 @@
 {% assign previous_article_label = site.theme_text.previous_article_label | default: "Previous article" %}
 {% assign next_article_label = site.theme_text.next_article_label | default: "Next article" %}
+{% assign effective_previous_post = page.previous %}
+{% assign effective_next_post = page.next %}
+{% if page.list %}
+{% assign series_posts = site.posts | where: "list", page.list | sort: "date" %}
+{% assign current_series_index = -1 %}
+{% for post in series_posts %}
+{% if post.url == page.url %}
+{% assign current_series_index = forloop.index0 %}
+{% endif %}
+{% endfor %}
+{% if current_series_index >= 0 %}
+{% assign effective_previous_post = page.previous %}
+{% assign effective_next_post = page.next %}
+{% assign previous_series_index = current_series_index | minus: 1 %}
+{% assign next_series_index = current_series_index | plus: 1 %}
+{% if previous_series_index >= 0 %}
+{% assign effective_previous_post = series_posts[previous_series_index] %}
+{% endif %}
+{% if next_series_index < series_posts.size %}
+{% assign effective_next_post = series_posts[next_series_index] %}
+{% endif %}
+{% endif %}
+{% endif %}
 <section class="post-navigation-shell">
     <div class="post-navigation-shell__inner post-navigation">
-        {% if page.previous.url %}
-        <a class="post-navigation__item" href="{{ site.baseurl }}{{ page.previous.url }}">
+        {% if effective_previous_post.url %}
+        <a class="post-navigation__item" href="{{ site.baseurl }}{{ effective_previous_post.url }}">
             <span class="post-navigation__label">{{ previous_article_label }}</span>
-            <span class="post-navigation__title">{{ page.previous.title }}</span>
+            <span class="post-navigation__title">{{ effective_previous_post.title }}</span>
         </a>
         {% endif %}
-        {% if page.next.url %}
-        <a class="post-navigation__item post-navigation__item--next" href="{{ site.baseurl }}{{ page.next.url }}">
+        {% if effective_next_post.url %}
+        <a class="post-navigation__item post-navigation__item--next" href="{{ site.baseurl }}{{ effective_next_post.url }}">
             <span class="post-navigation__label">{{ next_article_label }}</span>
-            <span class="post-navigation__title">{{ page.next.title }}</span>
+            <span class="post-navigation__title">{{ effective_next_post.title }}</span>
         </a>
         {% endif %}
     </div>

data/_sass/components/_core.scss

@@ -197,7 +197,7 @@
 }
 
 .hero-section {
-  padding: 4rem 0;
+  padding: 2.25rem 0 2.5rem;
   background:
     radial-gradient(circle at 8% 10%, color-mix(in srgb, var(--color-brand) 10%, transparent), transparent 42%),
     var(--color-surface);
@@ -307,6 +307,10 @@
   padding: 1.25rem;
 }
 
+.latest-posts__inner {
+  padding: 0.75rem 0;
+}
+
 .latest-posts__title,
 .contributions__title,
 .testimonials__title {
@@ -340,11 +344,20 @@
   margin-inline: auto;
 }
 
+.latest-posts__container {
+  width: 100%;
+  margin-inline: 0;
+}
+
 .latest-posts__cta {
   margin-top: 4rem;
   text-align: center;
 }
 
+.latest-posts__list {
+  width: min(100% - 2rem, 880px);
+}
+
 .post-listing,
 .content-shell,
 .post-header,
@@ -460,9 +473,9 @@
 .post-card__title {
   margin-bottom: 0.85rem;
   font-family: "Manrope", "Helvetica Neue", Helvetica, Arial, sans-serif;
-  font-size: clamp(1.28rem, 2.3vw, 1.75rem);
+  font-size: 1.875rem;
   font-weight: 800;
-  line-height: 1.25;
+  line-height: 1.2;
   letter-spacing: -0.01em;
   text-wrap: balance;
   overflow-wrap: break-word;
@@ -590,7 +603,7 @@
 
 .post-page .post-header {
   margin-top: 0.4rem;
-  padding: 1.6rem 1.75rem 1.35rem;
+  padding: 1.2rem 1rem 0.95rem;
   border: 1px solid color-mix(in srgb, var(--color-border) 86%, #c9d6ff 14%);
   border-bottom: 0;
   border-radius: 1rem 1rem 0 0;
@@ -782,8 +795,8 @@
 
 .post-page .post-title {
   margin-bottom: 0.95rem;
-  font-size: clamp(1.85rem, 4.6vw, 3rem);
-  line-height: 1.16;
+  font-size: 1.875rem;
+  line-height: 1.2;
   letter-spacing: -0.014em;
 }
 
@@ -803,7 +816,7 @@
 
 .post-page .content-shell {
   margin-top: 0;
-  padding: 2rem 2rem 1.8rem;
+  padding: 1.25rem 1rem 1.1rem;
   border: 1px solid color-mix(in srgb, var(--color-border) 84%, #c9d6ff 16%);
   border-top: 0;
   border-radius: 0 0 1rem 1rem;
@@ -821,20 +834,20 @@
 .post-page .post-navigation-shell__inner,
 .post-page .related-posts-shell__inner {
   margin-inline: auto;
-  padding: 1.1rem;
+  padding: 0.9rem;
   border: 1px solid color-mix(in srgb, var(--color-border) 84%, #c9d6ff 16%);
   border-radius: 1rem;
   background: #fff;
 }
 
 .post-page .comments-shell__inner {
-  padding: 2rem 2rem 1.8rem;
+  padding: 1.25rem 1rem 1.1rem;
 }
 
 .comments-shell__heading {
   display: block;
   margin-bottom: 0.3rem;
-  font-size: 1.3rem;
+  font-size: 1.16rem;
   font-weight: 800;
 }
 
@@ -870,8 +883,8 @@
   display: inline-flex;
   align-items: center;
   justify-content: center;
-  width: 2rem;
-  height: 2rem;
+  width: 1.85rem;
+  height: 1.85rem;
   border: 1px solid color-mix(in srgb, var(--color-border) 84%, #c9d6ff 16%);
   border-radius: 999px;
   color: var(--color-muted);
@@ -905,7 +918,7 @@
 }
 
 .post-page .post-navigation {
-  grid-template-columns: repeat(2, minmax(0, 1fr));
+  grid-template-columns: 1fr;
   gap: 0.9rem;
 }
 
@@ -929,7 +942,7 @@
 
 .page-article__header {
   margin-top: 0.4rem;
-  padding: 1.75rem 1.75rem 1.25rem;
+  padding: 1.35rem 1.25rem 1rem;
   border: 1px solid color-mix(in srgb, var(--color-border) 86%, #c9d6ff 14%);
   border-bottom: 0;
   border-radius: 1rem 1rem 0 0;
@@ -939,16 +952,14 @@
 }
 
 .page-article__header-layout {
-  display: flex;
-  justify-content: space-between;
-  gap: 2rem;
+  display: block;
 }
 
 .page-article__title {
   margin: 0 0 1rem;
-  font-size: clamp(1.9rem, 4.9vw, 3.2rem);
+  font-size: clamp(1.35rem, 8.2vw, 1.7rem);
   font-weight: 800;
-  line-height: 1.16;
+  line-height: 1.2;
   letter-spacing: -0.014em;
   text-wrap: balance;
   overflow-wrap: break-word;
@@ -965,7 +976,7 @@
 
 .page-article .content-shell {
   margin-top: 0;
-  padding: 2rem 2rem 1.8rem;
+  padding: 1.35rem 1.25rem 1.2rem;
   border: 1px solid color-mix(in srgb, var(--color-border) 84%, #c9d6ff 16%);
   border-top: 0;
   border-radius: 0 0 1rem 1rem;
@@ -991,7 +1002,7 @@
 .archive-hub .page-header--archive-hub {
   margin-top: 0.4rem;
   margin-bottom: 0;
-  padding: 2rem 1.75rem 1.15rem;
+  padding: 1.05rem 1rem 0.8rem;
   border: 1px solid color-mix(in srgb, var(--color-border) 86%, #c9d6ff 14%);
   border-bottom: 0;
   border-radius: 1rem 1rem 0 0;
@@ -1003,7 +1014,7 @@
 .blog-hub .blog-hub__listing,
 .archive-hub .archive-hub__listing {
   margin-top: 0;
-  padding: 0.65rem 1.35rem 1.1rem;
+  padding: 0.3rem 0.65rem 0.7rem;
   border: 1px solid color-mix(in srgb, var(--color-border) 84%, #c9d6ff 16%);
   border-top: 0;
   background: #fff;
@@ -1020,7 +1031,7 @@
 
 .blog-hub .pagination-shell {
   margin-top: 0;
-  padding: 0 1.35rem 1.2rem;
+  padding: 0 0.65rem 0.75rem;
   border: 1px solid color-mix(in srgb, var(--color-border) 84%, #c9d6ff 16%);
   border-top: 0;
   border-radius: 0 0 1rem 1rem;
@@ -1037,6 +1048,13 @@
   margin-bottom: 0.5rem;
 }
 
+.blog-hub .page-header__description,
+.archive-hub .page-header__description {
+  max-width: none;
+  margin-top: 0.6rem;
+  font-size: 1.05rem;
+}
+
 .page-header-wrap {
   padding: 0;
   background: #fff;
@@ -1047,6 +1065,12 @@
   background: transparent;
 }
 
+.page-header-wrap--blog .page-header-wrap__container,
+.page-header-wrap--archive .page-header-wrap__container {
+  width: 100%;
+  margin-inline: 0;
+}
+
 .page-header {
   margin-inline: auto;
   margin-bottom: 2rem;
@@ -1063,9 +1087,7 @@
 }
 
 .page-header__layout {
-  display: flex;
-  justify-content: space-between;
-  gap: 2rem;
+  display: block;
   padding-inline: 1.25rem;
 }
 
@@ -1075,9 +1097,9 @@
 
 .page-header__title {
   margin-bottom: 2rem;
-  font-size: clamp(2.05rem, 7vw, 4.2rem);
+  font-size: clamp(1.65rem, 10vw, 2.25rem);
   font-weight: 700;
-  line-height: 1.05;
+  line-height: 1.1;
   letter-spacing: -0.02em;
   text-wrap: balance;
   overflow-wrap: break-word;
@@ -1417,8 +1439,8 @@
 .content {
   color: color-mix(in srgb, var(--color-text) 90%, #1e293b 10%);
   font-family: "Source Serif 4", Georgia, Cambria, "Times New Roman", Times, serif;
-  font-size: 1.23rem;
-  line-height: 1.9;
+  font-size: 1.12rem;
+  line-height: 1.8;
 
   p {
     margin-bottom: 1.5rem;
@@ -1689,7 +1711,33 @@
   }
 }
 
+@media (min-width: 421px) {
+  .page-header__title {
+    font-size: clamp(1.85rem, 9vw, 2.8rem);
+    line-height: 1.08;
+  }
+
+  .post-card__title {
+    font-size: 3rem;
+  }
+
+  .post-page .post-title {
+    font-size: 3rem;
+  }
+
+  .page-article__title {
+    font-size: clamp(1.55rem, 7.2vw, 2.25rem);
+  }
+}
+
 @media (min-width: 1024px) {
+  .page-header-wrap--blog .page-header-wrap__container,
+  .page-header-wrap--archive .page-header-wrap__container,
+  .latest-posts__container {
+    width: min(100% - 2rem, 1280px);
+    margin-inline: auto;
+  }
+
   .site-header__inner {
     padding: 1.5rem 0;
   }
@@ -1707,11 +1755,21 @@
     display: none;
   }
 
+  .hero-section {
+    padding: 4rem 0;
+  }
+
   .hero-description {
     font-size: 1.5rem;
     line-height: 2.5rem;
   }
 
+  .latest-posts__inner,
+  .contributions__inner,
+  .testimonials__inner {
+    padding: 1.25rem;
+  }
+
   .post-card {
     flex-direction: row;
   }
@@ -1724,163 +1782,108 @@
     margin-bottom: 0;
   }
 
-  .page-header__layout {
-    padding-inline: 0;
-  }
-
-  .contributions__grid,
-  .testimonials__grid {
-    grid-template-columns: repeat(3, minmax(0, 1fr));
-  }
-}
-
-@media (max-width: 1023px) {
-  .page-header-wrap--blog .page-header-wrap__container,
-  .page-header-wrap--archive .page-header-wrap__container,
-  .latest-posts__container {
-    width: 100%;
-    margin-inline: 0;
-  }
-
-  .hero-section {
-    padding-top: 2.25rem;
-    padding-bottom: 2.5rem;
-  }
-
-  .page-header__title {
-    font-size: clamp(1.85rem, 9vw, 2.8rem);
-    line-height: 1.08;
-  }
-
   .post-card__title {
-    font-size: clamp(1.16rem, 5.8vw, 1.45rem);
-    line-height: 1.28;
-  }
-
-  .post-page .post-title {
-    font-size: clamp(1.5rem, 7.4vw, 2.1rem);
-    line-height: 1.2;
-  }
-
-  .page-article__title {
-    font-size: clamp(1.55rem, 7.2vw, 2.25rem);
-    line-height: 1.2;
-  }
-
-  .content {
-    font-size: 1.12rem;
-    line-height: 1.8;
-  }
-
-  .page-header__layout {
-    display: block;
-  }
-
-  .latest-posts__inner {
-    padding: 0.75rem 0;
-  }
-
-  .latest-posts__list {
-    width: min(100% - 2rem, 880px);
+    font-size: 3rem;
+    line-height: 1.25;
   }
 
   .post-page .post-header {
-    padding: 1.2rem 1rem 0.95rem;
+    padding: 1.6rem 1.75rem 1.35rem;
   }
 
-  .post-series__header,
-  .post-series__link,
-  .post-series__overflow-toggle {
-    padding-left: 0.95rem;
-    padding-right: 0.95rem;
+  .post-page .post-title {
+    font-size: 3rem;
+    line-height: 1.16;
   }
 
   .post-page .content-shell {
-    padding: 1.25rem 1rem 1.1rem;
+    padding: 2rem 2rem 1.8rem;
   }
 
-  .post-page .post-header,
-  .post-page .content-shell,
   .post-page .comments-shell__inner,
   .post-page .post-navigation-shell__inner,
   .post-page .related-posts-shell__inner {
-    width: min(100% - 2rem, 880px);
-  }
-
-  .post-page .comments-shell__inner,
-  .post-page .post-navigation-shell__inner,
-  .post-page .related-posts-shell__inner {
-    padding: 0.9rem;
+    padding: 1.1rem;
   }
 
   .post-page .comments-shell__inner {
-    padding: 1.25rem 1rem 1.1rem;
+    padding: 2rem 2rem 1.8rem;
   }
 
   .comments-shell__heading {
-    font-size: 1.16rem;
+    font-size: 1.3rem;
   }
 
   .comments-collapsible__icon-wrap,
   .series-collapsible__icon-wrap {
-    width: 1.85rem;
-    height: 1.85rem;
+    width: 2rem;
+    height: 2rem;
   }
 
   .post-page .post-navigation {
-    grid-template-columns: 1fr;
+    grid-template-columns: repeat(2, minmax(0, 1fr));
   }
 
   .page-article__header {
-    padding: 1.35rem 1.25rem 1rem;
+    padding: 1.75rem 1.75rem 1.25rem;
   }
 
   .page-article__header-layout {
-    display: block;
+    display: flex;
+    justify-content: space-between;
+    gap: 2rem;
+  }
+
+  .page-article__title {
+    font-size: clamp(1.9rem, 4.9vw, 3.2rem);
+    line-height: 1.16;
   }
 
   .page-article .content-shell {
-    padding: 1.35rem 1.25rem 1.2rem;
+    padding: 2rem 2rem 1.8rem;
   }
 
   .blog-hub .page-header--blog,
   .archive-hub .page-header--archive-hub {
-    width: min(100% - 2rem, 880px);
-    padding: 1.05rem 1rem 0.8rem;
+    padding: 2rem 1.75rem 1.15rem;
   }
 
   .blog-hub .blog-hub__listing,
   .archive-hub .archive-hub__listing {
-    width: min(100% - 2rem, 880px);
-    padding: 0.3rem 0.65rem 0.7rem;
+    padding: 0.65rem 1.35rem 1.1rem;
   }
 
   .blog-hub .pagination-shell {
-    width: min(100% - 2rem, 880px);
-    padding: 0 0.65rem 0.75rem;
+    padding: 0 1.35rem 1.2rem;
   }
 
   .blog-hub .page-header__description,
   .archive-hub .page-header__description {
-    max-width: none;
-    margin-top: 0.6rem;
-    font-size: 1.05rem;
+    max-width: 640px;
+    margin-top: 0;
+    font-size: 1.25rem;
   }
-}
 
-@media (max-width: 420px) {
-  .post-card__title {
-    font-size: clamp(1.08rem, 7vw, 1.28rem);
+  .page-header__layout {
+    display: flex;
+    justify-content: space-between;
+    gap: 2rem;
+    padding-inline: 0;
   }
 
-  .post-page .post-title,
-  .page-article__title {
-    font-size: clamp(1.35rem, 8.2vw, 1.7rem);
+  .page-header__title {
+    font-size: clamp(2.05rem, 7vw, 4.2rem);
+    line-height: 1.05;
   }
 
-  .page-header__title {
-    font-size: clamp(1.65rem, 10vw, 2.25rem);
-    line-height: 1.1;
+  .contributions__grid,
+  .testimonials__grid {
+    grid-template-columns: repeat(3, minmax(0, 1fr));
+  }
+
+  .content {
+    font-size: 1.23rem;
+    line-height: 1.9;
   }
 }
 

data/exe/imdhemy-image

@@ -0,0 +1,6 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require_relative "../lib/imdhemy/jekyll/theme/image_cli"
+
+exit(Imdhemy::Jekyll::Theme::ImageCLI.run(ARGV))

data/lib/imdhemy/jekyll/theme/image_cli.rb

@@ -0,0 +1,280 @@
+# frozen_string_literal: true
+
+require "fileutils"
+require "optparse"
+require "pathname"
+require "shellwords"
+require "tmpdir"
+
+module Imdhemy
+  module Jekyll
+    module Theme
+      class ImageCLI
+        SUPPORTED_EXTENSIONS = %w[.jpg .jpeg .png].freeze
+
+        Result = Struct.new(:path, :status, :original_size, :optimized_size, :message, keyword_init: true)
+
+        def self.run(argv)
+          new(argv).run
+        end
+
+        def initialize(argv)
+          @argv = argv.dup
+          @options = {
+            recursive: false,
+            dry_run: false
+          }
+        end
+
+        def run
+          parser.parse!(@argv)
+
+          if @argv.empty?
+            warn parser.to_s
+            return 1
+          end
+
+          paths = expand_inputs(@argv)
+          if paths.empty?
+            warn "No supported image files found."
+            return 1
+          end
+
+          results = paths.map { |path| optimize_path(path) }
+          print_results(results)
+
+          results.any? { |result| result.status == :error } ? 1 : 0
+        rescue OptionParser::InvalidOption, OptionParser::MissingArgument => e
+          warn e.message
+          warn parser.to_s
+          1
+        end
+
+        private
+
+        def parser
+          @parser ||= OptionParser.new do |opts|
+            opts.banner = "Usage: imdhemy-image [options] PATH [PATH ...]"
+
+            opts.on("-r", "--recursive", "Scan directories recursively") do
+              @options[:recursive] = true
+            end
+
+            opts.on("-n", "--dry-run", "Print what would change without writing files") do
+              @options[:dry_run] = true
+            end
+
+            opts.on("-h", "--help", "Show this help") do
+              puts opts
+              exit 0
+            end
+          end
+        end
+
+        def expand_inputs(inputs)
+          files = inputs.flat_map do |input|
+            path = Pathname(input).expand_path
+            if path.file?
+              supported_file?(path) ? [path] : []
+            elsif path.directory?
+              collect_directory(path)
+            else
+              warn "Skipping missing path: #{path}"
+              []
+            end
+          end
+
+          files.uniq
+        end
+
+        def collect_directory(directory)
+          pattern = @options[:recursive] ? "**/*" : "*"
+          directory.glob(pattern).select { |path| path.file? && supported_file?(path) }
+        end
+
+        def supported_file?(path)
+          SUPPORTED_EXTENSIONS.include?(path.extname.downcase)
+        end
+
+        def optimize_path(path)
+          optimizer = optimizer_for(path)
+          return Result.new(path: path, status: :skipped, message: "No optimizer available for #{path.extname.downcase}") unless optimizer
+
+          original_size = path.size
+          if @options[:dry_run]
+            return Result.new(
+              path: path,
+              status: :dry_run,
+              original_size: original_size,
+              optimized_size: original_size,
+              message: "Would run #{optimizer.label}"
+            )
+          end
+
+          optimized = optimizer.optimize(path)
+          return Result.new(path: path, status: :skipped, original_size: original_size, optimized_size: original_size, message: optimized[:message]) unless optimized[:changed]
+
+          Result.new(
+            path: path,
+            status: :optimized,
+            original_size: original_size,
+            optimized_size: path.size,
+            message: optimized[:message]
+          )
+        rescue StandardError => e
+          Result.new(path: path, status: :error, original_size: path.exist? ? path.size : nil, message: e.message)
+        end
+
+        def optimizer_for(path)
+          case path.extname.downcase
+          when ".jpg", ".jpeg"
+            jpeg_optimizer
+          when ".png"
+            png_optimizer
+          end
+        end
+
+        def jpeg_optimizer
+          @jpeg_optimizer ||= begin
+            if command_available?("jpegoptim")
+              ExternalOptimizer.new(
+                label: "jpegoptim",
+                command_builder: lambda { |path, temp_path|
+                  ["jpegoptim", "--strip-all", "--all-progressive", "--dest=#{temp_path.dirname}", path.to_s]
+                },
+                temp_output_builder: lambda { |path, temp_dir|
+                  temp_dir.join(path.basename.to_s)
+                }
+              )
+            elsif command_available?("sips")
+              SipsJpegOptimizer.new
+            end
+          end
+        end
+
+        def png_optimizer
+          @png_optimizer ||= begin
+            if command_available?("oxipng")
+              ExternalOptimizer.new(
+                label: "oxipng",
+                command_builder: lambda { |path, temp_path|
+                  ["oxipng", "--strip", "safe", "--opt", "2", "--out", temp_path.to_s, path.to_s]
+                },
+                temp_output_builder: ->(_path, temp_dir) { temp_dir.join("optimized.png") }
+              )
+            elsif command_available?("pngcrush")
+              ExternalOptimizer.new(
+                label: "pngcrush",
+                command_builder: lambda { |path, temp_path|
+                  ["pngcrush", "-q", "-reduce", "-brute", path.to_s, temp_path.to_s]
+                },
+                temp_output_builder: ->(_path, temp_dir) { temp_dir.join("optimized.png") }
+              )
+            end
+          end
+        end
+
+        def command_available?(command)
+          ENV.fetch("PATH", "").split(File::PATH_SEPARATOR).any? do |entry|
+            executable = File.join(entry, command)
+            File.file?(executable) && File.executable?(executable)
+          end
+        end
+
+        def print_results(results)
+          results.each do |result|
+            case result.status
+            when :optimized
+              saved = result.original_size - result.optimized_size
+              percent = percentage(saved, result.original_size)
+              puts "optimized #{result.path}: #{human_size(result.original_size)} -> #{human_size(result.optimized_size)} (saved #{percent}%) via #{result.message}"
+            when :dry_run
+              puts "dry-run #{result.path}: #{result.message}"
+            when :skipped
+              puts "skipped #{result.path}: #{result.message}"
+            when :error
+              puts "error #{result.path}: #{result.message}"
+            end
+          end
+        end
+
+        def percentage(saved, original)
+          return 0 if original.to_i <= 0
+
+          ((saved.to_f / original) * 100).round(1)
+        end
+
+        def human_size(bytes)
+          units = %w[B KB MB GB].freeze
+          value = bytes.to_f
+          unit = units.shift
+          while value >= 1024 && !units.empty?
+            value /= 1024
+            unit = units.shift
+          end
+
+          format(value >= 10 || unit == "B" ? "%.0f %s" : "%.1f %s", value, unit)
+        end
+      end
+
+      class ExternalOptimizer
+        def initialize(label:, command_builder:, temp_output_builder:)
+          @label = label
+          @command_builder = command_builder
+          @temp_output_builder = temp_output_builder
+        end
+
+        attr_reader :label
+
+        def optimize(path)
+          Dir.mktmpdir("imdhemy-image") do |tmpdir|
+            temp_dir = Pathname(tmpdir)
+            temp_output = @temp_output_builder.call(path, temp_dir)
+            command = @command_builder.call(path, temp_output)
+
+            success = system(*command, out: File::NULL, err: File::NULL)
+            raise "Optimizer failed: #{Shellwords.join(command)}" unless success
+
+            if !temp_output.exist? || temp_output.size >= path.size
+              return { changed: false, message: "#{label} ran but produced no smaller output" }
+            end
+
+            FileUtils.cp(temp_output, path)
+            { changed: true, message: label }
+          end
+        end
+      end
+
+      class SipsJpegOptimizer
+        attr_reader :label
+
+        def initialize
+          @label = "sips"
+        end
+
+        def optimize(path)
+          Dir.mktmpdir("imdhemy-image") do |tmpdir|
+            temp_output = Pathname(tmpdir).join(path.basename.to_s)
+            success = system(
+              "sips",
+              "-s", "format", "jpeg",
+              "-s", "formatOptions", "best",
+              path.to_s,
+              "--out", temp_output.to_s,
+              out: File::NULL,
+              err: File::NULL
+            )
+            raise "Optimizer failed: sips" unless success
+
+            if !temp_output.exist? || temp_output.size >= path.size
+              return { changed: false, message: "#{label} ran but produced no smaller output" }
+            end
+
+            FileUtils.cp(temp_output, path)
+            { changed: true, message: label }
+          end
+        end
+      end
+    end
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: imdhemy-jekyll-theme
 version: !ruby/object:Gem::Version
-  version: 1.2.2
+  version: 1.3.0
 platform: ruby
 authors:
 - Mohamad Eldhemy
 autorequire:
-bindir: bin
+bindir: exe
 cert_chain: []
-date: 2026-03-10 00:00:00.000000000 Z
+date: 2026-03-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: jekyll
@@ -69,7 +69,8 @@ dependencies:
 description:
 email:
 - imdhemy@gmail.com
-executables: []
+executables:
+- imdhemy-image
 extensions: []
 extra_rdoc_files: []
 files:
@@ -116,6 +117,8 @@ files:
 - assets/css/main.scss
 - assets/images/social.png
 - assets/js/dist/main.js
+- exe/imdhemy-image
+- lib/imdhemy/jekyll/theme/image_cli.rb
 homepage: https://imdhemy.com
 licenses:
 - MIT