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 en vivo y sus bornes, el editor de Nuevo símbolo de usuario y cada clase 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 panel de control dibuja y anima. El panel se titula "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 pastilla del conteo. Leer e inspeccionar necesitan Ver Logic; crear, importar, duplicar, editar y eliminar necesitan Configurar Logic. El formato de archivo en el que viaja un símbolo se describe en Símbolos SVG portables.

Las bibliotecas

Las bibliotecas del sistema son dibujo original de Ganter Lab, compilado dentro del producto y de solo lectura: una actualización las reemplaza sin tocar los datos de su estación. Los nombres de biblioteca y de categoría son los del catálogo y se quedan como están. Cada definición lleva una referencia estable system:<clave>, 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

Arriba de las tarjetas: Buscar (con el texto de ejemplo "Nombre, categoría o etiqueta"; coincide con el nombre, la descripción, la categoría, la norma y las etiquetas del símbolo, sin distinguir mayúsculas; la biblioteca se elige con su propio filtro), Biblioteca ("Todas las bibliotecas (530)" o una biblioteca con su conteo; elegir una borra la categoría y muestra la descripción de la biblioteca debajo de 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 pudieron 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 todo el catálogo.

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 celdas del panel de control, ancho × alto) y Ajuste (Contener, Estirar ambos, 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, para un símbolo del sistema, la licencia.
• Las acciones: Exportar el paquete para todos los roles; para un símbolo del sistema Duplicar en Mis símbolos, y para 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 máximo, 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 cada zona activa declarada, con su nombre, el efecto que mueve, una frase que describe la correspondencia, el rango de entrada y el elemento de destino (#id), y un control para probarla: un número (con un deslizador cuando el rango de entrada es finito), un conmutador de encendido y apagado, una caja de texto, o un selector de color con una caja 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 control. Las constantes que usted ponga aquí nunca se guardan y nunca llegan 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 conforme usted escribe, así que usted prueba el símbolo antes de crearlo.

Las reglas de una zona activa, reportadas cada una debajo de los campos y con la fila culpable resaltada: el nombre tiene que ser un identificador (una letra o un _ primero, y luego letras, dígitos, _, ., : o -) y ser único; el id de elemento tiene que existir en el marcado; Texto apunta solo a text y tspan; Relleno y Color del relleno apuntan a las figuras que se pueden rellenar, a los grupos, a use y al texto; las demás clases apuntan a grupos, a use, a figuras y a texto; Rotar, Giro y Escalar necesitan que el elemento lleve data-ganter-pivot="x y"; todos los valores de rango tienen que ser finitos; el par en Y es o los dos o ninguno, y solo para Trasladar y Escalar; los colores de encendido y de apagado tienen que ser un hexadecimal, un token de tema como var(--color-success) o un nombre de color de CSS; un elemento toma como máximo una zona activa por canal (relleno, contorno, grosor del contorno, o una por cada otra clase); una zona activa de Giro activado necesita una zona activa de Giro en ese mismo elemento.

Crear símbolo se queda en gris mientras haya algún error; Cancelar o Atrás salen sin crear nada. Cuando 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 (símbolos del sistema) copia el dibujo, la caja de vista, el ajuste, la huella, las configuraciones de tipo, los bornes y las sugerencias a un símbolo independiente llamado "<Nombre> copia" ("<Nombre> copia 2"… mientras esté tomado) 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 máximo ("El archivo del símbolo supera el límite de 1 MB."). El contenido decide el camino:

• SVG crudo (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: el nombre, el SVG, la caja de vista, el ajuste, la huella, las zonas activas, las configuraciones de tipo, los bornes y las sugerencias. Un paquete es estricto: el formato, la versión y el esquema tienen que coincidir, el SVG ya tiene que estar depurado (un paquete que necesita reparaciones se rechaza, no se repara), la caja de vista tiene que coincidir con la raíz del SVG, y cada borne, cada configuración y cada sugerencia 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"…). Cada 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 <nombre>.ganter-symbol.json: el mismo paquete v2 que lee la importación, sin ninguna identidad de la estación, para que viaje entre estaciones ("Se exportó <archivo>."). Un símbolo cuyo dibujo no tiene caja de vista en la raíz, o una de cuyas zonas activas lleva una dirección de la 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 autosuficiente 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, el sobre del paquete, los dieciséis anclajes globales, los ocho tipos de trazo, las clases de zona activa y sus reglas, los tokens 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 respuesta 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:<clave> 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 conexiones dibujadas en el editor de sinópticos por medio 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 trayectos internos, no edita el dibujo del sistema en su lugar, no importa un paquete que necesite 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.