# Changelog

All notable changes to this project will be documented in this file.

The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

## [2.1.0] - 2026-09-14

### Added

- Optional lazy initialization via Intersection Observer (`initDom({ lazy: true })`). Effects are created when elements approach the viewport (`rootMargin: "100px"`).
- Lifecycle events on effects (`start`, `progress`, `complete`, `error`) through the `EventTarget` pattern.
- Accessibility support: `prefers-reduced-motion`, `aria-live`, and `aria-label` announcements for screen readers.
- Automated test suite with Vitest and jsdom covering phrase extraction, looping, and `LasciiTextEffect` behavior.

### Changed

- Build system migrated from `tsc` to `tsup` (ESM + CJS, minification, declaration emit, source maps, and tree shaking).
- Added `build:watch` and `dev` scripts for faster local iteration.

## [2.0.0] - 2026-07-24

### Breaking Changes

- Auto-init no longer runs on `import "lascii"` or `import "lascii/dom"`. Migrate to `import "lascii/auto"` (or call `autoInitDom()` / `init()` manually).

### Added

- Structured error handling with logging and graceful fallbacks in `LasciiImageEffect` and `LasciiTextEffect`.
- `dispose()` lifecycle API (`Disposable`) to cancel timers, animation frames, and release DOM resources.
- `lascii/auto` entry point for declarative auto-initialization (`import "lascii/auto"`).
- `static init()` now returns created effect instances for easier cleanup in SPAs.
- Repository tooling: `CODEOWNERS` and pull request template.

### Changed

- Main entry (`lascii`) and `lascii/dom` are side-effect free for better tree shaking.
- `package.json` `sideEffects` now marks only `./dist/auto.js`.

### Fixed

- Silent failures during canvas initialization and image load now log structured warnings and restore the original element.
- Potential memory leaks from untracked timeouts, intervals, and `requestAnimationFrame` loops in long-lived SPAs.

## [1.1.0] - 2026-07-02

### Changed

- Migrated library source from JavaScript to TypeScript.
- Build output is now compiled to `dist/` with generated `.d.ts` and source maps.
- TypeScript declarations are generated from source instead of hand-written files.

### Added

- `npm run build` script and `prepare` hook for automatic compilation on install.

## [1.0.0] - 2026-05-27

### Added

- Initial public release of `lascii`.
- `LasciiTextEffect` — scramble/reveal text with optional phrase looping (`|:|` separator).
- `LasciiImageEffect` — ASCII canvas animation with staggered cell reveal and image fade-in.
- DOM adapter with `data-lascii-text` and `data-lascii-image` attributes.
- Auto-initialization on `DOMContentLoaded` when importing `lascii` or `lascii/dom`.
- Subpath exports: `lascii/dom`, `lascii/core/text`, `lascii/core/image`.
- TypeScript declaration files for all public entry points.
- Documentation: README, API reference, contributing and security policies.

[2.1.0]: https://github.com/whosramoss/lascii/releases/tag/v2.1.0
[2.0.0]: https://github.com/whosramoss/lascii/releases/tag/v2.0.0
[1.1.0]: https://github.com/whosramoss/lascii/releases/tag/v1.1.0
[1.0.0]: https://github.com/whosramoss/lascii/releases/tag/v1.0.0