DTK0051: Cannot Change Dock ID

Message

Cannot change the id of a dock. Use register() to add new docks.

Cause

The handle returned by ctx.docks.register({ id }) exposes an update(patch) method. Passing a different id in that patch is rejected — ids identify the entry and must remain stable for the kit client to track it across reactivity updates.

Fix

To "rename" a dock, call ctx.docks.register(...) with the new id. To change other fields, leave id out of the patch:

const handle = ctx.docks.register({ id: 'my-plugin', title: 'Old', /* ... */ })
handle.update({ title: 'New' }) // ✓
handle.update({ id: 'renamed' }) // ✗ DTK0051

Source

• packages/kit/src/node/host-docks.ts — the update closure returned from register throws DTK0051 when the patch carries a different id.