Array Settings

A single option controls array generation: arrayLength.

Usage

Every array produced by the call — at any depth — gets exactly arrayLength elements (default 3):

const tags = Forger.create<string[]>({ arrayLength: 6 })!;
// exactly 6 strings

interface Report {
  rows: string[];
  matrix: number[][];
}

const report = Forger.create<Report>({ arrayLength: 4 })!;
// rows: 4 strings; matrix: 4 arrays of 4 numbers each

Per level, not per graph

The length applies to every array occurrence, including arrays nested inside arrays and arrays of objects containing further arrays. arrayLength: 5 on number[][] yields a 5×5 matrix.

Not applied to tuples

Tuples ([string, number]) take their length from the type declaration and are not affected by arrayLength — see Tuples.

Reference

Option	Type	Default	Notes
`arrayLength`	`number`	`3`	Exact length of every generated array

08 September 2026