Docs: Restaurar capture_links y documentar error TypeScript intencional
All checks were successful
build-and-deploy / build-and-deploy (push) Successful in 56s

- Restaurar capture_links en PWA manifest (requerido para funcionamiento correcto)
- Agregar sección en README explicando error TS2353 intencional
- Documentar que capture_links es experimental pero funcional y necesario
- Incluir referencias a documentación oficial de la especificación

La propiedad capture_links es necesaria para capturar navegaciones
dentro del scope de la PWA en el ecosistema Nucleo V3.
This commit is contained in:
2025-10-17 16:52:21 -06:00
parent 40b0610ad9
commit 27dc90dfbe
2 changed files with 25 additions and 4 deletions

View File

@@ -1,6 +1,26 @@
# Nuxt Minimal Starter # Perfil Nucleo
Look at the [Nuxt documentation](https://nuxt.com/docs/getting-started/introduction) to learn more. Aplicación de perfil de usuario y launcher de aplicaciones para Nucleo V3.
## Errores de TypeScript Conocidos (Intencionales)
### `capture_links` en PWA Manifest (TS2353)
```
nuxt.config.ts(52,7): error TS2353: Object literal may only specify known properties, and 'capture_links' does not exist in type 'Partial<ManifestOptions>'.
```
**ESTE ERROR SE IGNORA INTENCIONALMENTE**
- `capture_links` es una propiedad **experimental** del Web App Manifest
- **NO está en los tipos oficiales de TypeScript** pero es completamente funcional en navegadores modernos
- Es **REQUERIDA** para el correcto funcionamiento de la PWA en el ecosistema Nucleo V3
- Permite capturar navegaciones dentro del scope de la aplicación
- Se debe mantener **SÍ O SÍ** aunque TypeScript reporte error
**Referencias:**
- [Web App Manifest - Capture Links (Experimental)](https://developer.mozilla.org/en-US/docs/Web/Manifest/capture_links)
- [WICG Manifest Incubations](https://github.com/WICG/manifest-incubations/blob/gh-pages/capture-links-explainer.md)
## Setup ## Setup

View File

@@ -47,8 +47,9 @@ export default defineNuxtConfig({
client_mode: 'navigate-existing' client_mode: 'navigate-existing'
}, },
// Capturar todos los enlaces que apunten a esta app // Capturar todos los enlaces que apunten a esta app
// NOTA: capture_links es experimental y no está en los tipos de ManifestOptions // NOTA: capture_links es experimental pero REQUERIDO para el funcionamiento correcto
// capture_links: 'existing-client-navigate', // TypeScript dará error TS2353 pero se ignora intencionalmente (ver README.md)
capture_links: 'existing-client-navigate',
// Extender scope a otros subdominios de Nucleo V3 // Extender scope a otros subdominios de Nucleo V3
scope_extensions: [ scope_extensions: [
{ {