Tuples ([A, B, ...])

A Tuple is a fixed-length set of items of the given types. Example:

import { type HybridObject, iOS } from 'nitro-core'

type Point = [number, number]
@iOS(...)
export declare class Math extends HybridObject {
  distance(a: Point, b: Point): number
}

Tuples can also have different types per value:

Bad ❌

import { type HybridObject, iOS } from 'nitro-core'

type Values = (number | string | Person)[]
@iOS(...)
export declare class Math extends HybridObject {
  calculate(values: Values): void
}

The type in the Bad ❌ example generates an array of variants, where its size is unknown and each value could be a number, a string or a Person. It is less efficient than a tuple because of the variant allocation.

Good ✅

import { type HybridObject, iOS } from 'nitro-core'

type Values = [number, string, Person]
@iOS(...)
export declare class Math extends HybridObject {
  calculate(values: Values): void
}

The type in the Good ✅ example generates a tuple, where its size is guaranteed to be 3 and each value is known at compile-time: values[0]: number, values[1]: string, values[2]: Person.