/**
 * 官方精选数据库：ESP Component Registry 与 IDF Component Manager
 *
 * ESP Component Registry（https://components.espressif.com）是面向
 * ESP-IDF v4.4+ / v5.x+ 的模块化库的核心分发生态。
 */

export const CATEGORIAS_COMPONENTES = [
	{
		id: "todos",
		nome: "全部组件",
		icone: "Layers",
		descricao: "浏览完整的精选库与驱动目录"
	},
	{
		id: "ui_display",
		nome: "UI、显示屏与图形",
		icone: "Monitor",
		descricao: "图形库（LVGL）、LCD/OLED 显示驱动、触摸与解码器"
	},
	{
		id: "cloud_conectividade",
		nome: "云与网络连接",
		icone: "Cloud",
		descricao: "ESP RainMaker、AWS IoT、MQTT、WebSocket、Mesh-Lite 与 ESP-Hosted 协处理"
	},
	{
		id: "audio_voz_ia",
		nome: "音频、语音与 AI",
		icone: "Brain",
		descricao: "ESP-SR 语音识别、DSP 处理、编解码器、DVP 摄像头与 TinyML"
	},
	{
		id: "smart_home_mesh",
		nome: "智能家居与 Mesh",
		icone: "Home",
		descricao: "Matter SDK、Zigbee 3.0（ZBOSS）协议栈、Thread 与 ESP-NOW 网络"
	},
	{
		id: "drivers_perifericos",
		nome: "驱动与传感器",
		icone: "Cpu",
		descricao: "按键、编码器、RGB LED、以太网（W5500/CH390）、原生 USB 以及环境/IMU 传感器"
	},
	{
		id: "bsp_placas",
		nome: "BSP（板级支持包）",
		icone: "CircuitBoard",
		descricao: "对 ESP-BOX-3、Korvo、EYE 和 M5Stack 等官方开发板的直接支持包"
	},
	{
		id: "sistema_utilitarios",
		nome: "系统与工具",
		icone: "Wrench",
		descricao: "LittleFS 文件系统、现代 C++ 封装、CBOR 与网络工具"
	}
];

export const COMPONENTES_REGISTRY = [
	// ==========================================
	// 1. UI, Displays & Gráficos
	// ==========================================
	{
		id: "espressif-esp_lvgl_port",
		namespace: "espressif",
		name: "esp_lvgl_port",
		versao: "^2.4.0",
		categoria: "ui_display",
		oficial: true,
		popular: true,
		titulo: "ESP LVGL Port",
		descricao: "官方的线程安全 LVGL（Light and Versatile Graphics Library）移植，面向 ESP-IDF，支持硬件加速和多显示屏。",
		tags: ["LVGL", "GUI", "显示屏", "触摸", "人机界面"],
		chips: ["ESP32", "ESP32-S2", "ESP32-S3", "ESP32-P4", "ESP32-C3", "ESP32-C6"],
		dependenciasSugeridas: ["lvgl/lvgl^9.1.0"],
		urlRegistry: "https://components.espressif.com/components/espressif/esp_lvgl_port",
		urlRepo: "https://github.com/espressif/esp-bsp/tree/master/components/esp_lvgl_port",
		exemploYaml: `dependencies:
  espressif/esp_lvgl_port: "^2.4.0"
  lvgl/lvgl: "^9.1.0"`
	},
	{
		id: "lvgl-lvgl",
		namespace: "lvgl",
		name: "lvgl",
		versao: "^9.1.0",
		categoria: "ui_display",
		oficial: false,
		popular: true,
		titulo: "LVGL Graphics Library Core",
		descricao: "嵌入式系统中最流行的 C 语言开源图形库。提供丰富的控件、流畅的动画和现代化的布局支持。",
		tags: ["LVGL 9", "Graphics", "Widgets", "GUI", "Embedded UI"],
		chips: ["ESP32", "ESP32-S2", "ESP32-S3", "ESP32-P4", "ESP32-C3", "ESP32-C6"],
		urlRegistry: "https://components.espressif.com/components/lvgl/lvgl",
		urlRepo: "https://github.com/lvgl/lvgl",
		exemploYaml: `dependencies:
  lvgl/lvgl: "^9.1.0"`
	},
	{
		id: "espressif-esp32_display_panel",
		namespace: "espressif",
		name: "esp32_display_panel",
		versao: "^0.2.0",
		categoria: "ui_display",
		oficial: true,
		popular: true,
		titulo: "ESP32 Display Panel Driver",
		descricao: "统一的 LCD 控制器（RGB、SPI、QSPI、MIPI-DSI）与电容触摸驱动，专为 ESP32-S3 和 ESP32-P4 设计。",
		tags: ["LCD", "MIPI-DSI", "QSPI", "Touch", "ST7789", "ILI9341"],
		chips: ["ESP32-S3", "ESP32-P4", "ESP32-S2", "ESP32"],
		urlRegistry: "https://components.espressif.com/components/espressif/esp32_display_panel",
		urlRepo: "https://github.com/esp-arduino-libs/ESP32_Display_Panel",
		exemploYaml: `dependencies:
  espressif/esp32_display_panel: "^0.2.0"`
	},
	{
		id: "espressif-esp_lcd_touch",
		namespace: "espressif",
		name: "esp_lcd_touch",
		versao: "^1.1.2",
		categoria: "ui_display",
		oficial: true,
		popular: true,
		titulo: "ESP LCD Touch Framework",
		descricao: "触摸屏 LCD 触摸面板的核心抽象组件。支持坐标校准、多点触控读取，并可直接与 LVGL 集成。",
		tags: ["触摸屏", "电容式", "电阻式", "I2C 触摸", "坐标"],
		chips: ["ESP32", "ESP32-S2", "ESP32-S3", "ESP32-P4", "ESP32-C3", "ESP32-C6"],
		urlRegistry: "https://components.espressif.com/components/espressif/esp_lcd_touch",
		urlRepo: "https://github.com/espressif/esp-iot-solution/tree/master/components/display/touch_panel/esp_lcd_touch",
		exemploYaml: `dependencies:
  espressif/esp_lcd_touch: "^1.1.2"`
	},
	{
		id: "espressif-esp_lcd_touch_gt911",
		namespace: "espressif",
		name: "esp_lcd_touch_gt911",
		versao: "^1.1.2",
		categoria: "ui_display",
		oficial: true,
		popular: true,
		titulo: "GT911 电容触摸驱动",
		descricao: "专用于 Goodix GT911 电容触摸控制器的 I2C 驱动，广泛用于 ESP32-S3 和 P4 的 4.3\"、5\" 和 7\" 显示屏。",
		tags: ["GT911", "Goodix", "电容触摸", "多点触控", "I2C"],
		chips: ["ESP32", "ESP32-S3", "ESP32-P4", "ESP32-S2"],
		urlRegistry: "https://components.espressif.com/components/espressif/esp_lcd_touch_gt911",
		urlRepo: "https://github.com/espressif/esp-iot-solution/tree/master/components/display/touch_panel/esp_lcd_touch_gt911",
		exemploYaml: `dependencies:
  espressif/esp_lcd_touch_gt911: "^1.1.2"`
	},
	{
		id: "espressif-esp_lcd_touch_ft5x06",
		namespace: "espressif",
		name: "esp_lcd_touch_ft5x06",
		versao: "^1.1.0",
		categoria: "ui_display",
		oficial: true,
		popular: false,
		titulo: "FocalTech FT5x06 / FT6x36 触摸驱动",
		descricao: "面向 FocalTech 控制器（FT5206、FT5316、FT5436、FT6236、FT6336）的电容触摸面板驱动，支持手势和中断。",
		tags: ["FT6236", "FT5x06", "FocalTech", "触摸", "I2C"],
		chips: ["ESP32", "ESP32-S3", "ESP32-P4", "ESP32-S2", "ESP32-C3"],
		urlRegistry: "https://components.espressif.com/components/espressif/esp_lcd_touch_ft5x06",
		urlRepo: "https://github.com/espressif/esp-iot-solution/tree/master/components/display/touch_panel/esp_lcd_touch_ft5x06",
		exemploYaml: `dependencies:
  espressif/esp_lcd_touch_ft5x06: "^1.1.0"`
	},
	{
		id: "espressif-esp_jpeg",
		namespace: "espressif",
		name: "esp_jpeg",
		versao: "^1.3.0",
		categoria: "ui_display",
		oficial: true,
		popular: false,
		titulo: "ESP JPEG Decoder (TJpgDec)",
		descricao: "高速 JPEG 编解码器，带有汇编 SIMD 优化，可在显示屏上无延迟地显示图像和摄像头视频流。",
		tags: ["JPEG", "TJpgDec", "摄像头", "图像", "SIMD"],
		chips: ["ESP32", "ESP32-S3", "ESP32-P4", "ESP32-C3"],
		urlRegistry: "https://components.espressif.com/components/espressif/esp_jpeg",
		urlRepo: "https://github.com/espressif/esp-jpeg",
		exemploYaml: `dependencies:
  espressif/esp_jpeg: "^1.3.0"`
	},

	// ==========================================
	// 2. Cloud & Conectividade
	// ==========================================
	{
		id: "espressif-esp_rainmaker",
		namespace: "espressif",
		name: "esp_rainmaker",
		versao: "^1.4.0",
		categoria: "cloud_conectividade",
		oficial: true,
		popular: true,
		titulo: "ESP RainMaker Agent",
		descricao: "乐鑫 ESP RainMaker AIoT 云平台的官方固件代理。支持手机 App、Alexa、Google Home 控制以及 OTA。",
		tags: ["RainMaker", "AWS Cloud", "iOS/Android App", "Alexa", "Google Home", "OTA"],
		chips: ["ESP32", "ESP32-S2", "ESP32-S3", "ESP32-C3", "ESP32-C6"],
		urlRegistry: "https://components.espressif.com/components/espressif/esp_rainmaker",
		urlRepo: "https://github.com/espressif/esp-rainmaker",
		exemploYaml: `dependencies:
  espressif/esp_rainmaker: "^1.4.0"`
	},
	{
		id: "espressif-mesh_lite",
		namespace: "espressif",
		name: "mesh_lite",
		versao: "^1.2.0",
		categoria: "cloud_conectividade",
		oficial: true,
		popular: true,
		titulo: "ESP Mesh-Lite Network Stack",
		descricao: "轻量级 Wi-Fi Mesh 网络，每个节点都有独立的 IP 连接，可在局域网内直接通信，并通过多跳访问云端。",
		tags: ["Mesh", "Wi-Fi Mesh", "Mesh 网络", "分布式 IoT", "IP Layer"],
		chips: ["ESP32", "ESP32-S2", "ESP32-S3", "ESP32-C3", "ESP32-C6"],
		urlRegistry: "https://components.espressif.com/components/espressif/mesh_lite",
		urlRepo: "https://github.com/espressif/esp-mesh-lite",
		exemploYaml: `dependencies:
  espressif/mesh_lite: "^1.2.0"`
	},
	{
		id: "espressif-esp_modbus",
		namespace: "espressif",
		name: "esp_modbus",
		versao: "^1.0.15",
		categoria: "cloud_conectividade",
		oficial: true,
		popular: true,
		titulo: "ESP-Modbus Industrial Stack",
		descricao: "完整的工业 Modbus 协议栈（主站/从站），支持 RS-485（RTU/ASCII）以及以太网/Wi-Fi（Modbus TCP）接口。",
		tags: ["Modbus", "RS-485", "Modbus TCP", "工业自动化", "PLC"],
		chips: ["ESP32", "ESP32-S3", "ESP32-C3", "ESP32-C6", "ESP32-P4"],
		urlRegistry: "https://components.espressif.com/components/espressif/esp_modbus",
		urlRepo: "https://github.com/espressif/esp-modbus",
		exemploYaml: `dependencies:
  espressif/esp_modbus: "^1.0.15"`
	},
	{
		id: "espressif-net_connect",
		namespace: "espressif",
		name: "net_connect",
		versao: "^1.0.0",
		categoria: "cloud_conectividade",
		oficial: true,
		popular: false,
		titulo: "Unified Network Connect",
		descricao: "统一的网络连接管理组件，可透明地切换并初始化 Wi-Fi、以太网、Thread 或移动 PPP。",
		tags: ["Network", "Wi-Fi", "Ethernet", "故障切换", "自动连接"],
		chips: ["ESP32", "ESP32-S2", "ESP32-S3", "ESP32-C3", "ESP32-C6", "ESP32-P4"],
		urlRegistry: "https://components.espressif.com/components/espressif/net_connect",
		urlRepo: "https://github.com/espressif/esp-idf/tree/master/components",
		exemploYaml: `dependencies:
  espressif/net_connect: "^1.0.0"`
	},
	{
		id: "espressif-esp_hosted",
		namespace: "espressif",
		name: "esp_hosted",
		versao: "^0.0.10",
		categoria: "cloud_conectividade",
		oficial: true,
		popular: false,
		titulo: "ESP-Hosted Coprocessor",
		descricao: "把 ESP32 变成无线通信协处理器（Wi-Fi + BLE），供 Linux 主机（Raspberry Pi、i.MX）或通过 SPI/SDIO/UART 连接的微控制器使用。",
		tags: ["协处理器", "SDIO", "SPI", "Linux Wi-Fi", "Raspberry Pi"],
		chips: ["ESP32", "ESP32-S3", "ESP32-C3", "ESP32-C6"],
		urlRegistry: "https://components.espressif.com/components/espressif/esp_hosted",
		urlRepo: "https://github.com/espressif/esp-hosted",
		exemploYaml: `dependencies:
  espressif/esp_hosted: "^0.0.10"`
	},
	{
		id: "espressif-esp-now",
		namespace: "espressif",
		name: "esp-now",
		versao: "^2.5.0",
		categoria: "cloud_conectividade",
		oficial: true,
		popular: true,
		titulo: "ESP-NOW Enhanced & Provisioning",
		descricao: "ESP-NOW 协议的扩展，提供遥控配对、AES-128 安全以及多设备控制等高级功能。",
		tags: ["ESP-NOW", "无线", "低延迟", "广播", "遥控"],
		chips: ["ESP32", "ESP32-S2", "ESP32-S3", "ESP32-C3", "ESP32-C6"],
		urlRegistry: "https://components.espressif.com/components/espressif/esp-now",
		urlRepo: "https://github.com/espressif/esp-now",
		exemploYaml: `dependencies:
  espressif/esp-now: "^2.5.0"`
	},

	// ==========================================
	// 3. Áudio, Voz & IA
	// ==========================================
	{
		id: "espressif-esp-sr",
		namespace: "espressif",
		name: "esp-sr",
		versao: "^1.5.0",
		categoria: "audio_voz_ia",
		oficial: true,
		popular: true,
		titulo: "ESP-SR Speech Recognition",
		descricao: "100% 离线的语音识别框架，包含 WakeNet（唤醒词）、MultiNet（本地命令）和 AFE 声学算法。",
		tags: ["语音", "WakeNet", "MultiNet", "语音识别", "离线", "AEC"],
		chips: ["ESP32-S3", "ESP32-P4", "ESP32"],
		urlRegistry: "https://components.espressif.com/components/espressif/esp-sr",
		urlRepo: "https://github.com/espressif/esp-sr",
		exemploYaml: `dependencies:
  espressif/esp-sr: "^1.5.0"`
	},
	{
		id: "espressif-esp_codec_dev",
		namespace: "espressif",
		name: "esp_codec_dev",
		versao: "^1.3.0",
		categoria: "audio_voz_ia",
		oficial: true,
		popular: true,
		titulo: "ESP Audio Codec Device HAL",
		descricao: "统一的 I2S/I2C 音频编解码器抽象层（ES8311、ES8388、ES7210、ES7243、TAS5805M），用于立体声输入输出。",
		tags: ["Audio Codec", "I2S", "ES8311", "ES8388", "麦克风 DAC"],
		chips: ["ESP32", "ESP32-S3", "ESP32-P4", "ESP32-C3", "ESP32-C6"],
		urlRegistry: "https://components.espressif.com/components/espressif/esp_codec_dev",
		urlRepo: "https://github.com/espressif/esp-codec-dev",
		exemploYaml: `dependencies:
  espressif/esp_codec_dev: "^1.3.0"`
	},
	{
		id: "espressif-es8311",
		namespace: "espressif",
		name: "es8311",
		versao: "^1.0.0",
		categoria: "audio_voz_ia",
		oficial: true,
		popular: true,
		titulo: "ES8311 音频编解码器驱动",
		descricao: "面向 Everest ES8311 编解码器（单声道 DAC + 麦克风 ADC）的专用低功耗驱动，见于 ESP32-S3-BOX 和 IoT 开发板。",
		tags: ["ES8311", "音频", "DAC", "麦克风", "I2S"],
		chips: ["ESP32", "ESP32-S3", "ESP32-P4", "ESP32-C3"],
		urlRegistry: "https://components.espressif.com/components/espressif/es8311",
		urlRepo: "https://github.com/espressif/esp-bsp/tree/master/components/es8311",
		exemploYaml: `dependencies:
  espressif/es8311: "^1.0.0"`
	},
	{
		id: "espressif-esp32-camera",
		namespace: "espressif",
		name: "esp32-camera",
		versao: "^2.0.12",
		categoria: "audio_voz_ia",
		oficial: true,
		popular: true,
		titulo: "ESP32 Camera Driver",
		descricao: "官方 CMOS 摄像头驱动（OV2640、OV3660、OV5640、OV7670、GC0308），支持 DMA、DMA-2D、JPEG 捕获，以及通过 HTTP/RTSP 的 MJPEG 流。",
		tags: ["摄像头", "OV2640", "OV5640", "DVP", "MIPI-CSI", "视频"],
		chips: ["ESP32", "ESP32-S3", "ESP32-P4", "ESP32-S2"],
		urlRegistry: "https://components.espressif.com/components/espressif/esp32-camera",
		urlRepo: "https://github.com/espressif/esp32-camera",
		exemploYaml: `dependencies:
  espressif/esp32-camera: "^2.0.12"`
	},
	{
		id: "espressif-esp-dsp",
		namespace: "espressif",
		name: "esp-dsp",
		versao: "^1.5.1",
		categoria: "audio_voz_ia",
		oficial: true,
		popular: true,
		titulo: "ESP-DSP Signal Processing",
		descricao: "面向 ESP32 SoC 的官方数字信号处理库（FFT、FIR/IIR 数字滤波器、矩阵与加速的线性代数）。",
		tags: ["DSP", "FFT", "滤波器", "数学", "SIMD", "汇编"],
		chips: ["ESP32", "ESP32-S3", "ESP32-P4", "ESP32-C3", "ESP32-C6"],
		urlRegistry: "https://components.espressif.com/components/espressif/esp-dsp",
		urlRepo: "https://github.com/espressif/esp-dsp",
		exemploYaml: `dependencies:
  espressif/esp-dsp: "^1.5.1"`
	},
	{
		id: "espressif-esp-nn",
		namespace: "espressif",
		name: "esp-nn",
		versao: "^1.2.0",
		categoria: "audio_voz_ia",
		oficial: true,
		popular: true,
		titulo: "ESP-NN Neural Network Kernels",
		descricao: "用向量汇编优化的内核，在 ESP32 芯片上加速神经网络和 TensorFlow Lite Micro 模型。",
		tags: ["TinyML", "TensorFlow Lite", "神经网络", "推理", "Edge AI"],
		chips: ["ESP32-S3", "ESP32-P4", "ESP32"],
		urlRegistry: "https://components.espressif.com/components/espressif/esp-nn",
		urlRepo: "https://github.com/espressif/esp-nn",
		exemploYaml: `dependencies:
  espressif/esp-nn: "^1.2.0"`
	},

	// ==========================================
	// 4. Smart Home & Mesh
	// ==========================================
	{
		id: "espressif-esp-matter",
		namespace: "espressif",
		name: "esp-matter",
		versao: "^1.3.0",
		categoria: "smart_home_mesh",
		oficial: true,
		popular: true,
		titulo: "ESP Matter SDK",
		descricao: "官方 SDK，用于创建可在 Wi-Fi 和 Thread 上与 Apple Home、Google Home、Amazon Alexa 和 Home Assistant 互操作的设备。",
		tags: ["Matter", "智能家居", "Apple HomeKit", "Google Home", "Thread", "CHIP"],
		chips: ["ESP32", "ESP32-S3", "ESP32-C3", "ESP32-C6", "ESP32-H2"],
		urlRegistry: "https://components.espressif.com/components/espressif/esp-matter",
		urlRepo: "https://github.com/espressif/esp-matter",
		exemploYaml: `dependencies:
  espressif/esp-matter: "^1.3.0"`
	},
	{
		id: "espressif-esp-zigbee-lib",
		namespace: "espressif",
		name: "esp-zigbee-lib",
		versao: "^1.6.0",
		categoria: "smart_home_mesh",
		oficial: true,
		popular: true,
		titulo: "ESP Zigbee 3.0 Library",
		descricao: "经过认证的 Zigbee 3.0 协议栈（ZBOSS），用于在 802.15.4 芯片上创建低功耗的协调器、路由器和终端设备节点。",
		tags: ["Zigbee 3.0", "ZBOSS", "802.15.4", "Home Automation", "电池供电"],
		chips: ["ESP32-H2", "ESP32-C6"],
		urlRegistry: "https://components.espressif.com/components/espressif/esp-zigbee-lib",
		urlRepo: "https://github.com/espressif/esp-zigbee-sdk",
		exemploYaml: `dependencies:
  espressif/esp-zigbee-lib: "^1.6.0"`
	},
	{
		id: "espressif-esp_rcp_update",
		namespace: "espressif",
		name: "esp_rcp_update",
		versao: "^1.0.0",
		categoria: "smart_home_mesh",
		oficial: true,
		popular: false,
		titulo: "ESP RCP Thread/Zigbee Gateway",
		descricao: "用于更新 802.15.4 射频协处理器（RCP）的组件，用来构建 Thread 边界路由器和多协议 Zigbee 网关。",
		tags: ["Thread Border Router", "OpenThread", "RCP", "Zigbee Gateway"],
		chips: ["ESP32-H2", "ESP32-C6", "ESP32-S3"],
		urlRegistry: "https://components.espressif.com/components/espressif/esp_rcp_update",
		urlRepo: "https://github.com/espressif/esp-thread-br",
		exemploYaml: `dependencies:
  espressif/esp_rcp_update: "^1.0.0"`
	},

	// ==========================================
	// 5. Drivers & Sensores
	// ==========================================
	{
		id: "espressif-led_indicator",
		namespace: "espressif",
		name: "led_indicator",
		versao: "^1.2.0",
		categoria: "drivers_perifericos",
		oficial: true,
		popular: true,
		titulo: "LED Indicator Driver",
		descricao: "智能的 LED 灯效控制驱动（快闪、呼吸/渐变、错误码和 RGB），不会阻塞主循环。",
		tags: ["LED", "PWM", "RGB", "闪烁", "视觉反馈"],
		chips: ["ESP32", "ESP32-S2", "ESP32-S3", "ESP32-C2", "ESP32-C3", "ESP32-C6", "ESP32-H2", "ESP32-P4"],
		urlRegistry: "https://components.espressif.com/components/espressif/led_indicator",
		urlRepo: "https://github.com/espressif/esp-iot-solution/tree/master/components/led/led_indicator",
		exemploYaml: `dependencies:
  espressif/led_indicator: "^1.2.0"`
	},
	{
		id: "espressif-button",
		namespace: "espressif",
		name: "button",
		versao: "^3.4.0",
		categoria: "drivers_perifericos",
		oficial: true,
		popular: true,
		titulo: "IoT Button Handler (iot_button)",
		descricao: "完整的按键管理器，支持消抖、单击、双击、多击、长按事件以及矩阵键盘。",
		tags: ["按键", "消抖", "Long Press", "Double Click", "GPIO"],
		chips: ["ESP32", "ESP32-S2", "ESP32-S3", "ESP32-C3", "ESP32-C6", "ESP32-H2", "ESP32-P4"],
		urlRegistry: "https://components.espressif.com/components/espressif/button",
		urlRepo: "https://github.com/espressif/esp-iot-solution/tree/master/components/button",
		exemploYaml: `dependencies:
  espressif/button: "^3.4.0"`
	},
	{
		id: "espressif-led_strip",
		namespace: "espressif",
		name: "led_strip",
		versao: "^2.5.4",
		categoria: "drivers_perifericos",
		oficial: true,
		popular: true,
		titulo: "Addressable LED Strip (WS2812/SK6812)",
		descricao: "高性能驱动，使用 RMT 或 SPI 外设控制 WS2812、WS2813 和 SK6812 可寻址 LED 灯带与灯阵。",
		tags: ["WS2812B", "Neopixel", "SK6812", "RMT", "LED 灯带", "RGB"],
		chips: ["ESP32", "ESP32-S2", "ESP32-S3", "ESP32-C3", "ESP32-C6", "ESP32-P4"],
		urlRegistry: "https://components.espressif.com/components/espressif/led_strip",
		urlRepo: "https://github.com/espressif/idf-extra-components/tree/master/led_strip",
		exemploYaml: `dependencies:
  espressif/led_strip: "^2.5.4"`
	},
	{
		id: "espressif-esp_tinyusb",
		namespace: "espressif",
		name: "esp_tinyusb",
		versao: "^1.5.0",
		categoria: "drivers_perifericos",
		oficial: true,
		popular: true,
		titulo: "ESP Native USB Device (TinyUSB)",
		descricao: "乐鑫为 ESP32-S2、ESP32-S3 和 ESP32-P4 提供的官方 TinyUSB 扩展，可模拟 USB CDC 串口、HID 键盘/鼠标、MSC 优盘、DFU 和 WebUSB。",
		tags: ["原生 USB", "TinyUSB", "USB CDC", "USB HID", "WebUSB", "MSC"],
		chips: ["ESP32-S2", "ESP32-S3", "ESP32-P4"],
		urlRegistry: "https://components.espressif.com/components/espressif/esp_tinyusb",
		urlRepo: "https://github.com/espressif/esp-tinyusb",
		exemploYaml: `dependencies:
  espressif/esp_tinyusb: "^1.5.0"`
	},
	{
		id: "espressif-w5500",
		namespace: "espressif",
		name: "w5500",
		versao: "^1.2.0",
		categoria: "drivers_perifericos",
		oficial: true,
		popular: true,
		titulo: "WIZnet W5500 SPI Ethernet Driver",
		descricao: "通过 SPI 总线驱动 WIZnet W5500 以太网芯片的官方驱动，把物理接口无缝接入 ESP-IDF 原生 TCP/IP 协议栈（lwIP）。",
		tags: ["W5500", "Ethernet", "SPI Ethernet", "RJ45", "lwIP", "有线网络"],
		chips: ["ESP32", "ESP32-S2", "ESP32-S3", "ESP32-C3", "ESP32-C6", "ESP32-P4"],
		urlRegistry: "https://components.espressif.com/components/espressif/w5500",
		urlRepo: "https://github.com/espressif/esp-eth-drivers/tree/master/w5500",
		exemploYaml: `dependencies:
  espressif/w5500: "^1.2.0"`
	},
	{
		id: "espressif-ch390",
		namespace: "espressif",
		name: "ch390",
		versao: "^1.0.0",
		categoria: "drivers_perifericos",
		oficial: true,
		popular: false,
		titulo: "CH390 SPI Ethernet Driver",
		descricao: "面向 WCH CH390 控制器的 SPI 10/100M 以太网驱动，适合在 ESP32-C3、S3 或 P4 开发板上低成本添加 RJ45 网口。",
		tags: ["CH390", "Ethernet", "WCH", "SPI Ethernet", "RJ45"],
		chips: ["ESP32", "ESP32-S3", "ESP32-C3", "ESP32-C6", "ESP32-P4"],
		urlRegistry: "https://components.espressif.com/components/espressif/ch390",
		urlRepo: "https://github.com/espressif/esp-eth-drivers/tree/master/ch390",
		exemploYaml: `dependencies:
  espressif/ch390: "^1.0.0"`
	},
	{
		id: "espressif-usb_host_uvc",
		namespace: "espressif",
		name: "usb_host_uvc",
		versao: "^1.0.4",
		categoria: "drivers_perifericos",
		oficial: true,
		popular: false,
		titulo: "USB Host UVC (Webcam Driver)",
		descricao: "USB Host 驱动，可把标准 USB UVC 网络摄像头直接接到 ESP32-S2、ESP32-S3 或 ESP32-P4 的原生 USB 口。",
		tags: ["USB Host", "UVC", "Webcam", "USB 摄像头", "视频"],
		chips: ["ESP32-S2", "ESP32-S3", "ESP32-P4"],
		urlRegistry: "https://components.espressif.com/components/espressif/usb_host_uvc",
		urlRepo: "https://github.com/espressif/esp-iot-solution/tree/master/components/usb/usb_host_uvc",
		exemploYaml: `dependencies:
  espressif/usb_host_uvc: "^1.0.4"`
	},
	{
		id: "espressif-sensor_hub",
		namespace: "espressif",
		name: "sensor_hub",
		versao: "^1.0.0",
		categoria: "drivers_perifericos",
		oficial: true,
		popular: false,
		titulo: "ESP Sensor Hub Manager",
		descricao: "统一的框架，用于管理异构传感器（I2C/SPI），支持周期采样、数据融合以及由事件/中断触发。",
		tags: ["传感器", "Sensor Hub", "I2C", "事件", "周期采集"],
		chips: ["ESP32", "ESP32-S2", "ESP32-S3", "ESP32-C3", "ESP32-C6", "ESP32-P4"],
		urlRegistry: "https://components.espressif.com/components/espressif/sensor_hub",
		urlRepo: "https://github.com/espressif/esp-iot-solution/tree/master/components/sensors/sensor_hub",
		exemploYaml: `dependencies:
  espressif/sensor_hub: "^1.0.0"`
	},
	{
		id: "espressif-bmi270_sensor",
		namespace: "espressif",
		name: "bmi270_sensor",
		versao: "^1.0.1",
		categoria: "drivers_perifericos",
		oficial: true,
		popular: false,
		titulo: "Bosch BMI270 IMU 传感器驱动",
		descricao: "面向 Bosch BMI270 六轴惯性 IMU 传感器（加速度计 + 陀螺仪）的官方驱动，支持运动手势和计步检测。",
		tags: ["BMI270", "IMU", "加速度计", "陀螺仪", "Bosch", "手势"],
		chips: ["ESP32", "ESP32-S3", "ESP32-C3", "ESP32-C6", "ESP32-P4"],
		urlRegistry: "https://components.espressif.com/components/espressif/bmi270_sensor",
		urlRepo: "https://github.com/espressif/esp-iot-solution/tree/master/components/sensors/imu/bmi270",
		exemploYaml: `dependencies:
  espressif/bmi270_sensor: "^1.0.1"`
	},
	{
		id: "espressif-ds18b20",
		namespace: "espressif",
		name: "ds18b20",
		versao: "^1.0.0",
		categoria: "drivers_perifericos",
		oficial: true,
		popular: true,
		titulo: "DS18B20 温度传感器驱动",
		descricao: "面向 Dallas/Maxim DS18B20 单总线（1-Wire）温度传感器的数字驱动，通过 RMT 总线支持在同一个 GPIO 引脚上挂接多个传感器。",
		tags: ["DS18B20", "1-Wire", "温度", "传感器", "Dallas"],
		chips: ["ESP32", "ESP32-S2", "ESP32-S3", "ESP32-C3", "ESP32-C6", "ESP32-P4"],
		urlRegistry: "https://components.espressif.com/components/espressif/ds18b20",
		urlRepo: "https://github.com/espressif/esp-iot-solution/tree/master/components/sensors/temperature/ds18b20",
		exemploYaml: `dependencies:
  espressif/ds18b20: "^1.0.0"`
	},
	{
		id: "esp-idf-lib-scd4x",
		namespace: "esp-idf-lib",
		name: "scd4x",
		versao: "^1.0.0",
		categoria: "drivers_perifericos",
		oficial: false,
		popular: true,
		titulo: "Sensirion SCD40/SCD41 CO2 传感器驱动",
		descricao: "面向 Sensirion SCD40 和 SCD41 光声式 CO2、温度和相对湿度传感器的高精度 I2C 驱动，带自动校准。",
		tags: ["SCD40", "SCD41", "Sensirion", "CO2", "空气质量", "I2C"],
		chips: ["ESP32", "ESP32-S2", "ESP32-S3", "ESP32-C3", "ESP32-C6", "ESP32-H2", "ESP32-P4"],
		urlRegistry: "https://components.espressif.com/components/esp-idf-lib/scd4x",
		urlRepo: "https://github.com/UncleRus/esp-idf-lib/tree/master/components/scd4x",
		exemploYaml: `dependencies:
  esp-idf-lib/scd4x: "^1.0.0"`
	},

	// ==========================================
	// 6. BSPs (Board Support Packages)
	// ==========================================
	{
		id: "espressif-esp-box-3",
		namespace: "espressif",
		name: "esp-box-3",
		versao: "^1.2.0",
		categoria: "bsp_placas",
		oficial: true,
		popular: true,
		titulo: "BSP ESP32-S3-BOX-3",
		descricao: "面向 ESP32-S3-BOX-3 AI 开发板的完整支持包，只需一个函数即可初始化触摸屏、音频编解码器、双麦克风、运动传感器和 LED。",
		tags: ["BSP", "ESP-BOX-3", "触摸显示屏", "麦克风", "音频 ES8311", "I2C/SPI"],
		chips: ["ESP32-S3"],
		urlRegistry: "https://components.espressif.com/components/espressif/esp-box-3",
		urlRepo: "https://github.com/espressif/esp-bsp/tree/master/bsp/esp-box-3",
		exemploYaml: `dependencies:
  espressif/esp-box-3: "^1.2.0"`
	},
	{
		id: "espressif-esp32_s3_korvo_2",
		namespace: "espressif",
		name: "esp32_s3_korvo_2",
		versao: "^1.1.0",
		categoria: "bsp_placas",
		oficial: true,
		popular: false,
		titulo: "BSP ESP32-S3-Korvo-2",
		descricao: "面向 ESP32-S3-Korvo-2 音频与语音识别开发套件的板级支持包（Board Support Package），支持 I2S 麦克风和触摸按键。",
		tags: ["BSP", "Korvo", "音频", "麦克风阵列", "ESP-SR"],
		chips: ["ESP32-S3"],
		urlRegistry: "https://components.espressif.com/components/espressif/esp32_s3_korvo_2",
		urlRepo: "https://github.com/espressif/esp-bsp/tree/master/bsp/esp32_s3_korvo_2",
		exemploYaml: `dependencies:
  espressif/esp32_s3_korvo_2: "^1.1.0"`
	},
	{
		id: "espressif-esp32_s3_eye",
		namespace: "espressif",
		name: "esp32_s3_eye",
		versao: "^1.1.0",
		categoria: "bsp_placas",
		oficial: true,
		popular: true,
		titulo: "BSP ESP32-S3-EYE",
		descricao: "面向官方计算机视觉开发板 ESP32-S3-EYE 的板级支持包，配置 OV2640 摄像头、圆形 SPI LCD 显示屏和数字麦克风。",
		tags: ["BSP", "ESP32-S3-EYE", "摄像头", "计算机视觉", "显示屏"],
		chips: ["ESP32-S3"],
		urlRegistry: "https://components.espressif.com/components/espressif/esp32_s3_eye",
		urlRepo: "https://github.com/espressif/esp-bsp/tree/master/bsp/esp32_s3_eye",
		exemploYaml: `dependencies:
  espressif/esp32_s3_eye: "^1.1.0"`
	},
	{
		id: "espressif-m5stack_core_s3",
		namespace: "espressif",
		name: "m5stack_core_s3",
		versao: "^1.0.0",
		categoria: "bsp_placas",
		oficial: true,
		popular: true,
		titulo: "BSP M5Stack CoreS3",
		descricao: "面向 M5Stack CoreS3 设备的官方板级支持包，初始化触摸屏、AXP2101 电源管理芯片、GC0308 摄像头和 I2S 扬声器。",
		tags: ["BSP", "M5Stack", "CoreS3", "Display ILI9342C", "AXP2101", "摄像头"],
		chips: ["ESP32-S3"],
		urlRegistry: "https://components.espressif.com/components/espressif/m5stack_core_s3",
		urlRepo: "https://github.com/espressif/esp-bsp/tree/master/bsp/m5stack_core_s3",
		exemploYaml: `dependencies:
  espressif/m5stack_core_s3: "^1.0.0"`
	},
	{
		id: "waveshare-esp32_p4_wifi6_touch_lcd_7b",
		namespace: "waveshare",
		name: "esp32_p4_wifi6_touch_lcd_7b",
		versao: "^1.0.0",
		categoria: "bsp_placas",
		oficial: false,
		popular: true,
		titulo: "BSP Waveshare ESP32-P4 Touch LCD 7\"",
		descricao: "面向高性能 Waveshare ESP32-P4 开发板的支持包，配备 7 英寸电容触摸屏（MIPI-DSI 1024x600）和 Wi-Fi 6 协处理器。",
		tags: ["BSP", "ESP32-P4", "MIPI-DSI", "Waveshare", "7 英寸屏", "触摸"],
		chips: ["ESP32-P4"],
		urlRegistry: "https://components.espressif.com/components/waveshare/esp32_p4_wifi6_touch_lcd_7b",
		urlRepo: "https://github.com/waveshare/ESP32-P4-WiFi6-Touch-LCD-7B",
		exemploYaml: `dependencies:
  waveshare/esp32_p4_wifi6_touch_lcd_7b: "^1.0.0"`
	},

	// ==========================================
	// 7. Sistema & Utilitários
	// ==========================================
	{
		id: "joltwallet-littlefs",
		namespace: "joltwallet",
		name: "littlefs",
		versao: "^1.14.8",
		categoria: "sistema_utilitarios",
		oficial: false,
		popular: true,
		titulo: "LittleFS Filesystem for ESP-IDF",
		descricao: "面向 SPI 闪存的 LittleFS 文件系统的稳健移植，带动态磨损均衡和防断电损坏保护。",
		tags: ["LittleFS", "Flash", "Filesystem", "Wear Leveling", "NVS"],
		chips: ["ESP32", "ESP32-S2", "ESP32-S3", "ESP32-C3", "ESP32-C6", "ESP32-H2", "ESP32-P4"],
		urlRegistry: "https://components.espressif.com/components/joltwallet/littlefs",
		urlRepo: "https://github.com/joltwallet/esp_littlefs",
		exemploYaml: `dependencies:
  joltwallet/littlefs: "^1.14.8"`
	},
	{
		id: "espressif-esp-idf-cxx",
		namespace: "espressif",
		name: "esp-idf-cxx",
		versao: "^1.2.0",
		categoria: "sistema_utilitarios",
		oficial: true,
		popular: true,
		titulo: "ESP-IDF C++ Idiomatic Wrappers",
		descricao: "现代 C++（C++17/C++20/C++23）类与封装集合，采用 RAII 语义，覆盖 GPIO、Wi-Fi、定时器、FreeRTOS 队列和信号量。",
		tags: ["C++", "C++20", "RAII", "Modern C++", "面向对象", "FreeRTOS"],
		chips: ["ESP32", "ESP32-S2", "ESP32-S3", "ESP32-C3", "ESP32-C6", "ESP32-H2", "ESP32-P4"],
		urlRegistry: "https://components.espressif.com/components/espressif/esp-idf-cxx",
		urlRepo: "https://github.com/espressif/esp-idf-cxx",
		exemploYaml: `dependencies:
  espressif/esp-idf-cxx: "^1.2.0"`
	},
	{
		id: "espressif-cbor",
		namespace: "espressif",
		name: "cbor",
		versao: "^0.6.0",
		categoria: "sistema_utilitarios",
		oficial: true,
		popular: false,
		titulo: "TinyCBOR Serialization",
		descricao: "超轻量级库，用于 CBOR（Concise Binary Object Representation）二进制格式的数据序列化与反序列化。",
		tags: ["CBOR", "序列化", "二进制", "IoT Protocol", "紧凑 JSON"],
		chips: ["ESP32", "ESP32-S2", "ESP32-S3", "ESP32-C3", "ESP32-C6", "ESP32-H2", "ESP32-P4"],
		urlRegistry: "https://components.espressif.com/components/espressif/cbor",
		urlRepo: "https://github.com/espressif/tinycbor",
		exemploYaml: `dependencies:
  espressif/cbor: "^0.6.0"`
	},
	{
		id: "espressif-esp_websocket_client",
		namespace: "espressif",
		name: "esp_websocket_client",
		versao: "^1.2.4",
		categoria: "sistema_utilitarios",
		oficial: true,
		popular: true,
		titulo: "ESP WebSocket Client",
		descricao: "支持 TLS/SSL（WSS）、自动重连、子协议和 ping/pong 心跳的实时双向 WebSocket 客户端。",
		tags: ["WebSocket", "WSS", "TLS", "实时", "Sockets", "JSON"],
		chips: ["ESP32", "ESP32-S2", "ESP32-S3", "ESP32-C3", "ESP32-C6", "ESP32-P4"],
		urlRegistry: "https://components.espressif.com/components/espressif/esp_websocket_client",
		urlRepo: "https://github.com/espressif/esp-protocols/tree/master/components/esp_websocket_client",
		exemploYaml: `dependencies:
  espressif/esp_websocket_client: "^1.2.4"`
	}
];

export const GUIA_COMPONENT_MANAGER = {
	titulo: "如何在 ESP-IDF 中使用 ESP Component Registry",
	resumo: "从 ESP-IDF v4.4 开始，并在 v5.x 及以后版本中趋于成熟，乐鑫采用了由 IDF Component Manager 管理的模块化包架构。不用再处理复杂的 git 子模块：现在只需在项目的 idf_component.yml 清单文件中声明所需的库。",
	vantagens: [
		{
			titulo: "自动安装，彼此解耦",
			descricao: "在执行 'idf.py build' 或 'idf.py reconfigure' 时，编译系统会自动下载、编译并管理库的版本。"
		},
		{
			titulo: "严格的语义化版本",
			descricao: "通过版本运算符精确控制何时更新（^ 表示兼容次版本，~ 表示补丁版本，也可以固定为精确版本）。"
		},
		{
			titulo: "项目更轻量、更整洁",
			descricao: "项目仓库保持干净，Git 历史中不会混入第三方代码。"
		},
		{
			titulo: "面向企业或社区的共享",
			descricao: "可以把你自己的组件发布到乐鑫的公共云，也可以发布到公司内部的私有注册中心。"
		}
	],
	comandosCli: [
		{
			comando: 'idf.py add-dependency "namespace/componente^versao"',
			exemplo: 'idf.py add-dependency "espressif/esp_lvgl_port^2.4.0"',
			explicacao: "自动创建或更新 'main/idf_component.yml' 文件，并加入指定的依赖。"
		},
		{
			comando: "idf.py reconfigure",
			exemplo: "idf.py reconfigure",
			explicacao: "强制 CMake 和 Component Manager 重新解析依赖树，并下载尚未获取的包。"
		},
		{
			comando: "compote component upload --name <component_name> --namespace <sua_org>",
			exemplo: "compote component upload --name meu_driver_sensor --namespace minhadiv",
			explicacao: "使用官方的 Compote CLI 工具，把你的开源或专有组件发布到 ESP Component Registry。"
		}
	],
	sintaxeManifesto: `# 典型的文件结构：main/idf_component.yml
dependencies:
  # 从乐鑫官方注册中心下载
  espressif/esp_lvgl_port: "^2.4.0"
  espressif/button: "~3.4.0"
  
  # 精确版本
  espressif/led_indicator: "1.2.0"
  
  # 社区依赖
  joltwallet/littlefs: "^1.14.8"
  
  # 本地磁盘上的依赖（可选）
  # meu_driver_local:
  #   path: "../../components/meu_driver"`
};