guiseek

1. Introdução

• Por que TypeScript melhora a experiência em projetos reais
• Diferença entre “tipar por tipar” e “usar tipos para clareza e manutenção”
• Cenários comuns de má experiência com TS

2. Tipagem com propósito

• Inferência de tipos vs. tipagem explícita: quando cada um é útil
• Uso inteligente de as const, literais e enums
• Evitando any e unknown mal utilizados

guiseek

export function range(length: number): IterableIterator<number>
export function range(start: number, stop: number): IterableIterator<number>
export function range(start: number, stop: number, step: number): IterableIterator<number>
export function* range(start: number, stop?: number, step = 1): IterableIterator<number> {
  if (stop === undefined) {
    return yield* range(0, start)
  }

  if (step === 0) {
    throw new RangeError('Step cannot be zero.')

guiseek

import {Mesh, Vector3, type BufferGeometry, type Vector3Tuple} from 'three'
import {ConvexHull} from 'three/examples/jsm/Addons.js'
import {
  Box,
  Vec3,
  Plane,
  Sphere,
  Trimesh,
  Cylinder,
  Heightfield,

guiseek

type Tag = keyof HTMLElementTagNameMap

type Dom = {
  [T in Tag]: <A extends HTMLElementTagNameMap[T]>(
    attrs: Partial<A>
  ) => HTMLElementTagNameMap[T]
}

// prettier-ignore
const TAGS: Tag[] = ['a','abbr','address','area','article','aside','audio','b','base','bdi','bdo','blockquote','body','br','button','canvas','caption','cite','code','col','colgroup','data','datalist','dd','del','details','dfn','dialog','div','dl','dt','em','embed','fieldset','figcaption','figure','footer','form','h1','h2','h3','h4','h5','h6','head','header','hgroup','hr','html','i','iframe','img','input','ins','kbd','label','legend','li','link','main','map','mark','menu','meta','meter','nav','noscript','object','ol','optgroup','option','output','p','picture','pre','progress','q','rp','rt','ruby','s','samp','script','search','section','select','slot','small','source','span','strong','style','sub','summary','sup','table','tbody','td','template','textarea','tfoot','th','thead','time','title','tr','track','u','ul','var','video','wbr',]

guiseek

export class Alias<T> {
  name: string
  constructor(name: string) {
    this.name = name
    return this as Alias<T>
  }
}

guiseek

type Concrete<T> = new (...params: any[]) => T;
type Abstract<T> = abstract new (...params: any[]) => T;

type Factory<T> = (...params: any[]) => T;
type AsyncFactory<T> = (...params: any[]) => Promise<T>;

type Ref<T> = Concrete<T> | Abstract<T>;

type Use<T> = Concrete<T>;

guiseek

export type Abstract<T, P extends unknown[] = never[]> = abstract new (
  ...args: P
) => T;

guiseek

import { Abstract, AsyncFactory, Constructor, Factory, Params } from './types';
import { validate } from './validate';
import { Token } from './token';

type Ref<T> = Token<T> | Abstract<T> | Constructor<T>;

type Use<T> = Constructor<T> | Factory<T> | AsyncFactory<T> | T;

interface Config<T> {
  ref: Ref<T>;

guiseek

import { createWriteStream, PathLike } from "node:fs";
import { Console } from "node:console";

export const logger = <T>(path: PathLike, data: T[]) => {
  const stream = createWriteStream(path);

  const console = new Console(stream);

  console.table(data);

guiseek

export type Abstract<T = any> = abstract new (...params: any[]) => T;