Guide

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 (or TickerBundle.default): use the named members such as window.Ticker.ticker(), which are unchanged.
  • The browser bundle is now dist/browser/ticker.global.js, which the ./browser/global export, unpkg and jsdelivr point to. dist/browser/global.global.js is 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).
  • homepage ends 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 through update()) 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: hidden wrapper (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 without navigation keep 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 in available / getTicker().
  • Clones drop the name attribute 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-wrapper element removes the runtime --ticker-position, --ticker-duration and --ticker-distance properties, the track’s hover-pause class and class option values the element did not already carry.
  • Batched IntersectionObserver callbacks 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 drag navigate frame.
  • The .ticker-featured layer 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, inertiaDeceleration and inertiaMaxVelocity options (data-inertia* in HTML, supported in responsive rules) 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. With resumeAfterDrag, autoplay resumes when the glide ends.

Examples

  • The drag-playback example enables inertia with resumeAfterDrag; 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 navigate events are now emitted at most once per animation frame instead of once per pointermove, and will-change: transform is retained while dragging or gliding.

[2.5.0] - 2026-10-30

Added

  • Opt-in resumeDelay navigation/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. navigate reports motion completion while the temporary navigation pause 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-featured or selected with setFeatured(element). The first marked direct item wins; other marked items remain ordinary moving items. setFeatured(null) clears the selection, and featured exposes the current original.
  • featuredPosition / data-featured-position align 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.itemsPerStep selects 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 itemsPerStep for multiple items; movement keeps the first incoming item visible. Explicit positive pixel step remains 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). Set pauseOnFocus: false only when your integration provides an equivalent policy.
  • data-playing now 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/down movement and inherited auto direction, 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), constant speed in CSS pixels per second and ordered viewport responsive rules. Manual pause survives automatic causes and breakpoint changes.
  • Add cyclic scrollTo()/scrollBy(), native button/range bindings through connectControls() and mouse/touch dragging that preserves perpendicular page scrolling and reduced-motion access.
  • Add opt-in resumeAfterDrag and 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/forms documentation 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/forms documentation conventions.
  • Added an npm-bundled docs/ reference for configuration, browser usage, styling, accessibility, TypeScript, and the public API.
  • Added .npmignore so source, tests, tooling, and the documentation site stay out of the published tarball.

[2.0.0] - 2026-09-24

Breaking changes

  • Replace enhance() and createTicker() with ticker(target, options) for an element-scoped controller, or mount() for declarative page ownership. Call the returned controller’s destroy() for teardown.
  • newTicker() returns TickerInstance | null instead of HTMLElement | null. available, getTicker() and getTickers() 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/browser is a side-effect-free ESM/CJS registry module. Plain HTML must load dist/browser/global.global.js to install window.Ticker.

Added and fixed

  • Replaced the ambiguous createTicker() / enhance() pair with ticker(target, options) and an element-scoped controller.
  • Reduced the browser namespace to the factory and registry lifecycle.
  • Fixed interactiveClones so interactive clones no longer inherit pointer-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 / browser singleton 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 interactiveClones to 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.