@pie-players/pie-players-shared 0.3.61 → 0.3.62

package/dist/config/profile.js

@@ -24,4 +24,3 @@ export const BUILDER_ORIGIN_URL = (typeof window !== "undefined" && window.PIE_B
 export const BUILDER_BUNDLE_URL = (typeof window !== "undefined" && window.PIE_BUILDER_BUNDLE_URL) ||
     readPublicEnv("PUBLIC_BUILDER_BUNDLE_URL") ||
     DEFAULT_BUILDER_BUNDLE_URL;
-//# sourceMappingURL=profile.js.map

package/dist/i18n/index.js

@@ -7,4 +7,3 @@
  */
 export { BUNDLED_TRANSLATIONS, getAvailableLocales, isRTLLocale, loadTranslations, } from "./loader.js";
 export { SimpleI18n } from "./simple-i18n.js";
-//# sourceMappingURL=index.js.map

package/dist/i18n/loader.js

@@ -130,4 +130,3 @@ export function getAvailableLocales() {
 export function isRTLLocale(locale) {
     return RTL_LOCALES.includes(locale);
 }
-//# sourceMappingURL=loader.js.map

package/dist/i18n/simple-i18n.js

@@ -196,4 +196,3 @@ export class SimpleI18n {
         return browserLang.split("-")[0];
     }
 }
-//# sourceMappingURL=simple-i18n.js.map

package/dist/i18n/types.js

@@ -5,4 +5,3 @@
  * Defined in players-shared to avoid circular dependencies.
  */
 export {};
-//# sourceMappingURL=types.js.map

package/dist/index.d.ts

@@ -13,3 +13,4 @@ export * from "./ui/focus-trap.js";
 export * from "./ui/first-focusable.js";
 export * from "./ui/debug-panel-persistence.js";
 export * from "./ui/safe-storage.js";
+export * from "./ui/scope-css.js";

package/dist/index.js

@@ -13,4 +13,4 @@ export * from "./ui/focus-trap.js";
 export * from "./ui/first-focusable.js";
 export * from "./ui/debug-panel-persistence.js";
 export * from "./ui/safe-storage.js";
-//# sourceMappingURL=index.js.map
+export * from "./ui/scope-css.js";

package/dist/instrumentation/debug-panel-stream.js

@@ -107,4 +107,3 @@ export function createMetricDebugRecord(args) {
             : undefined,
     };
 }
-//# sourceMappingURL=debug-panel-stream.js.map

package/dist/instrumentation/index.js

@@ -33,4 +33,3 @@
 export * from "./providers/index.js";
 export { isInstrumentationProvider } from "./provider-guards.js";
 export { clearBufferedInstrumentationDebugRecords, getBufferedInstrumentationDebugRecords, INSTRUMENTATION_DEBUG_EVENT_NAME, subscribeInstrumentationDebugRecords, } from "./debug-panel-stream.js";
-//# sourceMappingURL=index.js.map

package/dist/instrumentation/provider-guards.js

@@ -10,4 +10,3 @@ export function isInstrumentationProvider(value) {
         typeof candidate.destroy === "function" &&
         typeof candidate.isReady === "function");
 }
-//# sourceMappingURL=provider-guards.js.map

package/dist/instrumentation/providers/BaseInstrumentationProvider.js

@@ -264,4 +264,3 @@ export class BaseInstrumentationProvider {
         return attributes;
     }
 }
-//# sourceMappingURL=BaseInstrumentationProvider.js.map

package/dist/instrumentation/providers/CompositeInstrumentationProvider.js

@@ -79,4 +79,3 @@ export class CompositeInstrumentationProvider {
         }
     }
 }
-//# sourceMappingURL=CompositeInstrumentationProvider.js.map

package/dist/instrumentation/providers/ConsoleInstrumentationProvider.js

@@ -179,4 +179,3 @@ export class ConsoleInstrumentationProvider extends BaseInstrumentationProvider
         console.log("Attributes:", attributes);
     }
 }
-//# sourceMappingURL=ConsoleInstrumentationProvider.js.map

package/dist/instrumentation/providers/DebugPanelInstrumentationProvider.js

@@ -70,4 +70,3 @@ export class DebugPanelInstrumentationProvider extends BaseInstrumentationProvid
         });
     }
 }
-//# sourceMappingURL=DebugPanelInstrumentationProvider.js.map

package/dist/instrumentation/providers/NewRelicInstrumentationProvider.js

@@ -131,4 +131,3 @@ export class NewRelicInstrumentationProvider extends BaseInstrumentationProvider
         }
     }
 }
-//# sourceMappingURL=NewRelicInstrumentationProvider.js.map

package/dist/instrumentation/providers/index.js

@@ -10,4 +10,3 @@ export { CompositeInstrumentationProvider } from "./CompositeInstrumentationProv
 export { ConsoleInstrumentationProvider } from "./ConsoleInstrumentationProvider.js";
 export { DebugPanelInstrumentationProvider } from "./DebugPanelInstrumentationProvider.js";
 export { NewRelicInstrumentationProvider } from "./NewRelicInstrumentationProvider.js";
-//# sourceMappingURL=index.js.map

package/dist/instrumentation/types.js

@@ -6,4 +6,3 @@
  * to enable clients to use any instrumentation provider.
  */
 export {};
-//# sourceMappingURL=types.js.map

package/dist/loader-config.js

@@ -14,4 +14,3 @@ export const DEFAULT_LOADER_CONFIG = {
     resourceRetryDelay: 500,
     iifeBundleRetry: DEFAULT_IIFE_BUNDLE_RETRY_CONFIG,
 };
-//# sourceMappingURL=loader-config.js.map

package/dist/loaders/ElementLoader.js

@@ -54,4 +54,3 @@ export function aggregateElements(items) {
     });
     return elementMap;
 }
-//# sourceMappingURL=ElementLoader.js.map

package/dist/loaders/element-loader-types.js

@@ -23,4 +23,3 @@ export class AdapterFailure extends Error {
         this.reasons = reasons;
     }
 }
-//# sourceMappingURL=element-loader-types.js.map

package/dist/loaders/element-loader.js

@@ -416,4 +416,3 @@ export const __testing = {
         resolvedBackendOverrides.clear();
     },
 };
-//# sourceMappingURL=element-loader.js.map

package/dist/loaders/element-package-policy.js

@@ -65,4 +65,3 @@ export function assertElementPackagesAllowed(elements, policy) {
         }
     }
 }
-//# sourceMappingURL=element-package-policy.js.map

package/dist/loaders/esm-adapter.js

@@ -541,4 +541,3 @@ function assertImportMapSupported() {
         throw new Error('This browser does not support import maps. Use moduleResolution="url" or switch to iife/preloaded strategy.');
     }
 }
-//# sourceMappingURL=esm-adapter.js.map

package/dist/loaders/iife-adapter.js

@@ -395,4 +395,3 @@ function createEmptyConfigure() {
         }
     };
 }
-//# sourceMappingURL=iife-adapter.js.map

package/dist/loaders/index.js

@@ -35,4 +35,3 @@ export { assertElementPackagesAllowed, ElementPackagePolicyError, } from "./elem
 export { AdapterFailure, ElementAssertionError, ElementLoaderError, assertRegistered, ensureRegistered, } from "./element-loader.js";
 export { BUILT_IN_VIEWS, createEsmBackend, mapEsmViewElements, } from "./esm-adapter.js";
 export { createIifeBackend, DEFAULT_BUNDLE_HOST } from "./iife-adapter.js";
-//# sourceMappingURL=index.js.map

package/dist/object/index.js

@@ -37,4 +37,3 @@ export const cloneDeep = (value) => {
     }
     return copy;
 };
-//# sourceMappingURL=index.js.map

package/dist/pie/asset-handler.js

@@ -413,4 +413,3 @@ export function createDefaultSoundDeleteHandler() {
         done(); // Success
     };
 }
-//# sourceMappingURL=asset-handler.js.map

package/dist/pie/authoring-tag.js

@@ -10,4 +10,3 @@ export function transformMarkupForAuthoring(markup, elements) {
         return result.replace(exactTag, (_match, opening) => `${opening}${elementTag}-config`);
     }, markup);
 }
-//# sourceMappingURL=authoring-tag.js.map

package/dist/pie/authoring.js

@@ -198,4 +198,3 @@ export function createAuthoringAssetEventManager(rootElement, handlers, onHandle
         }
         : undefined);
 }
-//# sourceMappingURL=authoring.js.map

package/dist/pie/component-context.js

@@ -27,4 +27,3 @@ export function getCurrentComponentContext() {
         ? activeComponents[activeComponents.length - 1]
         : null;
 }
-//# sourceMappingURL=component-context.js.map

package/dist/pie/config.js

@@ -258,4 +258,3 @@ export const makeUniqueTags = (container) => {
         },
     };
 };
-//# sourceMappingURL=config.js.map

package/dist/pie/configure-initialization.js

@@ -28,4 +28,3 @@ export function initializeConfiguresFromLoadedBundle(config, configuration, opti
     logger.debug("[initializeConfiguresFromLoadedBundle] Initialization complete");
     return initializedModels;
 }
-//# sourceMappingURL=configure-initialization.js.map

package/dist/pie/correct-response-env.js

@@ -3,4 +3,3 @@ export const getCorrectResponseEnv = (env) => ({
     ...env,
     role: "instructor",
 });
-//# sourceMappingURL=correct-response-env.js.map

package/dist/pie/custom-element-define.js

@@ -28,4 +28,3 @@ export const defineCustomElementSafely = (tagName, elementConstructor, context =
         throw error;
     }
 };
-//# sourceMappingURL=custom-element-define.js.map

package/dist/pie/index.js

@@ -44,4 +44,3 @@ export { updatePieElement, updatePieElements, updatePieElementWithRef, } from ".
 export { addOrUpdateOverrideInUrl, applyElementOverrides, applyElementVersionOverridesPreserveTags, extractPackageInfo, formatElementOverrideParam, parseElementOverridesFromCurrentUrl, parseElementOverridesFromUrl, } from "./overrides.js";
 // Utils
 export { findOrAddSession, getPackageWithoutVersion, getPieElementBundlesUrl, parsePackageName, } from "./utils.js";
-//# sourceMappingURL=index.js.map

package/dist/pie/initialization.js

@@ -423,4 +423,3 @@ const withBlobBundleUrl = async (bundleJs, options, run) => {
         URL.revokeObjectURL(bundleUrl);
     }
 };
-//# sourceMappingURL=initialization.js.map

package/dist/pie/instrumentation-event-bridge.js

@@ -106,4 +106,3 @@ export function attachInstrumentationEventBridge(args) {
         }
     };
 }
-//# sourceMappingURL=instrumentation-event-bridge.js.map

package/dist/pie/instrumentation-event-map.js

@@ -101,4 +101,3 @@ export const ASSESSMENT_INSTRUMENTATION_EVENT_MAP = [
         instrumentationEventName: "pie-assessment-error",
     },
 ];
-//# sourceMappingURL=instrumentation-event-map.js.map

package/dist/pie/instrumentation-provider-resolution.js

@@ -63,4 +63,3 @@ export function resolveInstrumentationProvider(args) {
     }
     return undefined;
 }
-//# sourceMappingURL=instrumentation-provider-resolution.js.map

package/dist/pie/item-controller-storage.js

@@ -41,4 +41,3 @@ export class SessionStorageItemSessionStorage {
         catch { }
     }
 }
-//# sourceMappingURL=item-controller-storage.js.map

package/dist/pie/item-controller.js

@@ -89,4 +89,3 @@ export class ItemController {
     }
 }
 export const normalizeItemSessionContainer = normalizeSessionContainer;
-//# sourceMappingURL=item-controller.js.map

package/dist/pie/item-session-contract.js

@@ -254,4 +254,3 @@ export function normalizeItemSessionChange(args) {
         complete: getMetadataComplete(sessionDetail, candidate),
     };
 }
-//# sourceMappingURL=item-session-contract.js.map

package/dist/pie/logger.js

@@ -42,4 +42,3 @@ export function createPieLogger(namespace, debugEnabledFn) {
 export function isGlobalDebugEnabled() {
     return typeof window !== "undefined" && window.PIE_DEBUG === true;
 }
-//# sourceMappingURL=logger.js.map

package/dist/pie/math-rendering.js

@@ -123,4 +123,3 @@ export function renderMath(element) {
         renderer.renderMath(element);
     }
 }
-//# sourceMappingURL=math-rendering.js.map

package/dist/pie/overrides.js

@@ -199,4 +199,3 @@ export function extractPackageInfo(packageStr) {
         };
     }
 }
-//# sourceMappingURL=overrides.js.map

package/dist/pie/player-initializer.js

@@ -120,4 +120,3 @@ export async function fetchItemData(apiBaseUrl, itemId, token, endpoint, env, ad
     }
     return await response.json();
 }
-//# sourceMappingURL=player-initializer.js.map

package/dist/pie/registry.js

@@ -18,4 +18,3 @@ export const pieRegistry = () => {
     }
     return registry;
 };
-//# sourceMappingURL=registry.js.map

package/dist/pie/resource-monitor.js

@@ -1349,4 +1349,3 @@ export function getTrackedResourceRequests() {
 export function clearTrackedResourceRequests() {
     failedRequests.clear();
 }
-//# sourceMappingURL=resource-monitor.js.map

package/dist/pie/scoring.js

@@ -108,4 +108,3 @@ export async function scorePieItem(config, sessionData, options = {}) {
             : r.filter(Boolean),
     };
 }
-//# sourceMappingURL=scoring.js.map

package/dist/pie/stage-tracker.js

@@ -103,4 +103,3 @@ export function createStageTracker(opts) {
     }
     return { enter, reset, getCurrent };
 }
-//# sourceMappingURL=stage-tracker.js.map

package/dist/pie/stages.js

@@ -55,4 +55,3 @@ export function stageOrdinal(stage) {
     }
     return idx;
 }
-//# sourceMappingURL=stages.js.map

package/dist/pie/tag-names.js

@@ -59,4 +59,3 @@ export const toPrintHashedTag = (baseTag, hashSource, hashFn) => {
     const hash = Math.abs(hashFn(hashSource));
     return `${baseTag}-print-${hash}`;
 };
-//# sourceMappingURL=tag-names.js.map

package/dist/pie/types.js

@@ -49,4 +49,3 @@ export function isCustomElementConstructor(obj) {
 export function isPieRegistryAvailable(obj) {
     return obj && typeof obj.PIE_REGISTRY === "object";
 }
-//# sourceMappingURL=types.js.map

package/dist/pie/updates.js

@@ -225,4 +225,3 @@ export const updatePieElements = (config, session, env, container, onElementSess
         onElementSessionUpdate,
     }))).then(() => undefined);
 };
-//# sourceMappingURL=updates.js.map

package/dist/pie/utils.js

@@ -71,4 +71,3 @@ export const findOrAddSession = (data, id, element) => {
     data.push(ss);
     return ss;
 };
-//# sourceMappingURL=utils.js.map

package/dist/pie/versioned-tag.js

@@ -40,4 +40,3 @@ export function toPackageVersionedTag(tagName, packageSpec, options = {}) {
     // package versions at runtime, which requires updating the cloned runtime tag.
     return `${baseName}${VERSION_DELIMITER}${targetEncodedVersion}`;
 }
-//# sourceMappingURL=versioned-tag.js.map

package/dist/player-strategy.js

@@ -10,4 +10,3 @@ export function resolveItemPlayerView(mode, defaultView = "delivery") {
     }
     return defaultView;
 }
-//# sourceMappingURL=player-strategy.js.map

package/dist/security/index.js

@@ -4,4 +4,3 @@ export { resetSvgSanitizerForTesting, sanitizeSvgIcon, } from "./sanitize-svg-ic
 export { wrapOverwideImages, wrapOverwideImagesInElement, } from "./wrap-overwide-images.js";
 export { wrapModelRichContent } from "./wrap-model-rich-content.js";
 export { wrapOverwideTables, wrapOverwideTablesInElement, } from "./wrap-overwide-tables.js";
-//# sourceMappingURL=index.js.map

package/dist/security/sanitize-item-markup.d.ts

@@ -15,6 +15,17 @@ export interface SanitizeItemMarkupOptions {
      * tags that rewrite to `pie-*-config` or host-registered extensions.
      */
     allowedCustomElements?: string[];
+    /**
+     * Whether to apply the overwide image / table scroll wrappers after
+     * sanitizing. Defaults to `true` for screen rendering.
+     *
+     * Print rendering must pass `false`: the wrappers are `overflow-x: auto`
+     * reflow affordances (WCAG 1.4.10 at 400% zoom), and `@pie-players/pie-theme`
+     * carries no `@media print` override for them. In print media `overflow`
+     * clips instead of scrolling, so a wide image or table would be silently
+     * cut off at the column edge with no way to reach the rest.
+     */
+    wrapOverwideContent?: boolean;
 }
 /**
  * Sanitize raw item/passage markup before it is injected into the DOM.

package/dist/security/sanitize-item-markup.js

@@ -138,6 +138,9 @@ export function sanitizeItemMarkup(markup, options = {}) {
         RETURN_TRUSTED_TYPE: false,
     });
     const sanitized = typeof result === "string" ? result : String(result ?? "");
+    // Print rendering opts out: `overflow` clips rather than scrolls on paper.
+    if (options.wrapOverwideContent === false)
+        return sanitized;
     // PIE-94: wrap overwide authored images in a horizontal-scroll container
     // so they don't get clipped by ancestor `overflow-x: hidden` regions in
     // the section player (and match WCAG 1.4.10 Reflow at 400% zoom).
@@ -151,8 +154,8 @@ export function sanitizeItemMarkup(markup, options = {}) {
  * can safely use reference equality when deciding whether to re-sanitize.
  */
 export function createDefaultItemMarkupSanitizer(options = {}) {
-    const { allowedCustomElements } = options;
-    return (markup) => sanitizeItemMarkup(markup, { allowedCustomElements });
+    const { allowedCustomElements, wrapOverwideContent } = options;
+    return (markup) => sanitizeItemMarkup(markup, { allowedCustomElements, wrapOverwideContent });
 }
 /**
  * Derive the authoring-mode allow-list (`pie-*-config`) from a set of PIE
@@ -174,4 +177,3 @@ export function buildAuthoringAllowList(elementTagNames) {
 export function resetPurifierForTesting() {
     purifierInstance = null;
 }
-//# sourceMappingURL=sanitize-item-markup.js.map

package/dist/security/sanitize-svg-icon.js

@@ -86,4 +86,3 @@ export function resetSvgSanitizerForTesting() {
     svgPurifierInstance = null;
     stringCache.clear();
 }
-//# sourceMappingURL=sanitize-svg-icon.js.map

package/dist/security/validate-style-url.js

@@ -55,4 +55,3 @@ export function parseAllowedStyleOrigins(raw) {
         .map((entry) => entry.trim())
         .filter((entry) => entry.length > 0);
 }
-//# sourceMappingURL=validate-style-url.js.map

package/dist/security/wrap-model-rich-content.js

@@ -38,4 +38,3 @@ function wrapValue(value, parentKey) {
 export function wrapModelRichContent(model) {
     return wrapValue(model);
 }
-//# sourceMappingURL=wrap-model-rich-content.js.map

package/dist/security/wrap-overwide-images.js

@@ -113,4 +113,3 @@ export function wrapOverwideImages(markup) {
     });
     return wrapped > 0 ? body.innerHTML : markup;
 }
-//# sourceMappingURL=wrap-overwide-images.js.map

package/dist/security/wrap-overwide-tables.js

@@ -124,4 +124,3 @@ export function wrapOverwideTables(markup) {
     });
     return wrapped > 0 ? body.innerHTML : markup;
 }
-//# sourceMappingURL=wrap-overwide-tables.js.map

package/dist/server/npm-registry.js

@@ -57,4 +57,3 @@ export const getNpmPackageVersions = async (element, fetch, filter = DEFAULT_FIL
         return searchTerm ? [] : ["latest"];
     }
 };
-//# sourceMappingURL=npm-registry.js.map

package/dist/types/index.js

@@ -117,4 +117,3 @@ export var StandardType;
     StandardType[StandardType["LEVEL"] = 2] = "LEVEL";
     StandardType[StandardType["STANDARD"] = 3] = "STANDARD";
 })(StandardType || (StandardType = {}));
-//# sourceMappingURL=index.js.map

package/dist/ui/content-styles.js

@@ -202,4 +202,3 @@ export function resetContentStylesWarningForTesting() {
         clearTimeout(handle);
     pendingChecks.length = 0;
 }
-//# sourceMappingURL=content-styles.js.map

package/dist/ui/debug-panel-persistence.js

@@ -35,4 +35,3 @@ export function clearDebugPanelState(key) {
         // ignore
     }
 }
-//# sourceMappingURL=debug-panel-persistence.js.map

package/dist/ui/first-focusable.js

@@ -24,4 +24,3 @@ export function isProgrammaticFocusTarget(el) {
         return false;
     return el.offsetParent !== null || el.getClientRects().length > 0;
 }
-//# sourceMappingURL=first-focusable.js.map

package/dist/ui/focus-trap.js

@@ -81,4 +81,3 @@ export function createFocusTrap(container, options = {}) {
         }
     };
 }
-//# sourceMappingURL=focus-trap.js.map

package/dist/ui/safe-storage.js

@@ -18,4 +18,3 @@ export function safeLocalStorageSet(key, value) {
         // ignore
     }
 }
-//# sourceMappingURL=safe-storage.js.map

package/dist/ui/scope-css.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Scope an external stylesheet's rules to a single player instance, so a
+ * partner-authored stylesheet loaded via `<pie-item-player
+ * external-style-urls="...">` or `itemConfig.resources.stylesheets[*].url`
+ * styles that player's subtree instead of the whole host document.
+ *
+ * This replaces a single-regex implementation that prefixed every
+ * selector-like fragment. That is correct for flat selector rules and wrong for
+ * everything else: `@media screen { ... }` became
+ * `.scope @media screen { ... }`, an invalid selector, so the browser dropped
+ * the whole block and every rule inside it; `@font-face` and `@keyframes` were
+ * corrupted the same way; and `:root` became `.scope :root`, which can never
+ * match, because `:root` is `<html>` and is not a descendant of the player.
+ * At-rules and `:root` custom properties therefore never applied at all.
+ *
+ * The QTI player's `scopeCssRules` (`pie-qti` -
+ * `packages/item-player/src/components/utils/stylesheetRender.ts`) is not a
+ * drop-in either. Its `:root` handling is the behaviour we want and is adopted
+ * here, but it excludes `@` from its selector pattern rather than understanding
+ * at-rules, so `@media` and `@supports` lose their condition and their inner
+ * rules are hoisted and applied unconditionally — a mobile-only rule then
+ * applies at every viewport width, which is a subtler failure than dropping it.
+ *
+ * So this walks the stylesheet brace-by-brace instead of pattern-matching it.
+ * A real CSS parser would be the textbook answer and is deliberately not used:
+ * `@pie-players/pie-item-player` ships with two workspace dependencies, this
+ * runs in the delivery path, and scoping needs to know about rule boundaries
+ * only — not about property grammar.
+ *
+ * Known limits, all preserving existing behaviour rather than adding policy:
+ *
+ * - `@import` is passed through untouched, exactly as the old regex left it. It
+ *   pulls in an unscoped stylesheet, so it defeats scoping, but blocking it is
+ *   a security policy decision and not this function's job. Callers gate
+ *   stylesheet URLs with `validateExternalStyleUrl` before fetching.
+ * - Declaration blocks are emitted verbatim, so `url(...)` references are left
+ *   as authored and resolve against the stylesheet's own URL as before.
+ * - A style rule's block is never rewritten, which is also what native CSS
+ *   nesting needs: nested selectors are relative to a parent that has already
+ *   been scoped.
+ */
+/**
+ * Rewrite `cssText` so every selector it contains is confined to
+ * `scopeSelector`.
+ *
+ * Returns `cssText` unchanged when there is no scope selector to apply, and
+ * `""` for empty or non-string input.
+ */
+export declare function scopeStylesheetCss(cssText: unknown, scopeSelector: string): string;
+/**
+ * Confine a single selector to `scopeSelector`.
+ *
+ * Exported for tests and for callers that scope a selector they built
+ * themselves; `scopeStylesheetCss` is the entry point for stylesheet text.
+ */
+export declare function scopeSelector(selector: string, scopeSelector: string): string;