Skip to content

refactor(bundle-size)!: drop UncontrolledAPI wrapper, store callback directly#550

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

refactor(bundle-size)!: drop UncontrolledAPI wrapper, store callback directly#550
layershifter wants to merge 21 commits into
microsoft:masterfrom
layershifter:chore/bundle-size-stack-13

Conversation

@layershifter
Copy link
Copy Markdown
Member

Summary

The `UncontrolledAPI` object was a thin wrapper around a single user-supplied callback `checkUncontrolledCompletely`. There was only one internal call site (the Tab-key keydown handler from #549). The wrapper is removed — the callback is stored directly on `TabsterCore` as `checkUncontrolledCompletely` and inlined at the call site via `??`.

Breaking change

`tabster.uncontrolled` is removed from the public `Tabster` interface. Consumers should pass `checkUncontrolledCompletely` via `createTabster(win, { checkUncontrolledCompletely })` (already supported) and read it elsewhere via `tabster.core.checkUncontrolledCompletely` if needed.

Stack context

Stacked on top of #549. Net new in this PR: deletion of `src/Uncontrolled.ts` and the call-site inlining.

layershifter and others added 21 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>
…for tree-shaking

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
91.053 kB
28.018 kB
-22.787 kB
-2.919 kB
tabster
createTabster (core)
39.761 kB
11.892 kB
18.141 kB
6.369 kB
-21.62 kB
-5.523 kB
tabster
findAllFocusable
0 B
0 B
21.254 kB
7.35 kB
🆕 New entry
tabster
findLastFocusable
0 B
0 B
21.299 kB
7.369 kB
🆕 New entry
tabster
findNextFocusable
0 B
0 B
21.285 kB
7.363 kB
🆕 New entry
tabster
findPrevFocusable
0 B
0 B
21.299 kB
7.367 kB
🆕 New entry
tabster
getCrossOrigin
110.623 kB
30.244 kB
88.577 kB
27.312 kB
-22.046 kB
-2.932 kB
tabster
getDeloser
49.268 kB
14.234 kB
30.716 kB
10.069 kB
-18.552 kB
-4.165 kB
tabster
getGroupper
47 kB
13.593 kB
34.197 kB
11.451 kB
-12.803 kB
-2.142 kB
tabster
getModalizer
49.072 kB
14.378 kB
35.673 kB
11.932 kB
-13.399 kB
-2.446 kB
tabster
getModalizer (with dummy inputs)
0 B
0 B
38.228 kB
12.634 kB
🆕 New entry
tabster
getMover
54.653 kB
15.887 kB
41.113 kB
13.535 kB
-13.54 kB
-2.352 kB
tabster
getObservedElement
45.564 kB
13.484 kB
22.587 kB
7.88 kB
-22.977 kB
-5.604 kB
tabster
getOutline
48.867 kB
14.216 kB
24.567 kB
8.383 kB
-24.3 kB
-5.833 kB
tabster
getRestorer
42.518 kB
12.52 kB
20.546 kB
7.094 kB
-21.972 kB
-5.426 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