` headings moved out of the sortable container so axe `aria-required-children` passes; the kanban-board demo and the eight Developer-section lists were affected.
- Contrast fix: examples `_shared.css` `--text-muted` darkened from `#6a737d` to `#586069` so column / palette headings on the kanban + clone-mode pages meet WCAG AA 4.5:1.
- Suppression: `nested-interactive` is disabled for `/` only, with a code-level reason — the File Explorer demo exercises nested sortables on purpose (an outer folder is itself draggable AND contains a draggable list). Modernised ARIA pattern for nested DnD tracked as a follow-up.
- Un-skip 3 Mobile Chrome e2e tests (#48); assertion now device-aware
- Skip 5 consistently-flaky Mobile Safari dragAndDrop tests pending fix; tracked in #62
### Features
- `ignore` option restored with the legacy Sortable.js v1 default of `'a, img'` (issue #30):
- Descendants of a draggable item matching the selector no longer initiate a drag, so users can click `` links and natively drag `![]()
` elements without a sortable drag starting underneath them.
- Default applies even when no options are passed; pass `ignore: ''` to disable. Custom selectors override the default entirely (e.g. `ignore: 'input, button'` makes `` draggable again).
- Target-only match against `event.target` (legacy `Sortable.js:620` parity). Comma-separated criteria are split and matched individually so a single malformed selector cannot break the rest. The gate fires before any drag state mutation in both the HTML5 and pointer pipelines via the shared `shouldAllowDrag` check.
- `onMove(MoveEvent, originalEvent)` is now wired through the drag pipeline with the full legacy Sortable.js contract (issue #33):
- Returning `false` cancels the move for that tick — no placeholder shift, no `sort` / `update` / `change` emissions.
- Returning `-1` forces insert BEFORE the related item; `1` forces insert AFTER.
- The second argument is the live DOM event that triggered the dragover (`DragEvent` on the HTML5 path, `PointerEvent` on the pointer / `forceFallback` path).
- The `'move'` event-system channel still fires as a notification side-channel so internal subscribers and plugins continue to work — only the option callback controls cancellation / override.
- The TypeScript signature widened from `(event, originalEvent) => boolean | void` to `(event, originalEvent) => boolean | -1 | 1 | void` to express the override return values. Runtime behaviour for existing handlers is unchanged.
- `onMove` cross-zone enter is now wired in both pipelines (issue #60, follows #33 / #59):
- The HTML5 `dragover` cross-zone enter site and the pointer-pipeline cross-zone enter site both dispatch `onMove` BEFORE the target insertion, so returning `false` keeps the item (or clones) in the source zone for that tick.
- `MoveEvent.related` falls back to the target container itself when no draggable sibling is under the pointer (matches legacy `Sortable.js:1789`). The static `related: HTMLElement` type is preserved.
- Multi-item drags batch as all-or-nothing: a single `onMove` call per cross-zone enter, with `items: draggedItems`, then either insert every item or skip the whole batch.
- The `-1` / `1` override is applied only when there is a real sibling; with the container fallback the override has no meaningful side so the natural insertion proceeds.
- HTML5 cross-zone routes through the source Sortable's `onMove` (legacy parity — `Sortable.js:1772` reads `onMoveFn` off the source). The pointer pipeline already runs on the source DragManager so needs no rerouting.
- HTML5 fallback drag system implemented end-to-end (issue #29, PRs #53, #54, #55, #56):
- `forceFallback` — opt out of the HTML5 DnD listener path and drive drag entirely via pointer events
- `fallbackClass` — additional class applied to the pointer-driven ghost alongside `ghostClass`
- `fallbackOnBody` — append the ghost to `` (legacy parity) or keep it inside the sortable zone (default `false`)
- `fallbackOffsetX` / `fallbackOffsetY` — pixel offset for the ghost relative to the cursor (legacy `fallbackOffset.x/y`)
- `fallbackTolerance` — minimum pointer travel (Chebyshev distance) before the drag commits, with a capture / commit phase split in the pointer pipeline
- Ghost clone now strips identity-bearing attributes (`id`, the configured `dataIdAttr`, `aria-*`, `tabindex`) so the ghost cannot collide with the original when both live inside the same zone (default `fallbackOnBody: false`).
### Internal
- `GhostManager.createGhost` refactored to take an options bag instead of a long positional argument list. `GhostManager` is not part of the public API, so this is not a consumer-visible change.
- Pointer drag pipeline split into a capture phase (pre-tolerance) and a commit phase (post-tolerance). Observable externally only when `fallbackTolerance > 0`.
### Tests
- First-pass triage of E2E `test.skip` / `test.fixme` entries (issue #35):
- New audit inventory at `docs/plans/e2e-skip-audit.md` classifies every skip into `easy-unskip`, `tracked-elsewhere`, `needs-new-issue`, or `valid-conditional`.
- Un-skipped three tests verified passing on chromium: `grid-layout.spec.ts:25` (`test.fixme` → `test` for CSS grid assertions), `grid-layout.spec.ts:52` (removed chromium-only animation-timing conditional skip), `ghost-elements.spec.ts:89` (same pattern).
- One un-skip candidate (`basic-sortable.spec.ts:93` hover effects) failed empirically and was re-skipped with a citation to #74.
- Filed seven new tracking issues (#73–#79) covering grouped root causes (atomic dragAndDrop limitation, delay-option timing, clone-mode regressions, swap-threshold fixture, cross-list keyboard drag, animation suite rework).
- Refreshed comments on tracked-elsewhere skips (Mobile Chrome dragAndDrop timeout entries in `event-callbacks.spec.ts`, `drag-and-drop.spec.ts`, `ghost-elements.spec.ts:158`) to cite #48 directly; multi-drag skips in `multi-select.spec.ts` and `feature-demos.spec.ts` to cite #34.
### Documentation
- New `docs/accessibility.md` — canonical accessibility reference (issue #40):
- Full keyboard contract table (Tab, arrow keys, Home / End, Space, Ctrl+A, Enter, Escape, Shift+arrow placeholder for #36).
- Per-element ARIA attribute reference for the container (`role="listbox"`, `aria-multiselectable`, `aria-label`) and items (`role="option"`, `aria-setsize`, `aria-posinset`, `aria-selected`, `aria-grabbed`, roving `tabindex`).
- Heading-placement guidance: keep `` / `` headings _outside_ the sortable container to satisfy axe's `aria-required-children` rule.
- Screen-reader live region docs (single shared `.sortable-announcer`, `aria-live="assertive"`, the messages emitted on select / grab / move / drop / cancel).
- How to run the audit locally + the list of known follow-ups (deprecated `aria-grabbed`, nested-DnD ARIA, Shift+Arrow range selection #36).
- README "Accessibility" feature bullet now links the new `docs/accessibility.md` reference.
- `docs/index.html` landing page gains a dedicated "Accessibility" card pointing to the new reference.
- Bundled the examples + dev playground as a live gh-pages site (issue #71, sub-issue of #41):
- New `vite.config.examples.ts` — multi-page Vite build that emits `docs/demo/` with bundled HTML + chunked JS assets. Pages: root `index.html` (dev playground) plus the ten curated examples under `examples/`.
- New npm script `build:examples` runs the multi-page build; wired into `.github/workflows/docs.yml` so each docs deploy publishes the live site alongside the TypeDoc API reference.
- `examples/simple-list.html` and `examples/multi-list.html` are excluded from the bundle — they import the built library from `../dist/sortable.es.js` and exist only as E2E test fixtures.
- Root `index.html` rewritten to use relative dynamic imports (`./src/...`) so it bundles cleanly. `npm run dev` and the existing E2E suite continue to hit it unchanged.
- `docs/index.html` landing page now links the live examples (`./demo/examples/`) and adds a dedicated card for the dev playground (`./demo/`); `README.md` advertises the live examples URL above the local-dev fallback.
- `/docs/demo/` added to `.gitignore` (build output, like `/docs/api/`).
- Added `docs/migration-from-sortable-v1.md` — canonical migration guide from Sortable.js v1.x to Resortable v2 (option deltas, plugin imports, breaking changes, before/after recipes). Linked from `README.md`. (issue #66)
- Added a curated examples site under `examples/` (issue #65, sub-issue of #41):
- `examples/index.html` landing page links nine single-concept demos: `basic.html`, `shared-lists.html`, `kanban.html`, `clone-mode.html`, `swap.html`, `multi-drag.html`, `handle-filter.html`, `accessibility.html`, `custom-plugin.html`.
- Each example is a standalone page that imports the library from `../src/index.ts` (Vite-resolved during `npm run dev`), shows a live demo, and reproduces the wiring code inline as an annotated `` block.
- Shared `examples/_shared.css` keeps per-example CSS minimal.
- The existing `examples/simple-list.html` and `examples/multi-list.html` are intentionally left unchanged — they're E2E test fixtures referenced by `tests/e2e/animation*.spec.ts`. The curated set is additive.
- Linked from `README.md`.
- README updates (issue #64, sub-issue of #41):
- Added CDN install snippet (UMD via unpkg + jsDelivr, version-pinned to `2.0.0-alpha.1`, `window.Sortable` global usage) and a note that ESM via npm is the recommended path.
- Linked the buried `src/plugins/PluginDevelopmentGuide.md` from the Plugins section so custom-plugin authors can find it.
- Added an "API Reference" section with a placeholder link to the TypeDoc-generated docs site (deploy tracked in #63).
- Added a short "Framework wrappers" section noting React/Vue/Svelte wrappers are planned (tracked in #44).
- Expanded the built-in plugins list to match `src/plugins/index.ts` (AutoScroll, MarqueeSelect, OnSpill, Swap; MultiDrag shim noted).
- Added an install-from-Git fallback note since `resortable` is not yet on npm.
- Documentation infrastructure for the gh-pages site (issue #63, sub-issue of #41):
- Lifted `src/plugins/PluginDevelopmentGuide.md` to `docs/plugin-development.md` so it lives alongside the other shipped docs; updated the references in `README.md` and `examples/custom-plugin.html`.
- Added `docs/index.html` — a static landing page served at the gh-pages root with cards linking to the API reference, migration guide, plugin guide, examples, and the GitHub repo. The Markdown guides link to their GitHub-rendered versions (pragmatic choice — gh-pages does not render `.md` and a Markdown→HTML build step was deferred).
- Fixed the four TypeDoc warnings emitted by `npm run docs:build`:
- Moved the `Sortable.option` TSDoc block from the getter overload to the implementation signature so the `@param value` matches the implementation's parameter list.
- Re-exported `DragManager`, `DropZone`, `EventSystem` (with `Listener` / `SortableEventSystem`), and their referenced managers (`SelectionManager`, `KeyboardManager`, `GroupManager`, `AnimationManager`) from `src/index.ts` so TypeDoc emits them. These are genuine public API — the Plugin Development Guide documents `sortable.eventSystem.on(...)` and every built-in plugin reads `sortable.dragManager?.selectionManager`, so `@internal` was the wrong call. The `@internal` tag on `EventSystem` itself was removed for the same reason.
- Switched `typedoc.json` to TypeDoc's default HTML theme (removed `typedoc-plugin-markdown` plugin and devDependency) so `docs/api/index.html` actually exists for the gh-pages deploy. Flipped `treatWarningsAsErrors` to `true` to prevent regressions.
- Hardened `npm run docs:clean` — it was `rimraf docs`, which would have wiped the tracked migration guide, plugin guide, landing, and `plans/`. Now scoped to `rimraf docs/api`.
## [2.0.0-alpha.1] - 2025-09-01
### Features
- Initial project setup with modern TypeScript toolchain
- Vite and Rollup build system configuration
- ESLint, Prettier, and VS Code integration
- Comprehensive testing setup with Vitest and Playwright
- GitHub Actions CI/CD pipeline
- Semantic release automation
### Documentation
- Created comprehensive implementation plan
- Added CLAUDE.md for development guidance
This is the initial alpha release of Resortable - a modern TypeScript rewrite of Sortable.js. The foundation is now in place to begin implementing the core drag-and-drop functionality.
` headings _outside_ the sortable container to satisfy axe's `aria-required-children` rule.
- Screen-reader live region docs (single shared `.sortable-announcer`, `aria-live="assertive"`, the messages emitted on select / grab / move / drop / cancel).
- How to run the audit locally + the list of known follow-ups (deprecated `aria-grabbed`, nested-DnD ARIA, Shift+Arrow range selection #36).
- README "Accessibility" feature bullet now links the new `docs/accessibility.md` reference.
- `docs/index.html` landing page gains a dedicated "Accessibility" card pointing to the new reference.
- Bundled the examples + dev playground as a live gh-pages site (issue #71, sub-issue of #41):
- New `vite.config.examples.ts` — multi-page Vite build that emits `docs/demo/` with bundled HTML + chunked JS assets. Pages: root `index.html` (dev playground) plus the ten curated examples under `examples/`.
- New npm script `build:examples` runs the multi-page build; wired into `.github/workflows/docs.yml` so each docs deploy publishes the live site alongside the TypeDoc API reference.
- `examples/simple-list.html` and `examples/multi-list.html` are excluded from the bundle — they import the built library from `../dist/sortable.es.js` and exist only as E2E test fixtures.
- Root `index.html` rewritten to use relative dynamic imports (`./src/...`) so it bundles cleanly. `npm run dev` and the existing E2E suite continue to hit it unchanged.
- `docs/index.html` landing page now links the live examples (`./demo/examples/`) and adds a dedicated card for the dev playground (`./demo/`); `README.md` advertises the live examples URL above the local-dev fallback.
- `/docs/demo/` added to `.gitignore` (build output, like `/docs/api/`).
- Added `docs/migration-from-sortable-v1.md` — canonical migration guide from Sortable.js v1.x to Resortable v2 (option deltas, plugin imports, breaking changes, before/after recipes). Linked from `README.md`. (issue #66)
- Added a curated examples site under `examples/` (issue #65, sub-issue of #41):
- `examples/index.html` landing page links nine single-concept demos: `basic.html`, `shared-lists.html`, `kanban.html`, `clone-mode.html`, `swap.html`, `multi-drag.html`, `handle-filter.html`, `accessibility.html`, `custom-plugin.html`.
- Each example is a standalone page that imports the library from `../src/index.ts` (Vite-resolved during `npm run dev`), shows a live demo, and reproduces the wiring code inline as an annotated `` block.
- Shared `examples/_shared.css` keeps per-example CSS minimal.
- The existing `examples/simple-list.html` and `examples/multi-list.html` are intentionally left unchanged — they're E2E test fixtures referenced by `tests/e2e/animation*.spec.ts`. The curated set is additive.
- Linked from `README.md`.
- README updates (issue #64, sub-issue of #41):
- Added CDN install snippet (UMD via unpkg + jsDelivr, version-pinned to `2.0.0-alpha.1`, `window.Sortable` global usage) and a note that ESM via npm is the recommended path.
- Linked the buried `src/plugins/PluginDevelopmentGuide.md` from the Plugins section so custom-plugin authors can find it.
- Added an "API Reference" section with a placeholder link to the TypeDoc-generated docs site (deploy tracked in #63).
- Added a short "Framework wrappers" section noting React/Vue/Svelte wrappers are planned (tracked in #44).
- Expanded the built-in plugins list to match `src/plugins/index.ts` (AutoScroll, MarqueeSelect, OnSpill, Swap; MultiDrag shim noted).
- Added an install-from-Git fallback note since `resortable` is not yet on npm.
- Documentation infrastructure for the gh-pages site (issue #63, sub-issue of #41):
- Lifted `src/plugins/PluginDevelopmentGuide.md` to `docs/plugin-development.md` so it lives alongside the other shipped docs; updated the references in `README.md` and `examples/custom-plugin.html`.
- Added `docs/index.html` — a static landing page served at the gh-pages root with cards linking to the API reference, migration guide, plugin guide, examples, and the GitHub repo. The Markdown guides link to their GitHub-rendered versions (pragmatic choice — gh-pages does not render `.md` and a Markdown→HTML build step was deferred).
- Fixed the four TypeDoc warnings emitted by `npm run docs:build`:
- Moved the `Sortable.option` TSDoc block from the getter overload to the implementation signature so the `@param value` matches the implementation's parameter list.
- Re-exported `DragManager`, `DropZone`, `EventSystem` (with `Listener` / `SortableEventSystem`), and their referenced managers (`SelectionManager`, `KeyboardManager`, `GroupManager`, `AnimationManager`) from `src/index.ts` so TypeDoc emits them. These are genuine public API — the Plugin Development Guide documents `sortable.eventSystem.on(...)` and every built-in plugin reads `sortable.dragManager?.selectionManager`, so `@internal` was the wrong call. The `@internal` tag on `EventSystem` itself was removed for the same reason.
- Switched `typedoc.json` to TypeDoc's default HTML theme (removed `typedoc-plugin-markdown` plugin and devDependency) so `docs/api/index.html` actually exists for the gh-pages deploy. Flipped `treatWarningsAsErrors` to `true` to prevent regressions.
- Hardened `npm run docs:clean` — it was `rimraf docs`, which would have wiped the tracked migration guide, plugin guide, landing, and `plans/`. Now scoped to `rimraf docs/api`.
## [2.0.0-alpha.1] - 2025-09-01
### Features
- Initial project setup with modern TypeScript toolchain
- Vite and Rollup build system configuration
- ESLint, Prettier, and VS Code integration
- Comprehensive testing setup with Vitest and Playwright
- GitHub Actions CI/CD pipeline
- Semantic release automation
### Documentation
- Created comprehensive implementation plan
- Added CLAUDE.md for development guidance
This is the initial alpha release of Resortable - a modern TypeScript rewrite of Sortable.js. The foundation is now in place to begin implementing the core drag-and-drop functionality.
` block.
- Shared `examples/_shared.css` keeps per-example CSS minimal.
- The existing `examples/simple-list.html` and `examples/multi-list.html` are intentionally left unchanged — they're E2E test fixtures referenced by `tests/e2e/animation*.spec.ts`. The curated set is additive.
- Linked from `README.md`.
- README updates (issue #64, sub-issue of #41):
- Added CDN install snippet (UMD via unpkg + jsDelivr, version-pinned to `2.0.0-alpha.1`, `window.Sortable` global usage) and a note that ESM via npm is the recommended path.
- Linked the buried `src/plugins/PluginDevelopmentGuide.md` from the Plugins section so custom-plugin authors can find it.
- Added an "API Reference" section with a placeholder link to the TypeDoc-generated docs site (deploy tracked in #63).
- Added a short "Framework wrappers" section noting React/Vue/Svelte wrappers are planned (tracked in #44).
- Expanded the built-in plugins list to match `src/plugins/index.ts` (AutoScroll, MarqueeSelect, OnSpill, Swap; MultiDrag shim noted).
- Added an install-from-Git fallback note since `resortable` is not yet on npm.
- Documentation infrastructure for the gh-pages site (issue #63, sub-issue of #41):
- Lifted `src/plugins/PluginDevelopmentGuide.md` to `docs/plugin-development.md` so it lives alongside the other shipped docs; updated the references in `README.md` and `examples/custom-plugin.html`.
- Added `docs/index.html` — a static landing page served at the gh-pages root with cards linking to the API reference, migration guide, plugin guide, examples, and the GitHub repo. The Markdown guides link to their GitHub-rendered versions (pragmatic choice — gh-pages does not render `.md` and a Markdown→HTML build step was deferred).
- Fixed the four TypeDoc warnings emitted by `npm run docs:build`:
- Moved the `Sortable.option` TSDoc block from the getter overload to the implementation signature so the `@param value` matches the implementation's parameter list.
- Re-exported `DragManager`, `DropZone`, `EventSystem` (with `Listener` / `SortableEventSystem`), and their referenced managers (`SelectionManager`, `KeyboardManager`, `GroupManager`, `AnimationManager`) from `src/index.ts` so TypeDoc emits them. These are genuine public API — the Plugin Development Guide documents `sortable.eventSystem.on(...)` and every built-in plugin reads `sortable.dragManager?.selectionManager`, so `@internal` was the wrong call. The `@internal` tag on `EventSystem` itself was removed for the same reason.
- Switched `typedoc.json` to TypeDoc's default HTML theme (removed `typedoc-plugin-markdown` plugin and devDependency) so `docs/api/index.html` actually exists for the gh-pages deploy. Flipped `treatWarningsAsErrors` to `true` to prevent regressions.
- Hardened `npm run docs:clean` — it was `rimraf docs`, which would have wiped the tracked migration guide, plugin guide, landing, and `plans/`. Now scoped to `rimraf docs/api`.
## [2.0.0-alpha.1] - 2025-09-01
### Features
- Initial project setup with modern TypeScript toolchain
- Vite and Rollup build system configuration
- ESLint, Prettier, and VS Code integration
- Comprehensive testing setup with Vitest and Playwright
- GitHub Actions CI/CD pipeline
- Semantic release automation
### Documentation
- Created comprehensive implementation plan
- Added CLAUDE.md for development guidance
This is the initial alpha release of Resortable - a modern TypeScript rewrite of Sortable.js. The foundation is now in place to begin implementing the core drag-and-drop functionality.