Documenta sub-módulo site_tools_group_helpers e atualiza README principal

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

README.md

@@ -11,6 +11,7 @@ Módulo Drupal com ferramentas utilitárias reutilizáveis para outros módulos
 
 ## Sub-módulos
 
+- **site_tools_group_helpers**: Plugin `EntityReferenceSelection` que restringe campos de referência a grupos aos grupos dos quais o usuário atual é membro, com troca automática para o widget `options_select`. Requer o módulo contrib `group`.
 - **site_tools_msc_2020**: Widget de seleção em cascata (1–3 níveis) para o vocabulário MSC 2020, com carregamento eficiente dos 597 termos via `loadTree()` + consulta direta ao banco.
 - **site_tools_msc_2020_migrate**: Migrations para importação do vocabulário MSC 2020 a partir de CSV.
 

modules/site_tools_group_helpers/README.md

@@ -0,0 +1,50 @@
+# Site Tools — Group Helpers
+
+Sub-módulo do [Site Tools](../../README.md) com utilitários para integração com o módulo contrib [Group](https://www.drupal.org/project/group).
+
+## Requisitos
+
+- `site_tools`
+- `group` (contrib) ^3.0
+
+## Funcionalidades
+
+### Plugin de seleção: Member groups
+
+Plugin `EntityReferenceSelection` com id `site_tools_group_helpers` que restringe campos de referência à entidade `group` aos grupos dos quais o **usuário atual é membro**, em vez de listar todos os grupos do site.
+
+#### Como usar
+
+No formulário de configuração de um campo `entity_reference` com `target_type: group`, selecione **"Member groups (current user)"** em _Reference type_.
+
+Em YAML de configuração:
+
+```yaml
+handler: 'site_tools_group_helpers'
+handler_settings:
+  target_bundles: null   # null = qualquer tipo de grupo
+```
+
+O módulo também remove a obrigatoriedade de selecionar um tipo de grupo no formulário de configuração do campo, para campos que referenciam `group` — tanto neste handler quanto no handler padrão.
+
+### Troca automática de widget
+
+Ao configurar um campo para usar o handler `site_tools_group_helpers`, o módulo atualiza automaticamente todos os form displays daquele campo para o widget **`options_select`** (caixa de seleção), mais adequado quando o número de opções é pequeno.
+
+Ao reverter para outro handler, o widget é restaurado para `entity_reference_autocomplete`.
+
+## Instalação
+
+```bash
+drush en site_tools_group_helpers
+drush cr
+```
+
+Na instalação, o módulo verifica se há campos existentes já configurados com o handler `site_tools_group_helpers` (por exemplo, após importação de configuração) e aplica o widget `options_select` automaticamente.
+
+## Dependência em outros módulos
+
+```yaml
+dependencies:
+  - site_tools:site_tools_group_helpers
+```