- Docs
- Changelog
Changelog
Release notes for every documented Ticker version, including breaking changes, behavior changes, features and fixes.
Unreleased
No unreleased changes.
[4.0.0] - 2026-11-15
Breaking changes
- The classic script no longer defines
window.Ticker.default(orTickerBundle.default): use the named members such aswindow.Ticker.ticker(), which are unchanged. - The browser bundle is now
dist/browser/ticker.global.js, which the./browser/globalexport,unpkgandjsdelivrpoint to.dist/browser/global.global.jsis still published as an alias, so v3 script URLs keep working after updating the version.
Changed
- The browser bundle is minified (about 9.3 KB gzip instead of 13 KB).
homepageends with a slash, and every CDN snippet uses jsDelivr.- Installs use pnpm (
pnpm-lock.yaml); the vulnerable development dependencies (Astro, Vitest,source-map-js) are updated. The package has no runtime dependencies, so this does not affect consumers.
Examples
- Package, CDN and skill pins target 4.0.0 and the new bundle name.
[3.0.0] - 2026-11-05
Behavior changes
ticker(target)for a source or wrapper that already has a live controller now returns that controller (applying any passed options throughupdate()) instead of wrapping the enhanced source a second time and nesting tickers. A destroyed controller is replaced as before.- A native scroll of the
overflow: hiddenwrapper (focusing an offscreen original, find-in-page or fragment navigation) is converted into an equivalent logical seek and the scroll offset is reset, preserving playback intent. Static reduced-motion rows withoutnavigationkeep native scrolling.
Fixed
- Keyboard focus on an offscreen original no longer leaves the wrapper permanently scrolled, which offset the loop and could expose an uncovered edge until reload.
- A touch drag (which produces no click) or a mouse drag released outside the ticker no longer swallows the next click or keyboard activation inside it.
- The browser registry drops an entry when its controller is destroyed directly or by DOM removal under
mount(), instead of retaining the detached wrapper inavailable/getTicker(). - Clones drop the
nameattribute of their form controls, so a cloned checked radio no longer unchecks the original in the same group and named clone fields are not submitted with a form. - Destroying an adopted
[data-ticker]/.ticker-wrapperelement removes the runtime--ticker-position,--ticker-durationand--ticker-distanceproperties, the track’s hover-pause class andclassoption values the element did not already carry. - Batched
IntersectionObservercallbacks use the latest entry, so a quick enter/leave sequence no longer leaves the ticker in the wrong active state. destroy()cancels a pending throttled dragnavigateframe.- The
.ticker-featuredlayer rules are scoped to ticker wrappers with:where(), so an unrelated application element using that class is not repositioned.
Examples
- Package, CDN and skill pins target 3.0.0. The FAQ size figure reflects the current browser build.
[2.6.0] - 2026-11-04
Added
- Opt-in
inertia,inertiaDecelerationandinertiaMaxVelocityoptions (data-inertia*in HTML, supported inresponsiverules) continue a released pointer drag with linear-deceleration momentum, estimated from the last ~100 ms of pointer samples including coalesced events. Defaults (off, 1800 px/s², 2500 px/s) leave existing behavior unchanged; slow releases,pointercancel, lost capture and reduced motion do not glide. WithresumeAfterDrag, autoplay resumes when the glide ends.
Examples
- The drag-playback example enables
inertiawithresumeAfterDrag; complete/split Package / ESM and HTML / CDN recipes carry the option. Public docs, README, skill and delivery pins target 2.6.0.
Behavior changes
- Drag
navigateevents are now emitted at most once per animation frame instead of once perpointermove, andwill-change: transformis retained while dragging or gliding.
[2.5.0] - 2026-10-30
Added
- Opt-in
resumeDelaynavigation/control option holds autoplay after seeking for a reading interval. Repeated commands replace the wait; manual playback intent and automatic pause causes remain effective. The default remains immediate resumption.navigatereports motion completion while the temporarynavigationpause continues through the interval.
Examples
- Manual-navigation preview and complete/split Package / ESM and HTML / CDN recipes demonstrate a 1,500 ms reading interval. Public types, documentation, skill and delivery pins target 2.5.0.
[2.4.0] - 2026-10-29
Added
- One fixed featured original per ticker, marked with
data-featuredor selected withsetFeatured(element). The first marked direct item wins; other marked items remain ordinary moving items.setFeatured(null)clears the selection, andfeaturedexposes the current original. featuredPosition/data-featured-positionalign the overlay at logical start/center/end or axis-specific physical edges. The original is excluded from clones, repeat distance and item steps, with order/focus restoration and keyboard reveal beside the overlay. Playback intent is preserved.
Behavior changes
- Preserve opt-in mouse focus handling on fixed actions without allowing them to start a drag. Keyboard focus pause and explicit playback intent remain effective.
Examples
- Explain temporary hover/focus pauses in live and copied examples, with configuration guidance for changing those policies. Reserve message geometry so clearing focus does not move controls and lose a pointer click.
- Add selected-category and centered-logo recipes with position/orientation controls, drag navigation, associated category content and a labeled partner card. Every visible category button, including repeated copies, selects the original through stable keys. Complete and split files pin the prepared release;
[2.3.0] - 2026-10-29
Added
TickerControls.itemsPerStepselects the number of incoming items per button or rail arrow-key command; positive safe integers are supported, with a default of one.
Behavior changes
- Rapid connected-arrow clicks and rail arrow keys now count every same-direction step instead of repeatedly targeting the same incoming item. Reversals discard pending steps and move from the visible position; retargeting stays continuous on both axes and in RTL, with one completion event for the final destination.
- Connected arrows and range arrow keys now smoothly reveal one incoming item by default on horizontal and vertical axes instead of jumping one viewport. Configure
itemsPerStepfor multiple items; movement keeps the first incoming item visible. Explicit positive pixelstepremains supported and takes precedence. Item stepping excludes wrapper borders and respects CSS scroll-padding so applications can reserve readable space outside edge fades or overlays.
Examples
- Demonstrate removal by stable item key and current position in the live dynamic feed and complete/split CDN/ESM files; refresh copies after each edit.
[2.2.0] - 2026-10-28
Added
- Opt-in smooth navigation with duration and playback-intent preservation on controller methods and connected controls. Retain manual pauses, respect reduced motion and cancel on competing commands, drag, rebuild and destroy.
- Navigation event source identifies API, arrows, range, keyboard and drag without application replay handlers.
- Document deferred Astro mounting, delegated clone actions and equal sequence/track spacing.
Maintenance
- Update vulnerable website transitive dependencies without relaxing CI audits. npm publication is a separate maintainer action.
[2.1.0] - 2026-10-17
Behavior changes
- Keyboard focus now pauses playback by default (
pauseOnFocus: true). SetpauseOnFocus: falseonly when your integration provides an equivalent policy. data-playingnow reflects manual, focus and hover pause causes in addition to visibility and reduced motion. Integrations that read it should account for all pause reasons.- Existing entrypoints, physical left/right directions, selectors and duration mode remain supported. Use
play()/pause()instead of application-owned pause CSS.
Added and fixed
- Add vertical
up/downmovement and inheritedautodirection, with logical RTL seeking and fractional measurements on either axis. - Add persistent
play()/pause()intent,autoplay, immutable state snapshots and typed lifecycle/playback/navigation events. - Add
pauseOnFocus(enabled by default), constantspeedin CSS pixels per second and ordered viewportresponsiverules. Manual pause survives automatic causes and breakpoint changes. - Add cyclic
scrollTo()/scrollBy(), native button/range bindings throughconnectControls()and mouse/touch dragging that preserves perpendicular page scrolling and reduced-motion access. - Add opt-in
resumeAfterDragand its data attribute, preserving pre-drag playback intent and existing focus. Explicit pauses remain effective. - Keep dynamic additions/removals at constant pixel speed; fix empty source measurements so gaps never produce empty clones, with recovery on refresh.
- Extend the shared Home/Examples/Docs website with twelve live recipes and complete CDN/npm code, an interactive drag-resume toggle, illustrated vertical resources and rendered brand attribution. Preserve all original examples.
- Document the complete 2.1 API, upgrade behavior and agent integration; synchronize pinned examples and the downloadable Ticker skill.
- Preserve routes with or without trailing slashes and correct fractional documentation TOC tracking.
[2.0.4] - 2026-10-12
- Preserve fractional animation distances and use the horizontal column gap so repeated content stays aligned when ticker loops restart.
[2.0.3] - 2026-10-12
- Start tickers paused until they intersect the viewport, without a preactivation margin.
- Pause playback in hidden documents and share visibility and motion-preference listeners across standalone controllers and declarative tickers, with cleanup after the last ticker is destroyed.
- Reuse clones on unchanged automatic measurements to preserve animation progress; keep explicit refresh and updates rebuilding content even when its width is unchanged.
[2.0.2] - 2026-09-25
- Expanded the bundled and Starlight references to cover every public API, option, type, core utility, entrypoint, registry helper, and lifecycle edge case.
- Added dedicated controller, core, entrypoint, and recipe documentation following the
@samline/formsdocumentation structure. - Added explicit ownership, cleanup, server-rendering, accessibility, styling, and browser-registry guidance across both documentation surfaces.
[2.0.1] - 2026-09-24
- Aligned the README and Starlight documentation with the
@samline/formsdocumentation conventions. - Added an npm-bundled
docs/reference for configuration, browser usage, styling, accessibility, TypeScript, and the public API. - Added
.npmignoreso source, tests, tooling, and the documentation site stay out of the published tarball.
[2.0.0] - 2026-09-24
Breaking changes
- Replace
enhance()andcreateTicker()withticker(target, options)for an element-scoped controller, ormount()for declarative page ownership. Call the returned controller’sdestroy()for teardown. newTicker()returnsTickerInstance | nullinstead ofHTMLElement | null.available,getTicker()andgetTickers()still expose wrapper elements; use registry destroy helpers to remove registered entries.- Framework adapters are no longer shipped. Initialize Ticker in your framework’s client mount hook and destroy it during cleanup.
@samline/ticker/browseris a side-effect-free ESM/CJS registry module. Plain HTML must loaddist/browser/global.global.jsto installwindow.Ticker.
Added and fixed
- Replaced the ambiguous
createTicker()/enhance()pair withticker(target, options)and an element-scoped controller. - Reduced the browser namespace to the factory and registry lifecycle.
- Fixed
interactiveClonesso interactive clones no longer inheritpointer-events: none. - Removed framework adapters, unused helpers, duplicate documentation, and obsolete planning files.
- Added Starlight documentation, package smoke tests, CI, coverage, and GitHub Pages deployment.
[1.1.0] - 2026-09-23
- Added a shared
Ticker/browsersingleton and named registry helpers. - Recreating an id now tears down the previous runtime before enhancing it again.
- Destroying a registered ticker clears observers, clones, registry state, and restores the source DOM.
[1.0.8] - 2026-06-11
- Add
interactiveClonesto opt repeated controls into interaction, with matching runtime, framework adapter and documentation support.
[1.0.7] - 2026-06-11
- Initialize and destroy the React ticker at the component boundary; normalize class tokens and add server-rendering and React regression tests.
[1.0.6] - 2026-06-11
- Historical npm release. No version-specific functional notes were recorded in the repository.
[1.0.5] - 2026-06-11
- Historical npm release. No version-specific functional notes were recorded in the repository.
[1.0.4] - 2026-04-21
- Include the stylesheet as an explicit build entry and align browser/CDN usage documentation.
[1.0.3] - 2026-04-21
- Correct enhancement of existing content nodes, preserve source placement and accept multiple option class tokens.
[1.0.2] - 2026-04-21
- Publish the patch release after correcting conditional wrapper classes and CDN references.
[1.0.1] - 2026-04-21
- Correct the browser entry filename and version-pinned CDN URLs.
[1.0.0] - 2026-04-21
- Initial ticker runtime for Vanilla JavaScript, browser scripts and React, Vue and Svelte adapters, with automatic visual copies, reduced-motion support and responsive visibility observers.