Skip to content

refactor(core)!: rename api.moveToNext/moveToPrevious → activateNext/activatePrevious#1404

Merged
mathuo merged 1 commit into
v8-branchfrom
refactor/activate-navigation-api
Jul 5, 2026
Merged

refactor(core)!: rename api.moveToNext/moveToPrevious → activateNext/activatePrevious#1404
mathuo merged 1 commit into
v8-branchfrom
refactor/activate-navigation-api

Conversation

@mathuo

@mathuo mathuo commented Jul 5, 2026

Copy link
Copy Markdown
Owner

What

Renames the public focus-navigation API on DockviewApi:

  • New: activateNext(options?) / activatePrevious(options?)
  • Deprecated aliases: moveToNext / moveToPrevious still work (delegate to the new methods), with @deprecated JSDoc and removal planned for a future major.

Why

These methods advance the active panel/group (move focus) — they do not relocate a panel. The old names misread as panel-moving, which is now actively confusing because keyboard docking offers a real "move panel" action. The new names align with the existing activeGroup / activePanel vocabulary.

Scope

  • DockviewApi, DockviewComponent (interface + impl), and BaseGrid renamed.
  • Unchanged: the group-model moveToNext/moveToPrevious (active-panel cycling within a group, powering keyboard tab-switching) — a different concept, left as-is.
  • Docs updated: focus-navigation.mdx (+ "Renamed in v8" note), keyboard.mdx, features.mdx, llms-full.txt; regenerated api.output.json. Also tidied some awkward "free <noun>" wording.

Verification

  • Full dockview-core suite: 1128/1128 passing (incl. new delegation + deprecated-alias guard tests).
  • Typecheck clean; prettier clean.

🤖 Generated with Claude Code

…/activatePrevious

These methods advance the active panel/group (move focus); they do not relocate
a panel. The old names misread as panel-moving — especially now that keyboard
docking offers a genuine "move panel" action — so rename the focus-navigation
path to `activateNext`/`activatePrevious`, aligning with `activeGroup`/`activePanel`.

- DockviewApi: add `activateNext`/`activatePrevious`; keep `moveToNext`/
  `moveToPrevious` as @deprecated aliases (removal planned for a future major).
- DockviewComponent + BaseGrid: rename the internal methods.
- The group-model `moveToNext`/`moveToPrevious` (active-panel cycling within a
  group, used by keyboard tab switching) are a different concept and unchanged.
- Docs: focus-navigation, keyboard, features + llms; regenerated api.output.json.
  Also tidied awkward "free <noun>" wording flagged in review.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@sonarqubecloud

sonarqubecloud Bot commented Jul 5, 2026

Copy link
Copy Markdown

@mathuo mathuo merged commit 2e15199 into v8-branch Jul 5, 2026
9 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant