29 de mai de 2020 - 20 min de leitura
Iniciando no TypeScript
Guia prático para os primeiros passos da linguagem
Introdução - O que é o TypeScript?
É um superset do JavaScript criado pela Microsoft. o TS adiciona features como tipagem estática ao JavaScript e necessita ser transpilado para ser utilizado no browser ou até mesmo no nodejs.
Por que usar TypeScript?
JavaScript é uma linguagem dinâmica, com isso podemos(sem querer?) mudar o tipo das variáveis e obter retornos inesperados.
function sum(a, b) {
return a + b;
}
sum(10, 10); // 20
sum('2', '2'); // 22? concatenou a string :D
O TypeScript nos avisa em casos como esse e também em muitos outros.
Também podemos usar o TS como uma "documentação". Por exemplo, imagine uma propriedade em um objeto
que deve receber um array, mas esse array só pode ser preenchido com uma determinada string ou valor.
Para isso temos o type
:
type Platform = 'Windows' | 'Mac OS' | 'Linux';
type Feature = 'Single Player' | 'Multiplayer' | 'Co-op';
interface GameDetails {
id: string;
title: string;
description: string;
platforms: Platform[];
features: Feature[];
}
Platforms e features em GameDetails
são arrays que esperam os valores presente em seus respectivos types.
Primeiro código em TypeScript
Para transpilar o código TS para JS, utilizamos o tsc, então é necessário instala-lo:
npm install -g typescript
Vários editores são compatíveis com o TypeScript. O mais importante é a integração com a linguagem, para que o editor possa identificar os erros, ler as APIs etc.
Vamos usar um exemplo de uma página que soma dois números:
index.html
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>Sum</title>
</head>
<body>
<input type="number" id="num1">
<span>+</span>
<input type="number" id="num2">
<button id="button">Somar</button>
<script src="./somar.js"></script>
</body>
</html>
somar.js:
const input1 = document.getElementById('num1');
const input2 = document.getElementById('num2');
const button = document.getElementById('button');
function sum(a, b) {
return a + b;
}
button.addEventListener('click', function() {
console.log(sum(input1.value, input2.value));
});
A saída do click nunca vai ser a soma dos números, pois input.value retorna uma string. O retorno da função no exemplo acima é os valores concatenados, em vez de somados, como esperado.
Agora o mesmo código em TypeScript:
Arquivos em TypeScript devem possuir a extensão .TS
somar.ts:
const input1 = document.getElementById('num1') as HTMLInputElement;
const input2 = document.getElementById('num2') as HTMLInputElement;
const button = document.getElementById('button');
function sum(a: number, b: number) {
return a + b;
}
button.addEventListener('click', function() {
console.log(sum(input1.value, input2.value));
});
Para acessar a propriedade value do input sem o TS detectar um erro, foi necessário tipar a variável input1
e input2
como um HTMLInputElement
.
Também é possível ver a tipagem na função sum
. O código acima irá retornar erro ao chamar a função sum
passando input.value
, pois são strings e a função espera receber números.
console.log(sum(input1.value, input2.value));
se tentarmos compilar o código um exception será lançada:
Para compilar um arquivo TypeScript utilizamos o comando
tsc filename.ts
npx tsc 1-primeiro-código/somar.ts --watch
[9:58:25 PM] Starting compilation in watch mode...
1-primeiro-código/somar.ts:10:21 - error TS2345: Argument of type 'string' is not assignable to parameter of type 'number'.
10 console.log(sum(input1.value, input2.value));
~~~~~~~~~~~~
[9:58:27 PM] Found 1 error. Watching for file changes.
Para que o código compile, é necessário converter a string retornada do input para Number:
button.addEventListener('click', function() {
console.log(sum(Number(input1.value), Number(input2.value)));
});
Após compilar, o TypeScript gera um arquivo .js
que deve ser usado na aplicação. No caso, importado na página index.html
.
TSconfig
TSconfig é o arquivo de configuração do TypeScript. Com ele é possível definir regras de compilação, outputs etc.
Para gerar o arquivo tsconfig
:
tsc --init
O arquivo é criado no formato .json
e contém várias regras que podemos adicionar à nossa aplicação.
Na propriedade outDir
do tsconfig
é possível explicitar a saída do arquivo js
que será gerado, por exemplo. E no index.html
é necessário apontar pra esse arquivo de saída:
tsconfig.json
:
...
"outDir": "./dist",
...
index.html
<script src="./dist/somar.js"></script>
Na raiz onde se encontra o tsconfig
, basta compilar com o comando tsc
para a pasta dir
ser gerada com os respectivos arquivos .js
.
Recursos da linguagem - Types
A tipagem é uma das features mais importantes do TypeScript. Com ela podemos definir tipos nas variáveis, retorno de funções etc.
Vamos ver os principais tipos presentes no TS:
Any
Como o nome já diz, uma variável de tipo "qualquer":
let value: any;
value = 'foo';
value = 10;
value = false;
Boolean
Recebe true
ou false
:
let isOpened: boolean;
isOpened = false;
isOpened = 'false'; // Type '"false"' is not assignable to type 'boolean'.ts(2322)
Number
O tipo Number é um pouco diferente do que se vê em outras linguagens. O TypeScript não dispõe de números inteiros, sem sinal ou algo do tipo. Todos os números são definidos como números reais e podem ser representados, inclusive, por binários, hexadecimais etc:
let total: number;
total = 90 + 10;
total = 100.3;
total = 0064;
total = 1100100;
String
A famosa sequência de caracteres:
let message: string;
message = 'foo';
message = "foo";
message = `foo`;
Array
Há duas formas de se utilizar um array:
let values: number[];
values = [10, 20, 30];
let numbers: Array<number>;
numbers = [10, 20, 30];
A primeira forma seria um "sugar syntax", já a segunda utiliza um recurso chamado Generics, muito comum em outras linguagens.
Tuple
Outro tipo bem comum em outras linguagens são as tuples. É bem semelhante a um array, porém com tamanhos e valores de tipos bem definidos.
let title: [number, string];
title = [1, 'foo'];
Enum
São conjuntos ordenados de chaves e valores:
enum Colors {
white = '#fff',
black = '#000'
}
Void
Equivalente a uma função sem retorno:
function logger(): void {
console.log('hit');
}
Null | Undefined
Muito utilizados ao criar um type
, no exemplo uma variável que recebe uma string
ou undefined
:
type myType = string | undefined;
let myValue: myType;
Never
Nunca retorna. O código quando lança uma exception, ele nunca vai retornar nada, pois foi interrompido. A função responsável por tratar e até disparar essa expection pode receber o type never
:
throw new Error("error");
function error(): never {
throw new Error("error");
}
Object
Estrutura de chave => valor, muito comum no JS
:
let people: object;
people = {
name: 'Maicon',
};
Type Inference
Ao declararmos uma variável sem tipagem definida, o TypeScript vai utilizar o type inference
, que define o tipo da variável como o tipo do valor atribuido a ela.
var text = 'foo'; // string
Type Aliases e Union
Podemos adotar estratégias para situações em que o tipo do valor pode se sobrepor, por exemplo
uma função onde o primeiro parâmetro pode ser uma string
ou number
.
Para esse caso existe o union, onde os tipos permitidos são separados por |
:
function logDetails(uuid: number | string, item: string) {
console.log(`A product with ${uuid} has a title as ${item}`);
}
Também existem os aliases onde definimos um "novo" tipo para o typescript:
type uuid = number | string;
function logDetails(uuid: uuid, item: string) {
console.log(`A product with ${uuid} has a title as ${item}`);
}
De forma resumida criamos um atalho para uma variável que pode receber mais de um tipo primitivo, um number
ou uma string
.
Também podemos usar os aliases para receber um valor pré-definido:
type platform = 'Windows' | 'Linux' | 'MacOS';
function logConsole(platform: platform) {
console.log(platform);
}
logConsole('Windows');
logConsole('Ubuntu'); // Argument of type '"Ubuntu"' is not assignable to parameter of type 'platform'.ts(2345)
Classes
O TypeScript pode ser usado tanto com paradigmas como Orientação a Objetos e também funcional. Por conta disso, assim como no es6, ele conta com features como classes.
class Employee {
public empName: string;
protected empCode: number;
constructor(name: string, code: number){
this.empName = name;
this.empCode = code;
}
logDetails(): void {
console.log(`empName: ${this.empName}, empCode: ${this.empCode}`);
}
}
const employee = new Employee('maicon', 12);
employee.logDetails();
// empName: maicon, empCode: 12
Classes também podem ser extendidas, para herdar atributos e métodos:
class SalesEmployee extends Employee{
department: string;
constructor(name: string, code: number, department: string) {
super(name, code);
this.department = department;
}
employeeDetails(): void {
console.log(`
empName : ${this.empName},
empCode : ${this.empCode},
departament: ${this.department}`
);
}
}
let emp = new SalesEmployee("John Smith", 123, "Sales");
emp.employeeDetails();
// empName: John Smith, empCode: 123, departament: Sales
Data Modifiers
Na programação orientada a objetos, o conceito de 'Encapsulamento' é usado para tornar os membros da classe públicos ou privados, ou seja, uma classe pode controlar a visibilidade de seus atributos e métodos. Isso é feito usando modificadores de acesso.
Existem quatro tipos principais de modificadores de acesso no TypeScript: public
, private
, protected
, readonly
.
Public
Por padrão, todos os membros de uma classe no TypeScript são públicos. Todos os membros públicos podem ser acessados em qualquer lugar, sem restrições.
class Employee {
public empCode: string;
empName: string;
}
let emp = new Employee();
emp.empCode = 123;
emp.empName = "Swati";
Private
O modificador de acesso privado garante que os membros da classe sejam visíveis apenas para essa classe e não sejam acessíveis fora da classe que o contém.
class Employee {
private empCode: number;
empName: string;
}
let emp = new Employee();
emp.empCode = 123; // Compiler Error
emp.empName = "Swati"; // OK
Protected
O modificador de acesso protegido é semelhante ao modificador de acesso privado, exceto que os membros protegidos podem ser acessados usando suas classes derivadas.
class Employee {
public empName: string;
protected empCode: number;
constructor(name: string, code: number){
this.empName = name;
this.empCode = code;
}
}
class SalesEmployee extends Employee{
private department: string;
constructor(name: string, code: number, department: string) {
super(name, code);
this.department = department;
}
}
let emp = new SalesEmployee("John Smith", 123, "Sales");
emp.empCode; //Compiler Error
Readonly
O modificador de acesso para leitura. Permite que um atributo seja acessível de fora da classe, mas não alterado:
class Employee {
readonly empCode: number;
empName: string;
}
let emp = new Employee();
emp.empCode = 123; // Compiler Error
TypeScript Accessor
O TypeScript suporta getters/setters como uma maneira de interceptar acessos a um atributo de um objeto. Isso fornece uma maneira de ter um controle mais refinado sobre como um atributo é acessado em cada objeto.
Vamos converter uma classe simples para usar get e set. Primeiro, vamos começar com um exemplo sem utilizar acessors
:
class Employee {
fullName: string;
}
let employee = new Employee();
employee.fullName = "Bob Smith";
if (employee.fullName) {
console.log(employee.fullName);
}
Mudar ou recuperar atributos de uma classe de forma explícita pode ser conveniente, mas isso torna o código frágil.
Com getters e setters podemos definir regras ao setar um nome, e também preservar os atributos da classe fornecendo-o através de um getter:
No exemplo a seguir o atributo _fullName
é privado, e só pode ser definido seguindo uma regra de maxLenght
:
const fullNameMaxLength = 10;
class User {
private _fullName: string;
constructor(name: string) {
this._fullName = name;
}
get fullName(): string {
return this._fullName;
}
set fullName(newName: string) {
if (newName && newName.length > fullNameMaxLength) {
throw new Error("fullName has a max length of " + fullNameMaxLength);
}
this._fullName = newName;
}
}
let user = new User('Denis Chambers');
console.log('constructor', user.fullName)
user.fullName = "Bob Smith";
console.log('setter', user.fullName);
Um detalhe é que getters e setters não são chamados como um método ou função utilizando parênteses, mas apenas como atributo do objeto:
user.fullName = 'Maicon Silva'; // Setter
user.fullName; // Getter
Classes abstratas
Classes abstratas são classes base das quais outras classes podem ser derivadas. Elas não podem ser instanciadas diretamente.
abstract class Animal {
abstract makeSound(): void;
move(): void {
console.log("roaming the earth...");
}
}
São utilizadas como modelos para outras classes, para serem extendidas e então instanciadas.
Interfaces
Interaces descreve o formato que um objeto deve ter:
interface LabeledValue {
size: number;
label: string;
tags: string[];
getTag: (tag: string) => string;
}
function printLabel(labeledObj: LabeledValue) {
console.log(labeledObj.label);
}
let myObj: LabeledValue = {
size: 10,
label: "Size 10 Object",
tags: ['number', 'string', 'array'],
getTag: (label) => label,
};
printLabel(myObj);
As interfaces
trabalham com todos os tipos primitivos e também aceitam aliases
ou até mesmo outra interface
:
interface User {
name: string;
age?: number;
}
interface LabeledValue {
id: string | number;
user: User;
}
let myObj: LabeledValue = {
id: 10,
user: {
name: 'Maicon'
},
}
Para declararmos uma atributo na interace
que é opcional, interrogação ?
deve ser adicionado na propriedade opcional:
interface LabeledValue {
id?: string | number;
}
Caso contrário o objeto criado deve possuir todas as propriedades presente na interface
para não ocorrer erro de compilação.
Readonly property
Uma interface
pode receber o modificador de acesso para propriedades que não podem ser alteradas após a criação do objeto. Para isso a propriedade em questão deve ser precedida de readonly
e o objeto deve receber a interface como tipagem:
interface User {
readonly id: number;
name: string;
}
const user: User = {
id: 1,
name: 'Maicon'
}
user.id = 12; // Compile Error
user.name = 'Maicon Silva'; // OK
Extends interface
Interfaces podem ser extendidas assim como classes, dessa maneira a nova interface criada recebe os atributos da "interface mãe", mais os seus:
interface User {
readonly id: number;
name: string;
}
interface UserAddress extends User {
zipcode: string;
}
const address: UserAddress = {
id: 1,
name: 'Maicon',
zipcode: '05164110'
}
Implementando a interface em uma classe
Podemos também implementar uma classe que utiliza uma interface como base:
interface User {
readonly id: number;
name: string;
}
class CreateUser implements User {
id: number;
name: string;
constructor(id, name) {
this.id = id;
this.name = name;
}
}
const user = new CreateUser(10, 'Maicon Silva');
Generics
Uma parte importante na engenharia de software é a construção de componenets que não apenas possuem um escopo bem definido e consistente, mas que também são reutilizaveis. Esses são os generics.
Vamo criar uma função que é reposável por atribuir e retornar o estado de uma variável:
function useState() {
let state: number;
function getState() {
return state;
}
function setState(newState: number) {
state = newState;
}
return {
getState,
setState,
};
}
const newState = useState();
newState.setState(123);
console.log(newState.getState()); // 123
Nesse cenário, passar uma string ou qualquer outro tipo de dado para setState
vai gerar um erro de compilação, pois a função setState
espera receber um número.
Uma forma de contornar isso seria utilizar o union
:
...
let state: number | string;
function setState(newState: number | string) {
state = newState;
}
...
newState.setState(123); // OK
newState.setState('string'); // OK
Nesse momento entra o generic
. Através do generic
a variável pode receber seu tipo na primera vez que useState
foi chamado, e não ser alterado posteriormente:
newState.setState(123); // Agora o state é um número
newState.setState('string'); // Erro
Embora o uso any
ou union
possa ser genérico, ele pode nos privar de saber exatamente o valor que está entrando na função e também o que essa função irá retornar exatamente.
Nesse caso, precisamos de uma maneira de capturar o tipo do argumento de forma que também possamos usá-lo para indicar o que está sendo retornado. No próximo exemplo, vamor usar uma variável especial, um tipo de variável que funciona em tipos e não em valores.
// S = state
// T = Type
// K = key
// V = value
// E = element
function useState<S>() {
let state: S;
function getState() {
return state;
}
function setState(newState: S) {
state = newState;
}
return {
getState,
setState,
};
}
Isso faz com que o tipo da vairável seja definido no momento em que a função é chamada a primeira vez, no nosso caso na criação do newState
.
Se o tipo não for definido unknown
será retornado:
function useState<unknown>(): {
getState: () => unknown;
setState: (newState: unknown) => void;
}
Para definirmos a tipagem do generic, basta adicionar <type>
na criação de useState
:
const newState = useState<string>();
newState.setState('Agora é uma string'); // OK, foi criado como uma <string>
console.log(newState.getState());
newState.setState(123); // Erro
console.log(newState.getState());
Dessa forma nosso código bloqueia a entrada de qualquer dado que não seja uma string na função, mas isso
faz com que qualquer tipagem possa ser atribuida como generic
de useState
na sua criação:
const newState = useState<boolean | number[]>();
newState.setState([123, 456]); // OK
console.log(newState.getState());
newState.setState(false); // OK
console.log(newState.getState());
newState.setState('Agora é uma string'); // Error
console.log(newState.getState());
É possível extender os tipos que o generic
de useState
pode aceitar para controlar sua inicialização:
function useState<S extends string | number>() {
let state: S;
function getState() {
return state;
}
function setState(newState: S) {
state = newState;
}
return {
getState,
setState,
};
}
const newState = useState<boolean | number[]>(); // Erro
Default generic type
Também podemos atribuir um valor padrão para o generic
utilizando o operador =
:
function useState<S extends string | number = string>() {
let state: S;
function getState() {
return state;
}
function setState(newState: S) {
state = newState;
}
return {
getState,
setState,
};
}
Isso faz com que se useState
for chamado sem a definição do generic
, o tipo atribuido será string
:
const newState = useState(); // string
newState.setState('Agora é uma string');
console.log(newState.getState());
newState.setState(123); // Erro
console.log(newState.getState());
Type Utilities
O TypeScript fornece vários type utilities para facilitar transformações de tipos comuns. Esses utilitários estão disponíveis globalmente.
interface Todo {
title: string;
description: string;
completed: boolean;
}
const todo: Todo = {
title: 'Delete inactive users',
description: 'Remove all inactive users',
completed: false,
};
console.log(todo); // { ..., completed: false }
todo.completed = true; // OK
console.log(todo); // { ..., completed: true }
Alterar propriedades de objetos de forma direta pode acarretar side effects, quebra de contratos etc. Uma forma de previnir essa operação seria o Readonly<T>
type utilitie:
interface Todo {
title: string;
description: string;
completed: boolean;
}
const todo: Readonly<Todo> = {
title: 'Delete inactive users',
description: 'Remove all inactive users',
completed: false,
};
console.log(todo);
todo.completed = true; // Error
console.log(todo);
Uma forma de alterar esse objeto seria uma função que recebe o objeto e os dados que devem ser alterados, e retorna esses
valores atualizados. Para isso temos o Partial<T>
, que recebe propriedades do tipo, porém de forma opcional:
interface Todo {
title: string;
description: string;
}
function updateTodo(todo: Todo, fieldsToUpdate: Partial<Todo>) {
return { ...todo, ...fieldsToUpdate };
}
const todo1 = {
title: 'organize desk',
description: 'clear clutter',
};
const todo2 = updateTodo(todo1, {
description: 'throw out trash',
});
Também podemos criar um novo tipo "pegando propriedades" de um tipo já existente com o pick
:
interface Todo {
title: string;
description: string;
completed: boolean;
}
type TodoPreview = Pick<Todo, 'title' | 'completed'>;
const todo: TodoPreview = {
title: 'Clean room',
completed: false,
};
Uma outra forma de conseguir o mesmo resultado seria usar o Omit
:
interface Todo {
title: string;
description: string;
completed: boolean;
}
type TodoPreview = Omit<Todo, 'description'>;
const todo: TodoPreview = {
title: 'Clean room',
completed: false,
};
Ele funciona de forma contraria ao Pick
, recebendo apenas as propriedades que devem ser omitidas, no caso description
. Assim TodoPreview
é construido com title
e completed
.
Existem alguns outros type utilities que podemos usar, vale a pena conferir na doc.
Decorators
Os decorator são um recurso que pode ser usado para extender funcionalidades de classes, métodos, propriedade, acessores ou parâmetro. Utilizam @Expression
, onde expression
deve avaliar uma função que será chamada em tempo de execução com informações sobre a declaração decorada.
Atualmente os decorators é uma proposta de estágio 2 para o TypeScript.
Decoradores são um recurso experimental que pode mudar em versões futuras.
Para habilitar o suporte experimental aos decorators, é necessário uma configuração no tsconfig.json
:
...
"experimentalDecorators": true,
...
Criando um decorator
O decorador é uma função que recebe target
, sendo target
a instância da classe, como um parâmetro default:
function sealed(target) {
console.log(target);
}
@sealed
class Foo {}
new Foo(); // [Function: Foo]
Factory decorator
Se quisermos personalizar como um decorador é aplicado a uma declaração, podemos escrever uma fábrica de decoradores. Uma Decorator Factory é simplesmente uma função que retorna a expressão que será chamada pelo decorador em tempo de execução.
Podemos escrever uma fábrica de decoradores da seguinte maneira:
function logger(prefix: string) {
return (target) => {
console.log(`${target} - ${prefix}`);
}
}
@logger('isSealed')
class Foo { }
Class decorator
Como exemplo, vamos criar uma classe API
que recebe um decorator
para setar sua versão.
O que esse decorator
faz é retornar um construtor de classe que extende por padrão a classe target
:
function setAPIVersion(apiVersion: string) {
return (target) => {
return class extends target {
version = apiVersion;
}
}
}
@setAPIVersion('1.0.8')
class API { }
console.log(new API()); // class_1 { version: '1.0.8' }
Caso o decorator
retorne um valor, ele substituirá a declaração de classe pelo valor fornecido, que deve ser um construtor. Dessa maneira podemos aplicar mudanças diretas à classe, ao invés de apenas no protótipo da classe.
Property decorator
Um case comum é precisarmos validar uma propriedade de uma classe no momento em que ela é instânciada ou em que a propriedade é alterada. Nesse cenário, um property decorator
é uma solução.
Imagina a classe Person
que precisa receber a idade da pessoa, porém essa pessoa precisa ser maior de idade, ou no nosso caso, ter mais de 18 anos:
function minPersonAge(minAge: number) {
return (target: any, key: string) => {
let val = target[key];
const getter = () => val;
const setter = (value: number) => {
if (value < 18) {
throw new Error('Age must be over 18');
}
val = value;
};
Object.defineProperty(target, key, {
get: getter,
set: setter,
});
};
}
class Person {
// Precisa ser maior que 18
@minPersonAge(18)
age: number;
constructor(a: number) {
this.age = a;
}
}
console.log(new Person(17)); // Error
console.log(new Person(18)); // Person {}
Dessa vez o decorator
recebe target
e key
, sendo target
o objeto da classe e key
a propriedade onde o decorator
está assinado.
Method decorator
O method decorator
roda sempre que o método da classe for chamado.
Como exemplo, vamos criar uma classe Greeter
, onde o método greet
recebe um decorator
que força um delay antes de executar o método em sí:
function delay(ms: number) {
return (target: any, key: string, descriptor: PropertyDescriptor) => {
const originalMethod = descriptor.value;
descriptor.value = function (...args) {
setTimeout(() => {
originalMethod.apply(this, ...args);
}, ms);
return descriptor;
}
}
}
class Greeter {
greeting: string;
constructor(g: string) {
this.greeting = g;
}
// Cumprimenta depois de um determiado tempo
@delay(2000)
greet() {
console.log(this.greeting);
}
}
const pessoa = new Greeter('Good morning!');
pessoa.greet();
Assim como os decorators anteriores, o method decorator
também recebe target
e key
, mas também recebe descripton
, que contém as assinaturas do método original.
Conclusão
O uso do TypeScript trás uma série de benefícios ao JavaScript. A fluência na linguagem só vai acontecer a partir do momento que você começar a utiliza-lo, e ver como é bom ter um controle maior sobre os dados que entram e saem do seu sistema. Como toda tecnologia é necessário praticar e aplicar.
Se você ja programa em JavaScript, a curva de adaptação é pequena, e é algo que vale a pena encarar.
Para concluir, os tópicos que abordamos no post foram:
- Por que usar TypeScript?;
- Primeiro código, compilação;
- TSConfig;
- Recursos da linguagem - Types;
- Type Inference;
- Type Aliases e Union;
- Classes;
- TypeScript Accessors;
- Classes abstratas;
- Interfaces;
- Generics;
- Type Utilities;
- Decorators.
Você pode conferir o código produzido durante a escrita do artigo no meu Github.
Dicas, sugestões, conselhos ou melhorias? Você pode entrar em contato comigo pelo meu email ou abrir uma PR no repositório aqui.