@pie-players/pie-players-shared 0.3.29 → 0.3.31

package/{src → dist}/components/PieItemPlayer.svelte

@@ -8,8 +8,14 @@
 -->
 <script lang="ts">
   import { onDestroy, tick, untrack } from "svelte";
+  import { isInstrumentationProvider } from "../instrumentation/provider-guards.js";
   import type { LoaderConfig } from "../loader-config.js";
   import { DEFAULT_LOADER_CONFIG } from "../loader-config.js";
+  import {
+    buildAuthoringAllowList,
+    createDefaultItemMarkupSanitizer,
+    type ItemMarkupSanitizer,
+  } from "../security/index.js";
   import {
     AssetEventManager,
     createDefaultImageDeleteHandler,
@@ -24,6 +30,7 @@
   } from "../pie/correct-response-env.js";
   import { initializePiesFromLoadedBundle } from "../pie/initialization.js";
   import { createPieLogger, isGlobalDebugEnabled } from "../pie/logger.js";
+  import { resolveInstrumentationProvider } from "../pie/instrumentation-provider-resolution.js";
   import { findPieController } from "../pie/scoring.js";
   import type { AuthoringEnv } from "../pie/types.js";
   import { BundleType } from "../pie/types.js";
@@ -37,16 +44,6 @@
     SoundHandler,
   } from "../types/index.js";
 
-  type RetrySuccessDetail = {
-    url?: string;
-    resourceType?: string;
-    duration?: number;
-    size?: number;
-    retryCount?: number;
-    maxRetries?: number;
-    error?: string;
-  };
-
   // Create logger (respects global debug flag - pass function for dynamic checking)
   const logger = createPieLogger("pie-item-player", () =>
     isGlobalDebugEnabled()
@@ -68,6 +65,9 @@
     mode = "view" as "view" | "author",
     configuration = {} as Record<string, any>,
     authoringBackend = "demo" as "demo" | "required",
+    // Security: sanitize markup before {@html} injection unless the host opts out.
+    trustMarkup = false,
+    sanitizeMarkup,
     // Asset handler callbacks
     onInsertImage,
     onDeleteImage,
@@ -93,6 +93,9 @@
     mode?: "view" | "author";
     configuration?: Record<string, any>;
     authoringBackend?: "demo" | "required";
+    // Markup-trust controls
+    trustMarkup?: boolean;
+    sanitizeMarkup?: ItemMarkupSanitizer;
     // Asset handlers
     onInsertImage?: (handler: ImageHandler) => void;
     onDeleteImage?: (src: string, done: (err?: Error) => void) => void;
@@ -112,6 +115,7 @@
   let assetEventManager: AssetEventManager | null = $state(null);
   let authoringBlockedError: string | null = $state(null);
   let lastReportedAuthoringError: string | null = $state(null);
+  let runtimePlayerError: string | null = $state(null);
 
   // Transform markup for authoring mode (append -config suffix)
   function transformMarkupForAuthoring(
@@ -130,29 +134,103 @@
     return result;
   }
 
+  // Custom-element allow-list derived from the item/passage `elements` maps.
+  // Includes both the raw tag names and their authoring-mode `-config`
+  // rewrites so `transformMarkupForAuthoring` output still passes the
+  // sanitizer.
+  const itemAllowList = $derived.by<string[]>(() => {
+    const elements = itemConfig?.elements ?? {};
+    return buildAuthoringAllowList(Object.keys(elements));
+  });
+
+  const passageAllowList = $derived.by<string[]>(() => {
+    const elements = passageConfig?.elements ?? {};
+    return buildAuthoringAllowList(Object.keys(elements));
+  });
+
+  function applySanitizer(markup: string, allowList: string[]): string {
+    if (!markup) return "";
+    if (trustMarkup) return markup;
+    if (sanitizeMarkup) return sanitizeMarkup(markup);
+    const sanitizer = createDefaultItemMarkupSanitizer({
+      allowedCustomElements: allowList,
+    });
+    return sanitizer(markup);
+  }
+
   // Get appropriate markup based on mode
   const itemMarkup = $derived.by(() => {
     if (!itemConfig?.markup) return "";
-    if (mode === "author" && itemConfig.elements) {
-      return transformMarkupForAuthoring(
-        itemConfig.markup,
-        itemConfig.elements
-      );
-    }
-    return itemConfig.markup;
+    const raw =
+      mode === "author" && itemConfig.elements
+        ? transformMarkupForAuthoring(itemConfig.markup, itemConfig.elements)
+        : itemConfig.markup;
+    return applySanitizer(raw, itemAllowList);
   });
 
   const passageMarkup = $derived.by(() => {
     if (!passageConfig?.markup) return "";
-    if (mode === "author" && passageConfig.elements) {
-      return transformMarkupForAuthoring(
-        passageConfig.markup,
-        passageConfig.elements
-      );
-    }
-    return passageConfig.markup;
+    const raw =
+      mode === "author" && passageConfig.elements
+        ? transformMarkupForAuthoring(
+            passageConfig.markup,
+            passageConfig.elements
+          )
+        : passageConfig.markup;
+    return applySanitizer(raw, passageAllowList);
   });
 
+  function normalizePlayerErrorDetail(
+    detail: unknown,
+    fallbackCode = "ITEM_PLAYER_RUNTIME_ERROR"
+  ) {
+    if (detail && typeof detail === "object") {
+      const detailObject = detail as Record<string, unknown>;
+      const message =
+        typeof detailObject.message === "string" && detailObject.message.trim().length > 0
+          ? detailObject.message
+          : "Unknown PIE runtime error";
+      const code =
+        typeof detailObject.code === "string" && detailObject.code.trim().length > 0
+          ? detailObject.code
+          : fallbackCode;
+      return { ...detailObject, message, code };
+    }
+    const message =
+      typeof detail === "string" && detail.trim().length > 0
+        ? detail
+        : "Unknown PIE runtime error";
+    return { code: fallbackCode, message };
+  }
+
+  function trackPlayerError(detail: Record<string, unknown>) {
+    const resolvedProvider = resolveInstrumentationProvider({
+      player: { loaderConfig },
+      component: "pie-item-player",
+      debug: isGlobalDebugEnabled(),
+    });
+    if (!isInstrumentationProvider(resolvedProvider) || !resolvedProvider.isReady()) return;
+    const message =
+      typeof detail.message === "string" ? detail.message : "Unknown PIE runtime error";
+    const code =
+      typeof detail.code === "string" && detail.code.length > 0
+        ? detail.code
+        : "ITEM_PLAYER_RUNTIME_ERROR";
+    resolvedProvider.trackError(new Error(message), {
+      component: "pie-item-player",
+      errorType: code,
+      ...detail,
+    });
+  }
+
+  function reportPlayerError(detail: unknown, fallbackCode = "ITEM_PLAYER_RUNTIME_ERROR") {
+    const normalizedDetail = normalizePlayerErrorDetail(detail, fallbackCode);
+    runtimePlayerError = normalizedDetail.message as string;
+    logger.error("[PieItemPlayer] Runtime error:", normalizedDetail);
+    trackPlayerError(normalizedDetail);
+    dispatch("player-error", normalizedDetail);
+  }
+
   // Dispatch events (will add more as needed)
   const dispatch = (type: string, detail?: any) => {
     // Call callback prop if provided (Svelte 5 pattern)
@@ -185,8 +263,7 @@
   function reportAuthoringErrorOnce(message: string) {
     if (lastReportedAuthoringError === message) return;
     lastReportedAuthoringError = message;
-    logger.error(`[PieItemPlayer] ${message}`);
-    dispatch("player-error", {
+    reportPlayerError({
       code: "AUTHORING_BACKEND_CONFIG_ERROR",
       message,
     });
@@ -381,46 +458,6 @@
   // Root element reference for resource monitor
   let rootElement: HTMLElement | null = $state(null);
 
-  function normalizeResourceUrl(url: string): string {
-    try {
-      const parsed = new URL(url, window.location.href);
-      parsed.searchParams.delete("retry");
-      parsed.searchParams.delete("t");
-      return parsed.toString();
-    } catch {
-      return url;
-    }
-  }
-
-  function dispatchMediaRetryReady(detail: RetrySuccessDetail) {
-    if (!rootElement) return;
-    if (!detail || (detail.resourceType !== "audio" && detail.resourceType !== "video")) {
-      return;
-    }
-    const url = typeof detail.url === "string" ? detail.url : "";
-    if (!url) return;
-    const normalizedTargetUrl = normalizeResourceUrl(url);
-    const selector = detail.resourceType === "audio" ? "audio[src]" : "video[src]";
-    const mediaElements = Array.from(
-      rootElement.querySelectorAll<HTMLAudioElement | HTMLVideoElement>(selector)
-    );
-    for (const mediaEl of mediaElements) {
-      const currentSrc = mediaEl.currentSrc || mediaEl.src;
-      if (!currentSrc) continue;
-      if (normalizeResourceUrl(currentSrc) !== normalizedTargetUrl) continue;
-      mediaEl.dispatchEvent(
-        new CustomEvent("pie-media-retry-ready", {
-          detail: {
-            ...detail,
-            mediaTag: detail.resourceType,
-          },
-          bubbles: true,
-          composed: true,
-        })
-      );
-    }
-  }
-
   // Resource monitor (handles initialization and cleanup automatically)
   useResourceMonitor(
     () => rootElement,
@@ -429,26 +466,6 @@
     "pie-item-player"
   );
 
-  // Bridge resource-monitor retry success events to media-level recovery hooks so
-  // item elements can clear local disabled/error UI without coupling to player internals.
-  $effect(() => {
-    if (!rootElement) return;
-    const handleRetrySuccess = (event: Event) => {
-      const customEvent = event as CustomEvent<RetrySuccessDetail>;
-      dispatchMediaRetryReady(customEvent.detail ?? {});
-    };
-    rootElement.addEventListener(
-      "pie-resource-retry-success",
-      handleRetrySuccess as EventListener
-    );
-    return () => {
-      rootElement?.removeEventListener(
-        "pie-resource-retry-success",
-        handleRetrySuccess as EventListener
-      );
-    };
-  });
-
   // Initialize PIE elements AFTER markup is rendered (reactive pattern like PieItemPreview)
   $effect(() => {
     if (!itemConfig || initialized) return;
@@ -460,6 +477,7 @@
     // Wait for DOM to update (markup to render)
     tick().then(async () => {
       try {
+        runtimePlayerError = null;
         logger.debug("[PieItemPlayer] DOM ready, initializing PIE elements");
         logger.debug("[PieItemPlayer] Config:", {
           itemElements: Object.keys(itemConfig.elements || {}),
@@ -737,8 +755,14 @@
         );
         dispatch("load-complete");
       } catch (e: any) {
-        logger.error("[PieItemPlayer] Error initializing:", e);
-        dispatch("player-error", e.message);
+        reportPlayerError(
+          {
+            code: "ITEM_PLAYER_INITIALIZATION_ERROR",
+            message: e instanceof Error ? e.message : String(e),
+            cause: e instanceof Error ? e.stack || e.message : String(e),
+          },
+          "ITEM_PLAYER_INITIALIZATION_ERROR"
+        );
       }
     });
   });
@@ -797,16 +821,60 @@
         if (passageConfig) {
           updatePieElements(passageConfig, session, env, rootElement ?? undefined);
         }
+      } catch (e: any) {
+        reportPlayerError(
+          {
+            code: "ITEM_PLAYER_UPDATE_ERROR",
+            message: e instanceof Error ? e.message : String(e),
+            cause: e instanceof Error ? e.stack || e.message : String(e),
+          },
+          "ITEM_PLAYER_UPDATE_ERROR"
+        );
       } finally {
         isUpdating = false;
       }
     });
   });
 
+  $effect(() => {
+    if (!rootElement) return;
+    const handleControllerError = (event: Event) => {
+      const customEvent = event as CustomEvent;
+      reportPlayerError(customEvent.detail, "PIE_CONTROLLER_RUNTIME_ERROR");
+    };
+    rootElement.addEventListener(
+      "pie-controller-error",
+      handleControllerError as EventListener
+    );
+    return () => {
+      rootElement?.removeEventListener(
+        "pie-controller-error",
+        handleControllerError as EventListener
+      );
+    };
+  });
+
   // Note: Resource monitor cleanup is handled automatically by useResourceMonitor's onDestroy
 </script>
 
 <div class="pie-item-player" bind:this={rootElement}>
+  {#if runtimePlayerError}
+    <div
+      class="pie-player-error"
+      style="
+        padding: 20px;
+        margin: 20px 0;
+        border: 2px solid #d32f2f;
+        border-radius: 4px;
+        background-color: #ffebee;
+        color: #c62828;
+        font-family: sans-serif;
+      "
+    >
+      <h3 style="margin: 0 0 10px 0">Player Error</h3>
+      <p style="margin: 0">{runtimePlayerError}</p>
+    </div>
+  {/if}
   {#if authoringBlockedError}
     <div
       class="pie-player-error"

package/dist/i18n/translations/en/tools.json

@@ -43,7 +43,7 @@
     },
     "calculator": {
         "title": "Calculator",
-        "aria_label": "Calculator tool - Use Alt+Arrow keys to move, Escape to close",
+        "aria_label": "Calculator tool - Tab to reach title bar controls. On the title bar, Arrow keys move the window, Shift+Arrow resizes it, Home re-centers, and Escape closes.",
         "settings": "Calculator settings",
         "close": "Close calculator",
         "settings_title": "Calculator Settings",

package/{src → dist}/i18n/use-i18n-standalone.svelte.ts

@@ -25,6 +25,7 @@
  * ```
  */
 
+/// <reference types="svelte" />
 import { BUNDLED_TRANSLATIONS, loadTranslations } from "./loader.js";
 import { SimpleI18n } from "./simple-i18n.js";
 

package/{src → dist}/i18n/use-i18n.svelte.ts

@@ -20,6 +20,7 @@
  * ```
  */
 
+/// <reference types="svelte" />
 import type { I18nServiceApi } from "./types.js";
 
 /**

package/dist/index.d.ts

@@ -2,12 +2,14 @@ export * from "./config/profile.js";
 export * from "./instrumentation/index.js";
 export * from "./loader-config.js";
 export * from "./player-strategy.js";
+export * from "./security/index.js";
 export * from "./loaders/index.js";
 export * from "./object/index.js";
 export * from "./pie/index.js";
 export type { AssessmentEntity, AssessmentItemRef, AssessmentSection, ConfigEntity, Env, ItemConfig, ItemEntity, LegacyAssessmentSection, OutcomeResponse, PassageEntity, PieController, PieModel, QuestionEntity, RubricBlock, SectionQuestionRef, TestPart, } from "./types/index.js";
 export { editorPostFix } from "./types/index.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.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAElC,cAAc,gBAAgB,CAAC;AAC/B,YAAY,EACX,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EACjB,YAAY,EACZ,GAAG,EACH,UAAU,EACV,UAAU,EACV,uBAAuB,EACvB,eAAe,EACf,aAAa,EACb,aAAa,EACb,QAAQ,EACR,cAAc,EACd,WAAW,EACX,kBAAkB,EAClB,QAAQ,GACR,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,cAAc,oBAAoB,CAAC;AACnC,cAAc,iCAAiC,CAAC;AAChD,cAAc,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAElC,cAAc,gBAAgB,CAAC;AAC/B,YAAY,EACX,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EACjB,YAAY,EACZ,GAAG,EACH,UAAU,EACV,UAAU,EACV,uBAAuB,EACvB,eAAe,EACf,aAAa,EACb,aAAa,EACb,QAAQ,EACR,cAAc,EACd,WAAW,EACX,kBAAkB,EAClB,QAAQ,GACR,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,cAAc,oBAAoB,CAAC;AACnC,cAAc,yBAAyB,CAAC;AACxC,cAAc,iCAAiC,CAAC;AAChD,cAAc,sBAAsB,CAAC"}

package/dist/index.js

@@ -2,12 +2,18 @@ export * from "./config/profile.js";
 export * from "./instrumentation/index.js";
 export * from "./loader-config.js";
 export * from "./player-strategy.js";
+export * from "./security/index.js";
 export * from "./loaders/index.js";
 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/focus-trap.js";
+export * from "./ui/first-focusable.js";
 export * from "./ui/debug-panel-persistence.js";
 export * from "./ui/safe-storage.js";
+// use-promise is a Svelte 5 runes module and is shipped as raw source via
+// the `./ui/use-promise` subpath export. It is not re-exported here because
+// tsc cannot compile `.svelte.ts` runes correctly; the consumer's Svelte
+// plugin processes it at consume time.
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,0CAA0C;AAC1C,cAAc,gBAAgB,CAAC;AAmB/B,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,cAAc,oBAAoB,CAAC;AACnC,cAAc,iCAAiC,CAAC;AAChD,cAAc,sBAAsB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,0CAA0C;AAC1C,cAAc,gBAAgB,CAAC;AAmB/B,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,cAAc,oBAAoB,CAAC;AACnC,cAAc,yBAAyB,CAAC;AACxC,cAAc,iCAAiC,CAAC;AAChD,cAAc,sBAAsB,CAAC;AACrC,0EAA0E;AAC1E,4EAA4E;AAC5E,yEAAyE;AACzE,uCAAuC"}

package/dist/loader-config.d.ts

@@ -4,6 +4,16 @@
  * Mirrors the `LoaderConfig` used by PIEOneer's custom element tags.
  */
 import type { InstrumentationProvider } from "./instrumentation/types.js";
+export type IifeBundleRetryConfig = {
+    /**
+     * Delay in ms between IIFE bundle retry attempts.
+     */
+    retryDelayMs?: number;
+    /**
+     * Total timeout in ms before IIFE bundle load retries fail permanently.
+     */
+    timeoutMs?: number;
+};
 export type LoaderConfig = {
     /**
      * Enable tracking page actions/events.
@@ -47,11 +57,26 @@ export type LoaderConfig = {
      * Initial delay in ms before first resource retry attempt (exponential backoff).
      */
     resourceRetryDelay?: number;
+    /**
+     * Retry policy for IIFE bundle loads.
+     *
+     * Kept separate from resource retry settings so bundle-build polling can be tuned
+     * independently from media/resource retries.
+     */
+    iifeBundleRetry?: IifeBundleRetryConfig;
+};
+export declare const DEFAULT_IIFE_BUNDLE_RETRY_CONFIG: {
+    readonly retryDelayMs: 3000;
+    readonly timeoutMs: 120000;
 };
 export declare const DEFAULT_LOADER_CONFIG: {
     readonly trackPageActions: false;
     readonly instrumentationProvider: undefined;
     readonly maxResourceRetries: 3;
     readonly resourceRetryDelay: 500;
+    readonly iifeBundleRetry: {
+        readonly retryDelayMs: 3000;
+        readonly timeoutMs: 120000;
+    };
 };
 //# sourceMappingURL=loader-config.d.ts.map

package/dist/loader-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"loader-config.d.ts","sourceRoot":"","sources":["../src/loader-config.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AAE1E,MAAM,MAAM,YAAY,GAAG;IAC1B;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAE3B;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,uBAAuB,CAAC,EAAE,uBAAuB,CAAC;IAElD;;OAEG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAE5B;;OAEG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF,eAAO,MAAM,qBAAqB;;;;;CAKxB,CAAC"}
+{"version":3,"file":"loader-config.d.ts","sourceRoot":"","sources":["../src/loader-config.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AAE1E,MAAM,MAAM,qBAAqB,GAAG;IACnC;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IAC1B;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAE3B;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,uBAAuB,CAAC,EAAE,uBAAuB,CAAC;IAElD;;OAEG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAE5B;;OAEG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAE5B;;;;;OAKG;IACH,eAAe,CAAC,EAAE,qBAAqB,CAAC;CACxC,CAAC;AAEF,eAAO,MAAM,gCAAgC;;;CAGnC,CAAC;AAEX,eAAO,MAAM,qBAAqB;;;;;;;;;CAMxB,CAAC"}

package/dist/loader-config.js

@@ -3,10 +3,15 @@
  *
  * Mirrors the `LoaderConfig` used by PIEOneer's custom element tags.
  */
+export const DEFAULT_IIFE_BUNDLE_RETRY_CONFIG = {
+    retryDelayMs: 3000,
+    timeoutMs: 120000,
+};
 export const DEFAULT_LOADER_CONFIG = {
     trackPageActions: false,
     instrumentationProvider: undefined,
     maxResourceRetries: 3,
     resourceRetryDelay: 500,
+    iifeBundleRetry: DEFAULT_IIFE_BUNDLE_RETRY_CONFIG,
 };
 //# sourceMappingURL=loader-config.js.map

package/dist/loader-config.js.map

@@ -1 +1 @@
-{"version":3,"file":"loader-config.js","sourceRoot":"","sources":["../src/loader-config.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAoDH,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACpC,gBAAgB,EAAE,KAAK;IACvB,uBAAuB,EAAE,SAAS;IAClC,kBAAkB,EAAE,CAAC;IACrB,kBAAkB,EAAE,GAAG;CACd,CAAC"}
+{"version":3,"file":"loader-config.js","sourceRoot":"","sources":["../src/loader-config.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAwEH,MAAM,CAAC,MAAM,gCAAgC,GAAG;IAC/C,YAAY,EAAE,IAAI;IAClB,SAAS,EAAE,MAAM;CACR,CAAC;AAEX,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACpC,gBAAgB,EAAE,KAAK;IACvB,uBAAuB,EAAE,SAAS;IAClC,kBAAkB,EAAE,CAAC;IACrB,kBAAkB,EAAE,GAAG;IACvB,eAAe,EAAE,gCAAgC;CACxC,CAAC"}

package/dist/loaders/ElementLoader.d.ts

@@ -1,11 +1,12 @@
 /**
- * Element Loader - Core types and utilities for loading PIE elements
+ * Element Loader — element aggregation utilities.
  *
- * This module provides element aggregation and loading abstractions for PIE players.
- * It enables loading multiple PIE elements in a single operation, eliminating duplicate
- * bundle requests when multiple items use the same elements.
+ * The deep `ElementLoader` primitive lives in `./element-loader.ts`. This
+ * module owns the shared `ElementMap` type and the `aggregateElements`
+ * helper that reduces many items' element declarations into a single
+ * deduplicated, version-aware map (used by the section-player to
+ * pre-warm in one shot).
  */
-import type { BundleType } from "../pie/types.js";
 import type { ItemEntity } from "../types/index.js";
 /**
  * Map of element tag names to their package versions
@@ -14,35 +15,6 @@ import type { ItemEntity } from "../types/index.js";
 export type ElementMap = {
     [tagName: string]: string;
 };
-/**
- * Options for loading PIE elements
- */
-export interface LoadOptions {
-    /** Bundle type to load (player or clientPlayer) */
-    bundleType?: BundleType;
-    /** Whether to load controllers (for client-side processing) */
-    needsControllers?: boolean;
-    /** View mode (ESM only) - delivery, author, or print */
-    view?: "delivery" | "author" | "print";
-}
-/**
- * Common interface for element loaders (IIFE and ESM)
- */
-export interface ElementLoaderInterface {
-    /**
-     * Load elements directly from an element map
-     * @param elements - Map of element tag names to package versions
-     * @param options - Loading options
-     */
-    loadElements(elements: ElementMap, options?: LoadOptions): Promise<void>;
-    /**
-     * Extract and load elements from items
-     * Automatically aggregates unique elements from all items
-     * @param items - Array of items to extract elements from
-     * @param options - Loading options
-     */
-    loadFromItems(items: ItemEntity[], options?: LoadOptions): Promise<void>;
-}
 /**
  * Aggregate unique elements from multiple items
  *

package/dist/loaders/ElementLoader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ElementLoader.d.ts","sourceRoot":"","sources":["../../src/loaders/ElementLoader.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG;IAAE,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,CAAC;AAEvD;;GAEG;AACH,MAAM,WAAW,WAAW;IAC3B,mDAAmD;IACnD,UAAU,CAAC,EAAE,UAAU,CAAC;IAExB,+DAA+D;IAC/D,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAE3B,wDAAwD;IACxD,IAAI,CAAC,EAAE,UAAU,GAAG,QAAQ,GAAG,OAAO,CAAC;CACvC;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACtC;;;;OAIG;IACH,YAAY,CAAC,QAAQ,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzE;;;;;OAKG;IACH,aAAa,CAAC,KAAK,EAAE,UAAU,EAAE,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACzE;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,UAAU,CAmDjE"}
+{"version":3,"file":"ElementLoader.d.ts","sourceRoot":"","sources":["../../src/loaders/ElementLoader.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG;IAAE,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,CAAC;AAEvD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,UAAU,CAmEjE"}

package/dist/loaders/ElementLoader.js

@@ -1,9 +1,11 @@
 /**
- * Element Loader - Core types and utilities for loading PIE elements
+ * Element Loader — element aggregation utilities.
  *
- * This module provides element aggregation and loading abstractions for PIE players.
- * It enables loading multiple PIE elements in a single operation, eliminating duplicate
- * bundle requests when multiple items use the same elements.
+ * The deep `ElementLoader` primitive lives in `./element-loader.ts`. This
+ * module owns the shared `ElementMap` type and the `aggregateElements`
+ * helper that reduces many items' element declarations into a single
+ * deduplicated, version-aware map (used by the section-player to
+ * pre-warm in one shot).
  */
 import { parsePackageName } from "../pie/utils.js";
 /**
@@ -35,21 +37,31 @@ export function aggregateElements(items) {
     const elementMap = {};
     const seenOriginalTags = {};
     const VERSION_DELIMITER = "--version-";
+    const TAG_VERSION_PATTERN = "[0-9A-Za-z-]+";
+    const encodeVersionForTag = (version) => version
+        .trim()
+        .replace(/[.+]/g, "-")
+        .replace(/[^0-9A-Za-z-]/g, "-")
+        .replace(/-{2,}/g, "-");
     const parseTagName = (tagName) => {
-        const versionMatch = tagName.match(`${VERSION_DELIMITER}(\\d+-\\d+-\\d+)$`);
+        const versionMatch = tagName.match(new RegExp(`${VERSION_DELIMITER}(${TAG_VERSION_PATTERN})$`));
         return versionMatch
             ? {
                 baseName: tagName.replace(`${VERSION_DELIMITER}${versionMatch[1]}`, ""),
-                existingVersion: versionMatch[1].replace(/-/g, "."),
+                existingEncodedVersion: versionMatch[1],
             }
             : { baseName: tagName };
     };
     const normalizeElementTag = (tagName, packageSpec) => {
-        const { baseName, existingVersion } = parseTagName(tagName);
+        const { baseName, existingEncodedVersion } = parseTagName(tagName);
         const { version } = parsePackageName(packageSpec);
-        if (!version || existingVersion === version)
+        if (!version)
             return tagName;
-        return `${baseName}${VERSION_DELIMITER}${version.replace(/\./g, "-")}`;
+        const targetEncodedVersion = encodeVersionForTag(version);
+        if (!targetEncodedVersion || existingEncodedVersion === targetEncodedVersion) {
+            return tagName;
+        }
+        return `${baseName}${VERSION_DELIMITER}${targetEncodedVersion}`;
     };
     items.forEach((item) => {
         const itemElements = item.config?.elements || {};

package/dist/loaders/ElementLoader.js.map

@@ -1 +1 @@
-{"version":3,"file":"ElementLoader.js","sourceRoot":"","sources":["../../src/loaders/ElementLoader.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AA2CnD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAmB;IACpD,MAAM,UAAU,GAA2B,EAAE,CAAC;IAC9C,MAAM,gBAAgB,GAA2B,EAAE,CAAC;IAEpD,MAAM,iBAAiB,GAAG,YAAY,CAAC;IACvC,MAAM,YAAY,GAAG,CACpB,OAAe,EACkC,EAAE;QACnD,MAAM,YAAY,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,iBAAiB,mBAAmB,CAAC,CAAC;QAC5E,OAAO,YAAY;YAClB,CAAC,CAAC;gBACA,QAAQ,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,iBAAiB,GAAG,YAAY,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC;gBACvE,eAAe,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC;aACnD;YACF,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;IAC1B,CAAC,CAAC;IACF,MAAM,mBAAmB,GAAG,CAAC,OAAe,EAAE,WAAmB,EAAU,EAAE;QAC5E,MAAM,EAAE,QAAQ,EAAE,eAAe,EAAE,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;QAC5D,MAAM,EAAE,OAAO,EAAE,GAAG,gBAAgB,CAAC,WAAW,CAAC,CAAC;QAClD,IAAI,CAAC,OAAO,IAAI,eAAe,KAAK,OAAO;YAAE,OAAO,OAAO,CAAC;QAC5D,OAAO,GAAG,QAAQ,GAAG,iBAAiB,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE,CAAC;IACxE,CAAC,CAAC;IAEF,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;QACtB,MAAM,YAAY,GAAG,IAAI,CAAC,MAAM,EAAE,QAAQ,IAAI,EAAE,CAAC;QAEjD,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,EAAE;YACnD,MAAM,WAAW,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;YAChC,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC5B,gBAAgB,CAAC,GAAG,CAAC,GAAG,WAAW,CAAC;YACrC,CAAC;iBAAM,IAAI,gBAAgB,CAAC,GAAG,CAAC,KAAK,WAAW,EAAE,CAAC;gBAClD,kEAAkE;gBAClE,MAAM,IAAI,KAAK,CACd,6BAA6B,GAAG,kBAAkB,gBAAgB,CAAC,GAAG,CAAC,QAAQ,WAAW,IAAI;oBAC7F,mEAAmE,CACpE,CAAC;YACH,CAAC;YAED,MAAM,aAAa,GAAG,mBAAmB,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;YAC5D,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;gBAChC,UAAU,CAAC,aAAa,CAAC,GAAG,WAAW,CAAC;YACzC,CAAC;iBAAM,IAAI,UAAU,CAAC,aAAa,CAAC,KAAK,WAAW,EAAE,CAAC;gBACtD,MAAM,IAAI,KAAK,CACd,6BAA6B,aAAa,kBAAkB,UAAU,CAAC,aAAa,CAAC,QAAQ,WAAW,IAAI;oBAC3G,mEAAmE,CACpE,CAAC;YACH,CAAC;QACF,CAAC,CAAC,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,OAAO,UAAU,CAAC;AACnB,CAAC"}
+{"version":3,"file":"ElementLoader.js","sourceRoot":"","sources":["../../src/loaders/ElementLoader.ts"],"names":[],"mappings":"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"}