v0.62.0 - BareFrame-first refactor (2026-04-04)

What Changed?

This release refactors FlameFrame to be a schema validation layer only. Data operation methods (select, drop, filter, fillna, melt, pivot, unfoldColumns) have been removed from FlameFrame. Use BareFrame for all data operations, then call FlameFrame.from(df, schema) to validate.

---

What's New

Main Feature: BareFrame as the primary entry point

What it does: FlameFrame is now solely responsible for schema validation. All data transformation methods have been removed from FlameFrame and are available exclusively on BareFrame.

How to use it:

1. Read data into BareFrame
2. Apply transformations (filter, select, drop, etc.) on BareFrame
3. Call FlameFrame.from(df, schema) when validation is needed

Code example:

JavaScript

// Before (v0.61.0 and earlier)
const { frame, errors } = gaslamp.FlameFrame.from(df, schema);
const { frame: adults } = frame.filter(row => row.get("age") >= 18);
const { frame: result } = adults.select(["name", "age"]);

// After (v0.62.0)
const { frame, errors } = gaslamp.FlameFrame.from(df, schema);
const result = frame.toBareFrame()
  .filter(row => row.get("age") >= 18)
  .select(["name", "age"]);
// Re-validate if needed:
const { frame: validated } = gaslamp.FlameFrame.from(result, schema);

---

Added

• Nothing new added.

Changed

• FlameFrame is now a validation-only class. Use toBareFrame() to access the underlying BareFrame for data operations.

Fixed

• Nothing fixed.

---

Is It Safe to Upgrade?

• Breaking Changes: Yes
• Backward Compatible: No

The following FlameFrame methods have been removed:

Removed method	Replacement
frame.select(headers)	frame.toBareFrame().select(headers)
frame.drop(headers)	frame.toBareFrame().drop(headers)
frame.filter(predicate)	frame.toBareFrame().filter(predicate)
frame.fillna(value)	frame.toBareFrame().fillna(value)
frame.melt(options)	frame.toBareFrame().melt(options)
frame.pivot(options)	frame.toBareFrame().pivot(options)
frame.unfoldColumns(options)	frame.toBareFrame().unfoldColumns(options)

After calling toBareFrame() and applying operations, re-apply FlameFrame.from(df, schema) if schema validation is still required.

---

Release Details

• Date: 2026-04-04
• Version: v0.62.0
• gaslamp: 121
• pilotlamp: 79
• Files Changed: 25
• Commits:
  • 558c8373 refactor(flameframe): remove FlameFrame.select method
  • 65b607b4 refactor(flameframe): remove FlameFrame.drop method
  • 4051f229 refactor(flameframe): remove FlameFrame.filter method
  • 09afeb05 refactor(flameframe): remove FlameFrame.fillna method
  • 1b7c28fa refactor(flameframe): remove FlameFrame.melt method
  • 496235d3 refactor(flameframe): remove FlameFrame.pivot method
  • 4843c424 refactor(flameframe): remove FlameFrame.unfoldColumns method
  • 44b53f62 refactor(flameframe): remove unused _skip and _pruneSchema helpers
  • 4267a2be docs(guides): update flameframe.md Filtering section
  • ed29a2df docs(guides): update flameframe.md Practical Workflow example
  • 10712a7f docs(flameframe): update @module docstring to reflect validation-only role

---

Known Issues

• None.

---

Next Steps

• Add migration note to docs/guides/migration.md for the FlameFrame method removal.