@pie-players/pie-players-shared 0.3.74 → 1.0.0-beta.0

package/dist/i18n/messages/nl-NL.js

@@ -321,44 +321,20 @@ const nlNL = {
         textToSpeech: {
             name: "Voorlezen",
             description: "Inhoud laten voorlezen",
-            toolA11y: "Voorleeshulp",
-            title: "Voorlezen",
-            initializing: "Wordt gestart…",
-            initFailed: "Voorlezen kon niet worden gestart.",
-            selectText: "Selecteer tekst op de pagina om die te laten voorlezen.",
-            speed: "Snelheid:",
-            play: "Voorlezen",
-            pause: "Pauzeren",
-            resume: "Hervatten",
-            stop: "Stoppen",
-            speaking: "Aan het voorlezen…",
-            paused: "Gepauzeerd",
-            charactersSelected: {
-                one: "{count} teken geselecteerd",
-                other: "{count} tekens geselecteerd",
-            },
-            rate: {
-                slow: "Langzaam",
-                slower: "Langzamer",
-                normal: "Normaal",
-                faster: "Sneller",
-                fast: "Snel",
-                veryFast: "Zeer snel",
-            },
+            initFailed: "Voorlezen kon niet worden gestart. Probeer het opnieuw.",
             inline: {
                 controlsA11y: "Voorleesknoppen",
                 playbackSpeedA11y: "Voorleessnelheid",
                 rewindA11y: "Terugspoelen",
                 fastForwardA11y: "Vooruitspoelen",
                 stopA11y: "Voorlezen stoppen",
-                initializing: "Voorlezen wordt gestart",
-                initFailed: "Voorlezen kon niet worden gestart. Probeer het opnieuw.",
                 starting: "Voorlezen wordt gestart",
                 started: "Voorlezen gestart",
                 resumed: "Voorlezen hervat",
                 pausedAnnouncement: "Voorlezen gepauzeerd",
                 stopped: "Voorlezen gestopt",
                 switchedSection: "Het voorlezen is naar een ander onderdeel gegaan",
+                nothingToRead: "Hier is niets om voor te lezen",
                 startFailed: "Voorlezen kon niet worden gestart",
                 skippedForward: "Vooruitgespoeld",
                 skipForwardFailed: "Vooruitspoelen is niet gelukt",
@@ -438,6 +414,7 @@ const nlNL = {
         pnp: {
             title: "PNP-profiel",
             noAssessmentBound: "Geen toets gekoppeld",
+            noAssessmentBoundBody: "Profiel-, district- en afnamebeleid hebben niets om te lezen, dus alleen de requiredTools van een item kunnen een voorziening toekennen. Geef de toets door aan de assessment-eigenschap van de toolkit, of roep updateAssessment(...) aan op de toolkit-coordinator.",
             determinationReadOnly: "Vaststelling (alleen lezen)",
             toolsEditor: "Hulpmiddelen bewerken",
             enforcement: "PNP-handhaving",
@@ -450,6 +427,7 @@ const nlNL = {
             resolvedTools: "Toegekende hulpmiddelen (toolkit)",
             provenanceSummary: "Overzicht van herkomst van het hulpmiddelenbeleid",
             perToolDecisions: "Beslissingen per hulpmiddel",
+            policyDiagnostics: "Diagnose van het hulpmiddelenbeleid",
             profileReadOnly: "PNP-profiel (alleen lezen)",
         },
         tts: {
@@ -512,12 +490,39 @@ const nlNL = {
             previewEnterText: "Voer eerst voorbeeldtekst in.",
             previewUnavailable: "Een voorbeeld is niet mogelijk zolang deze dienst niet beschikbaar is.",
             browserSynthesisUnavailable: "Spraaksynthese van de browser is niet beschikbaar.",
-            browserSynthesisEndedEarly: "De spraaksynthese van de browser stopte voordat de audio begon. Start de browser opnieuw en probeer het nog eens.",
-            browserSynthesisQueueFailed: "De spraaksynthese van de browser kon het voorbeeldfragment niet in de wachtrij zetten.",
-            browserPreviewFailed: "Het voorbeeld van de browserstem kon niet worden afgespeeld.",
             ssmlWordTrackingDisabled: "Bij een Google SSML-voorbeeld blijft de SSML uit de bron intact, waardoor woordmarkering is uitgeschakeld.",
             applyUnavailable: "Instellingen toepassen is niet mogelijk zolang deze dienst niet beschikbaar is.",
             coordinatorUnavailable: "De toolkitcoördinator is niet beschikbaar voor voorleesinstellingen.",
+            customProviderNotRegistered: "Aangepaste provider '{id}' is niet geregistreerd.",
+            customProviderNoConfig: "Aangepaste provider '{id}' gaf geen configuratie om toe te passen.",
+            httpError: "HTTP {status}: {message}",
+            unknownError: "Onbekende fout",
+            previewRequestFailed: "Het voorbeeldverzoek is mislukt ({status}).",
+            notAvailable: "n.v.t.",
+            voiceLocal: "lokaal",
+            voiceRemote: "extern",
+            voiceBrowserDefault: "browserstandaard",
+            browserAvailable: {
+                one: "Browserspraak beschikbaar ({count} stem gevonden).",
+                other: "Browserspraak beschikbaar ({count} stemmen gevonden).",
+            },
+            pollyAvailable: {
+                one: "AWS Polly beschikbaar ({count} passende stem, engine {engine}).",
+                other: "AWS Polly beschikbaar ({count} passende stemmen, engine {engine}).",
+            },
+            googleAvailable: {
+                one: "Google Cloud TTS beschikbaar ({count} passende stem).",
+                other: "Google Cloud TTS beschikbaar ({count} passende stemmen).",
+            },
+            headerRowReservation: "Rij in de itemkop gereserveerd: {state}",
+            speedOptionsHelp: "Vermenigvuldigers, gescheiden door komma's of puntkomma's. Neem 1 op voor Normaal; laat leeg om de snelheidsknoppen te verbergen.",
+            usingSelectedVoice: "Gekozen stem: {voice}",
+            autoVoice: "Beste beschikbare stem (automatisch): {voice}",
+            autoVoiceWaiting: "Beste beschikbare stem (automatisch): wachten op de stemmen van de browser.",
+            previewHintBrowserSsml: "SSML wordt niet ondersteund in het browservoorbeeld.",
+            previewHintGoogleSsml: "SSML blijft intact. Markering uitgeschakeld.",
+            previewHintCustom: "Markering actief wanneer de provider spraakmarkeringen teruggeeft.",
+            previewHintTracking: "Markering actief tijdens het afspelen van het voorbeeld.",
         },
     },
 };

package/dist/i18n/provider.d.ts

@@ -43,12 +43,10 @@ export declare function detectBrowserLocale(): string;
 /**
  * The bundled provider.
  *
- * Retains the `SimpleI18n` name and the `I18nServiceApi` surface it published
- * before adoption. What changed is behaviour that had no caller: catalogs are
- * BCP-47 keyed and resolved through RFC 4647 lookup rather than string equality,
- * `dir`/`lang` are no longer written to `document.documentElement` (an embedded
- * player has no business writing the host page's root), and plural categories
- * come from `Intl.PluralRules` alone.
+ * Catalogs are BCP-47 keyed and resolved through RFC 4647 lookup, and plural
+ * categories come from `Intl.PluralRules`. It never writes `dir` or `lang` to
+ * `document.documentElement`: an embedded player does not own the host page's
+ * root.
  */
 export declare class SimpleI18n implements I18nServiceApi {
     /** Shared across instances and views: `Intl.PluralRules` is not cheap. */
@@ -138,11 +136,20 @@ export declare class SimpleI18n implements I18nServiceApi {
     private selectPluralCategory;
     private notify;
 }
+/**
+ * The graceful default: an English-only provider, shared process-wide.
+ *
+ * `composition-context.md` requires a resolver to work with no publisher
+ * present, and this is that state. A tool mounted bare — in `print-player` or
+ * an authoring harness — resolves this and renders English rather than
+ * leaking raw message keys onto the screen. It carries no locale loader, so it
+ * pulls no catalog beyond the 5 KB English one already in the bundle.
+ */
 export declare function getDefaultI18n(): I18nServiceApi;
 /**
  * Resolve a component's interface-locale provider from a published context.
  *
- * Returns a **fresh** object on every call, and that is the whole point. A
+ * Returns a **fresh** object on every call. A
  * provider is mutable: `setLocale` swaps its catalog in place, so its identity is
  * unchanged before and after a locale load. A reactive `$derived` reading the
  * provider directly therefore never invalidates, and a label rendered while the

package/dist/i18n/provider.js

@@ -9,7 +9,7 @@
  *
  * @module @pie-players/pie-players-shared/i18n/provider
  */
-import { findBestLanguageMatch, normalizeLanguageTag, } from "./language-tags.js";
+import { findBestLanguageMatch, normalizeLanguageTag, toLanguageTag, } from "./language-tags.js";
 import enUS from "./messages/en-US.js";
 /** The locale every fallback chain terminates at. */
 export const DEFAULT_LOCALE = "en-US";
@@ -31,7 +31,6 @@ export function dynamicMessageKey(key) {
  * Consulted only where `Intl.Locale.prototype.textInfo` is unavailable — it is
  * the authoritative CLDR answer but shipped late in Safari, and an assessment
  * laid out left-to-right for an Arabic reader is not a graceful degradation.
- * Replaces a four-entry list that omitted every subtag below.
  */
 const RTL_LANGUAGES = new Set([
     "ar", // Arabic
@@ -101,12 +100,10 @@ export function detectBrowserLocale() {
 /**
  * The bundled provider.
  *
- * Retains the `SimpleI18n` name and the `I18nServiceApi` surface it published
- * before adoption. What changed is behaviour that had no caller: catalogs are
- * BCP-47 keyed and resolved through RFC 4647 lookup rather than string equality,
- * `dir`/`lang` are no longer written to `document.documentElement` (an embedded
- * player has no business writing the host page's root), and plural categories
- * come from `Intl.PluralRules` alone.
+ * Catalogs are BCP-47 keyed and resolved through RFC 4647 lookup, and plural
+ * categories come from `Intl.PluralRules`. It never writes `dir` or `lang` to
+ * `document.documentElement`: an embedded player does not own the host page's
+ * root.
  */
 export class SimpleI18n {
     /** Shared across instances and views: `Intl.PluralRules` is not cheap. */
@@ -121,7 +118,7 @@ export class SimpleI18n {
     config;
     constructor(config = {}) {
         this.config = { ...config };
-        this.fallbackLocale = normalizeTag(config.fallbackLocale) || DEFAULT_LOCALE;
+        this.fallbackLocale = toLanguageTag(config.fallbackLocale) || DEFAULT_LOCALE;
         this.catalogs = new Map([[DEFAULT_LOCALE, enUS]]);
         this.customMessages = { ...(config.customMessages ?? {}) };
         this.loading = new Map();
@@ -160,11 +157,15 @@ export class SimpleI18n {
             // A locale we ship no catalog for is legitimate: the host may have
             // supplied its own messages for it. Honour the tag and let the
             // fallback chain cover whatever those messages omit.
-            this.locale = normalizeTag(locale) || DEFAULT_LOCALE;
+            this.locale = toLanguageTag(locale) || DEFAULT_LOCALE;
             this.notify();
             return;
         }
-        if (!this.catalogs.has(resolved)) {
+        // The loader is asked only for tags it declares. A tag that resolved through
+        // host messages alone has nothing to load, and is honoured like the
+        // unresolved case above.
+        if (!this.catalogs.has(resolved) &&
+            this.config.availableLocales?.includes(resolved)) {
             const inFlight = this.loading.get(resolved);
             if (inFlight) {
                 await inFlight;
@@ -243,7 +244,7 @@ export class SimpleI18n {
      * a catalog.
      */
     addCustomMessages(locale, messages) {
-        const tag = normalizeTag(locale);
+        const tag = toLanguageTag(locale);
         this.customMessages[tag] = deepMerge(this.customMessages[tag] ?? {}, messages);
         this.notify();
     }
@@ -256,7 +257,7 @@ export class SimpleI18n {
      * locales: the locale is per-view, the catalogs are per-provider.
      */
     withLocale(locale) {
-        const resolved = this.resolveLocaleTag(locale) ?? normalizeTag(locale);
+        const resolved = this.resolveLocaleTag(locale) ?? toLanguageTag(locale);
         if (resolved === this.locale)
             return this;
         const view = new SimpleI18n({ ...this.config, locale: resolved });
@@ -320,9 +321,9 @@ export class SimpleI18n {
             this.catalogs.set(locale, await load(locale));
         }
         catch (error) {
-            // A failed load is not fatal: the fallback chain still resolves every
-            // key to English. Rethrowing here would take down a player over a
-            // missing chunk.
+            // Rethrown with the locale named: `setLocale` rejects before switching
+            // (it assigns `this.locale` only after the load), so the previous locale
+            // stays active.
             throw new Error(`Failed to load i18n catalog for locale: ${locale}`, {
                 cause: error,
             });
@@ -350,9 +351,9 @@ export class SimpleI18n {
         const node = this.lookupNode(key);
         if (typeof node === "string")
             return node;
-        // A key landing on a namespace (`t("common")`) or on a plural group is a
-        // miss, not a hit: returning the object would put one where the caller
-        // expects a string, and interpolating it throws.
+        // A plural group resolves to its `other` form. A namespace (`t("common")`)
+        // is a miss: returning the object would put one where the caller expects
+        // a string, and interpolating it throws.
         if (node !== undefined && isPluralGroup(node))
             return node.other;
         return undefined;
@@ -375,9 +376,6 @@ export class SimpleI18n {
             listener();
     }
 }
-function normalizeTag(locale) {
-    return locale ? locale.trim().replace(/_/g, "-") : "";
-}
 function readPath(source, key) {
     if (!source)
         return undefined;
@@ -415,17 +413,16 @@ function deepMerge(target, source) {
     }
     return result;
 }
+let defaultProvider;
 /**
  * The graceful default: an English-only provider, shared process-wide.
  *
  * `composition-context.md` requires a resolver to work with no publisher
- * present, and this is that state. A tool mounted bare — in `print-player`, in
- * Studio preview, in an authoring harness — resolves this and renders English
- * rather than leaking raw message keys onto the screen. It carries no locale
- * loader, so it pulls no catalog beyond the 5 KB English one already in the
- * bundle.
+ * present, and this is that state. A tool mounted bare — in `print-player` or
+ * an authoring harness — resolves this and renders English rather than
+ * leaking raw message keys onto the screen. It carries no locale loader, so it
+ * pulls no catalog beyond the 5 KB English one already in the bundle.
  */
-let defaultProvider;
 export function getDefaultI18n() {
     if (!defaultProvider)
         defaultProvider = new SimpleI18n();
@@ -434,7 +431,7 @@ export function getDefaultI18n() {
 /**
  * Resolve a component's interface-locale provider from a published context.
  *
- * Returns a **fresh** object on every call, and that is the whole point. A
+ * Returns a **fresh** object on every call. A
  * provider is mutable: `setLocale` swaps its catalog in place, so its identity is
  * unchanged before and after a locale load. A reactive `$derived` reading the
  * provider directly therefore never invalidates, and a label rendered while the

package/dist/i18n/types.d.ts

@@ -52,11 +52,10 @@ type PluralCategoryKey = keyof PluralTranslation;
  * Dot-notation keys of a catalog shape.
  *
  * A plural group terminates the path at the group itself: `plural()` is called
- * with `tools.textToSpeech.charactersSelected`, never with
- * `…charactersSelected.other`. A group is recognized by every one of its keys
- * being a CLDR plural category — the containment has to run this way round,
- * because a group carrying only `one`/`other` does not contain the whole
- * category union.
+ * with `player.formative.triesLeft`, never with `…triesLeft.other`. A group is
+ * recognized by every one of its keys being a CLDR plural category — the
+ * containment has to run this way round, because a group carrying only
+ * `one`/`other` does not contain the whole category union.
  */
 type NestedKeys<T> = {
     [K in keyof T & string]: T[K] extends string ? K : keyof T[K] extends PluralCategoryKey ? K : T[K] extends object ? K | `${K}.${NestedKeys<T[K]>}` : K;

package/dist/index.d.ts

@@ -6,7 +6,7 @@ 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, AdvancedItemConfig, ConfigEntity, ConfigResource, Env, FormativeDeliveryPolicy, FormativeItemPolicy, TimedMediaSectionData, ItemConfig, ItemEntity, ItemSession, OutcomeResponse, PassageEntity, PieController, PieContent, PieDefaultModel, PieItemElement, PieModel, PieUpdateSession, RubricBlock, TestPart, } from "./types/index.js";
+export type { AssessmentEntity, AssessmentItemRef, AssessmentSection, AdvancedItemConfig, ConfigEntity, ConfigResource, Env, FormativeDeliveryPolicy, FormativeItemPolicy, TimedMediaSectionData, ItemConfig, ItemEntity, ItemSession, OutcomeResponse, PassageEntity, PieController, PieContent, PieDefaultModel, PieItemElement, PieModel, PieUpdateSession, ReferencedItemEntity, ReferencedPassageEntity, RubricBlock, TestPart, } from "./types/index.js";
 export { editorPostFix } from "./types/index.js";
 export * from "./ui/attribute-coercion.js";
 export * from "./ui/content-styles.js";

package/dist/index.js

@@ -5,7 +5,6 @@ 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/attribute-coercion.js";

package/dist/instrumentation/providers/BaseInstrumentationProvider.js

@@ -37,17 +37,13 @@ export class BaseInstrumentationProvider {
      * @param attributes Contextual attributes
      */
     trackError(error, attributes) {
-        // Guard: check if provider is ready
         if (!this.guardedOperation("trackError", error, attributes)) {
             return;
         }
-        // Apply error filter
         if (!this.applyErrorFilter(error, attributes)) {
             return;
         }
-        // Transform attributes
         const finalAttributes = this.transformAttributes(attributes);
-        // Delegate to concrete provider
         try {
             this.doTrackError(error, finalAttributes);
             if (this.config?.debug) {
@@ -73,28 +69,22 @@ export class BaseInstrumentationProvider {
      * @param attributes Event attributes
      */
     trackEvent(eventName, attributes) {
-        // Guard: check if provider is ready
         if (!this.guardedOperation("trackEvent", eventName, attributes)) {
             return;
         }
-        // Apply event filter
         if (!this.applyEventFilter(eventName, attributes)) {
             return;
         }
-        // Apply sampling
         if (!this.applySampling(eventName)) {
             return;
         }
-        // Transform attributes
         let finalAttributes = this.transformAttributes(attributes);
-        // Add timestamp if not present
         if (!finalAttributes.timestamp) {
             finalAttributes = {
                 ...finalAttributes,
                 timestamp: new Date().toISOString(),
             };
         }
-        // Delegate to concrete provider
         try {
             this.doTrackEvent(eventName, finalAttributes);
             if (this.config?.debug) {
@@ -134,11 +124,9 @@ export class BaseInstrumentationProvider {
      * @param attributes Optional user attributes
      */
     setUserContext(userId, attributes) {
-        // Guard: check if provider is ready
         if (!this.guardedOperation("setUserContext", userId, attributes)) {
             return;
         }
-        // Delegate to concrete provider
         try {
             this.doSetUserContext(userId, attributes);
             if (this.config?.debug) {
@@ -158,11 +146,9 @@ export class BaseInstrumentationProvider {
      * @param attributes Attributes to set globally
      */
     setGlobalAttributes(attributes) {
-        // Guard: check if provider is ready
         if (!this.guardedOperation("setGlobalAttributes", attributes)) {
             return;
         }
-        // Delegate to concrete provider
         try {
             this.doSetGlobalAttributes(attributes);
             if (this.config?.debug) {

package/dist/loader-config.d.ts

@@ -1,7 +1,5 @@
 /**
  * Shared loader configuration for PIE custom elements.
- *
- * Mirrors the `LoaderConfig` used by PIEOneer's custom element tags.
  */
 import type { InstrumentationProvider } from "./instrumentation/types.js";
 export type IifeBundleRetryConfig = {

package/dist/loader-config.js

@@ -1,7 +1,5 @@
 /**
  * Shared loader configuration for PIE custom elements.
- *
- * Mirrors the `LoaderConfig` used by PIEOneer's custom element tags.
  */
 export const DEFAULT_IIFE_BUNDLE_RETRY_CONFIG = {
     retryDelayMs: 3000,

package/dist/loaders/element-loader.js

@@ -128,6 +128,9 @@ const DEFAULT_LOAD_TIMEOUT_MS = DEFAULT_IIFE_BUNDLE_RETRY_CONFIG.timeoutMs;
 // Module-scoped in-flight cache. Key: backend signature + sorted elements.
 // Keeps concurrent identical requests collapsed to one backend call.
 const inFlightRequests = new Map();
+// An ESM backend keeps page state that later loads build on (the import maps it
+// injected, the shared dependency versions they fixed), so every load with the
+// same config reuses one backend. IIFE backends are created per call.
 const resolvedEsmBackends = new Map();
 const resolvedBackendOverrides = new Map();
 /**
@@ -350,22 +353,26 @@ function backendKeyOf(backend) {
     }
     return "unknown";
 }
+/**
+ * Plain data compares by value, functions and other objects by identity, so
+ * two configs get one key only when they behave the same.
+ */
 function fingerprintValue(value) {
     return JSON.stringify(normalizeForFingerprint(value, new Map()));
 }
 function normalizeForFingerprint(value, seen) {
     if (value === null || value === undefined)
         return value;
-    const primitiveType = typeof value;
-    if (primitiveType === "string" ||
-        primitiveType === "number" ||
-        primitiveType === "boolean") {
+    const valueType = typeof value;
+    if (valueType === "string" ||
+        valueType === "number" ||
+        valueType === "boolean") {
         return value;
     }
-    if (primitiveType === "function") {
+    if (valueType === "function") {
         return { __functionRef: getFunctionRefId(value) };
     }
-    if (primitiveType !== "object") {
+    if (valueType !== "object") {
         return String(value);
     }
     const objectValue = value;

package/dist/loaders/esm-adapter.d.ts

@@ -73,4 +73,15 @@ export declare function resolveEsmRuntimeSupportUrl(packageVersion: string, opti
     cdnBaseUrl: string;
     cdnProvider?: EsmCdnProviderOption;
 }): string | undefined;
+/**
+ * The npm root the ESM CDN the players load elements from serves raw package
+ * files under, `<root>/<package>@<version>/<path>`: the base URL for jsDelivr,
+ * raw.esm.sh for esm.sh, and for a custom provider whatever its
+ * `packageJsonUrl` puts before the package. `undefined` when that URL names
+ * no such root.
+ */
+export declare function resolveEsmAssetRoot(options: {
+    cdnBaseUrl: string;
+    cdnProvider?: EsmCdnProviderOption;
+}): string | undefined;
 export declare function pickElementClass(module: any, view: string): unknown;