Skip to content

refactor(bundle-size): extract context resolvers + slim TabsterCore surface#545

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

refactor(bundle-size): extract context resolvers + slim TabsterCore surface#545
layershifter wants to merge 16 commits into
microsoft:masterfrom
layershifter:chore/bundle-size-stack-8

Conversation

@layershifter
Copy link
Copy Markdown
Member

Summary

  • Extracts getTabsterContext and getRoot from RootAPI static methods to standalone functions in new src/Context.ts for better tree-shaking
  • Migrates all timer variables from raw number | undefined + window.setTimeout/clearTimeout to opaque Timer handles via createTimer/setTimer/clearTimer/isTimerActive helpers
  • Introduces findNextTabbableStrategies pluggable array on TabsterCore; Mover/Groupper/Modalizer factories push their strategies instead of hard-coding switch logic

Test plan

  • npm run type-check passes
  • npm run lint:check passes
  • npm run format:check passes
  • npm run test passes (286 passed, 18 skipped)

Part of bundle-size refactor stack (8/14).

🤖 Generated with Claude Code

layershifter and others added 16 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>
@layershifter layershifter force-pushed the chore/bundle-size-stack-8 branch from 75a2ea1 to 1acb7be Compare May 11, 2026 12:18
@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.6 kB
28.592 kB
-20.24 kB
-2.345 kB
tabster
createTabster (core)
39.761 kB
11.892 kB
31.297 kB
10.582 kB
-8.464 kB
-1.31 kB
tabster
findAllFocusable
0 B
0 B
31.366 kB
10.604 kB
🆕 New entry
tabster
findLastFocusable
0 B
0 B
31.355 kB
10.603 kB
🆕 New entry
tabster
findNextFocusable
0 B
0 B
31.341 kB
10.596 kB
🆕 New entry
tabster
findPrevFocusable
0 B
0 B
31.355 kB
10.601 kB
🆕 New entry
tabster
getCrossOrigin
110.623 kB
30.244 kB
91.086 kB
27.92 kB
-19.537 kB
-2.324 kB
tabster
getDeloser
49.268 kB
14.234 kB
39.315 kB
12.814 kB
-9.953 kB
-1.42 kB
tabster
getGroupper
47 kB
13.593 kB
37.605 kB
12.342 kB
-9.395 kB
-1.251 kB
tabster
getModalizer
49.072 kB
14.378 kB
39.136 kB
12.892 kB
-9.936 kB
-1.486 kB
tabster
getMover
54.653 kB
15.887 kB
44.688 kB
14.543 kB
-9.965 kB
-1.344 kB
tabster
getObservedElement
45.564 kB
13.484 kB
35.812 kB
12.063 kB
-9.752 kB
-1.421 kB
tabster
getOutline
48.867 kB
14.216 kB
37.729 kB
12.555 kB
-11.138 kB
-1.661 kB
tabster
getRestorer
42.518 kB
12.52 kB
33.363 kB
11.171 kB
-9.155 kB
-1.349 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