Símbolos

La biblioteca de Símbolos: las once bibliotecas del sistema y Mis símbolos, la búsqueda y los filtros de la galería, el inspector con sus entradas y sus bornes en vivo, el editor Nuevo símbolo de usuario y todas las clases de zona activa, Importar símbolo…, Exportar el paquete, Duplicar, Copiar la instrucción para el chat, y dónde se usa un símbolo.

Símbolos es la cuarta categoría bajo la raíz Recursos: el dibujo que un componente Símbolo de un panel de control dibuja y anima. El panel se encabeza "Símbolos", con la línea "Bibliotecas específicas para paneles de control modernos, bancos de pruebas, productos conectados, diagramas de normas, sistemas industriales e instalaciones. Todos los símbolos del sistema se pueden inspeccionar y duplicar en Mis símbolos." y la insignia del recuento. Leer e inspeccionar necesitan Ver Logic; crear, importar, duplicar, editar y eliminar necesitan Configurar Logic. El formato de archivo con el que viaja un símbolo se describe en Símbolos SVG portátiles.

Las bibliotecas

Las bibliotecas del sistema son dibujo original de Ganter Lab, compilado dentro del producto y de solo lectura: una actualización las sustituye sin tocar los datos de su estación. Cada definición lleva una referencia estable system:<key>, su biblioteca y su categoría, una descripción, etiquetas de búsqueda, la norma que le aplica, y metadatos de origen y de licencia.

La galería

Sobre las tarjetas: Búsqueda (texto de ejemplo "Nombre, categoría o etiqueta"; compara el nombre del símbolo, su descripción, su categoría, su norma y sus etiquetas, sin distinguir mayúsculas de minúsculas; la biblioteca se elige con su propio filtro), Biblioteca ("Todas las bibliotecas (530)" o una biblioteca con su recuento; elegir una borra la categoría y muestra la descripción de la biblioteca bajo los filtros), Categoría ("Todas las categorías" o una categoría de la biblioteca elegida), Origen y Por página. Una tarjeta muestra la biblioteca, una vista previa con la proporción natural del dibujo, el nombre, la categoría, el origen (Sistema o Míos) y una línea de capacidades: "Estático", "1 entrada" o "N entradas", seguidas de "· N borne(s)" cuando el símbolo declara bornes de conexión. Un resultado vacío dice "Ningún símbolo coincide con estos filtros." con Borrar los filtros. Cuando sus propios símbolos no se han podido leer, una nota dice "Mis símbolos no está disponible ahora mismo. Solo se listan las bibliotecas del sistema." en lugar de hacer pasar el paquete del sistema por el catálogo entero.

El inspector

Seleccionar una tarjeta abre el inspector al lado de la galería:

• El nombre y una insignia: Sistema · solo lectura, Mi símbolo, o Borrador sin guardar mientras el editor está abierto.
• La biblioteca, la categoría y la norma; la descripción.
• Huella (el tamaño sugerido en el panel de control, en celdas, anchura × altura) y Ajuste (Contener, Estirar, Estirar en X o Estirar en Y).
• "N entradas · N bornes de conexión", o "solo visual" cuando no hay bornes.
• Procedencia del dibujo, un desplegable con el origen y, en un símbolo del sistema, la licencia.
• Las acciones: Exportar el paquete para todos los roles; en un símbolo del sistema Duplicar en Mis símbolos, y en los suyos Editar y Eliminar (solo para los roles que configuran).
• El escenario de vista previa: el dibujo depurado, representado por el mismo runtime que un panel de control, con un tirador dibujado en el anclaje de cada borne. Un dibujo que no se puede representar deja el escenario vacío con "Vista previa no disponible" y el motivo. Cuando el depurador tuvo que reparar el marcado, un desplegable "La vista previa usa SVG depurado" lista las reparaciones (ocho como mucho, y luego "No se muestran N reparaciones más.").
• Entradas: "Las constantes transitorias afectan solo a esta vista previa." y Restablecer las entradas. Una sección por zona activa declarada, con su nombre, el efecto que gobierna, una frase que describe la correspondencia, el rango de entrada y el elemento de destino (#id), y un mando para probarla: un número (con un deslizador cuando el rango de entrada es finito), un conmutador de encendido y apagado, un cuadro de texto, o un selector de color con un cuadro de valor de pintura. "Este símbolo no declara entradas dinámicas." cuando no hay ninguna; una declaración no válida muestra su error en lugar de un mando. Las constantes que se fijan aquí no se guardan nunca y no llegan nunca a un panel de control.

Los efectos y cómo los describe el inspector:

Nuevo símbolo de usuario

El verbo sobre la fila Símbolos abre el editor en la columna de la galería ("Nuevo símbolo de usuario": "Componga SVG inerte y sus zonas activas de entrada con nombre para el panel de control."); el inspector sigue al borrador sin guardar mientras se escribe, así que el símbolo se prueba antes de crearlo.

Las reglas de las zonas activas, cada una informada bajo los campos y con la fila culpable resaltada: el nombre tiene que ser un identificador (primero una letra o _, luego letras, dígitos, _, ., : o -) y ser único; el id del elemento tiene que existir en el marcado; Text apunta solo a text y a tspan; Fill y Fill color apuntan a las formas que se pueden rellenar, a los grupos, a use y al texto; las demás clases apuntan a grupos, a use, a formas y a texto; Rotate, Giro y Scale necesitan que el elemento lleve data-ganter-pivot="x y"; todos los valores de rango tienen que ser finitos; el par de Y va entero o no va, y solo en Translate y en Scale; los colores de encendido y de apagado tienen que ser un hexadecimal, una ficha de tema como var(--color-success) o un nombre de color de CSS; un elemento admite como mucho una zona activa por canal (relleno, trazo, grosor del trazo, o una por cada otra clase); una zona activa de Giro habilitado necesita una zona activa de Giro sobre el mismo elemento.

Crear símbolo se queda en gris mientras haya algún error en pie; Cancelar o Atrás sale sin crear nada. Si sale bien, el registro de acciones dice "Símbolo creado." y la tarjeta nueva queda seleccionada.

Editar, Duplicar, Eliminar

Editar (solo sus símbolos) abre ese mismo editor con "Los cambios válidos de nombre, SVG y zonas activas se guardan automáticamente.": un cambio válido se guarda medio segundo después de la última edición ("Símbolo guardado."), y un borrador no válido no se guarda y cancela cualquier guardado pendiente, así que el símbolo guardado nunca se aparta de lo que muestra el inspector. Duplicar en Mis símbolos (en los símbolos del sistema) copia el dibujo, el cuadro de vista, el ajuste, la huella, las configuraciones de tipo, los bornes y las sugerencias a un símbolo independiente llamado "copia de <Name>" ("copia 2 de <Name>"… mientras esté ocupado) y lo abre para editarlo ("Símbolo del sistema copiado a Mis símbolos."); la definición del sistema no se cambia nunca. Eliminar pregunta "¿Eliminar 'X'? Los paneles de control que lo usen mostrarán un marcador de posición. Esta acción no se puede deshacer." ("Símbolo eliminado.").

Importar símbolo…

El segundo verbo sobre la fila es un selector de archivos que acepta archivos .svg y .ganter-symbol.json de 1 MB como mucho ("El archivo del símbolo supera el límite de 1 MB."). El contenido decide el camino:

• Un SVG en bruto (el contenido empieza por <) se importa como dibujo solo visual: sin zonas activas y sin bornes. El depurador lo repara y el registro de acciones cuenta las reparaciones ("Símbolo importado como recurso nuevo; se quitaron 3 elemento(s) SVG no seguro(s)."). El nombre es el nombre del archivo sin su extensión.
• Un paquete Ganter symbol v2 (el contenido empieza por {) se importa entero: nombre, SVG, cuadro de vista, ajuste, huella, zonas activas, configuraciones de tipo, bornes y sugerencias. Un paquete es estricto: el formato, la versión y el esquema tienen que coincidir, el SVG tiene que venir ya depurado (un paquete que necesita reparaciones se rechaza, no se repara), el cuadro de vista tiene que coincidir con la raíz del SVG, y todos los bornes, todas las configuraciones y todas las sugerencias tienen que ser válidos (el contrato). El registro de acciones nombra el primer problema ("Error al importar el símbolo: …").

Un nombre que ya usa uno de sus símbolos recibe un sufijo (" 2", " 3"…). Toda importación crea un símbolo nuevo y nunca sobrescribe uno.

Exportar el paquete

Exportar el paquete, en el inspector, descarga el símbolo seleccionado, del sistema o suyo, como <name>.ganter-symbol.json: el mismo paquete v2 que lee la importación, sin ninguna identidad de estación, para que viaje entre estaciones ("Se exportó <file>."). Un símbolo cuyo dibujo no tiene cuadro de vista en la raíz, o una de cuyas zonas activas lleva una dirección de estación, se rechaza ("Error al exportar el símbolo: …").

Copiar la instrucción para el chat

Copiar la instrucción para el chat copia al portapapeles una instrucción autónoma para un chat de IA externo que no tiene ningún acceso a la estación. Abre con "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.", sigue con el contrato v2 completo (las dos entradas aceptadas, la envoltura del paquete, los dieciséis anclajes globales, los ocho tipos de trazo, las clases de zona activa y sus reglas, las fichas de tema, las reglas de geometría de los bornes, los límites del depurador y un paquete válido mínimo), y termina con cómo traer de vuelta la respuesta: guarde la contestación como un archivo .svg o .ganter-symbol.json e impórtelo aquí. Ese mismo contrato es el que leen las herramientas symbol_validate y symbol_import del agente, así que un chat y un agente producen el mismo archivo. El registro de acciones dice "Instrucción para el chat copiada. Péguela en cualquier chat de IA e importe el SVG que devuelva." (o "El portapapeles rechazó la copia."). El verbo se dibuja para todos los roles, porque solo lee.

Dónde se usa un símbolo

El componente Símbolo de un panel de control referencia un símbolo como system:<key> o user:<id>, asigna cada zona activa a una dirección de Logic, elige el tipo de trazo de cualquier borne configurable, y une bornes con trazos dibujados en el editor de paneles a través de los tipos de trazo. Un símbolo no tiene dirección de Logic propia.

Lo que la biblioteca no hace

No dibuja ni mueve bornes ni recorridos internos, no edita en el sitio el dibujo del sistema, no importa un paquete que necesita reparaciones, no guarda ningún histórico de versiones, y no comparte sus símbolos entre estaciones por sí sola: exporte e importe el paquete.