Símbolos

A biblioteca de Símbolos: as onze bibliotecas do sistema e Meus símbolos, a busca e os filtros da galeria, o inspetor com as entradas ao vivo e os terminais, o editor Novo símbolo do usuário e cada tipo de slot, o Importar símbolo…, o Exportar o pacote, o Duplicar, o Copiar instrução para chat, e onde um símbolo é usado.

Symbols é a quarta categoria sob a raiz Assets: a arte que um componente Símbolo de dashboard desenha e anima. O painel tem o título "Símbolos", com a frase "Bibliotecas feitas sob medida para dashboards modernos, bancadas de teste, produtos conectados, diagramas de normas, sistemas industriais e instalações. Todo símbolo de sistema pode ser inspecionado e duplicado para Meus símbolos." e a pílula de contagem. Ler e inspecionar exigem Ver a lógica; criar, importar, duplicar, editar e excluir exigem Configurar a lógica. O formato de arquivo em que um símbolo viaja está descrito em Símbolos SVG portáteis.

As bibliotecas

As bibliotecas do sistema são arte original do Ganter Lab, compilada dentro do produto e somente leitura: uma atualização as substitui sem tocar nos dados da sua estação. Cada definição carrega uma referência estável system:<key>, a biblioteca e a categoria dela, uma descrição, etiquetas de busca, a norma aplicável e metadados de origem e de licença.

A galeria

Acima dos cartões: Buscar (texto de exemplo "Nome, categoria ou tag"; casa o nome, a descrição, a categoria, a norma e as etiquetas do símbolo, sem diferenciar maiúsculas de minúsculas; a biblioteca é escolhida no filtro próprio dela), Biblioteca ("Todas as bibliotecas (530)" ou uma biblioteca com a contagem dela; escolher uma limpa a categoria e mostra a descrição da biblioteca abaixo dos filtros), Categoria ("Todas as categorias" ou uma categoria da biblioteca escolhida), Origem e Por página. Um cartão mostra a biblioteca, uma prévia na proporção natural da arte, o nome, a categoria, a origem (Sistema ou Meus) e uma linha de capacidade: "Estático", "1 entrada" ou "N entradas", seguida de "· N terminais" quando o símbolo declara terminais de ligação. Um resultado vazio diz "Nenhum símbolo corresponde a estes filtros." com Limpar filtros. Quando os seus próprios símbolos não puderam ser lidos, uma nota diz "Meus símbolos está indisponível agora. Só as bibliotecas do sistema estão listadas.", em vez de passar o pacote do sistema por catálogo inteiro.

O inspetor

Selecionar um cartão abre o inspetor ao lado da galeria:

• O nome e um distintivo: Sistema · somente leitura, Meu símbolo, ou Rascunho não salvo só enquanto o símbolo é novo e ainda não foi criado, ou enquanto a edição aberta tem um erro que impede o salvamento automático (o distintivo continua Meu símbolo enquanto uma edição se salva sozinha, inclusive no meio segundo antes do salvamento).
• A biblioteca, a categoria e a norma; a descrição.
• Área ocupada (o tamanho sugerido no dashboard, em células, largura × altura) e Encaixe (Caber inteiro, Esticado, Esticar em X ou Esticar em Y).
• "N entradas · N terminais de ligação", ou "apenas visual" quando não há terminais.
• Procedência da arte, um revelador com a origem e, num símbolo do sistema, a licença.
• As ações: Exportar o pacote para todo papel; num símbolo do sistema, Duplicar para Meus símbolos; nos seus, Editar e Excluir (só papéis que configuram).
• O palco de prévia: a arte higienizada, desenhada pelo mesmo runtime de um dashboard, com uma alça desenhada no ancoradouro de cada terminal. Uma arte que não consegue ser desenhada deixa o palco vazio com "Prévia indisponível" e o motivo. Quando o higienizador precisou reparar a marcação, um revelador "A prévia usa SVG higienizado" lista os reparos (oito no máximo, e então "Mais N reparos não são mostrados.").
• Entradas: "As constantes passageiras afetam apenas esta prévia." e Restaurar as entradas. Uma seção por slot declarado, com o nome dele, o efeito que ele conduz, uma frase descrevendo o mapeamento, a faixa de entrada e o elemento alvo (#id), e um controle para experimentar: um número (com um controle deslizante quando a faixa de entrada é finita), um interruptor Ligado/Desligado, uma caixa de texto, ou um seletor de cor com uma caixa de valor de pintura. "Este símbolo não declara entradas dinâmicas." quando não há nenhuma; uma declaração inválida mostra o erro dela em vez de um controle. As constantes que você define aqui nunca são salvas e nunca chegam a um dashboard.

Os efeitos e como o inspetor os descreve:

Novo símbolo do usuário

O verbo sobre a linha Symbols abre o editor na coluna da galeria ("Novo símbolo do usuário": "Componha SVG inerte e os slots de entrada nomeados que o dashboard usa."); o inspetor acompanha o rascunho não salvo enquanto você digita, então você testa o símbolo antes de criá-lo.

Regras de slot, cada uma relatada abaixo dos campos, com a linha problemática contornada: o nome precisa ser um identificador (uma letra ou _ primeiro, depois letras, dígitos, _, ., : ou -) e ser único; o id do elemento precisa existir na marcação; Text mira apenas text e tspan; Fill e Fill color miram formas que podem ser preenchidas, grupos, use e texto; os outros tipos miram grupos, use, formas e texto; Rotate, Spin e Scale precisam que o elemento carregue data-ganter-pivot="x y"; todo valor de faixa precisa ser finito; o par de Y é ou os dois ou nenhum, e só em Translate e Scale; as cores de ligado e de desligado precisam ser um hexadecimal, um símbolo de tema como var(--color-success) ou um nome de cor do CSS; um elemento aceita no máximo um slot por canal (preenchimento, traço, largura do traço, ou um por cada outro tipo); um slot Spin enabled precisa de um slot Spin no mesmo elemento.

O Criar símbolo continua esmaecido enquanto qualquer erro estiver de pé; o Cancelar ou o Voltar sai sem criar. Quando dá certo, o feed diz "Símbolo criado." e o cartão novo fica selecionado.

Editar, Duplicar, Excluir

O Editar (só nos seus símbolos) abre o mesmo editor com "Mudanças válidas de nome, de SVG e de slot são salvas automaticamente.": uma mudança válida é salva meio segundo depois da última edição ("Símbolo salvo."), e um rascunho inválido não é salvo e cancela qualquer salvamento pendente, então o símbolo guardado nunca diverge do que o inspetor mostra. O Duplicar para Meus símbolos (símbolos do sistema) copia a arte, a caixa de visão, o ajuste, a área ocupada, as configurações de tipo, os terminais e as sugestões para um símbolo independente chamado "cópia de <Name>" ("cópia 2 de <Name>"… enquanto o nome estiver ocupado) e o seleciona na galeria sem abrir o editor ("Símbolo de sistema copiado para Meus símbolos."): o inspetor o mostra ao lado da galeria, qualquer busca ou filtro que esconderia a cópia é limpo e a galeria vai para a página que a guarda, e o Editar abre a cópia para edição. A definição do sistema nunca é alterada. O Excluir pergunta "Excluir 'X'? Os dashboards que o usam vão mostrar um marcador de lugar. Isso não pode ser desfeito." ("Símbolo excluído.").

Importar símbolo…

O segundo verbo sobre a linha é um seletor de arquivo que aceita arquivos .svg e .ganter-symbol.json de no máximo 1 MB ("O arquivo do símbolo é maior que o limite de 1 MB."). O conteúdo decide o caminho:

• SVG cru (o conteúdo começa com <) é importado como arte apenas visual: sem slots e sem terminais. O higienizador o repara e o feed conta os reparos ("Símbolo importado como um recurso novo; 3 itens SVG inseguros foram removidos."). O nome é o nome do arquivo sem a extensão.
• Um pacote Ganter symbol v2 (o conteúdo começa com {) é importado inteiro: nome, SVG, caixa de visão, ajuste, área ocupada, slots, configurações de tipo, terminais e sugestões. Um pacote é estrito: o formato, a versão e o esquema precisam bater, o SVG já precisa estar higienizado (um pacote que precise de reparos é recusado, não reparado), a caixa de visão precisa bater com a raiz do SVG, e todo terminal, configuração e sugestão precisa ser válido (o contrato). O feed nomeia o primeiro problema ("A importação do símbolo falhou: …").

Um nome já usado por um dos seus símbolos recebe sufixo (" 2", " 3"…). Toda importação cria um símbolo novo e nunca sobrescreve um.

Exportar o pacote

O Exportar o pacote do inspetor baixa o símbolo selecionado, do sistema ou seu, como <name>.ganter-symbol.json: o mesmo pacote v2 que a importação lê, sem nenhuma identidade de estação, para que ele viaje entre estações ("<file> exportado."). Um símbolo cuja arte não tem caixa de visão na raiz, ou um dos cujos slots carrega um endereço de estação, é recusado ("A exportação do símbolo falhou: …").

Copiar instrução para chat

O Copiar instrução para chat copia para a área de transferência uma instrução autossuficiente para um chat de IA externo, que não tem acesso à estação. Ela abre com "Crie um símbolo do Ganter Lab para mim. Devolva SOMENTE o conteúdo do arquivo, seja SVG cru, seja um único pacote .ganter-symbol.json v2, sem comentário nenhum, para que eu possa salvá-lo como arquivo e importá-lo sem alteração.", continua com o contrato v2 completo (as duas entradas aceitas, o envelope do pacote, os dezesseis ancoradouros globais, os oito tipos de ligação, os tipos de slot e as regras deles, os símbolos de tema, as regras de geometria de terminal, os limites do higienizador e um pacote válido mínimo), e termina com como trazer a resposta de volta: salve a resposta como um arquivo .svg ou .ganter-symbol.json e importe-o aqui. O mesmo contrato é o que as ferramentas symbol_validate e symbol_import do agente leem, então um chat e um agente produzem o mesmo arquivo. O feed diz "Instrução para chat copiada. Cole em qualquer chat de IA e importe o SVG que ele devolver." (ou "A área de transferência recusou a cópia."). O verbo é desenhado para todo papel, porque ele só lê.

Onde um símbolo é usado

O componente Símbolo de dashboard referencia um símbolo como system:<key> ou user:<id>, mapeia cada slot para um endereço da Logic, escolhe o tipo de ligação de qualquer terminal configurável, e une terminais com ligações desenhadas no editor de dashboard pelos tipos de ligação. Um símbolo não tem endereço próprio na Logic.

O que a biblioteca não faz

Ela não desenha nem move terminais e caminhos internos, não edita a arte do sistema no lugar, não importa um pacote que precisa de reparos, não guarda histórico de versões, e não compartilha sozinha os seus símbolos entre estações: exporte e importe o pacote.