Skip to content

v0.41.2 - fromRange/fromSheet API Fix and Documentation Updates (2026-03-24)

What Changed?

This release fixes the fromRange and fromSheet API on DataFrame (v2), replacing the header: boolean flag with an optional headers?: string[] parameter that is consistent with the existing fromArrays API. Documentation for JunkPocket and typedoc.json configuration are also cleaned up.

What's New

Fix: fromRange / fromSheet now accept explicit headers

What it does: The header: boolean parameter has been replaced with headers?: string[]. When omitted, the first row is used as column names (same as before). When provided, all rows are treated as data rows and the supplied array is used as column names.

Before:

JavaScript
// header=false generated numeric column names automatically
const df = gaslamp.DataFrameV2.fromRange(range, false);

After:

JavaScript
// headers omitted: first row becomes column names (default)
const df = gaslamp.DataFrameV2.fromRange(range);

// headers provided: all rows become data, explicit names are used
const df2 = gaslamp.DataFrameV2.fromRange(range, ["name", "age", "score"]);

Added

  • Nothing new.

Changed

  • DataFrame.fromRange(): header: boolean → headers?: string[]
  • DataFrame.fromSheet(): header: boolean → headers?: string[]
  • typedoc.json: removed stale types from intentionallyNotExported; aligned categoryOrder and groupOrder with actual @category / @group tags in the codebase
  • JunkPocket docstrings: improved descriptions and examples; fixed @since from 1.0.0 to 0.14.0

Fixed

  • Nothing.

Is It Safe to Upgrade?

  • Breaking Changes: Yes (minor)
  • Backward Compatible: No — header: boolean is no longer accepted

Any call passing false to fromRange or fromSheet will cause a TypeScript compile error. Replace fromRange(range, false) with fromRange(range) (first row as headers) or fromRange(range, ["col0", "col1", ...]) (explicit headers, all rows as data).

Release Details

  • Date: 2026-03-24
  • Version: v0.41.2
  • gaslamp: version 90
  • pilotlamp: version 47
  • Commits:
    • ed4907f fix(v2): change fromRange/fromSheet signature from header:boolean to headers?:string[]
    • 26803fc chore(typedoc): fix intentionallyNotExported and align category/group order
    • 8a34483 docs(gears): update JunkPocket docstrings and fix @since version

Known Issues

  • None

Next Steps

  • Continue v2 API stabilization