Bibliothèques d’illustrations .bbart

Collections d’illustrations réutilisables gérées par l’utilisateur. Basées sur JSON, dédupliquées par contenu et autonomes.

Un fichier .bbart est une collection d’éléments graphiques que vous souhaitez réutiliser dans plusieurs projets : logos, décorations, formes courantes, sélections capturées. Le panneau Bibliothèque d’illustrations les charge et les modifie.

Contrairement aux projets .lzrproj (qui représentent une conception unique en cours), les fichiers .bbart sont des bibliothèques organisées, conçues pour le partage, le contrôle de version et la réutilisation.

Contenu

Champ	Remarques
`library_id`	UUID. Identifie la bibliothèque de manière unique (et non par le nom du fichier).
`name`	Nom d’affichage. Modifiable.
`items[]`	Chaque élément possède son propre identifiant, type, géométrie, miniatures, étiquettes et catégorie.

Types d’éléments

Fichier externe : référence une image source ou un fichier vectoriel. L’élément contient les octets d’origine (dédupliqués par hachage de contenu au sein de la bibliothèque).
Instantané de sélection : version aplatie d’une sélection capturée depuis un projet. Le texte est aplati en géométrie, sans dépendance aux polices pour le destinataire. Inclut source_text_metadata pour une réédition ultérieure.

Miniatures

Chaque élément possède une miniature générée par le frontend et intégrée au fichier. Aucun rendu en direct n’est nécessaire lors du chargement de la bibliothèque.

Déduplication

Dans un même fichier .bbart, des octets raster identiques (selon leur hachage de contenu) sont stockés une seule fois et référencés depuis plusieurs éléments. Cela réduit la taille du fichier lorsque vous réimportez la même image en tant que plusieurs éléments.

Lecture et écriture

GUI : le panneau Bibliothèque d’illustrations crée, charge, enregistre, importe et exporte.
CLI : non exposée actuellement.

Un fichier .bbart est ouvert par Beam Bench et reste en mémoire pendant sa modification. Persistance avec écriture immédiate : chaque action de modification est immédiatement écrite sur le disque. Si l’écriture sur disque échoue, la modification en mémoire est conservée, la bibliothèque reçoit un save_error, et les opérations destructives sont bloquées jusqu’à une nouvelle tentative.

Migration depuis l’ancien JSON

Les bibliothèques *.json héritées des données d’application migrent automatiquement vers des fichiers .bbart frères au premier lancement. Le fichier .json d’origine est conservé.

Partage de bibliothèques

Un fichier .bbart est portable. Envoyez-le par e-mail ou téléversez-le ; le destinataire l’ouvre avec le panneau Bibliothèque d’illustrations → Charger.

Si deux fichiers .bbart partagent le même library_id (par exemple, si vous en avez copié un), le second à être chargé est remappé, un nouvel identifiant est généré, le fichier est réécrit et un avertissement s’affiche. Cela évite silencieusement les collisions d’identifiants.

Cas particuliers

Si l’enregistrement échoue (autorisations de fichier, fichier verrouillé, disque plein), la bibliothèque affiche une erreur d’enregistrement et désactive les opérations destructives jusqu’à ce que le prochain enregistrement réussisse. L’état n’est pas annulé silencieusement.
Renommer un fichier .bbart sur le disque modifie uniquement le nom d’affichage. Le library_id et le contenu restent intacts.
Deux fichiers peuvent avoir le même nom d’affichage tant que leur library_id est différent.