.bbart bibliotecas de arte

Colecciones de obras reutilizables administradas por el usuario. Basadas en JSON, con contenido deduplicado y autocontenidas.

Un archivo .bbart es una colección de clips de arte que quieres reutilizar en varios proyectos: logotipos, decoraciones, formas comunes y selecciones capturadas. El panel Biblioteca de arte los carga y edita.

A diferencia de los proyectos .lzrproj (que representan un único diseño en progreso), los archivos .bbart son bibliotecas organizadas, diseñadas para compartir, controlar versiones y reutilizar.

Qué contiene

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

Tipos de elementos

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

Miniaturas

Cada elemento tiene una miniatura generada por el frontend incluida en el archivo. No se necesita una representación en vivo al cargar la biblioteca.

Deduplicación

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

Cómo leer y escribir

Interfaz gráfica: el panel Biblioteca de arte crea, carga, guarda, importa y exporta.
CLI: actualmente no está disponible.

Beam Bench abre un archivo .bbart y lo mantiene en memoria mientras se edita. Persistencia de escritura directa: cada acción que modifica datos se escribe inmediatamente en el disco. Si la escritura en disco falla, la modificación en memoria se conserva y la biblioteca recibe un save_error; las operaciones destructivas se bloquean hasta que se vuelva a intentar.

Migración desde JSON heredado

Las bibliotecas heredadas *.json de los datos de la aplicación se migran automáticamente a archivos .bbart hermanos durante el primer inicio. El .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 con el panel Biblioteca de arte → Cargar.

Si dos archivos .bbart comparten el mismo library_id (por ejemplo, si copiaste uno), el segundo que se cargue se reasigna: se genera un nuevo id, se vuelve a escribir el archivo y aparece una advertencia. Esto evita silenciosamente las colisiones de ids.

Casos límite

Si falla el guardado (por permisos de archivo, archivo bloqueado o disco lleno), la biblioteca muestra un error de guardado y deshabilita las operaciones destructivas hasta que el siguiente guardado se complete correctamente. El estado no se revierte silenciosamente.
Cambiar el nombre de un archivo .bbart en el disco solo cambia el nombre para mostrar. library_id y el contenido permanecen intactos.
El mismo nombre para mostrar en dos archivos no representa un problema siempre que sus library_id sean diferentes.