Skip to content

v0.41.3 - DataFrameV1 deprecated / FlameFrameInvalid renamed (2026-03-24)

What Changed?

This release deprecates the v1 DataFrame implementation and renames ValidationError to FlameFrameInvalid to align with the Flame* naming convention. Users of DataFrameV1 are now guided to migrate to DataFrameV2 from src/v2. Docstrings across the FlameFrame module were also improved with clearer descriptions and corrected examples.

What's New

Main Feature: FlameFrameInvalid

What it does: Renames the ValidationError type to FlameFrameInvalid to be consistent with the FlameFrame* naming convention used throughout the module.

How to use it: Replace any import of ValidationError with FlameFrameInvalid.

Code example:

TypeScript
// Before
import { ValidationError } from "gaslamp";

// After
import { FlameFrameInvalid } from "gaslamp";

const { frame, errors } = FlameFrame.fromColumns(
  { name: ["Alice", 123], age: [25, 30] },
  { name: FlameGuards.isString, age: FlameGuards.isNumber },
);

for (const invalid of errors.errors) {
  Logger.log(`row ${invalid.rowIndex}: "${invalid.field}" got ${invalid.actual}`);
}

Added

  • Nothing added.

Changed

  • ValidationError renamed to FlameFrameInvalid — type name aligned with Flame* naming convention
  • DataFrameV1 marked as deprecated since 0.42.0 — users should migrate to DataFrameV2 from src/v2
  • FlameFrame docstrings improved — FlameFrameOptions, FlameFrameResult, FlameFrameInvalid descriptions and examples updated

Fixed

  • Nothing fixed.

Is It Safe to Upgrade?

  • Breaking Changes: Yes
  • Backward Compatible: No

ValidationError has been renamed to FlameFrameInvalid. Any code importing ValidationError must be updated. DataFrameV1 is now deprecated; existing code continues to work but deprecation warnings will appear in IDEs.

Release Details

  • Date: 2026-03-24
  • Version: v0.41.3
  • gaslamp: v91
  • pilotlamp: v48
  • Files Changed: 153
  • Commits:
    • 094fee8 chore: update bundle and analysis artifacts
    • d22ea41 docs(api): regenerate TypeDoc API reference
    • 0010627 chore: update uv.lock
    • 2b96c6f bump: version 0.41.2 → 0.41.3
    • f953bce docs(v2): improve FlameFrameOptions and FlameFrameResult docstrings
    • 17afa56 docs(v2): update FlameFrameInvalid docstring and fix examples
    • 892ee33 refactor(v2): rename ValidationError to FlameFrameInvalid
    • 9f6db84 docs(api): regenerate TypeDoc API reference
    • 5127148 refactor(torch): mark DataFrameV1 as deprecated since 0.42.0

Known Issues

  • Nothing known.

Next Steps

  • Complete migration of remaining v1 modules to v2
  • Remove DataFrameV1 in a future major release