theus-cli-linux-x64 0.2.84

package/vendor/theus-arsenal/skills/generacion-iconos-ios/SKILL.md

@@ -0,0 +1,156 @@
+---
+name: generacion-iconos-ios
+description: Genera iconos de app iOS como imagesets PNG para catálogos de assets de Xcode, desde SF Symbols (5000+ nativos de Apple) o la API de Iconify (275 000+ iconos open source de 200+ colecciones). Úsala al generar iconos, crear assets de iconos, añadir iconos a un catálogo de assets o buscar iconos para proyectos iOS.
+---
+
+# Generador de iconos iOS
+
+Genera imagesets PNG de iconos para catálogos de assets de Xcode desde dos fuentes.
+
+## Cuándo activarla
+
+- Generar assets de iconos para un proyecto iOS/macOS en Xcode
+- Buscar iconos entre colecciones open source
+- Crear imagesets PNG (1x, 2x, 3x) para catálogos de assets
+- Reemplazar iconos placeholder por assets de calidad de producción
+- Igualar el estilo de los iconos existentes en un proyecto Xcode
+
+## Principios centrales
+
+### 1. Dos fuentes, un formato de salida
+Ambas fuentes producen imagesets idénticos compatibles con Xcode. Elige según la necesidad:
+
+| Fuente | Iconos | Requiere | Ideal para |
+|--------|--------|----------|------------|
+| **API de Iconify** | 275 000+ de 200+ colecciones | Internet | Selección amplia, estilos específicos, iconos open source |
+| **SF Symbols** | 5000+ símbolos de Apple | Solo macOS | Estilo nativo de Apple, uso sin conexión |
+
+### 2. Iguala siempre el estilo existente
+Antes de generar, revisa los iconos existentes del proyecto para mantener consistencia de tamaño, color y grosor.
+
+### 3. Estructura de salida
+Ambos métodos producen un imageset completo de Xcode:
+
+```
+<dir-salida>/<nombre-asset>.imageset/
+  Contents.json
+  <nombre-asset>.png        # 1x (68 px por defecto)
+  <nombre-asset>@2x.png     # 2x (136 px por defecto)
+  <nombre-asset>@3x.png     # 3x (204 px por defecto)
+```
+
+## Ejemplos
+
+### Paso 1: evalúa los requisitos
+
+Determina qué necesita el icono: qué representa, el estilo preferido, el color objetivo y el tamaño.
+
+Si el proyecto ya tiene iconos, revisa el estilo existente:
+```bash
+# Comprobar dimensiones de un icono existente
+sips -g pixelWidth -g pixelHeight ruta/al/existente@2x.png
+```
+
+### Paso 2: busca iconos
+
+**API de Iconify (recomendada por su variedad):**
+```bash
+# Buscar en todas las colecciones
+"${THEUS_PLUGIN_ROOT}/skills/generacion-iconos-ios/scripts/iconify_gen.sh" search "receipt"
+
+# Buscar dentro de una colección concreta
+"${THEUS_PLUGIN_ROOT}/skills/generacion-iconos-ios/scripts/iconify_gen.sh" search "business card" --prefix mdi
+
+# Listar las colecciones disponibles
+"${THEUS_PLUGIN_ROOT}/skills/generacion-iconos-ios/scripts/iconify_gen.sh" collections
+```
+
+**SF Symbols (para estilo nativo de Apple):**
+Explora la app SF Symbols o consulta nombres comunes:
+
+| Caso de uso | Nombre del símbolo |
+|-------------|--------------------|
+| Documento | `doc.text`, `doc.fill` |
+| Recibo | `doc.text.below.ecg`, `receipt` |
+| Persona | `person.crop.rectangle`, `person.text.rectangle` |
+| Cámara | `camera`, `camera.fill` |
+| Escanear | `doc.viewfinder`, `qrcode.viewfinder` |
+| Ajustes | `gearshape`, `slider.horizontal.3` |
+
+### Paso 3: previsualiza (opcional)
+
+```bash
+# Previsualización de Iconify
+"${THEUS_PLUGIN_ROOT}/skills/generacion-iconos-ios/scripts/iconify_gen.sh" preview mdi:receipt-text-outline
+```
+
+### Paso 4: genera
+
+**API de Iconify:**
+```bash
+# Generación básica
+"${THEUS_PLUGIN_ROOT}/skills/generacion-iconos-ios/scripts/iconify_gen.sh" mdi:receipt-text-outline editTool_expenseReport
+
+# Color y ubicación de salida personalizados
+"${THEUS_PLUGIN_ROOT}/skills/generacion-iconos-ios/scripts/iconify_gen.sh" mdi:receipt-text-outline miIcono --color 007AFF --output ./Assets.xcassets/icons
+```
+
+Opciones: `--size <pt>` (por defecto: 68), `--color <hex>` (por defecto: 8E8E93), `--output <dir>` (por defecto: /tmp/icons)
+
+**SF Symbols:**
+```bash
+# Generación básica
+swift "${THEUS_PLUGIN_ROOT}/skills/generacion-iconos-ios/scripts/generate_icons.swift" doc.text.below.ecg editTool_expenseReport
+
+# Color, grosor y salida personalizados
+swift "${THEUS_PLUGIN_ROOT}/skills/generacion-iconos-ios/scripts/generate_icons.swift" person.crop.rectangle miIcono --color 007AFF --weight regular --output ./Assets.xcassets/icons
+```
+
+Opciones: `--size <pt>` (por defecto: 68), `--color <hex>` (por defecto: 8E8E93), `--weight <nombre>` (por defecto: thin), `--output <dir>` (por defecto: /tmp/icons)
+
+### Paso 5: verifica e integra
+
+1. Lee el PNG @2x generado para verificarlo visualmente
+2. Cópialo al catálogo de assets si no se generó directamente ahí:
+   ```bash
+   cp -r /tmp/icons/<nombre>.imageset ruta/a/Assets.xcassets/<grupo>/
+   ```
+3. Compila el proyecto para verificar que Xcode reconoce los nuevos assets
+
+## Colecciones populares de Iconify
+
+| Prefijo | Nombre | Cantidad | Estilo |
+|---------|--------|----------|--------|
+| `mdi` | Material Design Icons | 7400+ | Variantes rellenas + contorno |
+| `ph` | Phosphor | 9000+ | 6 grosores por icono |
+| `solar` | Solar | 7400+ | Bold, lineal, contorno |
+| `tabler` | Tabler Icons | 6000+ | Grosor de trazo consistente |
+| `lucide` | Lucide | 1700+ | Limpio, minimal |
+| `ri` | Remix Icon | 3100+ | Variantes rellenas + línea |
+| `carbon` | Carbon | 2400+ | Lenguaje de diseño de IBM |
+| `heroicons` | HeroIcons | 1200+ | Compañero de Tailwind CSS |
+
+Explóralas todas: <https://icon-sets.iconify.design/>
+
+## Referencia de scripts
+
+| Script | Fuente | Ruta |
+|--------|--------|------|
+| `iconify_gen.sh` | API de Iconify (275k+ iconos) | `${THEUS_PLUGIN_ROOT}/skills/generacion-iconos-ios/scripts/iconify_gen.sh` |
+| `generate_icons.swift` | SF Symbols (5k+ iconos) | `${THEUS_PLUGIN_ROOT}/skills/generacion-iconos-ios/scripts/generate_icons.swift` |
+
+## Buenas prácticas
+
+- **Busca antes de generar** — explora los iconos disponibles para encontrar la mejor coincidencia
+- **Iguala el estilo del proyecto** — revisa dimensiones, color y grosor de los iconos existentes antes de generar nuevos
+- **Usa Iconify para variedad** — con 200+ colecciones puedes encontrar exactamente el estilo que necesitas
+- **Usa SF Symbols para consistencia con Apple** — encajan perfectamente con la UI del sistema
+- **Genera directamente en el catálogo de assets** — usa `--output ./Assets.xcassets/icons` para evitar la copia manual
+- **Verifica visualmente** — previsualiza siempre el PNG @2x antes de hacer commit
+
+## Antipatrones
+
+- Generar iconos sin revisar el estilo de los iconos existentes del proyecto
+- Usar colores por defecto cuando el proyecto tiene una paleta definida
+- Generar en tamaños incorrectos (revisa primero los iconos existentes)
+- Hacer commit de iconos generados sin verificación visual

package/vendor/theus-arsenal/skills/generacion-iconos-ios/scripts/generate_icons.swift

@@ -0,0 +1,258 @@
+#!/usr/bin/env swift
+
+import AppKit
+import Foundation
+
+// MARK: - Configuración
+
+struct IconSpec {
+    let symbolName: String
+    let assetName: String
+    let baseSize: CGFloat
+    let color: NSColor
+    let weight: NSFont.Weight
+}
+
+func parseColor(_ hex: String) -> NSColor {
+    var hex = hex.trimmingCharacters(in: .whitespacesAndNewlines)
+    if hex.hasPrefix("#") { hex.removeFirst() }
+    guard hex.count == 6, let value = UInt64(hex, radix: 16) else {
+        return NSColor(red: 142/255, green: 142/255, blue: 147/255, alpha: 1.0)
+    }
+    return NSColor(
+        red: CGFloat((value >> 16) & 0xFF) / 255,
+        green: CGFloat((value >> 8) & 0xFF) / 255,
+        blue: CGFloat(value & 0xFF) / 255,
+        alpha: 1.0
+    )
+}
+
+func parseWeight(_ name: String) -> NSFont.Weight {
+    switch name.lowercased() {
+    case "ultralight": return .ultraLight
+    case "thin": return .thin
+    case "light": return .light
+    case "regular": return .regular
+    case "medium": return .medium
+    case "semibold": return .semibold
+    case "bold": return .bold
+    case "heavy": return .heavy
+    case "black": return .black
+    default: return .thin
+    }
+}
+
+// MARK: - Generación
+
+enum IconError: Error, CustomStringConvertible {
+    case directoryCreation(String)
+    case symbolNotFound(String)
+    case configurationFailed(String)
+    case pngCreation(String)
+    case fileWrite(String)
+
+    var description: String {
+        switch self {
+        case .directoryCreation(let msg): return msg
+        case .symbolNotFound(let msg): return msg
+        case .configurationFailed(let msg): return msg
+        case .pngCreation(let msg): return msg
+        case .fileWrite(let msg): return msg
+        }
+    }
+}
+
+func generateIcon(_ spec: IconSpec, outputDir: String) throws {
+    let dir = "\(outputDir)/\(spec.assetName).imageset"
+    do {
+        try FileManager.default.createDirectory(atPath: dir, withIntermediateDirectories: true)
+    } catch {
+        throw IconError.directoryCreation("No se pudo crear el directorio de salida '\(dir)': \(error.localizedDescription)")
+    }
+
+    let scales: [(suffix: String, multiplier: CGFloat)] = [("", 1), ("@2x", 2), ("@3x", 3)]
+
+    for scale in scales {
+        let pixelSize = spec.baseSize * scale.multiplier
+        let imageSize = NSSize(width: pixelSize, height: pixelSize)
+
+        let config = NSImage.SymbolConfiguration(
+            pointSize: pixelSize * 0.40,
+            weight: spec.weight,
+            scale: .large
+        )
+
+        guard let symbol = NSImage(systemSymbolName: spec.symbolName, accessibilityDescription: nil) else {
+            throw IconError.symbolNotFound("SF Symbol '\(spec.symbolName)' no encontrado. Abre la app 'SF Symbols' para explorar los nombres disponibles.")
+        }
+
+        guard let configured = symbol.withSymbolConfiguration(config) else {
+            throw IconError.configurationFailed("No se pudo aplicar la configuración de símbolo a '\(spec.symbolName)'")
+        }
+
+        let image = NSImage(size: imageSize, flipped: false) { rect in
+            let symSize = configured.size
+            let x = (rect.width - symSize.width) / 2
+            let y = (rect.height - symSize.height) / 2
+            let drawRect = NSRect(x: x, y: y, width: symSize.width, height: symSize.height)
+
+            let tinted = NSImage(size: symSize, flipped: false) { tintRect in
+                configured.draw(in: tintRect)
+                spec.color.set()
+                tintRect.fill(using: .sourceAtop)
+                return true
+            }
+
+            tinted.draw(in: drawRect, from: .zero, operation: .sourceOver, fraction: 1.0)
+            return true
+        }
+
+        guard let tiffData = image.tiffRepresentation,
+              let bitmap = NSBitmapImageRep(data: tiffData),
+              let pngData = bitmap.representation(using: .png, properties: [:]) else {
+            throw IconError.pngCreation("No se pudo crear el PNG para \(spec.assetName)\(scale.suffix)")
+        }
+
+        let fileName = "\(spec.assetName)\(scale.suffix).png"
+        do {
+            try pngData.write(to: URL(fileURLWithPath: "\(dir)/\(fileName)"))
+        } catch {
+            throw IconError.fileWrite("No se pudo escribir \(fileName): \(error.localizedDescription)")
+        }
+        print("  \(fileName) (\(Int(pixelSize))x\(Int(pixelSize)))")
+    }
+
+    // Escribir Contents.json
+    let json = """
+    {
+      "images" : [
+        {
+          "filename" : "\(spec.assetName).png",
+          "idiom" : "universal",
+          "scale" : "1x"
+        },
+        {
+          "filename" : "\(spec.assetName)@2x.png",
+          "idiom" : "universal",
+          "scale" : "2x"
+        },
+        {
+          "filename" : "\(spec.assetName)@3x.png",
+          "idiom" : "universal",
+          "scale" : "3x"
+        }
+      ],
+      "info" : {
+        "author" : "xcode",
+        "version" : 1
+      }
+    }
+    """
+    do {
+        try json.write(toFile: "\(dir)/Contents.json", atomically: true, encoding: .utf8)
+    } catch {
+        throw IconError.fileWrite("No se pudo escribir Contents.json: \(error.localizedDescription)")
+    }
+}
+
+func requireOptionValue(_ args: [String], at index: Int, flag: String) -> String {
+    guard index < args.count else {
+        fputs("ERROR: falta el valor de \(flag)\n", stderr)
+        exit(1)
+    }
+    let value = args[index]
+    if value.hasPrefix("--") {
+        fputs("ERROR: falta el valor de \(flag)\n", stderr)
+        exit(1)
+    }
+    return value
+}
+
+// MARK: - CLI
+
+let args = CommandLine.arguments
+
+if args.count < 3 || args.contains("--help") || args.contains("-h") {
+    print("""
+    Uso: generate_icons.swift <nombre-sf-symbol> <nombre-asset> [opciones]
+
+    Opciones:
+      --size <pt>       Tamaño base en puntos (por defecto: 68)
+      --color <hex>     Código de color hex (por defecto: 8E8E93)
+      --weight <nombre> Grosor: ultralight|thin|light|regular|medium|semibold|bold|heavy|black (por defecto: thin)
+      --output <dir>    Directorio de salida (por defecto: /tmp/icons)
+
+    Ejemplos:
+      generate_icons.swift doc.text.below.ecg editTool_expenseReport
+      generate_icons.swift person.crop.rectangle editTool_businessCard --color 007AFF --weight regular
+      generate_icons.swift receipt miRecibo --size 48 --output ./Assets.xcassets/icons
+
+    Explora los nombres de SF Symbols: abre la app SF Symbols (gratuita, de Apple) o https://developer.apple.com/sf-symbols/
+    """)
+    exit(0)
+}
+
+let symbolName = args[1]
+let assetName = args[2]
+
+var baseSize: CGFloat = 68
+var colorHex = "8E8E93"
+var weightName = "thin"
+var outputDir = "/tmp/icons"
+
+var i = 3
+while i < args.count {
+    switch args[i] {
+    case "--size":
+        let raw = requireOptionValue(args, at: i + 1, flag: "--size")
+        guard let size = Double(raw), size > 0 else {
+            fputs("ERROR: --size debe ser un número positivo\n", stderr)
+            exit(1)
+        }
+        baseSize = CGFloat(size)
+        i += 2
+        continue
+    case "--color":
+        colorHex = requireOptionValue(args, at: i + 1, flag: "--color")
+        let stripped = colorHex.hasPrefix("#") ? String(colorHex.dropFirst()) : colorHex
+        guard stripped.count == 6, UInt64(stripped, radix: 16) != nil else {
+            fputs("ERROR: --color debe ser un código hex de 6 dígitos (p. ej. 007AFF)\n", stderr)
+            exit(1)
+        }
+        i += 2
+        continue
+    case "--weight":
+        weightName = requireOptionValue(args, at: i + 1, flag: "--weight")
+        let validWeights = ["ultralight", "thin", "light", "regular", "medium", "semibold", "bold", "heavy", "black"]
+        guard validWeights.contains(weightName.lowercased()) else {
+            fputs("ERROR: --weight debe ser uno de: \(validWeights.joined(separator: ", "))\n", stderr)
+            exit(1)
+        }
+        i += 2
+        continue
+    case "--output":
+        outputDir = requireOptionValue(args, at: i + 1, flag: "--output")
+        i += 2
+        continue
+    default:
+        fputs("ADVERTENCIA: opción desconocida \(args[i])\n", stderr)
+    }
+    i += 1
+}
+
+let spec = IconSpec(
+    symbolName: symbolName,
+    assetName: assetName,
+    baseSize: baseSize,
+    color: parseColor(colorHex),
+    weight: parseWeight(weightName)
+)
+
+print("Generando \(assetName) desde el SF Symbol '\(symbolName)':")
+do {
+    try generateIcon(spec, outputDir: outputDir)
+    print("Salida: \(outputDir)/\(assetName).imageset/")
+} catch {
+    fputs("ERROR: \(error)\n", stderr)
+    exit(1)
+}

package/vendor/theus-arsenal/skills/generacion-iconos-ios/scripts/iconify_gen.sh

@@ -0,0 +1,235 @@
+#!/bin/bash
+#
+# Genera imagesets de iconos iOS desde la API de Iconify (275k+ iconos open source)
+# Usa: curl (descarga el SVG) + sips (conversión SVG->PNG, incluida en macOS)
+#
+# Uso:
+#   iconify_gen.sh <id-icono> <nombre-asset> [opciones]
+#   iconify_gen.sh search <consulta> [--prefix <coleccion>] [--limit <n>]
+#
+# Ejemplos:
+#   iconify_gen.sh mdi:receipt-text-outline miIconoGastos
+#   iconify_gen.sh search "business card"
+#   iconify_gen.sh search receipt --prefix mdi
+
+set -euo pipefail
+
+API_BASE="https://api.iconify.design"
+readonly CURL_OPTS=(--fail --silent --show-error --connect-timeout 10 --max-time 30)
+
+# Valores por defecto
+SIZE=68
+COLOR="8E8E93"
+OUTPUT="/tmp/icons"
+LIMIT=20
+
+require_value() {
+    local flag="$1"
+    local value="${2-}"
+    if [[ -z "$value" || "$value" == --* ]]; then
+        echo "ERROR: ${flag} requiere un valor" >&2
+        exit 1
+    fi
+}
+
+usage() {
+    cat <<'EOF'
+Uso:
+  iconify_gen.sh <id-icono> <nombre-asset> [opciones]    Genera un imageset de icono
+  iconify_gen.sh search <consulta> [opciones]             Busca iconos
+  iconify_gen.sh preview <id-icono>                       Descarga un SVG de previsualización
+  iconify_gen.sh collections                              Lista colecciones populares de iconos
+
+Opciones de generación:
+  --size <pt>       Tamaño base en puntos (por defecto: 68)
+  --color <hex>     Color hex sin # (por defecto: 8E8E93)
+  --output <dir>    Directorio de salida (por defecto: /tmp/icons)
+
+Opciones de búsqueda:
+  --prefix <nombre> Filtrar por colección (p. ej. mdi, lucide, tabler, ph)
+  --limit <n>       Máximo de resultados (por defecto: 20)
+
+Formato del ID de icono: <coleccion>:<nombre-icono>
+  Ejemplos: mdi:receipt-text-outline, lucide:credit-card, ph:address-book
+
+Colecciones populares:
+  mdi      Material Design Icons (7400+ iconos)
+  lucide   Lucide (1700+ iconos)
+  tabler   Tabler Icons (6000+ iconos)
+  ph       Phosphor (9000+ iconos)
+  ri       Remix Icon (2800+ iconos)
+  carbon   Carbon (2100+ iconos)
+EOF
+    exit 0
+}
+
+search_icons() {
+    local query="$1"
+    shift
+    local prefix=""
+
+    while [[ $# -gt 0 ]]; do
+        case "$1" in
+            --prefix) require_value --prefix "${2-}"; prefix="$2"; shift 2 ;;
+            --limit) require_value --limit "${2-}"; LIMIT="$2"; shift 2 ;;
+            *) shift ;;
+        esac
+    done
+
+    local encoded_query
+    encoded_query="$(python3 -c "import urllib.parse, sys; print(urllib.parse.quote(sys.argv[1]))" "$query")"
+    local url="${API_BASE}/search?query=${encoded_query}&limit=${LIMIT}"
+    if [[ -n "$prefix" ]]; then
+        url="${url}&prefix=${prefix}"
+    fi
+
+    local response
+    response=$(curl "${CURL_OPTS[@]}" "$url") || { echo "ERROR: la petición de búsqueda falló"; exit 1; }
+
+    local total
+    total=$(echo "$response" | python3 -c "import sys,json; print(json.load(sys.stdin).get('total',0))")
+
+    echo "Encontrados ${total} iconos para '${query}':"
+    echo ""
+    echo "$response" | python3 -c "
+import sys, json
+data = json.load(sys.stdin)
+for icon in data.get('icons', []):
+    print(f'  {icon}')
+"
+    echo ""
+    echo "Genera con:      iconify_gen.sh <id-icono> <nombre-asset>"
+    echo "Previsualiza con: iconify_gen.sh preview <id-icono>"
+}
+
+list_collections() {
+    echo "Colecciones populares de Iconify:"
+    echo ""
+    local resp
+    resp=$(curl "${CURL_OPTS[@]}" "${API_BASE}/collections") || { echo "ERROR: no se pudo obtener la lista de colecciones"; exit 1; }
+    echo "$resp" | python3 -c "
+import sys, json
+data = json.load(sys.stdin)
+popular = ['mdi','lucide','tabler','ph','ri','carbon','solar','heroicons','bi','octicon','ion','fe','charm','ci','iconoir','basil','uil','mingcute','flowbite','mynaui']
+for k in popular:
+    if k in data:
+        v = data[k]
+        name = v.get('name','')
+        total = v.get('total',0)
+        print(f'  {k:12s} {name} ({total} iconos)')
+"
+    echo ""
+    echo "Lista completa: https://icon-sets.iconify.design/"
+}
+
+preview_icon() {
+    local icon_id="$1"
+    local collection="${icon_id%%:*}"
+    local name="${icon_id#*:}"
+    local url="${API_BASE}/${collection}/${name}.svg?width=136&height=136&color=%23${COLOR}"
+    local outfile="/tmp/iconify_preview_${collection}_${name}.svg"
+
+    curl "${CURL_OPTS[@]}" "$url" -o "$outfile" || { echo "ERROR: icono '${icon_id}' no encontrado"; exit 1; }
+    echo "SVG de previsualización: ${outfile}"
+    echo "URL: ${url}"
+
+    # Convertir también a PNG para la comprobación visual
+    local pngfile="/tmp/iconify_preview_${collection}_${name}.png"
+    sips -s format png "$outfile" --out "$pngfile" >/dev/null 2>&1 || echo "ADVERTENCIA: la conversión con sips falló; el PNG puede ser incorrecto"
+    echo "PNG de previsualización: ${pngfile}"
+}
+
+generate_icon() {
+    local icon_id="$1"
+    local asset_name="$2"
+    shift 2
+
+    while [[ $# -gt 0 ]]; do
+        case "$1" in
+            --size) require_value --size "${2-}"; SIZE="$2"; shift 2 ;;
+            --color) require_value --color "${2-}"; COLOR="$2"; shift 2 ;;
+            --output) require_value --output "${2-}"; OUTPUT="$2"; shift 2 ;;
+            *) shift ;;
+        esac
+    done
+
+    local collection="${icon_id%%:*}"
+    local name="${icon_id#*:}"
+    local imageset_dir="${OUTPUT}/${asset_name}.imageset"
+
+    mkdir -p "$imageset_dir"
+
+    echo "Generando ${asset_name} desde Iconify '${icon_id}':"
+
+    local scales=("1:${SIZE}" "2:$((SIZE * 2))" "3:$((SIZE * 3))")
+
+    for scale_info in "${scales[@]}"; do
+        local scale="${scale_info%%:*}"
+        local px="${scale_info#*:}"
+        local suffix=""
+        [[ "$scale" != "1" ]] && suffix="@${scale}x"
+
+        local svg_url="${API_BASE}/${collection}/${name}.svg?width=${px}&height=${px}&color=%23${COLOR}"
+        local svg_file="${imageset_dir}/${asset_name}${suffix}.svg"
+        local png_file="${imageset_dir}/${asset_name}${suffix}.png"
+
+        curl "${CURL_OPTS[@]}" "$svg_url" -o "$svg_file" || { echo "ERROR: no se pudo descargar el icono '${icon_id}'"; exit 1; }
+        sips -s format png "$svg_file" --out "$png_file" >/dev/null 2>&1 || echo "ADVERTENCIA: la conversión con sips puede haber fallado para ${svg_file}"
+        rm "$svg_file"
+
+        echo "  ${asset_name}${suffix}.png (${px}x${px})"
+    done
+
+    # Escribir Contents.json
+    cat > "${imageset_dir}/Contents.json" <<JSONEOF
+{
+  "images" : [
+    {
+      "filename" : "${asset_name}.png",
+      "idiom" : "universal",
+      "scale" : "1x"
+    },
+    {
+      "filename" : "${asset_name}@2x.png",
+      "idiom" : "universal",
+      "scale" : "2x"
+    },
+    {
+      "filename" : "${asset_name}@3x.png",
+      "idiom" : "universal",
+      "scale" : "3x"
+    }
+  ],
+  "info" : {
+    "author" : "xcode",
+    "version" : 1
+  }
+}
+JSONEOF
+
+    echo "Salida: ${imageset_dir}/"
+}
+
+# Principal
+[[ $# -eq 0 ]] && usage
+[[ "$1" == "--help" || "$1" == "-h" ]] && usage
+
+case "$1" in
+    search)
+        shift
+        [[ $# -eq 0 ]] && { echo "Uso: iconify_gen.sh search <consulta>"; exit 1; }
+        search_icons "$@"
+        ;;
+    preview)
+        shift
+        [[ $# -eq 0 ]] && { echo "Uso: iconify_gen.sh preview <id-icono>"; exit 1; }
+        preview_icon "$1"
+        ;;
+    collections)
+        list_collections
+        ;;
+    *)
+        [[ $# -lt 2 ]] && { echo "Uso: iconify_gen.sh <id-icono> <nombre-asset> [opciones]"; exit 1; }
+        generate_icon "$@"
+        ;;
+esac