@pie-players/pie-players-shared 0.2.0

package/dist/pie/initialization.js

@@ -0,0 +1,349 @@
+/**
+ * PIE Initialization Module
+ *
+ * Bundle loading and element initialization logic.
+ * This is the core of the PIE player system.
+ */
+import { BUILDER_BUNDLE_URL } from "../config/profile";
+import { mergeObjectsIgnoringNullUndefined } from "../object";
+import { editorPostFix } from "../types";
+import { createPieLogger, isGlobalDebugEnabled } from "./logger";
+import { initializeMathRendering } from "./math-rendering";
+import { pieRegistry } from "./registry";
+import { findPieController } from "./scoring";
+import { BundleType, isCustomElementConstructor, isPieAvailable, Status, } from "./types";
+import { updatePieElement } from "./updates";
+import { findOrAddSession, getPackageWithoutVersion, getPieElementBundlesUrl, } from "./utils";
+// Create module-level logger (respects global debug flag - pass function for dynamic checking)
+const logger = createPieLogger("pie-initialization", () => isGlobalDebugEnabled());
+// Default options for loading PIE elements
+const defaultOptions = {
+    buildServiceBase: BUILDER_BUNDLE_URL,
+    bundleType: BundleType.player, // Default to player.js (no controllers, server-processed models)
+    env: { mode: "gather", role: "student" },
+};
+/**
+ * Helper function to initialize a PIE element
+ */
+const initializePieElement = (element, options) => {
+    const { config, session, env, eventListeners } = options;
+    const tagName = element.tagName.toLowerCase();
+    logger.debug(`[initializePieElement] Initializing ${tagName}#${element.id}`);
+    // Find model for this element
+    let model = config?.models?.find((m) => m.id === element.id);
+    if (!model) {
+        // Only warn if this element is from a client-player.js bundle (where models are expected)
+        // player.js bundles use server-processed models, so missing models are expected there
+        const registry = pieRegistry();
+        const registryEntry = registry[tagName];
+        if (registryEntry && registryEntry.bundleType === BundleType.clientPlayer) {
+            logger.warn(`[initializePieElement] Model not found for PIE element ${tagName}#${element.id} (client-player.js bundle)`);
+        }
+        return;
+    }
+    // Set session (with element property for updateSession callback)
+    const elementSession = findOrAddSession(session, model.id, model.element);
+    element.session = elementSession;
+    logger.debug(`[initializePieElement] Session set for ${tagName}#${element.id}:`, elementSession);
+    // Set model - use controller if available (client-player.js), or use server-processed model (player.js)
+    const controller = findPieController(tagName);
+    if (!env) {
+        logger.error(`[initializePieElement] ❌ FATAL: No env provided for ${tagName}`);
+        throw new Error(`No env provided for ${tagName}. PIE elements require an env object with mode and role.`);
+    }
+    if (!controller) {
+        // No controller available - using server-processed model (player.js bundle)
+        logger.debug(`[initializePieElement] ℹ️ No controller for ${tagName}, using server-processed model`);
+        logger.debug(`[initializePieElement] Model already processed by server:`, {
+            id: model.id,
+            element: model.element,
+            hasCorrectResponse: "correctResponse" in model,
+            mode: env.mode,
+            role: env.role,
+        });
+        // Set model directly - server already processed it
+        element.model = model;
+    }
+    else {
+        // Controller available - run client-side processing (client-player.js bundle)
+        // Note: updatePieElementWithRef handles controller invocation
+        logger.debug(`[initializePieElement] Controller found for ${tagName}, will invoke model() function`);
+    }
+    // Add event listeners
+    if (eventListeners) {
+        Object.entries(eventListeners).forEach(([evt, fn]) => {
+            element.addEventListener(evt, fn);
+        });
+    }
+};
+/**
+ * Shared element registration logic
+ * Extracted from initializePiesFromLoadedBundle and loadPieModule to eliminate ~200 lines of duplication
+ * Also fixes MutationObserver memory leak by storing latest config/session in window context
+ */
+const registerPieElementsFromBundle = (elementModule, config, session, registry, options) => {
+    const promises = [];
+    logger.debug("[registerPieElementsFromBundle] Available packages in bundle:", Object.keys(elementModule));
+    logger.debug("[registerPieElementsFromBundle] config.elements:", config.elements);
+    // Store latest config/session in window so MutationObserver can access current values
+    if (typeof window !== "undefined") {
+        window._pieCurrentContext = { config, session, env: options.env };
+    }
+    Object.entries(config.elements).forEach(([elName, pkg]) => {
+        logger.debug(`[registerPieElementsFromBundle] Processing element: ${elName} -> ${pkg}`);
+        const pkgStripped = getPackageWithoutVersion(pkg);
+        logger.debug(`[registerPieElementsFromBundle] Package without version: "${pkgStripped}"`);
+        const elementData = elementModule[pkgStripped];
+        logger.debug(`[registerPieElementsFromBundle] elementData result:`, elementData ? "FOUND" : "UNDEFINED");
+        if (!elementData) {
+            logger.error(`[registerPieElementsFromBundle] ❌ Package "${pkgStripped}" not found in bundle!`);
+            logger.error(`[registerPieElementsFromBundle] Lookup key: "${pkgStripped}"`);
+            logger.error(`[registerPieElementsFromBundle] Available packages:`, Object.keys(elementModule));
+            throw new Error(`pie ${pkgStripped} not found in ${Object.keys(elementModule)}`);
+        }
+        logger.debug(`[registerPieElementsFromBundle] elementData for ${pkgStripped}:`, {
+            hasController: !!elementData.controller,
+            hasElement: !!elementData.Element,
+            hasConfig: !!elementData.config,
+            controllerKeys: elementData.controller
+                ? Object.keys(elementData.controller)
+                : [],
+            bundleType: options.bundleType,
+        });
+        // Validate controller presence based on bundle type
+        if (!elementData.controller) {
+            if (options.bundleType === BundleType.clientPlayer) {
+                logger.error(`[registerPieElementsFromBundle] ❌ CRITICAL: No controller found for ${pkgStripped}!`);
+                logger.error(`[registerPieElementsFromBundle] Bundle type: ${options.bundleType} (controllers required)`);
+                throw new Error(`No controller found for ${pkgStripped}. client-player.js bundles MUST include controllers!`);
+            }
+            else {
+                logger.debug(`[registerPieElementsFromBundle] ℹ️ No controller found for ${pkgStripped} - using server-processed models (player.js bundle)`);
+            }
+        }
+        if (!customElements.get(elName)) {
+            // Register the element in our registry
+            logger.debug(`[registerPieElementsFromBundle] Registering ${elName} in registry${elementData.controller
+                ? " with controller"
+                : " (no controller - server-processed models)"}`);
+            registry[elName] = {
+                package: pkg,
+                status: Status.loading,
+                tagName: elName,
+                controller: elementData.controller || null,
+                config: elementData.config,
+                bundleType: options.bundleType,
+            };
+            if (isCustomElementConstructor(elementData.Element)) {
+                customElements.define(elName, elementData.Element);
+                // Initialize existing elements
+                const elements = document.querySelectorAll(elName);
+                logger.debug(`[registerPieElementsFromBundle] Found ${elements.length} elements for tag '${elName}'`);
+                elements.forEach((el) => {
+                    initializePieElement(el, {
+                        config,
+                        session,
+                        env: options.env,
+                        eventListeners: options.eventListeners?.[elName],
+                    });
+                });
+                // Update registry status
+                registry[elName] = {
+                    ...registry[elName],
+                    status: Status.loaded,
+                };
+                promises.push(customElements.whenDefined(elName).then(() => {
+                    logger.debug("[registerPieElementsFromBundle] defined custom PIE element: %s", elName);
+                }));
+                // Setup MutationObserver that uses current context (only once)
+                if (!window._pieElementObserver) {
+                    window._pieElementObserver = new MutationObserver((mutations) => {
+                        // Use current context from window instead of stale closure
+                        const context = window._pieCurrentContext;
+                        if (!context) {
+                            logger.warn("[MutationObserver] No current context available");
+                            return;
+                        }
+                        mutations.forEach((mutation) => {
+                            if (mutation.type === "childList") {
+                                mutation.addedNodes.forEach((node) => {
+                                    if (node.nodeType === Node.ELEMENT_NODE) {
+                                        const tagName = node.tagName.toLowerCase();
+                                        if (registry[tagName]) {
+                                            initializePieElement(node, {
+                                                config: context.config,
+                                                session: context.session,
+                                                env: context.env,
+                                                eventListeners: options.eventListeners?.[tagName],
+                                            });
+                                        }
+                                        // Check children of added nodes
+                                        node
+                                            .querySelectorAll("*")
+                                            .forEach((childNode) => {
+                                            const childTagName = childNode.tagName.toLowerCase();
+                                            if (registry[childTagName]) {
+                                                initializePieElement(childNode, {
+                                                    config: context.config,
+                                                    session: context.session,
+                                                    env: context.env,
+                                                    eventListeners: options.eventListeners?.[childTagName],
+                                                });
+                                            }
+                                        });
+                                    }
+                                });
+                            }
+                        });
+                    });
+                    window._pieElementObserver.observe(document.body, {
+                        childList: true,
+                        subtree: true,
+                    });
+                }
+                // Handle editor elements if needed
+                if (options.bundleType === BundleType.editor) {
+                    if (isCustomElementConstructor(elementData.Configure)) {
+                        const editorElName = elName + editorPostFix;
+                        customElements.define(editorElName, elementData.Configure);
+                        promises.push(customElements.whenDefined(editorElName).then(() => {
+                            logger.debug(`[registerPieElementsFromBundle] defined custom PIE editor element: ${editorElName}`);
+                        }));
+                    }
+                    else {
+                        logger.error(`[registerPieElementsFromBundle] pie.Configure for ${pkgStripped} is not a valid custom element constructor.`, elementData.configure);
+                    }
+                }
+            }
+            else {
+                logger.error(`[registerPieElementsFromBundle] pie.Element for ${pkgStripped} is not a valid custom element constructor.`);
+            }
+        }
+        else {
+            // Element already defined, just update it
+            updatePieElement(elName, {
+                config,
+                session,
+                env: options.env,
+                container: options.container,
+                ...(options.eventListeners?.[elName] && {
+                    eventListeners: options.eventListeners[elName],
+                }),
+            });
+            if (options.bundleType === BundleType.editor) {
+                const editorElName = elName + editorPostFix;
+                updatePieElement(editorElName, {
+                    config,
+                    session,
+                    container: options.container,
+                    ...(options.eventListeners?.[editorElName] && {
+                        eventListeners: options.eventListeners[editorElName],
+                    }),
+                });
+            }
+        }
+    });
+    return promises;
+};
+/**
+ * Initialize PIE elements from a bundle already loaded into window.pie
+ */
+export const initializePiesFromLoadedBundle = (config, session, opts = {}) => {
+    const registry = pieRegistry();
+    const options = mergeObjectsIgnoringNullUndefined(defaultOptions, opts);
+    if (isPieAvailable(window)) {
+        logger.debug("[initializePiesFromLoadedBundle] window.pie available");
+        const elementModule = window.pie.default;
+        // Use shared registration logic
+        registerPieElementsFromBundle(elementModule, config, session, registry, options);
+    }
+    else {
+        logger.error("[initializePiesFromLoadedBundle] window.pie not found; was the bundle inlined correctly?");
+    }
+};
+/**
+ * Load a PIE bundle from a URL and initialize elements
+ */
+export const loadPieModule = async (config, session, opts = {}) => {
+    if (!session) {
+        throw new Error("session is required");
+    }
+    // Initialize math-rendering module (required by PIE elements)
+    await initializeMathRendering();
+    const registry = pieRegistry();
+    const options = mergeObjectsIgnoringNullUndefined(defaultOptions, opts);
+    const url = opts.bundleUrl || getPieElementBundlesUrl(config, options);
+    const script = document.createElement("script");
+    script.src = url;
+    script.defer = true;
+    script.onerror = () => {
+        throw new Error(`failed to load script: ${url}`);
+    };
+    const loadPromise = new Promise((loadResolve) => {
+        script.addEventListener("load", () => {
+            logger.debug("[loadPieModule] Script loaded from:", url);
+            if (isPieAvailable(window)) {
+                logger.debug("[loadPieModule] window.pie available");
+                const elementModule = window.pie.default;
+                // Use shared registration logic (returns array of promises)
+                const registrationPromises = registerPieElementsFromBundle(elementModule, config, session, registry, options);
+                // Wait for all element definitions to complete
+                Promise.all(registrationPromises).then(() => loadResolve());
+            }
+            else {
+                logger.error("[loadPieModule] pie var not found; is %s a proper PIE IIFE module?", url);
+                loadResolve();
+            }
+        });
+    });
+    document.head.appendChild(script);
+    await loadPromise;
+    return { session };
+};
+/**
+ * Load a PIE bundle from a JavaScript string into window.pie (IIFE bundles only)
+ * This only registers elements and controllers - does NOT initialize them.
+ * For initialization, use initializePiesFromLoadedBundle after loading.
+ */
+export const loadBundleFromString = async (bundleJs) => {
+    // Strip sourceMappingURL comment to prevent 404 errors for .map files
+    const cleanedJs = bundleJs.replace(/\/\/# sourceMappingURL=.*$/m, "");
+    // Create a blob URL for the bundle JavaScript
+    const blob = new Blob([cleanedJs], { type: "application/javascript" });
+    const bundleUrl = URL.createObjectURL(blob);
+    try {
+        // Create a script tag to execute the bundle
+        const script = document.createElement("script");
+        script.src = bundleUrl;
+        script.type = "text/javascript"; // IIFE bundles are standard JS
+        // Wait for script to load
+        await new Promise((resolve, reject) => {
+            script.onload = () => resolve();
+            script.onerror = () => reject(new Error("Failed to load bundle"));
+            document.head.appendChild(script);
+        });
+        logger.debug("[loadBundleFromString] Bundle loaded into window.pie");
+    }
+    finally {
+        // Clean up the blob URL
+        URL.revokeObjectURL(bundleUrl);
+    }
+};
+/**
+ * Load a PIE bundle from a JavaScript string and initialize elements
+ * Convenience wrapper around loadBundleFromString + loadPieModule
+ */
+export const loadPieModuleFromString = async (bundleJs, config, session, opts = {}) => {
+    // Create a blob URL for the bundle JavaScript
+    const blob = new Blob([bundleJs], { type: "application/javascript" });
+    const bundleUrl = URL.createObjectURL(blob);
+    try {
+        // Use existing loadPieModule with the blob URL
+        await loadPieModule(config, session, { ...opts, bundleUrl });
+    }
+    finally {
+        // Always clean up the blob URL
+        URL.revokeObjectURL(bundleUrl);
+    }
+};
+//# sourceMappingURL=initialization.js.map

package/dist/pie/initialization.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"initialization.js","sourceRoot":"","sources":["../../src/pie/initialization.ts"],"names":[],"mappings":"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"}

package/dist/pie/logger.d.ts

@@ -0,0 +1,64 @@
+/**
+ * PIE Logger Utility
+ *
+ * Simple, efficient logging for PIE players with debug mode support.
+ * Uses browser console methods (debug, info, warn, error) which can be
+ * filtered natively in browser dev tools.
+ *
+ * Usage:
+ * ```typescript
+ * const logger = createPieLogger('pie-fixed-player', debug);
+ * logger.debug('Detailed debug info', data);  // Only shown if debug=true
+ * logger.info('Important production info');   // Always shown
+ * logger.warn('Warning message');             // Always shown
+ * logger.error('Error occurred', error);      // Always shown
+ * ```
+ */
+export interface PieLogger {
+    /**
+     * Debug-level logging - only shown when debug mode is enabled
+     * Use for: detailed initialization steps, data transformations, internal state
+     */
+    debug: (message: string, ...args: any[]) => void;
+    /**
+     * Info-level logging - always shown
+     * Use for: successful operations, lifecycle events, important milestones
+     */
+    info: (message: string, ...args: any[]) => void;
+    /**
+     * Warning-level logging - always shown
+     * Use for: recoverable errors, deprecated features, potential issues
+     */
+    warn: (message: string, ...args: any[]) => void;
+    /**
+     * Error-level logging - always shown
+     * Use for: errors, exceptions, failures
+     */
+    error: (message: string, ...args: any[]) => void;
+}
+/**
+ * Create a PIE logger instance
+ *
+ * @param namespace - Component name for log prefixing (e.g., 'pie-fixed-player')
+ * @param debugEnabledFn - Function that returns whether debug logs should be shown (checked dynamically on each call)
+ * @returns Logger instance with debug, info, warn, error methods
+ */
+export declare function createPieLogger(namespace: string, debugEnabledFn: () => boolean): PieLogger;
+/**
+ * Global debug flag - can be set via window for runtime debugging
+ *
+ * Usage in browser console:
+ * ```javascript
+ * window.PIE_DEBUG = true;  // Enable debug logging
+ * ```
+ */
+declare global {
+    interface Window {
+        PIE_DEBUG?: boolean;
+    }
+}
+/**
+ * Check if debug mode is enabled globally
+ */
+export declare function isGlobalDebugEnabled(): boolean;
+//# sourceMappingURL=logger.d.ts.map

package/dist/pie/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/pie/logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,MAAM,WAAW,SAAS;IACzB;;;OAGG;IACH,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC;IAEjD;;;OAGG;IACH,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC;IAEhD;;;OAGG;IACH,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC;IAEhD;;;OAGG;IACH,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC;CACjD;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC9B,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,MAAM,OAAO,GAC3B,SAAS,CAqBX;AAED;;;;;;;GAOG;AACH,OAAO,CAAC,MAAM,CAAC;IACd,UAAU,MAAM;QACf,SAAS,CAAC,EAAE,OAAO,CAAC;KACpB;CACD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,OAAO,CAE9C"}

package/dist/pie/logger.js

@@ -0,0 +1,45 @@
+/**
+ * PIE Logger Utility
+ *
+ * Simple, efficient logging for PIE players with debug mode support.
+ * Uses browser console methods (debug, info, warn, error) which can be
+ * filtered natively in browser dev tools.
+ *
+ * Usage:
+ * ```typescript
+ * const logger = createPieLogger('pie-fixed-player', debug);
+ * logger.debug('Detailed debug info', data);  // Only shown if debug=true
+ * logger.info('Important production info');   // Always shown
+ * logger.warn('Warning message');             // Always shown
+ * logger.error('Error occurred', error);      // Always shown
+ * ```
+ */
+/**
+ * Create a PIE logger instance
+ *
+ * @param namespace - Component name for log prefixing (e.g., 'pie-fixed-player')
+ * @param debugEnabledFn - Function that returns whether debug logs should be shown (checked dynamically on each call)
+ * @returns Logger instance with debug, info, warn, error methods
+ */
+export function createPieLogger(namespace, debugEnabledFn) {
+    const prefix = `[${namespace}]`;
+    return {
+        // Only debug method checks debugEnabledFn - it's checked dynamically on every call
+        debug: (message, ...args) => {
+            if (debugEnabledFn()) {
+                console.debug(prefix, message, ...args);
+            }
+        },
+        // info, warn, error always log (not gated by debug flag)
+        info: (message, ...args) => console.info(prefix, message, ...args),
+        warn: (message, ...args) => console.warn(prefix, message, ...args),
+        error: (message, ...args) => console.error(prefix, message, ...args),
+    };
+}
+/**
+ * Check if debug mode is enabled globally
+ */
+export function isGlobalDebugEnabled() {
+    return typeof window !== "undefined" && window.PIE_DEBUG === true;
+}
+//# sourceMappingURL=logger.js.map

package/dist/pie/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/pie/logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AA4BH;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAC9B,SAAiB,EACjB,cAA6B;IAE7B,MAAM,MAAM,GAAG,IAAI,SAAS,GAAG,CAAC;IAEhC,OAAO;QACN,mFAAmF;QACnF,KAAK,EAAE,CAAC,OAAe,EAAE,GAAG,IAAW,EAAE,EAAE;YAC1C,IAAI,cAAc,EAAE,EAAE,CAAC;gBACtB,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;YACzC,CAAC;QACF,CAAC;QAED,yDAAyD;QACzD,IAAI,EAAE,CAAC,OAAe,EAAE,GAAG,IAAW,EAAE,EAAE,CACzC,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;QAEvC,IAAI,EAAE,CAAC,OAAe,EAAE,GAAG,IAAW,EAAE,EAAE,CACzC,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;QAEvC,KAAK,EAAE,CAAC,OAAe,EAAE,GAAG,IAAW,EAAE,EAAE,CAC1C,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;KACxC,CAAC;AACH,CAAC;AAgBD;;GAEG;AACH,MAAM,UAAU,oBAAoB;IACnC,OAAO,OAAO,MAAM,KAAK,WAAW,IAAI,MAAM,CAAC,SAAS,KAAK,IAAI,CAAC;AACnE,CAAC"}

package/dist/pie/math-rendering.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Pluggable math rendering for PIE players
+ *
+ * PIE elements expect @pie-lib/math-rendering to be available on window.
+ * This module provides a pluggable provider pattern that allows switching
+ * between MathJax, KaTeX, or custom renderers.
+ *
+ * IMPORTANT: Uses dynamic import to avoid SSR issues - the module is browser-only.
+ */
+import { type MathRenderingAPI } from "@pie-players/math-renderer-core";
+/**
+ * Initialize math rendering with optional custom renderer
+ *
+ * If no custom renderer is provided, defaults to MathJax for backward compatibility.
+ * For custom renderers, use setMathRenderer() before calling this function.
+ *
+ * Sets TWO window globals that PIE elements expect:
+ * - window["@pie-lib/math-rendering"] (standard key)
+ * - window["_dll_pie_lib__math_rendering"] (SystemJS/DLL key for IIFE bundles)
+ *
+ * @param customRenderer - Optional custom renderer to use instead of default MathJax
+ *
+ * @example
+ * ```typescript
+ * // Default MathJax (backward compatible)
+ * await initializeMathRendering();
+ *
+ * // Custom renderer
+ * import { createKatexRenderer } from '@pie-players/math-renderer-katex';
+ * const katexRenderer = await createKatexRenderer();
+ * await initializeMathRendering(katexRenderer);
+ *
+ * // Or use setMathRenderer first
+ * setMathRenderer(katexRenderer);
+ * await initializeMathRendering();
+ * ```
+ */
+export declare function initializeMathRendering(customRenderer?: MathRenderingAPI): Promise<void>;
+/**
+ * Set custom math renderer programmatically
+ *
+ * Call this BEFORE initializeMathRendering() or any loader.load() calls
+ * to override the default MathJax renderer.
+ *
+ * @param renderer - The renderer to use
+ *
+ * @example
+ * ```typescript
+ * import { createKatexRenderer } from '@pie-players/math-renderer-katex';
+ * import { setMathRenderer } from '@pie-players/pie-players-shared/pie';
+ *
+ * const katexRenderer = await createKatexRenderer({ throwOnError: false });
+ * setMathRenderer(katexRenderer);
+ *
+ * // Now load PIE elements - they'll use KaTeX
+ * await loader.load(config, document, needsControllers);
+ * ```
+ */
+export declare function setMathRenderer(renderer: MathRenderingAPI): void;
+/**
+ * Render math in the given element
+ *
+ * Convenience wrapper that calls the active renderer's renderMath() function.
+ * Typically called after PIE elements are rendered.
+ *
+ * @param element - The element to render math within
+ */
+export declare function renderMath(element: HTMLElement): void;
+//# sourceMappingURL=math-rendering.d.ts.map

package/dist/pie/math-rendering.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"math-rendering.d.ts","sourceRoot":"","sources":["../../src/pie/math-rendering.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EACN,KAAK,gBAAgB,EAErB,MAAM,iCAAiC,CAAC;AAGzC;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAsB,uBAAuB,CAC5C,cAAc,CAAC,EAAE,gBAAgB,GAC/B,OAAO,CAAC,IAAI,CAAC,CA4Bf;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,gBAAgB,GAAG,IAAI,CAEhE;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,CAMrD"}

package/dist/pie/math-rendering.js

@@ -0,0 +1,98 @@
+/**
+ * Pluggable math rendering for PIE players
+ *
+ * PIE elements expect @pie-lib/math-rendering to be available on window.
+ * This module provides a pluggable provider pattern that allows switching
+ * between MathJax, KaTeX, or custom renderers.
+ *
+ * IMPORTANT: Uses dynamic import to avoid SSR issues - the module is browser-only.
+ */
+/// <reference path="../shims.d.ts" />
+import { mathRendererProvider, } from "@pie-players/math-renderer-core";
+import { createMathjaxRenderer } from "@pie-players/math-renderer-mathjax";
+/**
+ * Initialize math rendering with optional custom renderer
+ *
+ * If no custom renderer is provided, defaults to MathJax for backward compatibility.
+ * For custom renderers, use setMathRenderer() before calling this function.
+ *
+ * Sets TWO window globals that PIE elements expect:
+ * - window["@pie-lib/math-rendering"] (standard key)
+ * - window["_dll_pie_lib__math_rendering"] (SystemJS/DLL key for IIFE bundles)
+ *
+ * @param customRenderer - Optional custom renderer to use instead of default MathJax
+ *
+ * @example
+ * ```typescript
+ * // Default MathJax (backward compatible)
+ * await initializeMathRendering();
+ *
+ * // Custom renderer
+ * import { createKatexRenderer } from '@pie-players/math-renderer-katex';
+ * const katexRenderer = await createKatexRenderer();
+ * await initializeMathRendering(katexRenderer);
+ *
+ * // Or use setMathRenderer first
+ * setMathRenderer(katexRenderer);
+ * await initializeMathRendering();
+ * ```
+ */
+export async function initializeMathRendering(customRenderer) {
+    // Only run in browser
+    if (typeof window === "undefined") {
+        return;
+    }
+    // Already initialized - skip
+    if (mathRendererProvider.isInitialized()) {
+        return;
+    }
+    try {
+        // Use custom renderer or default to MathJax for backward compatibility
+        const renderer = customRenderer ?? (await createMathjaxRenderer());
+        // Set in provider (automatically updates window globals)
+        mathRendererProvider.setRenderer(renderer);
+        console.log("[MathRendering] ✅ Math rendering module initialized (both globals set)");
+    }
+    catch (error) {
+        console.error("[MathRendering] ❌ Failed to initialize math rendering:", error);
+        throw error;
+    }
+}
+/**
+ * Set custom math renderer programmatically
+ *
+ * Call this BEFORE initializeMathRendering() or any loader.load() calls
+ * to override the default MathJax renderer.
+ *
+ * @param renderer - The renderer to use
+ *
+ * @example
+ * ```typescript
+ * import { createKatexRenderer } from '@pie-players/math-renderer-katex';
+ * import { setMathRenderer } from '@pie-players/pie-players-shared/pie';
+ *
+ * const katexRenderer = await createKatexRenderer({ throwOnError: false });
+ * setMathRenderer(katexRenderer);
+ *
+ * // Now load PIE elements - they'll use KaTeX
+ * await loader.load(config, document, needsControllers);
+ * ```
+ */
+export function setMathRenderer(renderer) {
+    mathRendererProvider.setRenderer(renderer);
+}
+/**
+ * Render math in the given element
+ *
+ * Convenience wrapper that calls the active renderer's renderMath() function.
+ * Typically called after PIE elements are rendered.
+ *
+ * @param element - The element to render math within
+ */
+export function renderMath(element) {
+    const renderer = mathRendererProvider.getRenderer();
+    if (renderer && typeof renderer.renderMath === "function") {
+        renderer.renderMath(element);
+    }
+}
+//# sourceMappingURL=math-rendering.js.map