generic signature for dataframes

[scarf005]

Motivation

continuation of #151.

to reiterate:

• The type DataFrame in nodejs-polars lack generic type signature.
• Being able to know dataframe's structure in the type signature improves productivity and safety.
• This can be achieved using typescript's powerful type system. (e.g: Pick, Omit)

Feature Request

• Add generic type parameter for DataFrame type
• Defaults to any for type checker performance
• (Later) make methods of DataFrame and Series dependently typed.

To-be

import pl from "npm:nodejs-polars"

const df = pl.DataFrame({
    fruit: ["Apples", "Oranges"],
    comparability: [0, 1],
})
// df: pl.DataFrame<{ fruit: pl.Series<"Utf8">, comparability: pl.Series<"Float64"> }>

const obj = df.toObject()
// obj: { fruit: string[], comparability: number[] }

const fruit = df.getColumn('fruit')
// fruit: pl.Series<"Float64">

Additional Notes

current progress (2024-11-14):