@pie-element/element-player 0.1.2-next.12 → 0.1.2-next.14

package/README.md

@@ -83,7 +83,6 @@ For elements with import maps:
 
 - Loads elements via dynamic ESM imports: `import('@pie-element/hotspot')`
 - Handles session state and user interactions
-- Manages math rendering internally (MathJax)
 - Emits `session-changed` events
 - Works with both React and Svelte elements
 
@@ -92,16 +91,18 @@ For elements with import maps:
 - Loads print exports: `import('@pie-element/hotspot/print')`
 - Stateless (no session management)
 - Optimized for print layouts
-- Manages math rendering internally (MathJax)
 - Role-based rendering (student/instructor)
 
 **All views:**
 
 - Use import maps for module resolution
 - Self-contained (no external setup needed)
-- Handle math rendering automatically
 - Support for both React and Svelte elements
 
+### Math rendering
+
+The player typesets math through `window['@pie-lib/math-rendering'].renderMath`, read on every render. A renderer the host installs there before the player mounts, such as the legacy MathJax 3 one, is used and no MathJax 4 loads. Without one, the player installs a MathJax 4 renderer from `@pie-element/shared-math-rendering-mathjax`, which elements and later players on the page share.
+
 ### Events
 
 The player dispatches each event from `<pie-element-player>`, bubbling and composed. A bubble-phase listener on the player, on an ancestor or on `document` hears each event once, with `event.target` the player; a listener outside a shadow root that contains the player sees that root's host instead. The element's own `session-changed` stops at the element, and the player dispatches its copy in its place. A capture-phase listener on the player or above it also hears every `session-changed` the element dispatches, ahead of the player's copy, and should ignore events whose `event.composedPath()[0]` is not the player. That equals `event.target` when no shadow root lies between listener and player. A closed shadow root hides the player from both, so listen in the bubble phase there.