feat!: adopt object-based menu and helper APIs

[QuentinRoy]

Summary

Breaking API redesign for #108 and #109, plus a consistency pass that converts the remaining multi-argument helper APIs to named options objects. This is a clean break for the pre-1.0 package; there is no deprecation shim. The TypeScript migration (#123) will build on top of this PR.

Public API changes

#108 — single recursive MenuItem shape

• Menu items are now { label, children? } objects recursively.
• name is renamed to label throughout the model, layout, demo, documentation, and selection values.
• String item shorthand is removed; every item is an object.
• MMItem#getChildrenByName is renamed to getChildrenByLabel.
• Custom item id support is preserved.

#109 — options-object call signature

MarkingMenu(items, parentDOM, options) becomes:

MarkingMenu({ items, parent, ...options });

Example migration:

// Before
MarkingMenu(['Item', { name: 'Sub', children: ['A'] }], parent);

// After
MarkingMenu({
  items: [
    { label: 'Item' },
    { label: 'Sub', children: [{ label: 'A' }] },
  ],
  parent,
});

Selections now expose label instead of name.

Helper API consistency

The internal and exported helper APIs now use named configuration objects where positional arguments were ambiguous or numerous, including:

• connectLayout, createStrokeCanvas, and gesture feedback factories;
• MMItem construction and recursive model creation;
• navigation and dwelling configuration;
• drag watcher options;
• recognizer helpers (walkMMModel, findMMItem, articulation-point detection, and point lookup).

Related call sites, tests, and JSDoc were updated together. A small number of local helpers remain positional where their call sites are unambiguous.

Review notes

• The additional refactor is behavior-preserving: it changes argument shape and naming, not the menu/navigation algorithms.
• The audit tracking document was removed after the migration was completed; the durable documentation is in the source JSDoc and tests.
• No unrelated source changes were found in the branch.

Validation

• ✅ yarn test — 101/101 tests pass
• ✅ yarn lint — 0 errors; 4 warnings remain
• ✅ yarn format:check — clean
• ✅ yarn build and yarn build-demo — pass

Closes #108, closes #109.