feat(types): enhance TypedReturn to support primitive arrays

[ifyoumakeit]

Problem

When using get on a dynamic config with a fallback value, TypeScript returning Array<unknown> for all fallbacks of type array. This forced the use of type assertions (as) to get the correct typing, which isn't ideal for type safety.

Solution

Enhanced the TypedReturn type to properly handle arrays of primitive types (string, number, boolean) by recursively processing array element types. This maintains type safety while supporting the full range of JSON-compatible types, including nested arrays of primitives.

Testing

// Primitive arrays
const stringList = config.get("test.stringList", ["foo", "bar"]);       // type: string[]
const numberList = config.get("test.numberList", [1, 2, 3]);            // type: number[]
const booleanList = config.get("test.booleanList", [true, false]);      // type: boolean[]

// Nested arrays
const matrix = config.get("test.matrix", [[1, 2], [3, 4]]);            // type: number[][]
const stringMatrix = config.get("test.stringMatrix", [["a"], ["b"]]);   // type: string[][]

// Mixed arrays
const mixedList = config.get("test.mixed", ["foo", 42, true]);         // type: (string | number | boolean)[]
const stringOrNumber = config.get("test.mixed", ["foo", 42]);          // type: (string | number)[]

// Enum arrays
enum Status { Active = "ACTIVE", Inactive = "INACTIVE" }
const statusList = config.get("test.status", [Status.Active]);          // type: string[]

// Object arrays
const objectList = config.get("test.objects", [{ id: 1 }, { id: 2 }]); // type: object[]

// With undefined (fallback)
const maybeList = config.get("test.maybe");                            // type: unknown
const defaultList = config.get("test.default", [] as string[]);        // type: string[]

// Tuple types
const tuple = config.get("test.tuple", ["id", 123] as [string, number]); // type: [string, number]

[ifyoumakeit]

ha, closing since this is most likely due to how ya'll check value against the fallback type with _isTypeMatch for typed getters, and don't recurse over the array there.