Skip to content

refactor(bundle-size): extract Focusable mover/groupper resolver#546

Open
layershifter wants to merge 17 commits into
microsoft:masterfrom
layershifter:chore/bundle-size-stack-9
Open

refactor(bundle-size): extract Focusable mover/groupper resolver#546
layershifter wants to merge 17 commits into
microsoft:masterfrom
layershifter:chore/bundle-size-stack-9

Conversation

@layershifter
Copy link
Copy Markdown
Member

Summary

Extracts the ~70-line containment-conflict block from Focusable._acceptElement into a new MoverGroupperResolver.ts module. getMover and getGroupper register the resolver at construction time via tabster.focusableContextResolver; Focusable calls core.focusableContextResolver?.() and falls through to the default focusable walk when no resolver is registered.

Also decouples Focusable from direct Modalizer API calls — call sites previously reaching into tabster.modalizer now route through the context resolver.

Net effect: when neither Mover nor Groupper is imported, the ~70-line resolver block doesn't ship.

Stack context

Stacked on top of #545. Net new in this PR: MoverGroupperResolver.ts module + Focusable.ts slim + Modalizer decoupling.

layershifter and others added 17 commits May 11, 2026 11:41
\`patch-package\` postinstall hook applies three changes to
keyborg@2.14.0 covering both the ESM (\`dist/index.js\`) and CJS
(\`dist/index.cjs\`) bundles:

1. \`event.details = details\` — drop the \`@deprecated\` alias of
   \`event.detail\`. Tabster reads \`e.detail\` exclusively (verified
   across src/State/FocusedElement.ts and the rest of the codebase).

2. \`triggerKeys\` / \`dismissKeys\` props + the supporting
   \`shouldDismiss\` / \`scheduleDismiss\` / \`dismissTimer\`
   machinery. Tabster only ever calls \`createKeyborg(getWindow())\`
   with no props.

3. \`canOverrideNativeFocus\` runtime probe. Replaces the
   \`_canOverrideNativeFocus\` flag with the implicit-true assumption
   modern browsers (everything since IE9) already satisfy. The
   conditional \`details.isFocusedProgrammatically\` write becomes
   unconditional — semantically identical when override works.

Bundle deltas (createTabster default-mode):
  keyborg slice: 3.71 → 3.12 kB (-590 B, -16%)
  createTabster:  30.78 → 30.18 kB (-600 B)
  getModalizer:   38.47 → 37.87 kB (-600 B)
  getMover:       44.54 → 43.94 kB (-600 B)
  getCrossOrigin: 89.64 → 89.04 kB (-600 B)
  allExports:     92.09 → 91.50 kB (-590 B)

Tests pass: 3 pre-existing failures, no regressions across default,
uncontrolled, and root-dummy-inputs modes.

Stop-gap until upstream microsoft/keyborg can release the same
trims (the changes belong there, not as a Tabster-side fork).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Converts the `Subscribable<A, B>` abstract class and its consumers to
factory functions returning plain objects.

- `Subscribable` → `createSubscribable<A,B>()` factory returning a
  `SubscribableCore` interface. The public surface (subscribe/
  subscribeFirst/unsubscribe) matches `Types.Subscribable`; setVal/
  getVal/trigger are exposed for the composing factory only.
- `KeyboardNavigationState` class → `createKeyboardNavigationState`
  factory.
- `FocusedElementState` class → `createFocusedElementState` factory.
  `FocusedElementState` is preserved as a const namespace for the
  `forgetMemorized` and `findNextTabbable` static helpers.
- `ObservedElementAPI` class → `createObservedElementAPI` factory.
- `CrossOriginFocusedElementState` class →
  `createCrossOriginFocusedElementState` factory, with `setVal` static
  kept under same-named const namespace.
- `CrossOriginObservedElementState` class →
  `createCrossOriginObservedElementState` factory, with `trigger` static
  kept under same-named const namespace.

Also trims `Subscribable` itself: drops the `callCallbacks` helper in
favour of the inlined `trigger` closure, and adds `declare` to
`TabsterCustomEvent.details` to drop the redundant initializer SWC was
emitting.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
DummyInput was 23.6% of the core bundle (the single largest module).
Converting the four classes here in one coordinated pass:

- DummyInput            → createDummyInput
- DummyInputManager     → createDummyInputManager (interface + factory),
                          with externally-used statics moveWithPhantomDummy
                          and addPhantomDummyWithTarget kept under a same-
                          named const namespace
- DummyInputManagerCore → createDummyInputManagerCore. The class's
                          constructor-return-existing-instance trick (used
                          when an element already has dummy inputs from
                          another subsystem) becomes a natural early-return
                          in a factory.
- DummyInputObserver    → createDummyInputObserver

The four DummyManager subclasses (RootDummyManager, ModalizerDummyManager,
MoverDummyManager, GroupperDummyManager) are migrated from `extends
DummyInputManager` to composing `createDummyInputManager` and calling
`manager.setHandlers(...)` directly. They become free functions
(createRootDummyManager etc.) returning the same DummyInputManager
interface, so the consuming `dummyManager` field on Root/Modalizer/Mover/
Groupper is now typed as the interface rather than the subclass.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Class scaffolding (constructor + private field declarations + this-binding
on arrow methods) doesn't mangle as well as plain top-level functions and
closures. Switching RestorerAPI to a factory shaves ~570 B minified /
~45 B gzipped on getRestorer.

Pattern: closures replace private fields; the returned object exposes
only the public methods the interface requires.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Static methods (getDeloser, getHistory, forceRestoreFocus) are kept
under a same-named const namespace, so external call sites in
CrossOrigin.ts continue to work unchanged. The internal state needed
by those statics is exposed via an internal interface with _-prefixed
accessors.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
…actory conversions

Apply post-cherry-pick fixes across all 8 converted API factories:
- Use addListener/removeListener helpers (PR4) instead of direct addEventListener
- Use focusedElementState method calls instead of missing free-function exports
- Expose _grouppers/_modalizers as internal getters for test compatibility
- Add _grouppers and _modalizers to GroupperAPIInternal/ModalizerAPIInternal types
- Exclude generated bundle-size/.readable/ and .claude/ from prettier checks

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
…urface

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@github-actions
Copy link
Copy Markdown

📊 Bundle size report

Package & Exports Baseline (minified/GZIP) PR Change
tabster
all exports
113.84 kB
30.937 kB
93.857 kB
28.704 kB
-19.983 kB
-2.233 kB
tabster
createTabster (core)
39.761 kB
11.892 kB
30.768 kB
10.444 kB
-8.993 kB
-1.448 kB
tabster
findAllFocusable
0 B
0 B
30.837 kB
10.467 kB
🆕 New entry
tabster
findLastFocusable
0 B
0 B
30.826 kB
10.466 kB
🆕 New entry
tabster
findNextFocusable
0 B
0 B
30.812 kB
10.459 kB
🆕 New entry
tabster
findPrevFocusable
0 B
0 B
30.826 kB
10.464 kB
🆕 New entry
tabster
getCrossOrigin
110.623 kB
30.244 kB
91.343 kB
28.012 kB
-19.28 kB
-2.232 kB
tabster
getDeloser
49.268 kB
14.234 kB
38.786 kB
12.668 kB
-10.482 kB
-1.566 kB
tabster
getGroupper
47 kB
13.593 kB
37.758 kB
12.404 kB
-9.242 kB
-1.189 kB
tabster
getModalizer
49.072 kB
14.378 kB
38.7 kB
12.787 kB
-10.372 kB
-1.591 kB
tabster
getMover
54.653 kB
15.887 kB
44.841 kB
14.597 kB
-9.812 kB
-1.29 kB
tabster
getObservedElement
45.564 kB
13.484 kB
35.283 kB
11.926 kB
-10.281 kB
-1.558 kB
tabster
getOutline
48.867 kB
14.216 kB
37.2 kB
12.421 kB
-11.667 kB
-1.795 kB
tabster
getRestorer
42.518 kB
12.52 kB
32.834 kB
11.031 kB
-9.684 kB
-1.489 kB

🤖 This report was generated against a579ebbd50e37f1565551549fe57bbc9ddafab64

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