Skip to content

v0.41.1 - Counter Refactor and Documentation Updates (2026-03-23)

What Changed?

This release removes the logger argument from Counter and moves log output responsibility to AfterGlow, keeping each module focused on a single responsibility. Documentation is also updated: the getting-started guide now uses FlameFrame throughout, and a new developer guide covers the convert.ts utilities and Cell type.

What's New

Refactor: Counter no longer accepts a logger argument

What it does: Counter.increment() and Counter.reset() previously accepted an optional logger argument to output log messages. This created an implicit circular dependency between Counter and AfterGlow. The logger argument has been removed, and AfterGlow.count() / AfterGlow.countReset() now handle log output directly.

Before:

JavaScript
// AfterGlow was passing itself into Counter — circular coupling
this._counter.increment(label, this);
this._counter.reset(label, this);

After:

JavaScript
// Counter manages numbers; AfterGlow manages logging
const value = this._counter.increment(label);
this.info(`${label}: ${value}`);

this._counter.reset(label);
this.info(`${label}: reset to 0`);

Added

  • Developer guide: convert.ts utilities and Cell type (docs/dev/convert.md, docs/dev/cell.md)

Changed

  • Counter.increment() and Counter.reset(): removed logger argument
  • AfterGlow.count() and AfterGlow.countReset(): now call this.info() directly for log output
  • Getting-started guide (docs/getting-started/): all examples migrated to FlameFrame API
  • Developer guide (docs/dev/): reorganized into subfolders; added FlameFrame, FlameWright, and DataFrame/Sheets guides

Is It Safe to Upgrade?

  • Breaking Changes: No
  • Backward Compatible: Yes

Counter is an internal class not exported for direct use. The behavioral change in AfterGlow.count() and AfterGlow.countReset() is identical to before — both still log the count value via info().

Release Details

  • Date: 2026-03-23
  • Version: v0.41.1
  • gaslamp: version 89
  • pilotlamp: version 46
  • Commits:
    • 9b7627c docs(gears): update Counter docstrings
    • 63ea76b refactor(gears): remove logger argument from Counter
    • 4fe60ed docs(getting-started): migrate examples to FlameFrame API
    • 525bdef docs(dev): add cell.md and deduplicate type docs from convert.md
    • b14a37f docs(dev): add convert.ts developer guide and guides section
    • 570e471 docs(api): regenerate TypeDoc API reference
    • ccdab2a docs(mkdocs): update nav for reorganized developer guide
    • 11798f8 docs(dev): reorganize developer guide into subfolders
    • 76fe01a docs(guides): add FlameWright runtime type validation guide
    • 01a5bf0 docs(guides): add FlameFrame and Schema Validation guide
    • 2b2fa5b docs(guides): add DataFrame and Google Sheets guide

Known Issues

  • None

Next Steps

  • Continue expanding developer guides for remaining modules