Bibliotecas de recursos gráficos .bbart

Colecciones de recursos gráficos reutilizables gestionadas por el usuario. Basadas en JSON, sin contenido duplicado y autocontenidas.

Un archivo .bbart es una colección de elementos gráficos que quieres reutilizar en distintos proyectos: logotipos, adornos, formas habituales y selecciones capturadas. El panel Biblioteca de recursos gráficos permite cargarlos y editarlos.

A diferencia de los proyectos .lzrproj (que representan un único diseño en curso), los archivos .bbart son bibliotecas organizadas, concebidas para compartirlas, controlar sus versiones y reutilizarlas.

Contenido

Campo	Notas
`library_id`	UUID. Identifica la biblioteca de forma unívoca (no por el nombre del archivo).
`name`	Nombre para mostrar. Se puede editar.
`items[]`	Cada elemento tiene su propio identificador, tipo, geometría, miniaturas, etiquetas y categoría.

Tipos de elemento

Archivo externo: hace referencia a un archivo de imagen o vectorial de origen. El elemento contiene los bytes originales (sin duplicados según el hash del contenido dentro de la biblioteca).
Instantánea de selección: versión aplanada de una selección capturada en un proyecto. El texto se convierte en geometría, por lo que el destinatario no depende de las fuentes. Incluye source_text_metadata para poder volver a editarlo en el futuro.

Miniaturas

Cada elemento incluye en el archivo una miniatura generada por la interfaz. No es necesario renderizarla al cargar la biblioteca.

Eliminación de duplicados

En un mismo archivo .bbart, los bytes de ráster idénticos (según el hash del contenido) se almacenan una sola vez y varios elementos hacen referencia a ellos. Esto reduce el tamaño del archivo cuando vuelves a importar la misma imagen como varios elementos.

Lectura y escritura

Interfaz gráfica: el panel Biblioteca de recursos gráficos permite crear, cargar, guardar, importar y exportar.
CLI: actualmente no está disponible.

Beam Bench abre el archivo .bbart y lo mantiene en memoria mientras lo editas. Persistencia mediante escritura inmediata: cada acción que modifica la biblioteca escribe los cambios en el disco de inmediato. Si falla la escritura en el disco, la modificación se conserva en memoria, la biblioteca recibe un save_error y las operaciones destructivas quedan bloqueadas hasta que se vuelva a intentar.

Migración desde el JSON antiguo

Las bibliotecas *.json antiguas de los datos de la aplicación se migran automáticamente a archivos .bbart contiguos al iniciar por primera vez. El archivo .json original se conserva.

Compartir bibliotecas

Un archivo .bbart es portátil. Envíalo por correo electrónico o súbelo. El destinatario lo abre desde el panel Biblioteca de recursos gráficos → Cargar.

Si dos archivos .bbart comparten el mismo library_id (por ejemplo, porque has copiado uno), al cargar el segundo se reasigna su identificador, se genera uno nuevo, se reescribe el archivo y se muestra una advertencia. Esto evita que se produzcan colisiones de identificadores sin avisar.

Casos límite

Si falla el guardado (por los permisos del archivo, porque está bloqueado o porque el disco está lleno), la biblioteca muestra un error de guardado y desactiva las operaciones destructivas hasta que se pueda guardar correctamente. El estado no se revierte sin avisar.
Cambiar el nombre de un archivo .bbart en el disco solo modifica el nombre para mostrar. El library_id y el contenido permanecen intactos.
Dos archivos pueden tener el mismo nombre para mostrar siempre que sus library_id sean distintos.