Skip to content

v0.45.0 - DataFrame v1 Archived to legacy/v1 (2026-03-27)

What Changed?

This release archives DataFrameV1, GroupedDataFrameV1, and LazyFrameV1 from the active codebase into legacy/v1/. These symbols were deprecated since v0.42.0 and have been superseded by BareFrame, GroupedFrame, and LazyFrame in src/v2/. The gaslets functions that returned DataFrame now return BareFrame.

What's New

Main Feature: DataFrame v1 Archived

What it does: src/torch/dataframe/ and src/torch/lazyframe/ are moved to legacy/v1/ and removed from the public API. The active codebase now depends exclusively on the v2 frame implementations.

How to use it: Replace any remaining DataFrameV1 usage with BareFrame:

TypeScript
// Before (v1)
const df = new DataFrame().fromArrays(arrays, { header: true });
df.toArrays({ headers: true });

// After (v2)
const df = BareFrame.fromArrays(arrays);
df.toArrays();

Added

  • Nothing added.

Changed

  • src/torch/dataframe/ moved to legacy/v1/dataframe/
  • src/torch/lazyframe/ moved to legacy/v1/lazyframe/
  • DataFrameV1, GroupedDataFrameV1, LazyFrameV1 removed from public exports
  • readDataFrameFromRange / readDataFrameFromSheet return type changed: DataFrame → BareFrame
  • writeDataFrameToRange / writeDataFrameToSheet parameter type changed: DataFrame → BareFrame

Fixed

  • Nothing fixed.

Is It Safe to Upgrade?

  • Breaking Changes: Yes
  • Backward Compatible: No

Users who import DataFrameV1, GroupedDataFrameV1, or LazyFrameV1 directly from gaslamp will need to migrate to the v2 equivalents. The gaslets sheet/drive functions now require BareFrame instead of DataFrame.

Release Details

  • Date: 2026-03-27
  • Version: v0.45.0
  • gaslamp: clasp version 97
  • pilotlamp: clasp version 55
  • Files Changed: 222
  • Commits:
    • 082307cc refactor(torch): remove dataframe and lazyframe exports from torch/index
    • f1605353 refactor(gaslets): migrate sheet-dataframe from DataFrame to BareFrame
    • 606271d1 refactor(gaslets): migrate drive from DataFrame to BareFrame
    • 3be03616 chore: regenerate API docs and bundle after dataframe v1 removal
    • 6ffc09d3 refactor(torch): move dataframe and lazyframe to legacy/v1
    • 3491a31f test(torch): remove v1 DataFrame and GroupedDataFrame test files
    • 2c346030 docs(legacy): update v1/README to reflect dataframe/lazyframe archive status

Known Issues

  • Expression (src/torch/expression/) remains in src/ and is not yet archived.
  • FlameWright v1 (src/flamewright/) and AfterGlow v1 (src/afterglow/) are still pending removal.

Next Steps

  • Archive Expression to legacy/v1/
  • Archive FlameWright v1 and AfterGlow v1 to legacy/v1/