Add pluggable movement strategies (v1.3.0)
Turn the hardcoded straight-line sweep into a strategy system behind three
seams so new patterns are easy to add and, for the first time, testable
without nut.js or a real screen:
- src/device.ts: injectable Device seam over nut.js (autoDelayMs lives
here now); the only module that touches the native lib.
- src/strategies.ts: pure per-pattern path generators + registry + lenient
name resolution. Ships line, diagonal, jitter, walk,
arc, figureEight.
- src/executor.ts: single executePath driver owning bounds policy
(abort/clamp/reflect), pacing, interrupt detection, and
restore-on-clean.
keeper.ts's simulateActivity now selects a strategy and delegates to the
executor; the default `line` pattern is byte-for-byte the previous behavior.
New config surface, layered CLI > file > default with strict validation:
- -p/--pattern <name> movement strategy (names matched case/-/_-insensitive)
- -s/--step-size <px> pixels per step; stepCount is now a step *count*
Robustness for the new edge-seeking patterns: interrupt detection compares
against the last commanded (rounded) point with a 2px tolerance, and
clamp/reflect stay a couple pixels off the screen edge, so sub-pixel cursor
placement on scaled/multi-monitor displays isn't misread as user activity.
jitter's radius scales with sweep length so it moves at the default stepSize.
Tests: new suites for strategies, the executor (all bounds policies,
rounding, interrupt, tolerance, pacing), and the keeper loop; config and
configFile suites extended for pattern/stepSize. editor.test.ts moved to
tests/ for consistency. 64 pass.
This commit is contained in:
@@ -5,6 +5,47 @@ All notable changes to `move` are documented here.
|
||||
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).
|
||||
|
||||
## [1.3.0] - 2026-08-06
|
||||
|
||||
### Added
|
||||
- Pluggable movement strategies. New `-p, --pattern <name>` flag and
|
||||
`pattern` config key select how the cursor moves: `line` (default,
|
||||
unchanged behavior), `diagonal`, `jitter`, `walk`, `arc`, `figureEight`.
|
||||
- `-s, --step-size <pixels>` decouples pixels-per-step from `stepCount`
|
||||
(which is now a step *count*, not a pixel distance). Default `1`.
|
||||
- Pattern names are matched leniently: case and separators are ignored, so
|
||||
`figureEight`, `figure-eight`, `figure_eight`, and `FIGUREEIGHT` are all
|
||||
accepted (on the CLI and in the config file) and resolve to the canonical
|
||||
name.
|
||||
- `src/device.ts`: injectable `Device` seam over nut.js, enabling unit
|
||||
tests for movement without the native binary or a real screen.
|
||||
- `src/strategies.ts`: pure, per-pattern path generators plus the registry
|
||||
and name validation.
|
||||
- `src/executor.ts`: single `executePath` driver owning bounds policy
|
||||
(`abort`/`clamp`/`reflect`), pacing, interrupt detection, and restore.
|
||||
- Test suites for strategies, the executor (all bounds policies, rounding,
|
||||
interrupt), and the keeper loop.
|
||||
|
||||
### Changed
|
||||
- `simulateActivity` no longer hardcodes a straight-line sweep; it selects a
|
||||
strategy from the registry and delegates execution to `executePath`. The
|
||||
default `line` pattern is byte-for-byte the previous behavior.
|
||||
- Interrupt detection now compares against the last *commanded* (rounded)
|
||||
point rather than an ideal target, so fractional/curved paths don't
|
||||
self-trip.
|
||||
- `mouse.config.autoDelayMs = 0` moved from `runKeeper` into
|
||||
`createNutDevice` — the single place nut.js is wired up.
|
||||
- `runKeeper(config, device?)` accepts an injected device for testing.
|
||||
- `jitter`'s radius now scales with the sweep length (like the other
|
||||
patterns) instead of `stepSize` alone, so it produces real cursor motion
|
||||
at the default `stepSize` of 1 rather than hovering within a 2px radius.
|
||||
- Interrupt detection tolerates a small (2px) gap between the commanded and
|
||||
read-back cursor position, and the `clamp`/`reflect` patterns stay a few
|
||||
pixels off the screen edge. Together these avoid false "user activity"
|
||||
aborts from sub-pixel cursor placement on scaled or multi-monitor setups,
|
||||
which the new edge-seeking patterns would otherwise hit. `line` (policy
|
||||
`abort`) is unaffected.
|
||||
|
||||
## [1.2.0] - 2026-06-17
|
||||
|
||||
### Added
|
||||
@@ -67,6 +108,7 @@ Initial release.
|
||||
- Source split into `src/{move,cli,config,keeper}.ts`.
|
||||
- `bin` entry + shebang so `bun link` registers `move` globally.
|
||||
|
||||
[1.3.0]: https://gitea.cahlen.com/nokeo08/Move/compare/v1.2.0...v1.3.0
|
||||
[1.2.0]: https://gitea.cahlen.com/nokeo08/Move/compare/v1.1.1...v1.2.0
|
||||
[1.1.1]: https://gitea.cahlen.com/nokeo08/Move/compare/v1.1.0...v1.1.1
|
||||
[1.1.0]: https://gitea.cahlen.com/nokeo08/Move/compare/v1.0.1...v1.1.0
|
||||
|
||||
Reference in New Issue
Block a user