@liquidcars/atlas 0.1.44 → 0.1.46

package/README.md

@@ -159,16 +159,33 @@ La misma funcionalidad puede controlarse explícitamente:
 
 ```js
 const atlas = document.querySelector("liquidcars-atlas");
-const frame = atlas.captureFrame(); // canvas 2D con el framebuffer actual
+const transparent = atlas.captureFrame(); // canvas 2D con alfa
+const themed = atlas.captureFrame({ background: "theme" }); // añade el fondo visual del componente
+const white = atlas.captureFrame({ background: "#ffffff" }); // fondo sólido opcional
+const presentation = atlas.captureFrame({ background: "transparent", scale: 2 }); // salida HD
+const copied = await atlas.copyFrame({ background: "theme", scale: 2 }); // portapapeles PNG
+const portable = await atlas.copyFrame({ background: "transparent", scale: 2, fallback: "download" });
 atlas.prepareForPrint();
 atlas.restoreAfterPrint();
 ```
 
 `captureFrame()` usa `WebGLRenderingContext.readPixels()` para funcionar también
 en navegadores que no permiten copiar directamente un canvas WebGL sin
-`preserveDrawingBuffer`. Para evitar que un bloque se divida entre páginas, el
+`preserveDrawingBuffer`. El framebuffer permanece transparente: el fondo de tema
+se compone en el canvas 2D únicamente cuando se solicita y no recibe luces ni
+sombras de la escena. `scale` vuelve a renderizar temporalmente entre 1× y 4×,
+respetando el límite de framebuffer del navegador, y restaura inmediatamente el
+canvas interactivo. Los colores WebGL semitransparentes se convierten de alfa
+premultiplicado a alfa directo para conservar el tono de los contenedores
+abiertos cuando el PNG se coloca sobre un fondo claro. Para evitar que un bloque se divida entre páginas, el
 componente aplica `break-inside: avoid` durante la impresión.
 
+La toolbar incorpora las variantes PNG con fondo y transparente. Ambas usan
+`copyFrame()` a resolución 2×; si el portapapeles de imágenes no está disponible,
+la acción descarga `atlas-view.png`. La API emite `lc-image-export` con el método
+empleado (`clipboard` o `download`) y `lc-image-export-error` si tampoco puede
+generar el archivo.
+
 ## Contrato de datos
 
 - `palette`: mapa de nombres de color a valores CSS/hex.