fix(spoolbuddy): resolve react-simple-keyboard interop default so the kiosk keyboard renders (#2616)

Focusing any text field on a SpoolBuddy screen (inventory Search, or the
Search / Color Name / Brand fields on write-tag New Spool) blanked the UI
with React error #130 ("Element type is invalid ... but got: object"). It hit
both internal and Spoolman inventories, so it was not data-specific.

The SpoolBuddy shell mounts VirtualKeyboard, an on-screen keyboard that pops up
on focusin for any input -- so every field on every SpoolBuddy page tripped it,
while the main app (no on-screen keyboard) was fine. VirtualKeyboard imports the
default export of react-simple-keyboard, a CommonJS package; under the current
bundler's CJS->ESM interop that default resolves to the module namespace object
({ KeyboardReact, default }) rather than the component, so <Keyboard> renders an
object as an element type and React throws. vitest's interop returns the real
component, so it only manifested in the browser build -- a runtime, not a type,
problem.

Add a small resolveInteropDefault helper that unwraps such an interop-wrapped
default: it returns the value as-is when already a usable element type
(function/class, tag string, or a $$typeof-marked forwardRef/memo/lazy) and
otherwise falls through to .default and named exports. VirtualKeyboard resolves
the real component through it.
This commit is contained in:
maziggy
2026-07-20 13:41:41 +02:00
parent 258db95483
commit 585b1be054
7 changed files with 294 additions and 152 deletions
+39
View File
@@ -0,0 +1,39 @@
/**
* Unwrap a default import that a bundler's CommonJS->ESM interop may have
* wrapped in a module namespace object.
*
* Some CommonJS packages set `module.exports = { default: X, Named: X }`.
* Depending on the bundler (and differing between the browser build, the test
* runner, and Node's own ESM loader), `import X from 'pkg'` can hand you that
* whole object instead of `X`. Rendering such an object as a React component
* throws "Element type is invalid ... got: object" (React error #130) — see
* #2616, where react-simple-keyboard's default import arrived as the namespace
* object and crashed every SpoolBuddy screen on input focus.
*
* This returns the value unchanged when it is already a usable React element
* type (a function/class component, a tag string, or an object carrying a React
* `$$typeof` marker such as forwardRef/memo/lazy). Otherwise it tries `.default`
* and then each of `fallbackKeys` in order, returning the first usable one, and
* finally falls back to the original value.
*/
export function resolveInteropDefault<T = unknown>(value: unknown, fallbackKeys: string[] = []): T {
if (isRenderableType(value)) return value as T;
if (value !== null && typeof value === 'object') {
const obj = value as Record<string, unknown>;
if (isRenderableType(obj.default)) return obj.default as T;
for (const key of fallbackKeys) {
if (isRenderableType(obj[key])) return obj[key] as T;
}
}
return value as T;
}
/** True when `v` is something React can render as an element type. */
function isRenderableType(v: unknown): boolean {
if (typeof v === 'function' || typeof v === 'string') return true;
// forwardRef / memo / lazy / context objects are valid element types and are
// distinguished from a plain interop wrapper by their React `$$typeof` marker.
return typeof v === 'object' && v !== null && '$$typeof' in v;
}