@pie-players/pie-players-shared 0.2.0

package/dist/pie/iife-loader.js

@@ -0,0 +1,303 @@
+/**
+ * IIFE PIE Loader
+ *
+ * Dynamically loads PIE elements from IIFE bundles served by the PIE build service.
+ * Matches the behavior of the original pie-player from @pie-players/pie-player-components.
+ *
+ * Integrates with the existing PIE registry system to enable shared
+ * initialization code to work with IIFE-loaded elements.
+ */
+import { createPieLogger } from "./logger";
+import { initializeMathRendering } from "./math-rendering";
+import { pieRegistry } from "./registry";
+import { BundleType, isCustomElementConstructor, Status } from "./types";
+import { getPackageWithoutVersion } from "./utils";
+// Logger factory - will be initialized when loader is created
+let logger;
+// Default PIE bundle service URL.
+// Use the public proxy endpoint (stable + cached) rather than the builder origin directly.
+export const DEFAULT_BUNDLE_HOST = "https://proxy.pie-api.com/bundles/";
+// Initialize pieHelpers on window if not already present
+if (typeof window !== "undefined" && !window.pieHelpers) {
+    window.pieHelpers = {
+        loadingScripts: {},
+        loadingPromises: {},
+    };
+}
+export class IifePieLoader {
+    config;
+    constructor(config) {
+        this.config = config;
+        // Initialize logger with debug function
+        logger = createPieLogger("iife-loader", config.debugEnabled || (() => false));
+    }
+    /**
+     * Get the bundle URL based on config elements
+     */
+    getBundleUrl(elements, bundleType, bundleInfo) {
+        // 1. If explicit bundle URL provided in config, use that
+        if (bundleInfo?.url) {
+            logger.debug("Using explicit bundle URL from config:", bundleInfo.url);
+            return bundleInfo.url;
+        }
+        // 2. Build URL from element versions using bundle host
+        const packageVersions = Object.values(elements).join("+");
+        const url = `${this.config.bundleHost}${encodeURI(packageVersions)}/${bundleType}`;
+        logger.debug("Using bundle host URL:", url);
+        return url;
+    }
+    /**
+     * Load an IIFE bundle from the specified URL
+     */
+    async loadBundleScript(url, doc) {
+        return new Promise((resolve, reject) => {
+            const script = doc.createElement("script");
+            script.src = url;
+            script.defer = true;
+            script.setAttribute("data-pie-bundle", "true"); // Mark as PIE bundle for cleanup
+            script.onload = () => {
+                logger.debug("Bundle loaded successfully from:", url);
+                resolve();
+            };
+            script.onerror = () => {
+                const error = `Failed to load IIFE bundle from: ${url}`;
+                logger.error(error);
+                reject(new Error(error));
+            };
+            doc.head.appendChild(script);
+        });
+    }
+    whenDefinedWithTimeout(tagName) {
+        const ms = this.config.whenDefinedTimeoutMs ?? 5000;
+        return Promise.race([
+            customElements.whenDefined(tagName).then(() => undefined),
+            new Promise((_, reject) => setTimeout(() => reject(new Error(`Timeout waiting for ${tagName}`)), ms)),
+        ]);
+    }
+    createEmptyConfigure() {
+        // Minimal configure element to avoid hard failures when a package lacks Configure export.
+        // Matches legacy behavior (empty-configure) but intentionally does not emit model updates.
+        return class EmptyConfigureElement extends HTMLElement {
+            _model;
+            _configuration;
+            set model(m) {
+                this._model = m;
+            }
+            get model() {
+                return this._model;
+            }
+            set configuration(c) {
+                this._configuration = c;
+            }
+            get configuration() {
+                return this._configuration;
+            }
+        };
+    }
+    /**
+     * Register elements from the loaded IIFE bundle into the PIE registry
+     */
+    async registerElementsFromBundle(elements, needsControllers, bundleType) {
+        const registry = pieRegistry();
+        if (!window.pie || !window.pie.default) {
+            throw new Error("window.pie not found - IIFE bundle did not load correctly");
+        }
+        const pieModule = window.pie.default;
+        logger.debug("Found window.pie.default with packages:", Object.keys(pieModule));
+        logger.debug("Elements to register:", elements);
+        logger.debug("Bundle type:", bundleType);
+        const promises = [];
+        const isEditorBundle = bundleType === BundleType.editor;
+        for (const [tagName, packageVersion] of Object.entries(elements)) {
+            try {
+                const packageName = getPackageWithoutVersion(packageVersion);
+                logger.debug(`Registering element ${tagName} from package ${packageName} (full: ${packageVersion})`);
+                const elementData = pieModule[packageName];
+                if (!elementData) {
+                    throw new Error(`Package "${packageName}" not found in IIFE bundle. Available: ${Object.keys(pieModule).join(", ")}`);
+                }
+                // For editor bundles, look for Configure class; otherwise use Element class.
+                // If Configure is missing, fall back to an empty configure element (legacy parity).
+                const ElementClass = isEditorBundle
+                    ? elementData.Configure || this.createEmptyConfigure()
+                    : elementData.Element;
+                const controller = needsControllers ? elementData.controller : null;
+                // For editor bundles, append -config suffix to tag name
+                const actualTagName = isEditorBundle ? `${tagName}-config` : tagName;
+                if (!ElementClass) {
+                    const classType = isEditorBundle ? "Configure" : "Element";
+                    throw new Error(`No ${classType} class found in package ${packageName}`);
+                }
+                // Register in the global PIE registry (used by shared initialization code)
+                registry[actualTagName] = {
+                    package: packageVersion,
+                    status: Status.loading,
+                    tagName: actualTagName,
+                    element: ElementClass,
+                    controller: controller,
+                    config: elementData.config || null,
+                    bundleType: bundleType || "iife", // Mark bundle type
+                };
+                // Register custom element if not already defined
+                if (!customElements.get(actualTagName)) {
+                    if (isCustomElementConstructor(ElementClass)) {
+                        // Wrap the Element class to allow multiple registrations with the same constructor
+                        customElements.define(actualTagName, class extends ElementClass {
+                        });
+                        logger.debug(`Registered custom element: ${actualTagName}`);
+                        // Wait for element to be defined, then update status
+                        const promise = this.whenDefinedWithTimeout(actualTagName)
+                            .then(() => {
+                            registry[actualTagName] = {
+                                ...registry[actualTagName],
+                                status: Status.loaded,
+                            };
+                            logger.debug(`Element ${actualTagName} fully loaded`);
+                        })
+                            .catch((err) => {
+                            logger.error(`Failed to define element ${actualTagName}:`, err);
+                        });
+                        promises.push(promise);
+                    }
+                    else {
+                        logger.warn(`Element class for ${packageName} is not a valid custom element constructor`);
+                    }
+                }
+                else {
+                    logger.debug(`Element ${actualTagName} already registered`);
+                    registry[actualTagName] = {
+                        ...registry[actualTagName],
+                        status: Status.loaded,
+                    };
+                }
+            }
+            catch (err) {
+                logger.error(`Failed to register element ${tagName}:`, err);
+                throw err;
+            }
+        }
+        // Wait for all elements to be defined
+        await Promise.all(promises);
+        logger.debug("All elements registered and defined");
+    }
+    /**
+     * Load PIE elements from IIFE bundle
+     *
+     * @param contentConfig - Item config with elements
+     * @param doc - Document to inject script into
+     * @param bundleType - Type of bundle (BundleType.player, BundleType.clientPlayer, or BundleType.editor)
+     * @param needsControllers - Whether controllers are needed
+     */
+    async load(contentConfig, doc, bundleType, needsControllers) {
+        logger.debug("load() called");
+        logger.debug("Bundle type:", bundleType);
+        logger.debug("Needs controllers:", needsControllers);
+        logger.debug("Content config:", contentConfig);
+        if (!contentConfig?.elements) {
+            logger.warn("No elements in config");
+            return;
+        }
+        // 0. Initialize math-rendering (required by PIE elements)
+        await initializeMathRendering();
+        // 1. Determine bundle URL
+        const bundleUrl = this.getBundleUrl(contentConfig.elements, bundleType, contentConfig.bundle);
+        // 2. Check if we need to load a different bundle
+        // Remove any previously loaded bundle script to avoid conflicts
+        const existingScript = doc.querySelector(`script[src="${bundleUrl}"]`);
+        const existingScriptDifferent = Array.from(doc.querySelectorAll('script[data-pie-bundle="true"]')).find((script) => script.getAttribute("src") !== bundleUrl);
+        if (existingScriptDifferent) {
+            logger.debug("Removing previously loaded bundle:", existingScriptDifferent.getAttribute("src"));
+            existingScriptDifferent.remove();
+            // Clear window.pie to force clean reload
+            if (window.pie) {
+                delete window.pie;
+            }
+        }
+        // If the exact bundle we need is already loaded, just register elements
+        if (existingScript && window.pie && window.pie.default) {
+            logger.debug("Exact bundle already loaded, registering elements");
+            await this.registerElementsFromBundle(contentConfig.elements, needsControllers, bundleType);
+            logger.debug("✅ Elements registered from existing bundle");
+            return;
+        }
+        // 3. Check if bundle is currently loading - if so, wait for it
+        if (window.pieHelpers?.loadingPromises?.[bundleUrl]) {
+            logger.debug("Bundle is already loading, waiting for existing load:", bundleUrl);
+            await window.pieHelpers.loadingPromises[bundleUrl];
+            logger.debug("Existing bundle load completed, registering elements");
+            await this.registerElementsFromBundle(contentConfig.elements, needsControllers, bundleType);
+            logger.debug("✅ Elements registered from already-loading bundle");
+            return;
+        }
+        // 4. Mark as loading and create promise
+        if (window.pieHelpers) {
+            window.pieHelpers.loadingScripts[bundleUrl] = true;
+        }
+        // Create and store the loading promise
+        const loadPromise = (async () => {
+            try {
+                // Load the IIFE bundle
+                logger.debug("Loading IIFE bundle from:", bundleUrl);
+                try {
+                    await this.loadBundleScript(bundleUrl, doc);
+                }
+                catch (e) {
+                    if (this.config.reFetchBundle) {
+                        const retryUrl = bundleUrl +
+                            (bundleUrl.includes("?") ? "&" : "?") +
+                            `t=${Date.now()}`;
+                        logger.warn("[IifePieLoader] Initial bundle load failed, retrying with cache bust:", retryUrl);
+                        await this.loadBundleScript(retryUrl, doc);
+                    }
+                    else {
+                        throw e;
+                    }
+                }
+                // Register elements from the loaded bundle
+                logger.debug("Registering elements from loaded bundle");
+                await this.registerElementsFromBundle(contentConfig.elements, needsControllers, bundleType);
+                logger.debug("✅ IIFE bundle loaded and elements registered");
+            }
+            catch (err) {
+                logger.error("Failed to load IIFE bundle:", err);
+                // Clean up on error
+                if (window.pieHelpers) {
+                    delete window.pieHelpers.loadingPromises[bundleUrl];
+                    delete window.pieHelpers.loadingScripts[bundleUrl];
+                }
+                throw err;
+            }
+            finally {
+                // Clean up promise after completion (success or failure)
+                if (window.pieHelpers?.loadingPromises?.[bundleUrl]) {
+                    delete window.pieHelpers.loadingPromises[bundleUrl];
+                }
+            }
+        })();
+        // Store the promise so other loaders can wait for it
+        if (window.pieHelpers) {
+            window.pieHelpers.loadingPromises[bundleUrl] = loadPromise;
+        }
+        // Wait for the load to complete
+        await loadPromise;
+    }
+    /**
+     * Get controller for a specific element tag
+     */
+    getController(tag) {
+        const registry = pieRegistry();
+        return registry[tag]?.controller || null;
+    }
+    /**
+     * Wait for elements to be fully loaded
+     */
+    async elementsHaveLoaded(elements) {
+        const promises = elements.map((el) => {
+            logger.debug(`Waiting for ${el.tag} to be defined`);
+            return this.whenDefinedWithTimeout(el.tag);
+        });
+        await Promise.all(promises);
+        return { elements, val: true };
+    }
+}
+//# sourceMappingURL=iife-loader.js.map

package/dist/pie/iife-loader.js.map

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

package/dist/pie/index.d.ts

@@ -0,0 +1,31 @@
+/**
+ * PIE Utilities Index
+ *
+ * Barrel export for backward compatibility.
+ * For better tree-shaking, import directly from specific modules:
+ *
+ * - `pie/types` - Interfaces and enums
+ * - `pie/registry` - Registry management
+ * - `pie/utils` - URL building and session utilities
+ * - `pie/config` - Config manipulation
+ * - `pie/updates` - Element update functions
+ * - `pie/scoring` - Scoring and controller lookup
+ * - `pie/initialization` - Bundle loading and element initialization
+ */
+export { addMarkupForPackage, addRubricIfNeeded, elementForPackage, makeUniqueTags, modelsForPackage, } from "./config";
+export type { EsmLoaderConfig } from "./esm-loader";
+export { EsmPieLoader } from "./esm-loader";
+export type { IifeLoaderConfig } from "./iife-loader";
+export { DEFAULT_BUNDLE_HOST, IifePieLoader } from "./iife-loader";
+export { initializePiesFromLoadedBundle, loadBundleFromString, loadPieModule, loadPieModuleFromString, } from "./initialization";
+export type { PieLogger } from "./logger";
+export { createPieLogger, isGlobalDebugEnabled } from "./logger";
+export type { ItemData, PiePlayerConfig, PiePlayerElements, } from "./player-initializer";
+export { buildApiParams, buildEventListenersMap, ensurePiePlayerLoaded, extractPassageMarkup, fetchItemData, initializePiePlayer, } from "./player-initializer";
+export { pieRegistry } from "./registry";
+export { findPieController, scorePieItem } from "./scoring";
+export type { Entry, EventListeners, EventListenersMap, LoadPieElementsOptions, PieElement, PieRegistry, UpdatePieElementOptions, } from "./types";
+export { BundleType, defaultPieElementOptions, isCustomElementConstructor, isPieAvailable, isPieRegistryAvailable, Status, } from "./types";
+export { updatePieElement, updatePieElements, updatePieElementWithRef, } from "./updates";
+export { findOrAddSession, getPackageWithoutVersion, getPieElementBundlesUrl, parsePackageName, } from "./utils";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/pie/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,EACN,mBAAmB,EACnB,iBAAiB,EACjB,iBAAiB,EACjB,cAAc,EACd,gBAAgB,GAChB,MAAM,UAAU,CAAC;AAElB,YAAY,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,YAAY,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEnE,OAAO,EACN,8BAA8B,EAC9B,oBAAoB,EACpB,aAAa,EACb,uBAAuB,GACvB,MAAM,kBAAkB,CAAC;AAE1B,YAAY,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAEjE,YAAY,EACX,QAAQ,EACR,eAAe,EACf,iBAAiB,GACjB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACN,cAAc,EACd,sBAAsB,EACtB,qBAAqB,EACrB,oBAAoB,EACpB,aAAa,EACb,mBAAmB,GACnB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzC,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAE5D,YAAY,EACX,KAAK,EACL,cAAc,EACd,iBAAiB,EACjB,sBAAsB,EACtB,UAAU,EACV,WAAW,EACX,uBAAuB,GACvB,MAAM,SAAS,CAAC;AACjB,OAAO,EACN,UAAU,EACV,wBAAwB,EACxB,0BAA0B,EAE1B,cAAc,EACd,sBAAsB,EACtB,MAAM,GACN,MAAM,SAAS,CAAC;AAEjB,OAAO,EACN,gBAAgB,EAChB,iBAAiB,EACjB,uBAAuB,GACvB,MAAM,WAAW,CAAC;AAEnB,OAAO,EACN,gBAAgB,EAChB,wBAAwB,EACxB,uBAAuB,EACvB,gBAAgB,GAChB,MAAM,SAAS,CAAC"}

package/dist/pie/index.js

@@ -0,0 +1,34 @@
+/**
+ * PIE Utilities Index
+ *
+ * Barrel export for backward compatibility.
+ * For better tree-shaking, import directly from specific modules:
+ *
+ * - `pie/types` - Interfaces and enums
+ * - `pie/registry` - Registry management
+ * - `pie/utils` - URL building and session utilities
+ * - `pie/config` - Config manipulation
+ * - `pie/updates` - Element update functions
+ * - `pie/scoring` - Scoring and controller lookup
+ * - `pie/initialization` - Bundle loading and element initialization
+ */
+// Config
+export { addMarkupForPackage, addRubricIfNeeded, elementForPackage, makeUniqueTags, modelsForPackage, } from "./config";
+export { EsmPieLoader } from "./esm-loader";
+export { DEFAULT_BUNDLE_HOST, IifePieLoader } from "./iife-loader";
+// Initialization
+export { initializePiesFromLoadedBundle, loadBundleFromString, loadPieModule, loadPieModuleFromString, } from "./initialization";
+export { createPieLogger, isGlobalDebugEnabled } from "./logger";
+export { buildApiParams, buildEventListenersMap, ensurePiePlayerLoaded, extractPassageMarkup, fetchItemData, initializePiePlayer, } from "./player-initializer";
+// Registry
+export { pieRegistry } from "./registry";
+// Scoring
+export { findPieController, scorePieItem } from "./scoring";
+export { BundleType, defaultPieElementOptions, isCustomElementConstructor, 
+// Type guards (functions)
+isPieAvailable, isPieRegistryAvailable, Status, } from "./types";
+// Updates
+export { updatePieElement, updatePieElements, updatePieElementWithRef, } from "./updates";
+// Utils
+export { findOrAddSession, getPackageWithoutVersion, getPieElementBundlesUrl, parsePackageName, } from "./utils";
+//# sourceMappingURL=index.js.map

package/dist/pie/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/pie/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,SAAS;AACT,OAAO,EACN,mBAAmB,EACnB,iBAAiB,EACjB,iBAAiB,EACjB,cAAc,EACd,gBAAgB,GAChB,MAAM,UAAU,CAAC;AAGlB,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,OAAO,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACnE,iBAAiB;AACjB,OAAO,EACN,8BAA8B,EAC9B,oBAAoB,EACpB,aAAa,EACb,uBAAuB,GACvB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAOjE,OAAO,EACN,cAAc,EACd,sBAAsB,EACtB,qBAAqB,EACrB,oBAAoB,EACpB,aAAa,EACb,mBAAmB,GACnB,MAAM,sBAAsB,CAAC;AAC9B,WAAW;AACX,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,UAAU;AACV,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAW5D,OAAO,EACN,UAAU,EACV,wBAAwB,EACxB,0BAA0B;AAC1B,0BAA0B;AAC1B,cAAc,EACd,sBAAsB,EACtB,MAAM,GACN,MAAM,SAAS,CAAC;AACjB,UAAU;AACV,OAAO,EACN,gBAAgB,EAChB,iBAAiB,EACjB,uBAAuB,GACvB,MAAM,WAAW,CAAC;AACnB,QAAQ;AACR,OAAO,EACN,gBAAgB,EAChB,wBAAwB,EACxB,uBAAuB,EACvB,gBAAgB,GAChB,MAAM,SAAS,CAAC"}

package/dist/pie/initialization.d.ts

@@ -0,0 +1,40 @@
+/**
+ * PIE Initialization Module
+ *
+ * Bundle loading and element initialization logic.
+ * This is the core of the PIE player system.
+ */
+import type { ConfigEntity, Env } from "../types";
+import type { LoadPieElementsOptions } from "./types";
+declare global {
+    interface Window {
+        _pieElementObserver?: MutationObserver;
+        _pieCurrentContext?: {
+            config: ConfigEntity;
+            session: any[];
+            env?: Env;
+        };
+    }
+}
+/**
+ * Initialize PIE elements from a bundle already loaded into window.pie
+ */
+export declare const initializePiesFromLoadedBundle: (config: ConfigEntity, session: any[], opts?: LoadPieElementsOptions) => void;
+/**
+ * Load a PIE bundle from a URL and initialize elements
+ */
+export declare const loadPieModule: (config: ConfigEntity, session: any[], opts?: LoadPieElementsOptions) => Promise<{
+    session: any[];
+}>;
+/**
+ * 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 declare const loadBundleFromString: (bundleJs: string) => Promise<void>;
+/**
+ * Load a PIE bundle from a JavaScript string and initialize elements
+ * Convenience wrapper around loadBundleFromString + loadPieModule
+ */
+export declare const loadPieModuleFromString: (bundleJs: string, config: ConfigEntity, session: any[], opts?: LoadPieElementsOptions) => Promise<void>;
+//# sourceMappingURL=initialization.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"initialization.d.ts","sourceRoot":"","sources":["../../src/pie/initialization.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,GAAG,EAAY,MAAM,UAAU,CAAC;AAM5D,OAAO,KAAK,EAEX,sBAAsB,EAGtB,MAAM,SAAS,CAAC;AA2BjB,OAAO,CAAC,MAAM,CAAC;IACd,UAAU,MAAM;QACf,mBAAmB,CAAC,EAAE,gBAAgB,CAAC;QACvC,kBAAkB,CAAC,EAAE;YACpB,MAAM,EAAE,YAAY,CAAC;YACrB,OAAO,EAAE,GAAG,EAAE,CAAC;YACf,GAAG,CAAC,EAAE,GAAG,CAAC;SACV,CAAC;KACF;CACD;AA4UD;;GAEG;AACH,eAAO,MAAM,8BAA8B,GAC1C,QAAQ,YAAY,EACpB,SAAS,GAAG,EAAE,EACd,OAAM,sBAA2B,KAC/B,IAqBF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,aAAa,GACzB,QAAQ,YAAY,EACpB,SAAS,GAAG,EAAE,EACd,OAAM,sBAA2B,KAC/B,OAAO,CAAC;IACV,OAAO,EAAE,GAAG,EAAE,CAAC;CACf,CAiDA,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,GAAU,UAAU,MAAM,KAAG,OAAO,CAAC,IAAI,CA0BzE,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,uBAAuB,GACnC,UAAU,MAAM,EAChB,QAAQ,YAAY,EACpB,SAAS,GAAG,EAAE,EACd,OAAM,sBAA2B,KAC/B,OAAO,CAAC,IAAI,CAYd,CAAC"}