Blog Docs Log in Get started

pantheon-ai/typescript-advanced

Comprehensive TypeScript guidance covering compiler configuration, advanced types, utility types, type guards, strict mode workflows, and documentation patterns; use when configuring tsconfig, designing complex generics, making illegal states unrepresentable, fixing type errors, or writing testable and maintainable type-safe APIs.

Overall
score

99%

Review — 99%

Does it follow best practices?

Validation — 10 / 11 Passed

Validation for skill structure

Generics

Basic Generics

Type variables that allow components to work with any type:

function identity<T>(value: T): T {
  return value;
}

const num = identity(42);        // T inferred as number
const str = identity("hello");   // T inferred as string

Generic Constraints

Restrict type parameters with extends:

interface HasLength {
  length: number;
}

function logLength<T extends HasLength>(value: T): void {
  console.log(value.length);
}

logLength("hello");     // OK
logLength([1, 2, 3]);   // OK
logLength({ length: 5 }); // OK
// logLength(42);       // Error: number has no length

Multiple Type Parameters

function pair<T, U>(first: T, second: U): [T, U] {
  return [first, second];
}

const result = pair("age", 30); // [string, number]

// With constraints
function merge<T extends object, U extends object>(
  obj1: T,
  obj2: U
): T & U {
  return { ...obj1, ...obj2 };
}

Generic Interfaces

interface Container<T> {
  value: T;
  map<U>(fn: (value: T) => U): Container<U>;
}

interface Response<T> {
  data: T;
  status: number;
  headers: Record<string, string>;
}

const userResponse: Response<User> = {
  data: { id: 1, name: 'Alice' },
  status: 200,
  headers: {}
};

Generic Classes

class Box<T> {
  constructor(private value: T) {}
  
  getValue(): T {
    return this.value;
  }
  
  map<U>(fn: (value: T) => U): Box<U> {
    return new Box(fn(this.value));
  }
}

const numBox = new Box(42);
const strBox = numBox.map(n => n.toString());

Default Type Parameters

interface Config<T = string> {
  value: T;
}

const stringConfig: Config = { value: "hello" };
const numberConfig: Config<number> = { value: 42 };

// Useful for API responses
interface ApiResponse<T = unknown> {
  data: T;
  error?: string;
}

Generic Type Aliases

type Result<T, E = Error> = 
  | { success: true; value: T }
  | { success: false; error: E };

type Nullable<T> = T | null;
type AsyncFn<T, Args extends any[]> = (...args: Args) => Promise<T>;

Constrained Keys

function getProperty<T, K extends keyof T>(obj: T, key: K): T[K] {
  return obj[key];
}

const user = { name: 'Alice', age: 30 };
const name = getProperty(user, 'name'); // string
const age = getProperty(user, 'age');   // number
// getProperty(user, 'invalid');        // Error

Generic Inference

TypeScript infers generic types from usage:

// Inferred from argument
function wrap<T>(value: T) {
  return { value };
}

const wrapped = wrap(42); // { value: number }

// Inferred from return type
function parse<T>(json: string): T {
  return JSON.parse(json);
}

const user: User = parse('{"name":"Alice"}'); // T inferred as User

Advanced Generic Patterns

Builder Pattern

class QueryBuilder<T> {
  private conditions: string[] = [];
  
  where(condition: string): QueryBuilder<T> {
    this.conditions.push(condition);
    return this;
  }
  
  execute(): T[] {
    // Execute query
    return [];
  }
}

Type-Safe Event Emitter

type EventMap = Record<string, any>;

class TypedEmitter<Events extends EventMap> {
  on<K extends keyof Events>(
    event: K,
    handler: (payload: Events[K]) => void
  ): void {
    // Implementation
  }
  
  emit<K extends keyof Events>(event: K, payload: Events[K]): void {
    // Implementation
  }
}

interface AppEvents {
  'user:login': { userId: string; timestamp: Date };
  'user:logout': { userId: string };
}

const emitter = new TypedEmitter<AppEvents>();
emitter.on('user:login', (payload) => {
  // payload is correctly typed as { userId: string; timestamp: Date }
});

Best Practices

Use descriptive generic names (T for type, K for key, V for value)
Add constraints to generics when possible
Leverage type inference instead of explicit type arguments
Use default type parameters for common cases
Avoid over-constraining generics

Common Pitfalls

Don't use generics when concrete types suffice
Avoid too many type parameters (>3 is often a code smell)
Don't forget to constrain when needed
Avoid losing type information by being too generic

Install with Tessl CLI

npx tessl i pantheon-ai/typescript-advanced@0.1.1

references

compiler-module-resolution.md

compiler-performance.md

compiler-strict-mode.md

compiler-tsconfig.md

docs-adr-templates.md

docs-framework-docs.md

docs-jsdoc-patterns.md

docs-typedoc-config.md

guards-assertion-functions.md

guards-basic.md

guards-branded-types.md

guards-discriminated-unions.md

guards-exhaustiveness.md

guards-generic.md

guards-inference-infer.md

guards-inference-return.md

patterns-advanced-generics.md

patterns-api-client.md

patterns-branded-types.md

patterns-builder.md

patterns-deep-readonly.md

patterns-dependency-injection.md

patterns-event-emitter.md

patterns-form-validation.md

patterns-plugin-system.md

patterns-recursive-types.md

patterns-state-machine.md

patterns-type-safe-module.md

practices-illegal-states.md

practices-module-patterns.md

practices-runtime-validation.md

practices-type-first.md

types-conditional.md

types-generics.md

types-index-signatures.md

types-mapped.md

types-narrowing.md

types-template-literals.md

types-type-assertions.md

types-unions-intersections.md

utilities-custom-mapped-types.md

utilities-extract-exclude.md

utilities-key-remapping.md

utilities-nonnullable-awaited.md

utilities-partial-required.md

utilities-pick-omit.md

utilities-readonly-record.md

utilities-returntype-parameters.md