Ordenar cores por luminância

A ferramenta valida cada valor, normaliza a notação hex curta e completa, converte canais sRGB em luz linear e ordena pela luminância relativa WCAG. Cada resultado traz a cor normalizada e sua luminância, para que você examine diferenças pequenas sem depender da percepção visual. Empates mantêm a ordem original, duplicatas são preservadas e entradas idênticas sempre geram a mesma saída.

Crie uma escala de brilho a partir de uma paleta desordenada

Coleções de cores normalmente seguem a criação dos tokens ou a serialização do arquivo, não o brilho. Envie o array colors e receba registros da menor para a maior luminância relativa. Formas de três dígitos são expandidas, as de seis aceitam cerquilha opcional e o retorno usa #rrggbb minúsculo. Isso facilita snapshots, arquivos de tokens, CSS e comparações. Duplicatas não são removidas, pois podem representar tokens diferentes. Cores com luminância exatamente igual mantêm a ordem de entrada, evitando oscilações entre execuções. A resposta informa quantidade, direção e método. Use a lista para montar uma paleta sequencial ou analisar tons vizinhos. A operação apenas reordena: não cria tonalidades intermediárias, não renomeia tokens nem promete passos perceptualmente uniformes.

Entenda como a luminância relativa define a ordem

Luminância relativa não é a média simples dos bytes vermelho, verde e azul. Cores hex codificam canais sRGB com uma curva não linear; cada canal é escalado entre zero e um e convertido em luz linear. Valores até o limite sRGB são divididos por 12.92, e os demais usam a função de potência padrão. Em seguida, aplicam-se os coeficientes 0.2126, 0.7152 e 0.0722. Verde tem o maior peso e azul o menor; o resultado vai de zero no preto a um no branco. A ordenação utiliza o número completo, sem arredondamento. As seis casas exibidas servem para leitura e serialização estável. O modelo integra cálculos WCAG, mas ordenar uma paleta não comprova acessibilidade; avalie separadamente cada par de primeiro plano e fundo.

Valide entradas e integre resultados determinísticos

O campo colors deve ser um array não vazio com até 1000 itens. Cada item precisa ser uma string com exatamente três ou seis dígitos hexadecimais após uma cerquilha opcional. Espaços externos são ignorados; alfa, nomes CSS, funções rgb(), comprimentos inválidos e outros tipos são rejeitados. O erro aponta o índice incorreto, sem descartar ou adivinhar valores. Isso impede que builds aceitem uma escala parcial aparentemente válida. A implementação faz apenas aritmética local e ordenação em memória, sem rede, relógio, aleatoriedade ou retenção. Assim, o mesmo array gera o mesmo JSON no navegador, em CI e pela API. O uso no navegador é gratuito; cada chamada API custa US$ 0,002. Duplicatas preservadas e empates estáveis permitem mapear os resultados aos metadados originais com segurança.