Symboles

La bibliothèque Symboles : les onze bibliothèques système et Mes symboles, la recherche et les filtres de la galerie, l'inspecteur avec ses entrées vivantes et ses bornes, l'éditeur Nouveau symbole utilisateur et chaque nature de zone active, Importer un symbole…, Exporter le paquet, Dupliquer, Copier l'instruction de conversation, et où un symbole est utilisé.

Symboles est la quatrième catégorie sous la racine Ressources : le dessin qu'un composant Symbol de tableau de bord dessine et anime. Le volet est intitulé « Symboles », avec la ligne « Des bibliothèques conçues pour les tableaux de bord modernes, les bancs d'essai, les produits connectés, les schémas normalisés, les systèmes industriels et les installations. Chaque symbole système est inspectable et peut être dupliqué dans Mes symboles. » et le badge de comptage. Lire et inspecter demandent Voir Logic; créer, importer, dupliquer, modifier et supprimer demandent Configurer Logic. Le format de fichier dans lequel un symbole voyage est décrit dans Symboles SVG portables.

Les bibliothèques

Les bibliothèques système sont des dessins Ganter Lab originaux, compilés dans le produit et en lecture seule : une mise à jour les remplace sans toucher aux données de votre station. Chaque définition porte une référence stable system:<clé>, sa bibliothèque et sa catégorie, une description, des étiquettes de recherche, la norme qui s'y applique, et des métadonnées d'origine et de licence.

La galerie

Au-dessus des cartes : Rechercher (texte d'exemple « Nom, catégorie ou étiquette »; la recherche compare le nom, la description, la catégorie, la norme et les étiquettes du symbole, sans tenir compte de la casse; la bibliothèque se choisit avec son propre filtre), Bibliothèque (« Toutes les bibliothèques (530) » ou une bibliothèque avec son compte; en choisir une efface la catégorie et affiche la description de la bibliothèque sous les filtres), Catégorie (« Toutes les catégories » ou une catégorie de la bibliothèque choisie), Origine et Par page. Une carte montre la bibliothèque, un aperçu au format naturel du dessin, le nom, la catégorie, l'origine (Système ou Les miens) et une ligne de capacités : « Statique », « 1 entrée » ou « N entrées », suivies de « · N borne(s) » quand le symbole déclare des bornes de raccordement. Un résultat vide indique « Aucun symbole ne correspond à ces filtres. » avec Effacer les filtres. Quand vos propres symboles n'ont pas pu être lus, une note indique « Mes symboles est indisponible pour le moment. Seules les bibliothèques du système sont listées. » plutôt que de faire passer le lot système pour le catalogue entier.

L'inspecteur

Sélectionner une carte ouvre l'inspecteur à côté de la galerie :

• Le nom et un badge : Système · lecture seule, Mon symbole, ou Brouillon non enregistré pendant que l'éditeur est ouvert.
• La bibliothèque, la catégorie et la norme; la description.
• Encombrement (la taille conseillée sur le tableau de bord, en cellules, largeur × hauteur) et Ajustement (Contenir, Étirer dans les deux sens, Étirer en X ou Étirer en Y).
• « N entrées · N bornes de raccordement », ou « purement visuel » quand il n'y a pas de bornes.
• Provenance du dessin, un dépliant qui donne l'origine et, pour un symbole système, la licence.
• Les actions : Exporter le paquet pour tout rôle; pour un symbole système Dupliquer dans Mes symboles, pour les vôtres Modifier et Supprimer (rôles qui configurent seulement).
• La scène d'aperçu : le dessin assaini, rendu par le même runtime qu'un tableau de bord, avec une poignée dessinée à l'ancrage de chaque borne. Un dessin qui ne peut pas s'afficher laisse la scène vide avec « Aperçu indisponible » et la raison. Quand l'assainissement a dû réparer le balisage, un dépliant « L'aperçu utilise du SVG assaini » liste les corrections (huit au plus, puis « N corrections supplémentaires ne sont pas affichées. »).
• Entrées : « Les constantes temporaires n'affectent que cet aperçu. » et Réinitialiser les entrées. Une section par zone active déclarée, avec son nom, l'effet qu'elle pilote, une phrase décrivant la correspondance, la plage d'entrée et l'élément visé (#id), et une commande pour l'essayer : un nombre (avec un curseur quand la plage d'entrée est finie), un interrupteur Actif/Inactif, une zone de texte, ou un sélecteur de couleur avec une zone de valeur de peinture. « Ce symbole ne déclare aucune entrée dynamique. » quand il n'y en a pas; une déclaration invalide affiche son erreur à la place d'une commande. Les constantes que vous réglez ici ne sont jamais enregistrées et n'atteignent jamais un tableau de bord.

Les effets et la façon dont l'inspecteur les décrit :

Nouveau symbole utilisateur

Le verbe placé au-dessus de la ligne Symboles ouvre l'éditeur dans la colonne de la galerie (« Nouveau symbole utilisateur » : « Composez du SVG inerte et ses zones actives nommées pour le tableau de bord. »); l'inspecteur suit le brouillon non enregistré au fil de la frappe, vous éprouvez donc le symbole avant de le créer.

Les règles des zones actives, chacune signalée sous les champs avec la ligne fautive encadrée : le nom doit être un identifiant (une lettre ou _ en premier, puis des lettres, des chiffres, _, ., : ou -) et être unique; l'identifiant d'élément doit exister dans le balisage; Text ne vise que text et tspan; Fill et FillColor visent les formes qui se remplissent, les groupes, use et le texte; les autres natures visent les groupes, use, les formes et le texte; Rotate, Rotation continue et Scale exigent que l'élément porte data-ganter-pivot="x y"; chaque valeur de plage doit être finie; la paire Y est présente en entier ou pas du tout, et seulement pour Translate et Scale; les couleurs active et inactive doivent être un hexadécimal, un jeton de thème tel que var(--color-success) ou un nom de couleur CSS; un élément prend au plus une zone active par canal (remplissage, contour, épaisseur de contour, ou une par autre nature); une zone active Rotation continue active exige une zone active Rotation continue sur le même élément.

Créer le symbole reste grisé tant qu'une erreur subsiste; Annuler ou Retour quitte sans créer. En cas de succès le journal des actions indique « Symbole créé. » et la nouvelle carte est sélectionnée.

Modifier, Dupliquer, Supprimer

Modifier (vos symboles seulement) ouvre le même éditeur avec « Les changements valides de nom, de SVG et de zone active sont enregistrés automatiquement. » : un changement valide est enregistré une demi-seconde après la dernière modification (« Symbole enregistré. »), et un brouillon invalide n'est pas enregistré et annule tout enregistrement en attente, si bien que le symbole stocké ne diverge jamais de ce que montre l'inspecteur. Dupliquer dans Mes symboles (symboles système) copie le dessin, la zone d'affichage, l'ajustement, l'encombrement, les configurations de type, les bornes et les suggestions dans un symbole indépendant nommé « <Nom> copy » (« <Nom> copy 2 », etc., tant que le nom est pris) et l'ouvre pour modification (« Symbole système copié dans Mes symboles. »); la définition système n'est jamais changée. Supprimer demande : Supprimer « X »? Les tableaux de bord qui l'utilisent afficheront un espace réservé. Cette action est irréversible. (« Symbole supprimé. »)

Importer un symbole…

Le deuxième verbe au-dessus de la ligne est un sélecteur de fichier qui accepte les fichiers .svg et .ganter-symbol.json de 1 MB au plus (« Le fichier du symbole dépasse la limite de 1 MB. »). Le contenu décide du chemin :

• Un SVG brut (le contenu commence par <) est importé comme dessin purement visuel : ni zones actives, ni bornes. L'assainissement le répare et le journal des actions compte les corrections (« Symbole importé comme nouvelle ressource; 3 élément(s) SVG dangereux ont été retirés. »). Le nom est celui du fichier sans son extension.
• Un paquet Ganter symbol v2 (le contenu commence par {) est importé en entier : nom, SVG, zone d'affichage, ajustement, encombrement, zones actives, configurations de type, bornes et suggestions. Un paquet est strict : le format, la version et le schéma doivent correspondre, le SVG doit être déjà assaini (un paquet qui aurait besoin de corrections est refusé, non réparé), la zone d'affichage doit correspondre à la racine du SVG, et chaque borne, configuration et suggestion doit être valide (le contrat). Le journal des actions nomme le premier problème (« Échec de l'import du symbole : … »).

Un nom déjà utilisé par l'un de vos symboles reçoit un suffixe (« 2 », « 3 », etc.). Chaque import crée un symbole et n'en écrase jamais un.

Exporter le paquet

Exporter le paquet, dans l'inspecteur, télécharge le symbole sélectionné, système ou à vous, sous la forme <nom>.ganter-symbol.json : le même paquet v2 que lit l'import, sans aucune identité de station, pour qu'il voyage d'une station à l'autre (« <fichier> exporté. »). Un symbole dont le dessin n'a pas de zone d'affichage à la racine, ou dont l'une des zones actives porte une adresse de station, est refusé (« Échec de l'export du symbole : … »).

Copier l'instruction de conversation

Copier l'instruction de conversation copie dans le presse-papiers une instruction autoportante destinée à une IA de conversation externe, qui n'a aucun accès à la station. Elle s'ouvre sur « Create a Ganter Lab symbol for me. Return ONLY the file content, either raw SVG or a single .ganter-symbol.json v2 package, with no commentary, so I can save it as a file and import it unchanged. », se poursuit avec le contrat v2 complet (les deux entrées acceptées, l'enveloppe du paquet, les seize ancrages globaux, les huit types de tracé, les natures de zone active et leurs règles, les jetons de thème, les règles de géométrie des bornes, les limites de l'assainissement et un paquet valide minimal), et se termine par la façon de rapporter la réponse : enregistrez-la comme un fichier .svg ou .ganter-symbol.json et importez-le ici. Ce même contrat est ce que lisent les outils symbol_validate et symbol_import de l'agent : une conversation et un agent produisent donc le même fichier. Le journal des actions indique « Instruction de conversation copiée. Collez-la dans n'importe quel clavardage d'IA et importez le SVG qu'il renvoie. » (ou « L'instruction n'a pas pu être copiée : … »). Le verbe est dessiné pour tout rôle, parce qu'il ne fait que lire.

Où un symbole est utilisé

Le composant de tableau de bord Symbol référence un symbole par system:<clé> ou user:<id>, associe chaque zone active à une adresse Logic, choisit le type de tracé de toute borne configurable, et relie les bornes par des tracés dessinés dans l'éditeur de tableau de bord à travers les types de tracé. Un symbole n'a pas d'adresse Logic à lui.

Ce que la bibliothèque ne fait pas

Elle ne dessine ni ne déplace les bornes et les chemins internes, ne modifie pas un dessin système sur place, n'importe pas un paquet qui aurait besoin de corrections, ne garde aucun historique de versions, et ne partage pas vos symboles d'une station à l'autre par elle-même : exportez et importez le paquet.