plura-assistent

v1.0.4

Published

23 days ago

Plugin de acessibilidade para alto contraste com suporte a <contrast-border>

Downloads

120

0High
0Medium
0Low

lucas_camargo

accessibility dark-mode vue angular font-control stop-animations diversity a11y contrast react nextjs tailwind plura

PluraAssistent – Documentação Oficial (BETA 1.0)

Versão: BETA 1.0
IA: Azure OpenAI – modelo o4-mini
Licença: Uso interno ETS
Acesso: Via token ETS
Compatibilidade: Funciona em React, Angular, Next.js, Vue e qualquer projeto que utilize NPM
Status: Em evolução contínua ...

O PluraAssistent é a biblioteca oficial de acessibilidade e inteligência artificial do ecossistema Plura, criada para garantir inclusão, acessibilidade visual e apoio cognitivo dentro das aplicações da ETS.

Ele foi projetado para ser integrado com mínimo esforço:
Instalou, configurou o Provider e todo o assistente passa a funcionar automaticamente.

Principais Funcionalidades

Todas as funcionalidades abaixo são automáticas após a instalação da lib + configuração do Provider.

1. IA Simplificadora de Texto (com Glossário Automático)

Simplifica textos complexos (jurídicos, técnicos, internos).
Gera glossário automático quando identifica termos difíceis.
Mantém o contexto e preserva a intenção original.
Funciona com Azure OpenAI o4-mini.

2. Modo Noturno (Dark Mode) – Assistente

Aplicado automaticamente ao assistent.
Pensado para conforto visual.
Em funcionalidades futuras, pretende ser expandido à plataforma toda.

3. Daltonismo – Modo Automático (Cores e Imagens)

O assistente adapta automaticamente o sistema para:

Protanopia
Deuteranopia
Tritanopia
Acromatopsia
Tricromacia anômala

Ajustando:

✔ cores
✔ ícones
✔ botões
✔ textos
✔ imagens

Nenhuma configuração é necessária.

4. Aumento Automático de Fonte

Para pessoas com baixa visão:

aumenta toda tipografia,
mantém hierarquia e responsividade,
não requer hooks ou componentes extras.

Tem quatro modos de fonte, com 1.0x, 1.25x, 1.50x e 1.75x de tamanho da fonte.

5. Parar Animações (Acessibilidade Neurológica)

Pensado para:

pessoas com epilepsia fotossensível,
TDAH,
sensibilidade a estímulos,
vertigem digital.

O assistente automaticamente:

desabilita animações,
remove transições,
evita flickers e loops.

6. Alto Contraste (Low Vision Mode) – com Hooks e Tags

O modo de alto contraste ajusta automaticamente:

✔ ícones
✔ botões
✔ sombras
✔ cartões
✔ textos
✔ backgrounds
✔ bordas
✔ componentes estruturais

Além disso, a lib fornece tags personalizadas para destacar blocos.

Exemplo real de uso:

import { useEffect } from "react";
import { ToggleContrast, registerContrastBorder } from "plura-assistent";

export default function App() {
  useEffect(() => {
    registerContrastBorder();
  }, []);

  return (
    <>
      <ToggleContrast />
      <contrast-border>
        <p>Esse bloco vai ter borda no contraste</p>
      </contrast-border>
    </>
  );
}

Instalação

Requer token da ETS:

npm install plura-assistent

yarn add plura-assistent

📌 O token ETS é obrigatório para instalar e usufruir da biblioteca.

Configuração do Provider

Após configurar, todas as features passam a funcionar automaticamente.

import { PluraAssistentProvider } from "plura-assistent";

export default function RootLayout({ children }) {
  return (
    <html lang="pt-BR">
      <body>
        <PluraAssistentProvider
          config={{
            token: process.env.NEXT_PUBLIC_ASSISTENT_TOKEN, // Token da ETS
            environment: "prod",
          }}
        >
          {children}
        </PluraAssistentProvider>
      </body>
    </html>
  );
}

Como o Assistente Funciona Internamente

O frontend chama a lib.
A lib repassa ao backend ETS.
O backend valida token e contexto.
O backend consulta Azure OpenAI o4-mini.
A resposta volta tratada.
A lib aplica as regras de acessibilidade conforme necessidade do usuário.

Segurança

Nenhum dado sensível vai diretamente ao OpenAI.
A ETS controla todas as operações via token.
Existem limites e auditoria interna de segurança para garantir que a IA não erre dados confidencias, sendo nível 1 de confidencialidade.

Versão BETA 1.0

Como versão inicial:

pode conter ajustes estruturais,
pode sofrer breaking changes,
tem telemetria reforçada,
está recebendo feedback contínuo da ETS.

Boas Práticas

Não envie dados sensíveis à IA.
Trate loading e erros.
Armazene textos processados no backend quando úteis.
Utilize tags como <contrast-border> para granularidade no contraste.

Resumo Final

O PluraAssistent oferece:

IA com simplificação + glossário
Revisão textual inteligente
Alto contraste com hooks e tags
Aumento de fonte automático
Modo noturno
Daltonismo (cores + imagens)
Bloqueio de animações
Compatibilidade com React, Angular, Next.js, Vue e qualquer solução NPM

E principalmente:

➡️ Após instalar e configurar o Provider, tudo funciona automaticamente.