@tmf_ciclica/ciclicastorybook 1.2.164 → 1.2.166

package/README.md

@@ -25,6 +25,32 @@ export default defineConfig({
 })
 ```
 
+### Nombres de componentes legibles
+
+Cuando la app consumidora pre-bundla la librería con esbuild, los nombres de los
+componentes se renombran a identificadores minificados (`d0`, `d1`, ...), por lo
+que los warnings de React (como el de las `key`) muestran nombres encriptados.
+
+El build de la librería añade automáticamente `displayName` a todos los
+componentes exportados. Los strings no se renombran nunca, así que los warnings
+y stack traces de React mostrarán el nombre real del componente:
+
+```
+Warning: Each child in a list should have a unique "key" prop.
+Check the render method of `Legend`. It was passed a child from DataLayout.
+```
+
+No requiere configuración en la app consumidora: basta con usar la versión
+publicada de la librería.
+
+### Warnings de `key` en listas
+
+Si ves el warning `Each child in a list should have a unique "key" prop`, el
+problema está en un componente de la librería que renderiza una lista sin `key`
+o con `key` duplicada. Los componentes de la librería ya usan `key` correctas,
+pero si encuentras uno que no, el warning ahora te dirá **qué componente** es
+(gracias a los `displayName`), lo que facilita localizarlo y corregirlo.
+
 ### ErrorBoundary
 
 La librería exporta un `ErrorBoundary` que captura errores de los componentes y