# Changelog ## Release v1.1.1 (2026-10-18) ### Features - Bundle offline Markdown documentation (`ai/usage.md`, `getting-started.md`, concepts, recipes, migrations, changelog) directly in the npm distribution package. - Provide machine-readable AI Agent Guide (`ai/usage.md`) and dynamic `llms.txt` ecosystem index for AI coding assistants. - Add version-specific migration guides covering `v0.0.1-rc.1 -> v0.0.1-rc.2`, `v0.0.1-rc.2 -> v1.0.0`, and `v1.0.x -> v1.1.0` with verified Angular 22 before/after code transformations. - Export raw Markdown documentation endpoints (`.md`) across all documentation routes. - Add automated validation scripts for package archive structure, Markdown link resolution, version consistency, and Angular `ngc` recipe/migration snippet compilation. ### Bug Fixes & Behavioral Changes - Fix duplicate H1 headings rendered on documentation pages in Starlight. ### Deprecations - None. ### Breaking Changes - None. ## Release v1.1.0 (2026-10-18) ### Features - Add opt-in `preserveOnLayoutChange` configuration option to maintain section-relative scroll positions during asynchronous layout reflows (e.g., accordions, lazy images, form expansions). - Preserve section-relative pixel displacement (`displacement`) across automatic layout corrections and data updates to keep the reader's exact reading position intact. - Add accessible focus management (`focus: true`) to `scrollTo()` with temporary `tabindex="-1"` handling and completion coordination for smooth scrolling. - Optimize layout reflow tracking using region-scoped `ResizeObserver` and `requestAnimationFrame` coalescing to prevent layout thrashing. - Guard against scroll interruptions by deferring layout preservation during active smooth scrolling and skipping redundant sub-pixel (`< 1px`) scroll adjustments. - Update demo application with layout preservation controls, accordion examples, accessible navigation toggles, and refreshed architecture documentation. ### Bug Fixes & Behavioral Changes - None. ### Deprecations - None. ### Breaking Changes - None. ### Migration Guide - See [Migration Guide: v1.0 to v1.1](docs/src/content/docs/migrations/v1.0-to-v1.1.md) for upgrade instructions and before/after code examples. ## Release v1.0.0 ### Features - Handle subsequent Angular router fragment navigations automatically after initial page load without requiring consumer coordination. - Queue pending scroll targets and retry navigation via `MutationObserver` until asynchronous data and matching DOM elements are rendered. - Tag scroll-spy navigation origins to distinguish internal fragment updates from external navigation and prevent navigation loops. - Support browser history navigation (back/forward popstate) with scroll position restoration while preserving custom router history state. - Support multiple anchor prefixes via `anchorPrefixes` array configuration. - Add strict explicit anchor selection mode (`explicitOnly`) to restrict anchor resolution exclusively to `[scrollAnchor]` directives. - Add parameter help tooltips and interactive anchor strategy toggles to the demo application. - Integrate Mermaid architecture and lifecycle flow diagrams into the documentation. - Add mascot branding in demo header and update favicons across docs and demo app. - Expand test matrix and Playwright configuration with dedicated per-browser test suites. ### Bug Fixes & Behavioral Changes - None. ### Deprecations - None. ### Breaking Changes - None. ### Migration Guide - See [Migration Guide: v0.0.1-rc.2 to v1.0.0](docs/src/content/docs/migrations/v0.0.1-rc.2-to-1.0.0.md) for upgrade instructions and before/after code examples. ## Pre-Release v0.0.1-rc.2 ### Features - Track visible live sections in real time so position preservation during asynchronous data updates or resizing targets the current reading position. - Keep the currently read section active in the scroll-spy until the next section begins, prioritizing fully contained sections within the reading area. - Add `bottomOffset` and `activationThreshold` configuration options for granular control over active reading boundaries and trigger lines. - Add active zone overlay in demo application to visualize active boundaries and exclusion zones. ### Bug Fixes & Behavioral Changes - Cancel pending initial scroll restoration on user interaction (wheel, touch, navigation keys) prior to data readiness, while ignoring inputs in editable elements. - Ensure programmatic `scrollTo()` continues to work as expected after user interruption. - Improve server-side rendering (SSR) resilience when `ResizeObserver` or `defaultView` is not available. ### Deprecations - None. ### Breaking Changes - None. ### Migration Guide - See [Migration Guide: v0.0.1-rc.1 to v0.0.1-rc.2](docs/src/content/docs/migrations/v0.0.1-rc.1-to-0.0.1-rc.2.md) for upgrade instructions and before/after code examples. ## Pre-Release v0.0.1-rc.1 The first public release preview. The public API is under review. ### Features - Anchor scrolling through `magicScroll`, with automatic scroll-container detection, configurable offsets and header measurement. - URL synchronization and initial scroll-position restoration. - Scroll-position preservation when data or container dimensions change. - Inheritable defaults through `provideMagicScroll`, with overrides per region or action and separate behavior for restoration and user interaction. - Support for signals, plain input data, Angular resources and provider-neutral data sources. - Optional anchor markers, explicit IDs through `scrollAnchor` and independent scoping for nested scroll regions. ### Bug Fixes & Behavioral Changes - None. ### Deprecations - None. ### Breaking Changes - None.