@sebastienrousseau/dotfiles 0.2.481 → 0.2.500

package/scripts/theme/install-catppuccin-themes.sh

@@ -1,38 +1,62 @@
-#!/bin/bash
-# Catppuccin GNOME Theme Installation Script
-# Installs Catppuccin GTK themes, icon themes, and shell themes
-
-set -e
+#!/usr/bin/env bash
+# Copyright (c) 2015-2026 Dotfiles. All rights reserved.
+## Catppuccin Theme Installer — Install Catppuccin themes for GNOME.
+##
+## Downloads and installs GTK themes, icon themes, cursor themes,
+## GNOME Shell themes, and wallpapers from Catppuccin repositories.
+##
+## # Requirements
+## - git: For cloning theme repositories
+## - curl: For downloading assets
+## - gnome-tweaks (optional): For applying themes
+## - gnome-extensions (optional): For shell themes
+##
+## # Usage
+## install-catppuccin-themes.sh           # Install all components
+## install-catppuccin-themes.sh gtk       # GTK themes only
+## install-catppuccin-themes.sh icons     # Icon themes only
+## install-catppuccin-themes.sh cursors   # Cursor themes only
+## install-catppuccin-themes.sh shell     # GNOME Shell themes only
+## install-catppuccin-themes.sh wallpapers # Wallpapers only
+## install-catppuccin-themes.sh refresh   # Refresh theme cache
+##
+## # Platform Notes
+## - Linux/GNOME: Full support
+## - Other DEs: GTK themes may work, shell themes require GNOME
+
+set -euo pipefail
 
 THEME_DIR="$HOME/.themes"
 ICON_DIR="$HOME/.icons"
-TEMP_DIR="/tmp/catppuccin-install"
-
-# Colors for output
-RED='\033[0;31m'
-GREEN='\033[0;32m'
-YELLOW='\033[1;33m'
-BLUE='\033[0;34m'
-NC='\033[0m' # No Color
+TEMP_DIR="$(umask 077 && mktemp -d)"
+
+# Colors for output (respect NO_COLOR: https://no-color.org)
+if [[ -z "${NO_COLOR:-}" ]] && [[ -t 1 ]]; then
+  RED='\033[0;31m' GREEN='\033[0;32m' YELLOW='\033[1;33m'
+  BLUE='\033[0;34m' NC='\033[0m'
+else
+  RED='' GREEN='' YELLOW='' BLUE='' NC=''
+fi
 
 log() {
-  echo -e "${BLUE}[INFO]${NC} $1"
+  printf '%b\n' "${BLUE}[INFO]${NC} $1"
 }
 
 warn() {
-  echo -e "${YELLOW}[WARN]${NC} $1"
+  printf '%b\n' "${YELLOW}[WARN]${NC} $1"
 }
 
 error() {
-  echo -e "${RED}[ERROR]${NC} $1"
+  printf '%b\n' "${RED}[ERROR]${NC} $1"
 }
 
 success() {
-  echo -e "${GREEN}[SUCCESS]${NC} $1"
+  printf '%b\n' "${GREEN}[SUCCESS]${NC} $1"
 }
 
 # Create directories
-mkdir -p "$THEME_DIR" "$ICON_DIR" "$TEMP_DIR"
+mkdir -p "$THEME_DIR" "$ICON_DIR"
+trap 'rm -rf "$TEMP_DIR"' EXIT
 
 # Check if git is available
 if ! command -v git &>/dev/null; then
@@ -44,15 +68,15 @@ fi
 install_gtk_themes() {
   log "Installing Catppuccin GTK themes..."
 
-  cd "$TEMP_DIR"
+  cd "$TEMP_DIR" || return 1
 
   if [ ! -d "catppuccin-gtk" ]; then
     git clone https://github.com/catppuccin/gtk.git catppuccin-gtk
   else
-    cd catppuccin-gtk && git pull && cd ..
+    git -C catppuccin-gtk pull
   fi
 
-  cd catppuccin-gtk
+  cd catppuccin-gtk || return 1
 
   # Install all variants
   for variant in Latte Frappe Macchiato Mocha; do
@@ -79,15 +103,15 @@ install_gtk_themes() {
 install_papirus_icons() {
   log "Installing Papirus icon themes..."
 
-  cd "$TEMP_DIR"
+  cd "$TEMP_DIR" || return 1
 
   if [ ! -d "papirus-icon-theme" ]; then
     git clone https://github.com/PapirusDevelopmentTeam/papirus-icon-theme.git
   else
-    cd papirus-icon-theme && git pull && cd ..
+    git -C papirus-icon-theme pull
   fi
 
-  cd papirus-icon-theme
+  cd papirus-icon-theme || return 1
 
   # Install Papirus variants
   for variant in Papirus Papirus-Dark Papirus-Light; do
@@ -103,15 +127,15 @@ install_papirus_icons() {
 install_catppuccin_cursors() {
   log "Installing Catppuccin cursor themes..."
 
-  cd "$TEMP_DIR"
+  cd "$TEMP_DIR" || return 1
 
   if [ ! -d "catppuccin-cursors" ]; then
     git clone https://github.com/catppuccin/cursors.git catppuccin-cursors
   else
-    cd catppuccin-cursors && git pull && cd ..
+    git -C catppuccin-cursors pull
   fi
 
-  cd catppuccin-cursors
+  cd catppuccin-cursors || return 1
 
   # Install cursor themes for each variant
   for variant in Catppuccin-Latte-* Catppuccin-Frappe-* Catppuccin-Macchiato-* Catppuccin-Mocha-*; do
@@ -135,15 +159,15 @@ install_shell_themes() {
     fi
   fi
 
-  cd "$TEMP_DIR"
+  cd "$TEMP_DIR" || return 1
 
   if [ ! -d "catppuccin-gnome-shell" ]; then
     git clone https://github.com/catppuccin/gnome.git catppuccin-gnome-shell
   else
-    cd catppuccin-gnome-shell && git pull && cd ..
+    git -C catppuccin-gnome-shell pull
   fi
 
-  cd catppuccin-gnome-shell
+  cd catppuccin-gnome-shell || return 1
 
   # Install shell themes (use explicit names for portability)
   for variant in Latte Frappe Macchiato Mocha; do
@@ -175,15 +199,15 @@ install_wallpapers() {
     mkdir -p "$wallpaper_dir"
   fi
 
-  cd "$TEMP_DIR"
+  cd "$TEMP_DIR" || return 1
 
   if [ ! -d "catppuccin-wallpapers" ]; then
     git clone https://github.com/catppuccin/wallpapers.git catppuccin-wallpapers
   else
-    cd catppuccin-wallpapers && git pull && cd ..
+    git -C catppuccin-wallpapers pull
   fi
 
-  cd catppuccin-wallpapers
+  cd catppuccin-wallpapers || return 1
 
   # Copy wallpapers
   for variant in latte frappe macchiato mocha; do

package/scripts/theme/install-cursors.sh

@@ -1,4 +1,5 @@
 #!/usr/bin/env bash
+# Copyright (c) 2015-2026 Dotfiles. All rights reserved.
 set -euo pipefail
 
 THEME="${DOTFILES_CURSOR_THEME:-Bibata-Modern-Ice}"

package/scripts/theme/install-file-icons.sh

@@ -1,4 +1,5 @@
 #!/usr/bin/env bash
+# Copyright (c) 2015-2026 Dotfiles. All rights reserved.
 set -euo pipefail
 
 THEME="${DOTFILES_ICON_THEME:-Papirus}"

package/scripts/theme/install-grub-theme.sh

@@ -1,6 +1,16 @@
 #!/usr/bin/env bash
+# Copyright (c) 2015-2026 Dotfiles. All rights reserved.
 set -euo pipefail
 
+# Cross-platform sed in-place (BSD vs GNU)
+sed_in_place() {
+  if sed --version >/dev/null 2>&1; then
+    sed -i "$@" # GNU
+  else
+    sed -i '' "$@" # BSD (macOS)
+  fi
+}
+
 THEME_SRC="${DOTFILES_GRUB_THEME_DIR:-$HOME/.config/dotfiles/grub/theme}"
 THEME_NAME="${DOTFILES_GRUB_THEME_NAME:-dotfiles}"
 APPLY=0
@@ -37,7 +47,7 @@ mkdir -p "$THEME_DST"
 cp -R "$THEME_SRC/." "$THEME_DST"
 
 if grep -q '^GRUB_THEME=' /etc/default/grub; then
-  sed -i.bak "s|^GRUB_THEME=.*|GRUB_THEME=\"$THEME_DST/theme.txt\"|" /etc/default/grub
+  sed_in_place "s|^GRUB_THEME=.*|GRUB_THEME=\"$THEME_DST/theme.txt\"|" /etc/default/grub
 else
   echo "GRUB_THEME=\"$THEME_DST/theme.txt\"" >>/etc/default/grub
 fi

package/scripts/theme/install-lock-icon.sh

@@ -1,4 +1,5 @@
 #!/usr/bin/env bash
+# Copyright (c) 2015-2026 Dotfiles. All rights reserved.
 set -euo pipefail
 
 icon_path="${DOTFILES_LOCK_ICON:-$HOME/.config/dotfiles/lock/icon.png}"

package/scripts/theme/merge-wallpaper.sh

@@ -0,0 +1,141 @@
+#!/usr/bin/env bash
+# Copyright (c) 2015-2026 Dotfiles. All rights reserved.
+# merge-wallpaper.sh — Merge dark+light wallpapers into a single dynamic HEIC.
+#
+# Creates an Apple-compatible dynamic HEIC with appearance metadata so macOS
+# automatically shows the correct variant based on Light/Dark mode.
+#
+# Usage:
+#   bash merge-wallpaper.sh                  # Merge all pairs in ~/Pictures/Wallpapers/
+#   bash merge-wallpaper.sh <family>         # Merge a specific family (e.g. macos-tahoe)
+#   bash merge-wallpaper.sh --dry-run        # Show what would be merged
+set -euo pipefail
+
+WALLPAPER_DIR="${DOTFILES_WALLPAPER_DIR:-$HOME/Pictures/Wallpapers}"
+DRY_RUN=false
+TARGET=""
+
+for arg in "$@"; do
+  case "$arg" in
+    --dry-run) DRY_RUN=true ;;
+    --help | -h)
+      echo "Usage: merge-wallpaper.sh [--dry-run] [family-name]"
+      echo ""
+      echo "Merges *-dark.heic + *-light.heic into a single dynamic HEIC"
+      echo "that switches appearance automatically on macOS."
+      exit 0
+      ;;
+    *) TARGET="$arg" ;;
+  esac
+done
+
+if ! command -v heif-enc &>/dev/null; then
+  echo "Error: heif-enc required (brew install libheif)" >&2
+  exit 1
+fi
+
+if ! command -v magick &>/dev/null; then
+  echo "Error: ImageMagick (magick) required" >&2
+  exit 1
+fi
+
+# Generate the Apple desktop appearance XMP metadata.
+# Format: bplist with {l: 0, d: 1} meaning image 0 = light, image 1 = dark.
+generate_xmp() {
+  local apr_b64="YnBsaXN0MDDSAQIDBFFsUWQQABABCA0PERMAAAAAAAABAQAAAAAAAAAFAAAAAAAAAAAAAAAAAAAAFQ=="
+  cat <<XMPEOF
+<?xpacket begin="" id="W5M0MpCehiHzreSzNTczkc9d"?>
+<x:xmpmeta xmlns:x="adobe:ns:meta/" x:xmptk="dotfiles">
+  <rdf:RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#">
+    <rdf:Description rdf:about=""
+      xmlns:apple_desktop="http://ns.apple.com/namespace/1.0/"
+      apple_desktop:apr="${apr_b64}"/>
+  </rdf:RDF>
+</x:xmpmeta>
+<?xpacket end="w"?>
+XMPEOF
+}
+
+merge_pair() {
+  local family="$1"
+  local dark_file=""
+  local light_file=""
+
+  # Find dark and light files
+  for ext in heic jpg png; do
+    [[ -z "$dark_file" && -f "$WALLPAPER_DIR/${family}-dark.${ext}" ]] && dark_file="$WALLPAPER_DIR/${family}-dark.${ext}"
+    [[ -z "$light_file" && -f "$WALLPAPER_DIR/${family}-light.${ext}" ]] && light_file="$WALLPAPER_DIR/${family}-light.${ext}"
+  done
+
+  if [[ -z "$dark_file" || -z "$light_file" ]]; then
+    echo "  ✗  $family — missing dark or light variant"
+    return 1
+  fi
+
+  local output="$WALLPAPER_DIR/${family}.heic"
+
+  if [[ "$DRY_RUN" == "true" ]]; then
+    echo "  ○  $family — would merge $(basename "$light_file") + $(basename "$dark_file") → $(basename "$output")"
+    return 0
+  fi
+
+  local tmpdir
+  tmpdir="$(mktemp -d)"
+  trap "rm -rf '$tmpdir'" RETURN
+
+  # Convert both to JPEG for heif-enc input (it handles JPEG best)
+  magick "$light_file" -quality 95 "$tmpdir/light.jpg" 2>/dev/null
+  magick "$dark_file" -quality 95 "$tmpdir/dark.jpg" 2>/dev/null
+
+  # Generate XMP metadata file
+  generate_xmp >"$tmpdir/xmp.xml"
+
+  # Encode as multi-image HEIC: image 0 = light (primary), image 1 = dark
+  if heif-enc \
+    -q 90 \
+    "$tmpdir/light.jpg" \
+    "$tmpdir/dark.jpg" \
+    -o "$tmpdir/merged.heic" 2>/dev/null; then
+
+    # Inject Apple desktop appearance XMP
+    if command -v exiftool &>/dev/null; then
+      exiftool -overwrite_original -XMP="<=$tmpdir/xmp.xml" "$tmpdir/merged.heic" 2>/dev/null || true
+    fi
+
+    # Replace the pair with the merged file
+    mv "$tmpdir/merged.heic" "$output"
+    rm -f "$dark_file" "$light_file"
+    echo "  ✓  $family — merged → $(basename "$output")"
+    return 0
+  else
+    echo "  ✗  $family — heif-enc failed"
+    return 1
+  fi
+}
+
+echo "Dynamic wallpaper merger"
+echo ""
+
+if [[ -n "$TARGET" ]]; then
+  merge_pair "$TARGET"
+else
+  # Find all families with dark+light pairs
+  merged=0
+  failed=0
+  for dark_file in "$WALLPAPER_DIR"/*-dark.heic "$WALLPAPER_DIR"/*-dark.jpg "$WALLPAPER_DIR"/*-dark.png; do
+    [[ -f "$dark_file" ]] || continue
+    base="$(basename "$dark_file")"
+    family="${base%-dark.*}"
+    if merge_pair "$family"; then
+      merged=$((merged + 1))
+    else
+      failed=$((failed + 1))
+    fi
+  done
+  echo ""
+  echo "Done: $merged merged, $failed failed"
+  if [[ "$DRY_RUN" != "true" && $merged -gt 0 ]]; then
+    echo ""
+    echo "Run 'dot theme rebuild --force' to regenerate themes for merged wallpapers."
+  fi
+fi

package/scripts/theme/rebuild-themes.sh

@@ -0,0 +1,309 @@
+#!/usr/bin/env bash
+# Copyright (c) 2015-2026 Dotfiles. All rights reserved.
+# rebuild-themes.sh — Discover wallpapers and generate themes.toml dynamically.
+#
+# Scans system wallpaper directories and ~/Pictures/Wallpapers/ for images,
+# extracts dominant colors via extract-theme.py, and assembles themes.toml.
+# Custom wallpapers override system wallpapers with the same name.
+#
+# Usage:
+#   bash rebuild-themes.sh              # Rebuild themes.toml
+#   bash rebuild-themes.sh --force      # Force regeneration (ignore cache)
+#   bash rebuild-themes.sh --list       # List discovered wallpapers without rebuilding
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+EXTRACT_SCRIPT="$SCRIPT_DIR/extract-theme.py"
+DOTFILES_DIR="${HOME}/.dotfiles"
+THEMES_FILE="$DOTFILES_DIR/.chezmoidata/themes.toml"
+CACHE_DIR="${XDG_CACHE_HOME:-$HOME/.cache}/dotfiles/themes"
+CUSTOM_DIR="${DOTFILES_WALLPAPER_DIR:-$HOME/Pictures/Wallpapers}"
+
+FORCE=false
+LIST_ONLY=false
+
+for arg in "$@"; do
+  case "$arg" in
+    --force) FORCE=true ;;
+    --list) LIST_ONLY=true ;;
+  esac
+done
+
+# ---------------------------------------------------------------------------
+# Discover wallpapers from all sources
+# ---------------------------------------------------------------------------
+
+declare -A WALLPAPERS # name -> path (custom overrides system)
+declare -A WP_SOURCE  # name -> "system" | "custom"
+
+discover_macos_system() {
+  local sys_dir="/System/Library/Desktop Pictures"
+  [[ -d "$sys_dir" ]] || return 0
+
+  # Register top-level system wallpapers (will be deduped later if thumbnails have dark/light)
+  local file name
+  for file in "$sys_dir"/*.heic; do
+    [[ -f "$file" ]] || continue
+    name="$(basename "$file" .heic)"
+    name="$(echo "$name" | tr '[:upper:]' '[:lower:]' | tr ' ' '-')"
+    name="${name//[^a-z0-9-]/}"
+    WALLPAPERS["$name"]="$file"
+    WP_SOURCE["$name"]="system"
+  done
+
+  # Also check .thumbnails for wallpapers with Dark/Light variants
+  local thumb_dir="$sys_dir/.thumbnails"
+  if [[ -d "$thumb_dir" ]]; then
+    # First pass: register all thumbnails
+    for file in "$thumb_dir"/*.heic; do
+      [[ -f "$file" ]] || continue
+      local base
+      base="$(basename "$file" .heic)"
+      name="$(echo "$base" | tr '[:upper:]' '[:lower:]' | tr ' ' '-')"
+      name="${name//[^a-z0-9-]/}"
+      if [[ -z "${WALLPAPERS[$name]+x}" ]]; then
+        WALLPAPERS["$name"]="$file"
+        WP_SOURCE["$name"]="system"
+      fi
+    done
+
+    # Second pass: remove base wallpapers that have explicit dark/light variants
+    # e.g. if "big-sur-graphic-dark" exists, remove "big-sur-graphic"
+    local check_name
+    for name in "${!WALLPAPERS[@]}"; do
+      if [[ "${name}" != *-dark && "${name}" != *-light ]]; then
+        check_name="${name}-dark"
+        if [[ -n "${WALLPAPERS[$check_name]+x}" ]]; then
+          unset "WALLPAPERS[$name]"
+          unset "WP_SOURCE[$name]"
+          continue
+        fi
+        check_name="${name}-light"
+        if [[ -n "${WALLPAPERS[$check_name]+x}" ]]; then
+          unset "WALLPAPERS[$name]"
+          unset "WP_SOURCE[$name]"
+        fi
+      fi
+    done
+  fi
+}
+
+discover_linux_system() {
+  local dirs=(
+    /usr/share/backgrounds
+    /usr/share/wallpapers
+  )
+
+  local dir file name
+  for dir in "${dirs[@]}"; do
+    [[ -d "$dir" ]] || continue
+    while IFS= read -r file; do
+      name="$(basename "$file")"
+      name="${name%.*}"
+      name="$(echo "$name" | tr '[:upper:]' '[:lower:]' | tr ' ' '-')"
+      name="${name//[^a-z0-9-]/}"
+      # Avoid duplicates — first found wins for system
+      if [[ -z "${WALLPAPERS[$name]+x}" ]]; then
+        WALLPAPERS["$name"]="$file"
+        WP_SOURCE["$name"]="system"
+      fi
+    done < <(find "$dir" -maxdepth 3 -type f \( -name "*.jpg" -o -name "*.png" -o -name "*.heic" \) 2>/dev/null | sort)
+  done
+}
+
+discover_custom() {
+  [[ -d "$CUSTOM_DIR" ]] || return 0
+
+  local file name frame_count
+  for file in "$CUSTOM_DIR"/*.heic "$CUSTOM_DIR"/*.jpg "$CUSTOM_DIR"/*.png; do
+    [[ -f "$file" ]] || continue
+    name="$(basename "$file")"
+    name="${name%.*}"
+
+    # Check if this is a dynamic HEIC (multi-frame = light+dark in one file)
+    if [[ "${file##*.}" == "heic" ]]; then
+      frame_count="$(magick identify "$file" 2>/dev/null | wc -l | tr -d ' ')"
+      if [[ "$frame_count" -ge 2 && "$name" != *-dark && "$name" != *-light ]]; then
+        # Dynamic HEIC: register as both dark and light
+        WALLPAPERS["${name}-light"]="${file}[0]"
+        WP_SOURCE["${name}-light"]="custom"
+        WALLPAPERS["${name}-dark"]="${file}[1]"
+        WP_SOURCE["${name}-dark"]="custom"
+        # Store the original file path for wallpaper-sync
+        WALLPAPERS["${name}"]="$file"
+        WP_SOURCE["${name}"]="custom-dynamic"
+        continue
+      fi
+    fi
+
+    WALLPAPERS["$name"]="$file"
+    WP_SOURCE["$name"]="custom"
+  done
+}
+
+# Remove dynamic base entries (keep only the -dark/-light variants for theme gen)
+cleanup_dynamic_entries() {
+  for name in "${!WP_SOURCE[@]}"; do
+    if [[ "${WP_SOURCE[$name]}" == "custom-dynamic" ]]; then
+      unset "WALLPAPERS[$name]"
+      unset "WP_SOURCE[$name]"
+    fi
+  done
+}
+
+# Discover in order: system first, custom overrides
+case "$(uname -s)" in
+  Darwin) discover_macos_system ;;
+  Linux) discover_linux_system ;;
+esac
+discover_custom
+cleanup_dynamic_entries
+
+# ---------------------------------------------------------------------------
+# List mode
+# ---------------------------------------------------------------------------
+
+if [[ "$LIST_ONLY" == "true" ]]; then
+  printf '%-40s %-8s %s\n' "NAME" "SOURCE" "PATH"
+  printf '%-40s %-8s %s\n' "----" "------" "----"
+  for name in $(printf '%s\n' "${!WALLPAPERS[@]}" | sort); do
+    printf '%-40s %-8s %s\n' "$name" "${WP_SOURCE[$name]}" "${WALLPAPERS[$name]}"
+  done
+  echo ""
+  echo "Total: ${#WALLPAPERS[@]} wallpapers"
+  exit 0
+fi
+
+# ---------------------------------------------------------------------------
+# Check dependencies
+# ---------------------------------------------------------------------------
+
+if [[ ! -f "$EXTRACT_SCRIPT" ]]; then
+  echo "Error: extract-theme.py not found at $EXTRACT_SCRIPT" >&2
+  exit 1
+fi
+
+if ! command -v python3 &>/dev/null; then
+  echo "Error: python3 required" >&2
+  exit 1
+fi
+
+if ! command -v magick &>/dev/null; then
+  echo "Error: ImageMagick (magick) required" >&2
+  exit 1
+fi
+
+mkdir -p "$CACHE_DIR"
+
+# Clean orphaned cache files (wallpapers that no longer exist)
+for cache_file in "$CACHE_DIR"/*.toml; do
+  [[ -f "$cache_file" ]] || continue
+  cached_name="$(basename "$cache_file" .toml)"
+  if [[ -z "${WALLPAPERS[$cached_name]+x}" ]]; then
+    rm -f "$cache_file"
+  fi
+done
+
+# ---------------------------------------------------------------------------
+# Generate themes
+# ---------------------------------------------------------------------------
+
+sys_count=0
+cust_count=0
+for name in "${!WP_SOURCE[@]}"; do
+  case "${WP_SOURCE[$name]}" in
+    system) sys_count=$((sys_count + 1)) ;;
+    custom) cust_count=$((cust_count + 1)) ;;
+  esac
+done
+echo "Discovering wallpapers..."
+echo "  Found: $sys_count system, $cust_count custom (${#WALLPAPERS[@]} total)"
+echo ""
+
+GENERATED=0
+CACHED=0
+FAILED=0
+
+echo "Generating themes..."
+
+# Build work list (skip cached)
+WORK=()
+for name in $(printf '%s\n' "${!WALLPAPERS[@]}" | sort); do
+  [[ -n "${WALLPAPERS[$name]+x}" ]] || continue
+  wp_path="${WALLPAPERS[$name]}"
+  cache_file="$CACHE_DIR/${name}.toml"
+
+  if [[ "$FORCE" != "true" && -f "$cache_file" && "$cache_file" -nt "$wp_path" ]]; then
+    CACHED=$((CACHED + 1))
+    continue
+  fi
+  WORK+=("$name")
+done
+
+# Process in parallel (up to 4 jobs)
+JOBS=4
+TOTAL_WORK=${#WORK[@]}
+if [[ $TOTAL_WORK -gt 0 ]]; then
+  echo "  Processing $TOTAL_WORK wallpapers ($JOBS parallel jobs)..."
+  for name in "${WORK[@]}"; do
+    wp_path="${WALLPAPERS[$name]}"
+    cache_file="$CACHE_DIR/${name}.toml"
+    source_type="${WP_SOURCE[$name]}"
+
+    (
+      if python3 "$EXTRACT_SCRIPT" "$wp_path" --name "$name" --source "$source_type" >"$cache_file" 2>/dev/null; then
+        printf "  %-40s [%s] ✓\n" "$name" "$source_type"
+      else
+        rm -f "$cache_file"
+        printf "  %-40s [%s] ✗\n" "$name" "$source_type"
+      fi
+    ) &
+
+    # Limit parallel jobs
+    while [[ $(jobs -r | wc -l) -ge $JOBS ]]; do
+      wait -n 2>/dev/null || true
+    done
+  done
+  wait
+fi
+
+# Count results
+GENERATED=$(find "$CACHE_DIR" -name "*.toml" -newer "$0" 2>/dev/null | wc -l | tr -d ' ')
+FAILED=$((TOTAL_WORK - GENERATED))
+echo ""
+echo "Results: $TOTAL_WORK processed, $CACHED cached, $FAILED failed"
+
+# ---------------------------------------------------------------------------
+# Assemble themes.toml
+# ---------------------------------------------------------------------------
+
+echo ""
+echo "Assembling themes.toml..."
+
+{
+  cat <<'HEADER'
+# ============================================================================
+# Theme Manifest — Auto-generated from wallpaper dominant colors
+# ============================================================================
+# Generated by: scripts/theme/rebuild-themes.sh
+# Algorithm: K-Means clustering in CIELAB color space
+# Do not edit manually — run `dot theme rebuild` to regenerate.
+#
+# Sources:
+#   System: /System/Library/Desktop Pictures/ (macOS)
+#           /usr/share/backgrounds/ (Linux)
+#   Custom: ~/Pictures/Wallpapers/
+
+HEADER
+
+  for cache_file in "$CACHE_DIR"/*.toml; do
+    [[ -f "$cache_file" ]] || continue
+    echo ""
+    cat "$cache_file"
+  done
+} >"$THEMES_FILE"
+
+theme_count=$(grep -c '^\[themes\.' "$THEMES_FILE" | head -1)
+echo "  Written: $THEMES_FILE ($theme_count theme sections)"
+echo ""
+echo "Done. Run 'dot theme list' to see available themes."