@sebastienrousseau/dotfiles 0.2.519 → 0.2.521

package/scripts/theme/merge-wallpaper.sh

@@ -1,146 +0,0 @@
-#!/usr/bin/env bash
-# SPDX-License-Identifier: MIT
-# Copyright (c) 2015-2026 Sebastien Rousseau
-# 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)"
-  # Single-quotes prevent the variable expanding at trap-definition time;
-  # `$tmpdir` resolves when the trap fires (still scoped to this function
-  # because RETURN is per-function).
-  # shellcheck disable=SC2064  # intentionally expand $tmpdir at trap time within this function scope
-  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

@@ -1,544 +0,0 @@
-#!/usr/bin/env bash
-# SPDX-License-Identifier: MIT
-# Copyright (c) 2015-2026 Sebastien Rousseau
-# 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
-
-# This script relies on associative arrays (`declare -A`) and `wait -n`,
-# both of which need bash >= 4. macOS ships /bin/bash 3.2, where it would
-# otherwise fail with cryptic "invalid option" / "bad array subscript"
-# errors mid-run. Re-exec under a newer bash when one is available
-# (Homebrew, MacPorts, mise), and fail with a clear, actionable message
-# otherwise rather than corrupting a half-built themes.toml.
-if ((BASH_VERSINFO[0] < 4)); then
-  for _newer_bash in \
-    /opt/homebrew/bin/bash \
-    /usr/local/bin/bash \
-    "${HOMEBREW_PREFIX:-}/bin/bash" \
-    "$(command -v bash 2>/dev/null || true)"; do
-    if [[ -n "$_newer_bash" && -x "$_newer_bash" ]] &&
-      "$_newer_bash" -c '((BASH_VERSINFO[0] >= 4))' 2>/dev/null; then
-      exec "$_newer_bash" "$0" "$@"
-    fi
-  done
-  echo "Error: 'dot theme rebuild' needs bash >= 4 (macOS ships bash 3.2)." >&2
-  echo "       Install a newer bash and retry:  brew install bash" >&2
-  exit 1
-fi
-
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-EXTRACT_SCRIPT="$SCRIPT_DIR/extract-theme.py"
-DOTFILES_DIR="${HOME}/.dotfiles"
-
-# Descend into the chezmoi source subdir when .chezmoiroot is present (post-reorg, chezmoi files under defaults/)
-CHEZMOI_SRC="$DOTFILES_DIR"
-if [[ -f "$DOTFILES_DIR/.chezmoiroot" ]]; then
-  _sub="$(head -1 "$DOTFILES_DIR/.chezmoiroot" | tr -d '[:space:]')"
-  [[ -n "$_sub" && -d "$DOTFILES_DIR/$_sub" ]] && CHEZMOI_SRC="$DOTFILES_DIR/$_sub"
-fi
-THEMES_FILE="$CHEZMOI_SRC/.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 variant
-  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-]/}"
-      while [[ "$name" == *--* ]]; do name="${name//--/-}"; done
-      name="${name#-}"
-      name="${name%-}"
-      [[ -n "$name" ]] || continue
-      # Static system images carry no mode; theme them in both modes so
-      # they show as a pair (unless the file is already a -dark/-light).
-      if [[ "$name" == *-dark || "$name" == *-light ]]; then
-        [[ -z "${WALLPAPERS[$name]+x}" ]] && {
-          WALLPAPERS["$name"]="$file"
-          WP_SOURCE["$name"]="system"
-        }
-        continue
-      fi
-      local key
-      for variant in dark light; do
-        key="${name}-${variant}"
-        if [[ -z "${WALLPAPERS[$key]+x}" ]]; then
-          WALLPAPERS["$key"]="$file"
-          WP_SOURCE["$key"]="system"
-        fi
-      done
-    done < <(find "$dir" -maxdepth 3 -type f \
-      \( -iname '*.jpg' -o -iname '*.jpeg' -o -iname '*.png' \
-      -o -iname '*.heic' -o -iname '*.webp' -o -iname '*.tiff' \) 2>/dev/null | sort)
-  done
-}
-
-discover_custom() {
-  [[ -d "$CUSTOM_DIR" ]] || return 0
-
-  local file base name ext frame_count
-  # Case-insensitive, wide extension match. The old fixed-glob loop
-  # (`*.heic *.jpg *.png`) silently dropped `.jpeg`, `.webp`, `.tiff`
-  # and every uppercase variant (`.JPG`, `.HEIC`, …), so those
-  # wallpapers never made it into the theme table.
-  while IFS= read -r file; do
-    [[ -f "$file" ]] || continue
-    base="$(basename "$file")"
-    base="${base%.*}"
-    ext="$(echo "${file##*.}" | tr '[:upper:]' '[:lower:]')"
-
-    # Normalize to the [a-z0-9-] namespace that themes.toml and the
-    # `dot theme list` picker regex both require — a raw name with
-    # spaces/uppercase would generate a section the picker can't match.
-    name="$(echo "$base" | tr '[:upper:]' '[:lower:]' | tr ' _' '--')"
-    name="${name//[^a-z0-9-]/}"
-    while [[ "$name" == *--* ]]; do name="${name//--/-}"; done
-    name="${name#-}"
-    name="${name%-}"
-    [[ -n "$name" ]] || continue
-
-    # Dynamic HEIC (multi-frame = light+dark packed in one file).
-    if [[ "$ext" == "heic" ]]; then
-      frame_count="$(magick identify "$file" 2>/dev/null | wc -l | tr -d ' ')"
-      if [[ "$frame_count" -ge 2 && "$name" != *-dark && "$name" != *-light ]]; then
-        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
-
-    # Explicitly-named single-mode variant (foo-dark.jpg / foo-light.jpg):
-    # honour the author's mode, register the one variant as-is.
-    if [[ "$name" == *-dark || "$name" == *-light ]]; then
-      WALLPAPERS["$name"]="$file"
-      WP_SOURCE["$name"]="custom"
-      continue
-    fi
-
-    # Static single image: theme it in BOTH modes (extract-theme forces
-    # the mode from the -dark/-light suffix) so it appears as a light/dark
-    # pair in `dot theme list`. Previously a static produced only one
-    # variant and paired_families() hid it entirely.
-    WALLPAPERS["${name}-dark"]="$file"
-    WP_SOURCE["${name}-dark"]="custom"
-    WALLPAPERS["${name}-light"]="$file"
-    WP_SOURCE["${name}-light"]="custom"
-  done < <(find "$CUSTOM_DIR" -maxdepth 1 -type f \
-    \( -iname '*.heic' -o -iname '*.jpg' -o -iname '*.jpeg' \
-    -o -iname '*.png' -o -iname '*.webp' -o -iname '*.tiff' \) 2>/dev/null | sort)
-}
-
-# 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. System (OS-shipped)
-# wallpapers are opt-in — most users only want themes from their own
-# wallpapers. Enable the ~100 built-in ones with DOTFILES_THEME_SYSTEM=1.
-if [[ "${DOTFILES_THEME_SYSTEM:-0}" == "1" ]]; then
-  case "$(uname -s)" in
-    Darwin) discover_macos_system ;;
-    Linux) discover_linux_system ;;
-  esac
-fi
-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
-# ---------------------------------------------------------------------------
-
-# Report distinct WALLPAPERS (families), not theme sections. Every
-# wallpaper — a dynamic HEIC (light+dark frames) or a static image —
-# yields a `-light` and a `-dark` theme, so a raw section count is ~2x
-# the file count and reads as wrong ("74 files → 148 custom"). Collapse
-# -dark/-light back to the family so the numbers match what's on disk
-# and what `dot theme list` shows, and report the theme total separately.
-# Explicit empty init: a `declare -A x` that never gets a key still trips
-# `set -u` on ${#x[@]} (even in bash 5) — happens now that system wallpapers
-# are opt-in and sys_fam can stay empty.
-declare -A sys_fam=() cust_fam=()
-for name in "${!WP_SOURCE[@]}"; do
-  family="${name%-dark}"
-  family="${family%-light}"
-  case "${WP_SOURCE[$name]}" in
-    system) sys_fam["$family"]=1 ;;
-    custom) cust_fam["$family"]=1 ;;
-  esac
-done
-sys_count=${#sys_fam[@]}
-cust_count=${#cust_fam[@]}
-echo "Discovering wallpapers..."
-echo "  Found: $sys_count system, $cust_count custom wallpapers" \
-  "($((sys_count + cust_count)) total → ${#WALLPAPERS[@]} light/dark themes)"
-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 (bash >= 4 guaranteed by the guard at the top).
-    while [[ $(jobs -r | wc -l) -ge $JOBS ]]; do
-      wait -n 2>/dev/null || true
-    done
-  done
-  wait
-fi
-
-# Count results — how many of THIS run's work items produced a cache file.
-# (The old `find -newer "$0"` counted every cache file newer than the script,
-# so when everything was cached FAILED went negative.)
-GENERATED=0
-FAILED=0
-for name in "${WORK[@]}"; do
-  if [[ -f "$CACHE_DIR/${name}.toml" ]]; then
-    GENERATED=$((GENERATED + 1))
-  else
-    FAILED=$((FAILED + 1))
-  fi
-done
-echo ""
-echo "Results: $GENERATED generated, $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
-
-  # Assemble ONLY the wallpapers discovered this run, not every file left in
-  # the cache. This drops themes for wallpapers no longer present (e.g. system
-  # wallpapers once DOTFILES_THEME_SYSTEM is turned off) instead of letting
-  # stale cache entries pile up in themes.toml.
-  for name in $(printf '%s\n' "${!WALLPAPERS[@]}" | sort); do
-    cache_file="$CACHE_DIR/${name}.toml"
-    [[ -f "$cache_file" ]] || continue
-    echo ""
-    cat "$cache_file"
-  done
-
-  # Synthetic fallback themes — always emitted, never wallpaper-derived.
-  # Every theme template degrades to `fallback-dark` when `.theme` is unset or
-  # names a theme absent from this file. Because these are re-emitted on every
-  # rebuild, a regeneration that drops any wallpaper theme can never break the
-  # fallback (unlike hardcoding a wallpaper theme like the old big-sur-dark).
-  # switch.sh hides the `fallback` family from user-facing theme lists.
-  cat <<'FALLBACK'
-
-# ─────────────────────────────────────────────────────────────────────
-# Synthetic fallback themes (NOT wallpaper-derived, NEVER user-selectable).
-# ─────────────────────────────────────────────────────────────────────
-
-[themes.fallback-dark]
-mode = "dark"
-family = "fallback"
-macos_accent = 4
-wallpaper = ""
-source = "custom"
-
-[themes.fallback-dark.term]
-bg = "#1e1e2e"
-fg = "#d4d4d4"
-cursor = "#455c67"
-cursor_text = "#1e1e2e"
-sel_bg = "#394145"
-sel_fg = "#d4d4d4"
-c0  = "#3c3c4d"
-c1  = "#997d7a"
-c2  = "#479174"
-c3  = "#8a836f"
-c4  = "#5f86b7"
-c5  = "#917e8e"
-c6  = "#5c8d82"
-c7  = "#b9b8bb"
-c8  = "#605f72"
-c9  = "#bf9b97"
-c10 = "#67b293"
-c11 = "#aba389"
-c12 = "#7fa6d9"
-c13 = "#b49cb0"
-c14 = "#7bada1"
-c15 = "#e2e2e3"
-
-[themes.fallback-dark.ui]
-accent = "#455c67"
-accent_text = "#ffffff"
-error = "#997d7a"
-warning = "#8a836f"
-success = "#479174"
-info = "#5f86b7"
-panel = "#242435"
-border = "#302f38"
-
-[themes.fallback-dark.app]
-nvim = "tokyonight"
-nvim_style = "night"
-lualine = "tokyonight"
-gtk_theme = "Adwaita-dark"
-gtk_icon = "Papirus-Dark"
-gnome_shell = ""
-gnome_gtk = "Adwaita-dark"
-vscode = "Tokyonight Mocha"
-vscode_dark = "Tokyonight Mocha"
-vscode_light = "Tokyonight Latte"
-cat_wallpaper = ""
-starship_palette = "catppuccin_mocha"
-
-
-[themes.fallback-light]
-mode = "light"
-family = "fallback"
-macos_accent = 4
-wallpaper = ""
-source = "custom"
-
-[themes.fallback-light.term]
-bg = "#fbf1c7"
-fg = "#3c3836"
-cursor = "#2c5989"
-cursor_text = "#fbf1c7"
-sel_bg = "#c6cfe0"
-sel_fg = "#3c3836"
-c0  = "#2e2c26"
-c1  = "#7d3d39"
-c2  = "#205a48"
-c3  = "#5b501d"
-c4  = "#2b527d"
-c5  = "#6e4069"
-c6  = "#25554c"
-c7  = "#6f6d67"
-c8  = "#54524b"
-c9  = "#853733"
-c10 = "#025c46"
-c11 = "#5b500b"
-c12 = "#0d5388"
-c13 = "#743b6f"
-c14 = "#15564b"
-c15 = "#979693"
-
-[themes.fallback-light.ui]
-accent = "#2c5989"
-accent_text = "#ffffff"
-error = "#7d3d39"
-warning = "#5b501d"
-success = "#205a48"
-info = "#2b527d"
-panel = "#f2e8bf"
-border = "#e3e0d3"
-
-[themes.fallback-light.app]
-nvim = "catppuccin"
-nvim_style = "latte"
-lualine = "catppuccin"
-gtk_theme = "Adwaita"
-gtk_icon = "Papirus-Light"
-gnome_shell = ""
-gnome_gtk = "Adwaita"
-vscode = "Catppuccin Latte"
-vscode_dark = "Catppuccin Mocha"
-vscode_light = "Catppuccin Latte"
-cat_wallpaper = ""
-starship_palette = "catppuccin_latte"
-FALLBACK
-} >"$THEMES_FILE"
-
-# Count top-level [themes.NAME] blocks only — not the .term/.ui/.app
-# subsections (which inflated the tally ~4x).
-theme_count=$(grep -cE '^\[themes\.[a-z0-9-]+\]$' "$THEMES_FILE")
-echo "  Written: $THEMES_FILE ($theme_count themes)"
-echo ""
-echo "Done. Run 'dot theme list' to see available themes."