@pie-players/pie-players-shared 0.3.60 → 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

@@ -8,7 +8,9 @@ export * from "./object/index.js";
 export * from "./pie/index.js";
 export type { AssessmentEntity, AssessmentItemRef, AssessmentSection, AdvancedItemConfig, ConfigEntity, ConfigResource, Env, ItemConfig, ItemEntity, ItemSession, OutcomeResponse, PassageEntity, PieController, PieContent, PieDefaultModel, PieItemElement, PieModel, QuestionEntity, RubricBlock, TestPart, } from "./types/index.js";
 export { editorPostFix } from "./types/index.js";
+export * from "./ui/content-styles.js";
 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

@@ -8,8 +8,9 @@ export * from "./object/index.js";
 // Barrel export for PIE runtime utilities
 export * from "./pie/index.js";
 export { editorPostFix } from "./types/index.js";
+export * from "./ui/content-styles.js";
 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.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Installs the shared PIE content stylesheet
+ * (`@pie-players/pie-theme/components.css`) into the host document.
+ *
+ * Authored assessment content depends on classes that belong to no single
+ * component: passage markup (`.numbered-paragraph`, `.p-number`,
+ * `div.passage-title`), the legacy `kds-*` families, the `@media print`
+ * `.noprint` rules, and the answer-eliminator classes. Players render into
+ * light DOM, so those rules have to exist as a document-level stylesheet —
+ * there is no shadow root to scope them to.
+ *
+ * Hosts used to be required to import that stylesheet themselves. Nothing
+ * enforced it and nothing failed loudly when they didn't: the item rendered,
+ * the passage was simply unstyled, and it surfaced as a visual bug reported by
+ * hand days later. Players install the stylesheet themselves instead, which
+ * keeps the host contract at "import the player".
+ *
+ * The CSS text is passed in rather than imported here: this package builds with
+ * plain `tsc`, so it cannot inline a stylesheet. Bundler-built player packages
+ * import it with Vite's `?inline` and hand the text over.
+ */
+export type ContentStylesResult = "installed" | "already-installed" | "opted-out" | "no-document";
+/**
+ * True when the host declared `<html data-pie-content-styles="host">`, i.e. it
+ * takes ownership of loading the stylesheet.
+ */
+export declare function contentStylesOptedOut(): boolean;
+/**
+ * True when `components.css` is applied to the document, by any route. Reads the
+ * sentinel custom property the stylesheet declares on `:root`.
+ *
+ * Only meaningful once the document's stylesheets have been applied — a host
+ * that loads CSS via an async `<link>` reads as missing until it lands.
+ */
+export declare function contentStylesPresent(): boolean;
+/**
+ * Installs `cssText` as a document-level stylesheet, once per document.
+ *
+ * The stylesheet is **prepended** to `<head>` and deliberately left out of a
+ * cascade layer. Prepending reproduces the placement hosts were told to use by
+ * hand — first in the entry, before app CSS — so an app rule and a content rule
+ * of equal specificity resolve in the host's favour, exactly as before.
+ *
+ * A cascade layer looks tempting here and is the wrong tool: unlayered author
+ * declarations beat *all* layered ones regardless of specificity, so a host
+ * reset as broad as `p { margin: 0 }` would silently outrank
+ * `.numbered-paragraph { margin-left: 36px }`. That trades a visible missing
+ * stylesheet for a subtler override bug, so ordinary specificity wins instead.
+ *
+ * @param cssText Contents of `@pie-players/pie-theme/components.css`.
+ * @param source Package installing the styles, for diagnostics.
+ */
+export declare function installContentStyles(cssText: string, source: string): ContentStylesResult;
+/**
+ * Reports, once per page, the two ways content styling can go wrong. Neither is
+ * detectable synchronously — a host copy may still be in flight as an async
+ * `<link>` — so the check is deferred.
+ *
+ * - **Missing**: the host opted out and then loaded nothing, so authored content
+ *   renders unstyled. This is the failure the old host-import contract produced
+ *   silently.
+ * - **Duplicated**: the host still imports `components.css` itself *and* the
+ *   player installed a copy. Rendering is correct while the two agree, but the
+ *   host's copy loads later and therefore wins ties at equal specificity — so a
+ *   host copy pinned to an older `@pie-players/pie-theme` silently overrides the
+ *   player's newer rules. Harmless today, a confusing override tomorrow.
+ */
+export declare function auditContentStyles(source: string): void;
+/**
+ * Test-only: clears the once-per-page warning latch and cancels any pending
+ * deferred check, so a timer scheduled by one test cannot warn during the next.
+ */
+export declare function resetContentStylesWarningForTesting(): void;