docs: doc 12 blueprint Widget Builder (spec->widget Elementor PHP)

Fundamentado na API publica real do Elementor (Widget_Base, Controls_Manager,
Widgets_Manager, Elements_Manager, widget core Heading como exemplo) mais os
padroes de seguranca ja confirmados em codigo real Free (EMCP_Tools_Widget_Store/
Widget_Loader do doc06 - manifest-only, tamper guard sha256, path containment,
runtime_validate). O compilador spec->PHP em si (EMCP_Tools_Widget_Generator) e
a camada de abilities MCP continuam ausentes do build Free - marcado [REAL] vs
[DESENHO PROPRIO] em cada afirmacao do documento.

Recomenda 'zero tool de activacao via MCP' para set-widget-status, seguindo a
mesma filosofia ja confirmada no Themer PHP e nos PHP Snippets (aprovacao
humana obrigatoria antes de codigo gerado por IA correr em producao).

Actualiza INDEX.md com a 13a entrada e totais revistos.

docs/INDEX.md

@@ -1,11 +1,12 @@
 # EMCP Tools — Mapeamento completo e blueprint de réplica
 
-Índice e síntese de 12 documentos (~6 940 linhas), produzidos 19-08-2026 por leitura directa do
+Índice e síntese de 13 documentos (~7 810 linhas), produzidos 19-08-2026 por leitura directa do
 código-fonte `emcp-tools` v3.12.1 (build Free, `msrbuilds/elementor-mcp`, GPL-2.0-or-later),
 instalado em `emanuelalmeida.pt` (`/home/ealmeida/emanuelalmeida.pt/wp-content/plugins/emcp-tools/`),
-mais um doc adicional (11) fundamentado no WooCommerce 11.0.1 real instalado em
-`ecommerce.descomplicar.pt`. Cruzado com `skill://emcp-tools` (auditoria de postura de segurança
-viva nos 3 sites do ecossistema: `descomplicar.pt`, `emanuelalmeida.pt`, `starter.descomplicar.pt`).
+mais dois docs adicionais (11, WooCommerce; 12, Widget Builder) fundamentados noutro código real
+quando o EMCP Pro correspondente está ausente. Cruzado com `skill://emcp-tools` (auditoria de
+postura de segurança viva nos 3 sites do ecossistema: `descomplicar.pt`, `emanuelalmeida.pt`,
+`starter.descomplicar.pt`).
 
 **Objectivo desta série:** especificação funcional completa, ao nível de "o que este código faz e
 porquê", para servir de base a uma réplica própria — seja fork (GPL permite) seja reescrita limpa.
@@ -31,10 +32,12 @@ copiar-1:1 / simplificar / deixar de fora.
 | [09-STOCK-IMAGES-CLOUD-OAUTH](09-STOCK-IMAGES-CLOUD-OAUTH.md) | Unsplash/Pexels/Pixabay, EMCP Cloud (ligação/sync), servidor OAuth para MCP remoto | 654 | ~17 | Nenhuma |
 | [10-MODULOS-E-INVENTARIO-PRO](10-MODULOS-E-INVENTARIO-PRO.md) | Sistema de módulos (toggles), Image Optimization, SVG Support, **inventário definitivo das 30 classes Pro-only** | 661 | n/a + 30 ausentes | — (estrutural + auditoria) |
 | [11-WOOCOMMERCE-BLUEPRINT](11-WOOCOMMERCE-BLUEPRINT.md) | **Não é auditoria EMCP** — blueprint de abilities WooCommerce (produtos/encomendas/clientes/cupões/analytics/webhooks) fundamentado no WooCommerce real, para preencher o gap `EMCP_Tools_Woo_Integration` (Pro, código ausente). Exclui SEO/Yoast por pedido. | 878 | ~35 propostas | WooCommerce activo |
+| [12-WIDGET-BUILDER-BLUEPRINT](12-WIDGET-BUILDER-BLUEPRINT.md) | **Não é auditoria EMCP** — blueprint de gerador spec→widget-Elementor-PHP (marca `[REAL]`/`[DESENHO PRÓPRIO]` em cada afirmação), fundamentado na API pública `Widget_Base`/`Controls_Manager` do Elementor real + no `EMCP_Tools_Widget_Store`/`Widget_Loader` já Free/reais (doc 06). Recomenda "zero tool de activação via MCP", ecoando Themer PHP/Sandbox. | 651 | 8 propostas | Elementor activo |
 
-Total: **~6 940 linhas de documentação**, ~165 abilities EMCP confirmadas + ~35 abilities WooCommerce
-propostas (doc 11, não implementadas no EMCP — blueprint próprio) sobre **~128 465 linhas de PHP**
-do plugin `emcp-tools` (`~50k` das quais são o SDK Freemius bundled, irrelevante para réplica).
+Total: **~7 810 linhas de documentação**, ~165 abilities EMCP confirmadas + ~35 WooCommerce + 8
+Widget Builder propostas (docs 11-12, não implementadas no EMCP — blueprints próprios) sobre
+**~128 465 linhas de PHP** do plugin `emcp-tools` (`~50k` das quais são o SDK Freemius bundled,
+irrelevante para réplica).
 
 ---