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

package/README.md

@@ -1,8 +1,9 @@
 # PIE Players Shared
 
-Shared runtime utilities for the `@pie-players/*` player suite. This package is
-for framework code and host integrations that need the same loader, PIE config,
-security, object, i18n, or type helpers used by the player packages.
+Shared runtime utilities for the `@pie-players/*` player suite: the element
+loader, PIE config and session helpers, markup security, i18n, and the
+formative, timed-media and media contracts. For framework code and host
+integrations that need the helpers the player packages use.
 
 ## Public Exports
 
@@ -12,28 +13,38 @@ import { makeUniqueTags } from "@pie-players/pie-players-shared/pie";
 import { normalizeItemPlayerStrategy } from "@pie-players/pie-players-shared";
 ```
 
-Supported subpaths are declared in `package.json`:
-
-- `@pie-players/pie-players-shared`
-- `@pie-players/pie-players-shared/loader-config`
-- `@pie-players/pie-players-shared/security`
-- `@pie-players/pie-players-shared/object`
-- `@pie-players/pie-players-shared/types`
-- `@pie-players/pie-players-shared/formative`
-- `@pie-players/pie-players-shared/timed-media`
-- `@pie-players/pie-players-shared/media`
-- `@pie-players/pie-players-shared/pie`
-- `@pie-players/pie-players-shared/pie/tag-names`
-- `@pie-players/pie-players-shared/loaders`
-- `@pie-players/pie-players-shared/i18n`
+The subpaths below are the package's `exports`; nothing else is importable.
+
+| Subpath | Contents |
+| --- | --- |
+| `@pie-players/pie-players-shared` | The root: the loader, PIE, security and object helpers, loader config, instrumentation providers, the item-player strategy helpers, the default bundle host URL (`BUILDER_BUNDLE_URL`), a subset of the shared types, and the UI helpers (attribute coercion, content styles, pointer gestures, overlay placement, focus trap, safe storage, scoped CSS) |
+| `/loader-config` | `LoaderConfig` and its defaults: instrumentation (`trackPageActions`, `instrumentationProvider`), resource retry, and IIFE bundle retry |
+| `/security` | The item-markup sanitizer (`sanitizeItemMarkup`, `createDefaultItemMarkupSanitizer`, `buildAuthoringAllowList`), external-stylesheet URL validation, the SVG icon and `style` attribute sanitizers, and the wrappers that put overwide images and tables in a scrollable region |
+| `/object` | `mergeObjectsIgnoringNullUndefined`, `cloneDeep`, `isPlainRecord` |
+| `/types` | The shared types: item, passage, section and session entities, PIE models and controllers, accessibility catalogs, and the [media vocabulary](#media-validation) |
+| `/formative` | [Formative delivery](#formative-delivery) |
+| `/timed-media` | [Timed media](#timed-media) |
+| `/media` | [Media validation](#media-validation) |
+| `/pie` | PIE runtime utilities: config helpers, bundle initialization, `ItemController` and the item session contract, session commit and snapshots, authoring helpers, math renderer setup, instrumentation event maps ([PIE utilities](src/pie/README.md)) |
+| `/pie/tag-names` | Custom element tag helpers: `validateCustomElementTag`, `toViewTag`, `toPrintHashedTag`, `parseVersionedTagName` |
+| `/loaders` | The `ElementLoader` primitive and its IIFE and ESM adapters, `registerPreloadedElements`, the element package policy, and the MathJax event names ([Element loading](#element-loading)) |
+| `/i18n` | `createPieI18n`, a provider for every bundled locale ([i18n](src/i18n/README.md)) |
+| `/i18n/types` | The i18n contract, types only |
+| `/i18n/provider` | `SimpleI18n`, `getDefaultI18n` and `resolveInterfaceI18n`, with the English catalog only |
+| `/i18n/catalogs` | `BUNDLED_LOCALES` and lazy loaders for the bundled locales other than English |
+| `/i18n/language-tags` | BCP 47 language tag normalization and matching |
+| `/nds-icon-button` | `<nds-icon-button>`, an icon button vendored as a prebuilt bundle with Lit inlined; importing it registers the tag. The assessment toolkit and `@pie-players/pie-tool-tts-inline` render it |
+| `/ui/attribute-coercion` | Boolean attribute coercion for custom elements |
+| `/ui/content-styles` | `installContentStyles`, `auditContentStyles` and the opt-out checks behind the item player's content styles |
+| `/tools/term-lookup` | Term normalization and the lookup session the dictionary tools share; the host supplies the endpoint or a resolver |
 
 ## Formative Delivery
 
 `@pie-players/pie-players-shared/formative` holds the policy resolution, outcome
 aggregation, Try-state reducer, item view, and mastery rollup that
-`pie-section-player` drives. It is pure — no DOM, no timers, no element registry
-— so it is testable without a browser and importable by an adapter that has no
-player.
+`pie-section-player` drives. It is pure (no DOM, no timers, no element
+registry), so it is testable without a browser and importable by an adapter that
+has no player.
 
 ```ts
 import {
@@ -44,8 +55,8 @@ import {
 } from "@pie-players/pie-players-shared/formative";
 ```
 
-The authored half — `FormativeDeliveryPolicy` on `AssessmentSection` and
-`FormativeItemPolicy` on `AssessmentItemRef` — is re-exported from the package
+The authored half, `FormativeDeliveryPolicy` on `AssessmentSection` and
+`FormativeItemPolicy` on `AssessmentItemRef`, is re-exported from the package
 root and from `/types`, beside the section types it annotates.
 
 The contract is [`docs/prds/formative-delivery-contract.md`](../../docs/prds/formative-delivery-contract.md),
@@ -55,9 +66,9 @@ including the QTI 3 mapping and why PIE says **Try** rather than "attempt".
 
 `@pie-players/pie-players-shared/timed-media` holds the timed-media section
 vocabulary, its validation, the cue reduction, the session slice, and the **Media
-Time Source** port that a section reaches media through. Pure apart from
-`createMediaElementTimeSource`, which is inert until called, so the contract stays
-importable in Node beside the rest.
+Time Source** port that a section reaches media through. It is pure apart from
+`createMediaElementTimeSource`, which is inert until called, so the contract
+imports in Node.js beside the rest.
 
 ```ts
 import {
@@ -69,14 +80,14 @@ import {
 } from "@pie-players/pie-players-shared/timed-media";
 ```
 
-The port is shaped after `HTMLMediaElement` on purpose — a native `<video>`
-satisfies it through the adapter above — with two departures: seeking is
-`seekTo(seconds)` rather than a writable `currentTime`, and `capabilities` declares
-`canPause` / `canRestrictSeeking`, because a source that cannot control playback
-needs a way to say so. A host implementing the port directly needs no PIE element to
-deliver timed media.
+The port is shaped after `HTMLMediaElement`, so a native `<video>` satisfies it
+through `createMediaElementTimeSource`, with two departures: seeking is
+`seekTo(seconds)` in place of a writable `currentTime`, and `capabilities`
+declares `canPause` and `canRestrictSeeking`, because a source that cannot
+control playback needs a way to say so. A host implementing the port directly
+needs no PIE element to deliver timed media.
 
-The authored half — `sectionType` and `timedMedia` on `AssessmentSection` — is
+The authored half, `sectionType` and `timedMedia` on `AssessmentSection`, is
 re-exported from the package root and from `/types`, beside the section types it
 annotates.
 
@@ -87,14 +98,22 @@ unenforceable policy degrades to advisory rather than failing closed.
 ## Media Validation
 
 `@pie-players/pie-players-shared/media` validates authored, wire-facing media
-references before they reach a media element: the source-scheme allow-list
-(`isSafeMediaSrc`), source normalization with dedupe by `src`
-(`normalizeMediaSources`), fragment-range normalization, and
-unknown-`MediaAssetRef.version` rejection. `applyMediaFragment` writes a
-fragment range as a Media Fragments URI, and `enforceMediaFragment` holds a
-media element to that range because browsers honour the URI inconsistently.
+references before they reach a media element:
+
+- `isSafeMediaSrc` is the source-scheme allow-list: relative and
+  protocol-relative URLs, `http:`, `https:`, `data:` and `blob:`.
+- `normalizeMediaSources` drops unsafe and malformed sources and deduplicates by
+  `src`, keeping the first.
+- `normalizeMediaFragment` normalizes a fragment range; an end at or before the
+  start becomes an open end.
+- `isUnsupportedMediaAssetVersion` rejects a `MediaAssetRef.version` other than
+  `SUPPORTED_MEDIA_ASSET_VERSION` (1); an absent version passes.
+- `applyMediaFragment` writes a fragment range as a Media Fragments URI (`#t=`),
+  and `enforceMediaFragment` holds a media element to that range, because
+  browsers honor the URI inconsistently.
+
 Nothing runs at import time, so an element imports it without the assessment
-toolkit; the toolkit root re-exports the same names.
+toolkit.
 
 ```ts
 import {
@@ -104,44 +123,38 @@ import {
 } from "@pie-players/pie-players-shared/media";
 ```
 
-The media vocabulary it validates is [`docs/prds/shared-contracts/media-asset-contract.md`](../../docs/prds/shared-contracts/media-asset-contract.md).
-
-## Browser ESM Element Contract
-
-The canonical producer-side contract lives with the `pie-elements-ng` package
-contract. The loader assumptions here must stay aligned with that producer
-surface.
-
-The ESM element loader consumes static `@pie-element/*` browser entries such as
-`dist/browser/delivery/index.js`; it does not transform element packages through
-CDN `+esm` entry points. Browser ESM elements must publish exact shared runtime
-metadata in `package.json` under `pie.browserSharedDependencies`.
-Under URL resolution it loads the variant an element declares in
-`pie.browserEditorRuntime` and maps that runtime's `pie.browserModules`, one
-runtime version per page; see
-[Shared editor runtime](../../docs/item-player/loading-strategies.md#shared-editor-runtime).
-
-jsDelivr is the default npm CDN provider. Hosts can opt into `esm.sh` with
-`loaderOptions.esmCdnProvider = "esm.sh"` and `loaderOptions.esmCdnUrl =
-"https://esm.sh"`. For `esm.sh`, PIE package artifacts are loaded from
-`raw.esm.sh` while shared browser dependencies are loaded from `esm.sh`.
-Provider names are open-ended: custom/internal providers can pass their own name
-when they follow the jsDelivr-compatible package-file URL layout, or pass a
-provider object when package artifacts and shared dependencies need different
-route builders.
-
-`dependencies` and `peerDependencies` are not used as fallback runtime contracts.
-If multiple elements request different minor or patch versions of a shared
-singleton such as React, the loader chooses the highest same-major version and
-emits console plus instrumentation warnings. Different major versions fail the
-load and are also reported through console and instrumentation.
-
-Preloaded mode means the host has already registered the expected custom element
-tag; it is not a separate package format. IIFE mode remains supported through the
-same package exports and controller compatibility shim used by legacy builders.
+The media vocabulary it validates ships in `/types`:
+
+| Type | Shape |
+| --- | --- |
+| `MediaAssetRef` | `{ version: 1, id, kind, sources, poster?, thumbnail?, durationSeconds?, tracks?, transcript?, label?, description?, lang? }` |
+| `MediaKind` | `"image" \| "audio" \| "video" \| "other"` |
+| `MediaSource` | `{ src, type?, width?, height?, bitrate? }` |
+| `TextTrackRef` | `{ src, kind, lang, label, default? }`, where `kind` is `captions`, `subtitles`, `descriptions`, `chapters` or `metadata` |
+| `TranscriptRef` | `{ src?, html?, plainText?, lang? }` |
+| `MediaFragmentRange` | `{ startSeconds, endSeconds? }`: a slice of a longer recording, so one file serves several content nodes |
+| `SignLanguageCardPayload` | `{ signLang?, media, fragment? }`, the payload of a `sign-language` catalog card |
+| `SpokenAudioCardPayload` | `{ media, fragment? }`, the payload of a recorded `spoken` catalog card |
+| `CatalogCardPayload` | Either payload; the card's `catalog` decides which |
+
+The design record is [`docs/prds/shared-contracts/media-asset-contract.md`](../../docs/prds/shared-contracts/media-asset-contract.md).
+
+## Element Loading
+
+`@pie-players/pie-players-shared/loaders` holds the `ElementLoader` primitive and
+the IIFE and ESM adapters `<pie-item-player>` loads elements through.
+[Loading strategies](../../docs/item-player/loading-strategies.md) documents
+their behavior, including the ESM adapter's file layout and CDN providers
+([`strategy="esm"`](../../docs/item-player/loading-strategies.md#strategyesm))
+and the one-version rule for page singletons such as React
+([Shared dependencies](../../docs/item-player/loading-strategies.md#shared-dependencies)).
+The producer side is the
+[PIE element contract](https://github.com/pie-framework/pie-elements-ng/blob/develop/docs/PIE_ELEMENT_CONTRACT.md)
+in pie-elements-ng.
 
 ## Related Documentation
 
 - [PIE utilities README](src/pie/README.md)
 - [i18n README](src/i18n/README.md)
-- [PIE element tag/id contract](../../docs/architecture/types-and-utilities-contract.md)
+- [Loading strategies](../../docs/item-player/loading-strategies.md)
+- [Internationalization](../../docs/architecture/internationalization.md)

package/dist/components/vendor/nds/README.md

@@ -22,9 +22,9 @@ lands, so it never leaks into a consumer's own dependency set.
 
 | Field | Value |
 | --- | --- |
-| Upstream repo | `git@github.com:RenaissancePlace/nextComponentLibrary.git` |
+| Upstream | NDS component library |
 | Source file | `web-components/src/components/icon-button/nds-icon-button.ts` |
-| Last sync commit | `1c728d3` (`feat(UX-2319): add new components…`) |
+| Last sync commit | `1c728d3` |
 | Bundler | Vite 7 in lib mode, ES output, single-file (Lit inlined) |
 
 ## Why a vendored bundle, not an npm dep
@@ -79,9 +79,8 @@ Consuming bundlers treat this module per their own externals config:
 
 When a newer `nds-icon-button` is needed:
 
-1. Pull the latest `nextComponentLibrary` next to this repo (sibling checkout:
-   `../../nextComponentLibrary`).
-2. From `nextComponentLibrary/web-components/`, `bun install`.
+1. Check out the latest NDS component library source.
+2. From its `web-components/` directory, `bun install`.
 3. Build a self-contained ESM bundle (no shared chunks) — the upstream
    `vite.bundle.config.js` splits Lit into a `property.js` chunk, which would
    break the single-file copy here. Use this one-shot config instead:

package/dist/config/profile.d.ts

@@ -1,7 +1,7 @@
 /**
  * Minimal, frontend-safe defaults for PIE build service URLs.
  *
- * In PIEOneer, these come from `$env/dynamic/public`. In `pie-players` we avoid
+ * A SvelteKit host reads these from `$env/dynamic/public`. `pie-players` avoids
  * SvelteKit env dependencies so this can be consumed by any bundler.
  */
 declare global {

package/dist/config/profile.js

@@ -1,7 +1,7 @@
 /**
  * Minimal, frontend-safe defaults for PIE build service URLs.
  *
- * In PIEOneer, these come from `$env/dynamic/public`. In `pie-players` we avoid
+ * A SvelteKit host reads these from `$env/dynamic/public`. `pie-players` avoids
  * SvelteKit env dependencies so this can be consumed by any bundler.
  */
 import { DEFAULT_BUNDLE_HOST } from "../loaders/defaults.js";

package/dist/i18n/index.d.ts

@@ -28,6 +28,6 @@ import type { I18nConfig, I18nServiceApi } from "./types.js";
  */
 export declare function createPieI18n(config?: I18nConfig): I18nServiceApi;
 export { BUNDLED_LOCALES, loadBundledCatalog } from "./catalogs.js";
-export { findBestLanguageMatch, languageTagLookupSequence, languageTagsEqual, normalizeLanguageTag, } from "./language-tags.js";
+export { findBestLanguageMatch, languageTagLookupSequence, languageTagsEqual, normalizeLanguageTag, toLanguageTag, } from "./language-tags.js";
 export { DEFAULT_LOCALE, detectBrowserLocale, dynamicMessageKey, getDefaultI18n, localeDirection, resolveInterfaceI18n, SimpleI18n, } from "./provider.js";
 export type { BundledLocaleCode, DynamicMessageKey, I18nConfig, I18nProvider, I18nServiceApi, InterpolationValues, LocaleCode, MessageCatalog, MessageKey, MessageKeyInput, MessageNode, PluralOptions, PluralTranslation, TextDirection, TranslationBundle, } from "./types.js";

package/dist/i18n/index.js

@@ -35,5 +35,5 @@ export function createPieI18n(config = {}) {
     });
 }
 export { BUNDLED_LOCALES, loadBundledCatalog } from "./catalogs.js";
-export { findBestLanguageMatch, languageTagLookupSequence, languageTagsEqual, normalizeLanguageTag, } from "./language-tags.js";
+export { findBestLanguageMatch, languageTagLookupSequence, languageTagsEqual, normalizeLanguageTag, toLanguageTag, } from "./language-tags.js";
 export { DEFAULT_LOCALE, detectBrowserLocale, dynamicMessageKey, getDefaultI18n, localeDirection, resolveInterfaceI18n, SimpleI18n, } from "./provider.js";

package/dist/i18n/language-tags.d.ts

@@ -22,12 +22,20 @@
  * Converts POSIX underscores to hyphens, strips a POSIX charset or modifier
  * suffix (`es_ES.UTF-8`, `es_ES@euro`), and lowercases. Lowercasing rather than
  * applying BCP-47 display casing is intentional — this output is a comparison
- * key, not something to render.
+ * key, not something to render. `toLanguageTag` is the form to render.
  *
  * Returns an empty string for nullish or blank input, which callers read as
  * "this card declares no language".
  */
 export declare function normalizeLanguageTag(tag: string | null | undefined): string;
+/**
+ * A tag in BCP-47 syntax with its authored casing kept: POSIX underscores become
+ * hyphens, so `es_ES` renders as `es-ES`. The form for a `lang` attribute or a
+ * platform locale API.
+ *
+ * Returns an empty string for nullish or blank input.
+ */
+export declare function toLanguageTag(tag: string | null | undefined): string;
 /**
  * Whether two language tags denote the same locale, ignoring separator style and
  * case. Two tags that both declare no language are not a match.

package/dist/i18n/language-tags.js

@@ -22,7 +22,7 @@
  * Converts POSIX underscores to hyphens, strips a POSIX charset or modifier
  * suffix (`es_ES.UTF-8`, `es_ES@euro`), and lowercases. Lowercasing rather than
  * applying BCP-47 display casing is intentional — this output is a comparison
- * key, not something to render.
+ * key, not something to render. `toLanguageTag` is the form to render.
  *
  * Returns an empty string for nullish or blank input, which callers read as
  * "this card declares no language".
@@ -34,6 +34,16 @@ export function normalizeLanguageTag(tag) {
     const withoutPosixSuffix = separatorsUnified.split(/[.@]/)[0];
     return withoutPosixSuffix.toLowerCase();
 }
+/**
+ * A tag in BCP-47 syntax with its authored casing kept: POSIX underscores become
+ * hyphens, so `es_ES` renders as `es-ES`. The form for a `lang` attribute or a
+ * platform locale API.
+ *
+ * Returns an empty string for nullish or blank input.
+ */
+export function toLanguageTag(tag) {
+    return tag ? tag.trim().replace(/_/g, "-") : "";
+}
 /**
  * Whether two language tags denote the same locale, ignoring separator style and
  * case. Two tags that both declare no language are not a match.

package/dist/i18n/messages/en-US.d.ts

@@ -393,30 +393,7 @@ declare const enUS: {
         textToSpeech: {
             name: string;
             description: string;
-            toolA11y: string;
-            title: string;
-            initializing: string;
             initFailed: string;
-            selectText: string;
-            speed: string;
-            play: string;
-            pause: string;
-            resume: string;
-            stop: string;
-            speaking: string;
-            paused: string;
-            charactersSelected: {
-                one: string;
-                other: string;
-            };
-            rate: {
-                slow: string;
-                slower: string;
-                normal: string;
-                faster: string;
-                fast: string;
-                veryFast: string;
-            };
             /** Inline reading controls and their live-region announcements. */
             inline: {
                 controlsA11y: string;
@@ -424,14 +401,13 @@ declare const enUS: {
                 rewindA11y: string;
                 fastForwardA11y: string;
                 stopA11y: string;
-                initializing: string;
-                initFailed: string;
                 starting: string;
                 started: string;
                 resumed: string;
                 pausedAnnouncement: string;
                 stopped: string;
                 switchedSection: string;
+                nothingToRead: string;
                 startFailed: string;
                 skippedForward: string;
                 skipForwardFailed: string;
@@ -526,6 +502,7 @@ declare const enUS: {
         pnp: {
             title: string;
             noAssessmentBound: string;
+            noAssessmentBoundBody: string;
             determinationReadOnly: string;
             toolsEditor: string;
             enforcement: string;
@@ -538,6 +515,7 @@ declare const enUS: {
             resolvedTools: string;
             provenanceSummary: string;
             perToolDecisions: string;
+            policyDiagnostics: string;
             profileReadOnly: string;
         };
         /** TTS settings panel. */
@@ -601,12 +579,39 @@ declare const enUS: {
             previewEnterText: string;
             previewUnavailable: string;
             browserSynthesisUnavailable: string;
-            browserSynthesisEndedEarly: string;
-            browserSynthesisQueueFailed: string;
-            browserPreviewFailed: string;
             ssmlWordTrackingDisabled: string;
             applyUnavailable: string;
             coordinatorUnavailable: string;
+            customProviderNotRegistered: string;
+            customProviderNoConfig: string;
+            httpError: string;
+            unknownError: string;
+            previewRequestFailed: string;
+            notAvailable: string;
+            voiceLocal: string;
+            voiceRemote: string;
+            voiceBrowserDefault: string;
+            browserAvailable: {
+                one: string;
+                other: string;
+            };
+            pollyAvailable: {
+                one: string;
+                other: string;
+            };
+            googleAvailable: {
+                one: string;
+                other: string;
+            };
+            headerRowReservation: string;
+            speedOptionsHelp: string;
+            usingSelectedVoice: string;
+            autoVoice: string;
+            autoVoiceWaiting: string;
+            previewHintBrowserSsml: string;
+            previewHintGoogleSsml: string;
+            previewHintCustom: string;
+            previewHintTracking: string;
         };
     };
 };

package/dist/i18n/messages/en-US.js

@@ -407,30 +407,7 @@ const enUS = {
         textToSpeech: {
             name: "Text to Speech",
             description: "Read content aloud",
-            toolA11y: "Text-to-speech tool",
-            title: "Text-to-Speech",
-            initializing: "Initializing…",
-            initFailed: "Failed to initialize text-to-speech.",
-            selectText: "Select text on the page to read it aloud.",
-            speed: "Speed:",
-            play: "Play",
-            pause: "Pause",
-            resume: "Resume",
-            stop: "Stop",
-            speaking: "Speaking…",
-            paused: "Paused",
-            charactersSelected: {
-                one: "{count} character selected",
-                other: "{count} characters selected",
-            },
-            rate: {
-                slow: "Slow",
-                slower: "Slower",
-                normal: "Normal",
-                faster: "Faster",
-                fast: "Fast",
-                veryFast: "Very Fast",
-            },
+            initFailed: "Unable to initialize text-to-speech. Try again.",
             /** Inline reading controls and their live-region announcements. */
             inline: {
                 controlsA11y: "Reading controls",
@@ -438,14 +415,13 @@ const enUS = {
                 rewindA11y: "Rewind",
                 fastForwardA11y: "Fast-forward",
                 stopA11y: "Stop reading",
-                initializing: "Initializing text-to-speech",
-                initFailed: "Unable to initialize text-to-speech. Try again.",
                 starting: "Starting reading",
                 started: "Reading started",
                 resumed: "Reading resumed",
                 pausedAnnouncement: "Reading paused",
                 stopped: "Reading stopped",
                 switchedSection: "Reading switched to another section",
+                nothingToRead: "Nothing to read aloud here",
                 startFailed: "Unable to start reading",
                 skippedForward: "Skipped forward",
                 skipForwardFailed: "Unable to skip forward",
@@ -540,6 +516,7 @@ const enUS = {
         pnp: {
             title: "PNP Profile",
             noAssessmentBound: "No assessment bound",
+            noAssessmentBoundBody: "Profile, district and test-administration policy have nothing to read, so only an item's requiredTools can grant an accommodation. Pass the assessment to the toolkit's assessment property, or call updateAssessment(...) on the toolkit coordinator.",
             determinationReadOnly: "Determination (read-only)",
             toolsEditor: "Tools Editor",
             enforcement: "PNP enforcement",
@@ -552,6 +529,7 @@ const enUS = {
             resolvedTools: "Resolved Tools (toolkit)",
             provenanceSummary: "Tool Policy Provenance Summary",
             perToolDecisions: "Per-Tool Decisions",
+            policyDiagnostics: "Policy Diagnostics",
             profileReadOnly: "PNP Profile (read-only)",
         },
         /** TTS settings panel. */
@@ -617,12 +595,39 @@ const enUS = {
             previewEnterText: "Enter preview text before starting playback.",
             previewUnavailable: "Cannot preview while this service is unavailable.",
             browserSynthesisUnavailable: "Browser speech synthesis is unavailable.",
-            browserSynthesisEndedEarly: "Browser speech synthesis ended before audio started. Restart the browser and try again.",
-            browserSynthesisQueueFailed: "Browser speech synthesis failed to queue preview audio.",
-            browserPreviewFailed: "Failed to play browser voice preview.",
             ssmlWordTrackingDisabled: "Google SSML preview preserves authored SSML, so word tracking is disabled.",
             applyUnavailable: "Cannot apply settings while this service is unavailable.",
             coordinatorUnavailable: "Toolkit coordinator is not available for text-to-speech updates.",
+            customProviderNotRegistered: "Custom provider '{id}' is not registered.",
+            customProviderNoConfig: "Custom provider '{id}' did not return an apply config.",
+            httpError: "HTTP {status}: {message}",
+            unknownError: "Unknown error",
+            previewRequestFailed: "Preview request failed ({status}).",
+            notAvailable: "n/a",
+            voiceLocal: "local",
+            voiceRemote: "remote",
+            voiceBrowserDefault: "browser default",
+            browserAvailable: {
+                one: "Browser TTS available ({count} voice detected).",
+                other: "Browser TTS available ({count} voices detected).",
+            },
+            pollyAvailable: {
+                one: "AWS Polly available ({count} matching voice, {engine} engine).",
+                other: "AWS Polly available ({count} matching voices, {engine} engine).",
+            },
+            googleAvailable: {
+                one: "Google Cloud TTS available ({count} matching voice).",
+                other: "Google Cloud TTS available ({count} matching voices).",
+            },
+            headerRowReservation: "Item header row reservation: {state}",
+            speedOptionsHelp: "Comma or semicolon-separated multipliers. Include 1 for Normal; leave empty to hide speed controls.",
+            usingSelectedVoice: "Using selected voice: {voice}",
+            autoVoice: "Best available voice (auto): {voice}",
+            autoVoiceWaiting: "Best available voice (auto): waiting for browser voices.",
+            previewHintBrowserSsml: "SSML is unsupported in Browser preview.",
+            previewHintGoogleSsml: "SSML preserved. Tracking disabled.",
+            previewHintCustom: "Tracking enabled when provider returns speech marks.",
+            previewHintTracking: "Tracking enabled while preview plays.",
         },
     },
 };

package/dist/i18n/messages/nl-NL.d.ts

@@ -321,44 +321,20 @@ declare const nlNL: {
         textToSpeech: {
             name: string;
             description: string;
-            toolA11y: string;
-            title: string;
-            initializing: string;
             initFailed: string;
-            selectText: string;
-            speed: string;
-            play: string;
-            pause: string;
-            resume: string;
-            stop: string;
-            speaking: string;
-            paused: string;
-            charactersSelected: {
-                one: string;
-                other: string;
-            };
-            rate: {
-                slow: string;
-                slower: string;
-                normal: string;
-                faster: string;
-                fast: string;
-                veryFast: string;
-            };
             inline: {
                 controlsA11y: string;
                 playbackSpeedA11y: string;
                 rewindA11y: string;
                 fastForwardA11y: string;
                 stopA11y: string;
-                initializing: string;
-                initFailed: string;
                 starting: string;
                 started: string;
                 resumed: string;
                 pausedAnnouncement: string;
                 stopped: string;
                 switchedSection: string;
+                nothingToRead: string;
                 startFailed: string;
                 skippedForward: string;
                 skipForwardFailed: string;
@@ -438,6 +414,7 @@ declare const nlNL: {
         pnp: {
             title: string;
             noAssessmentBound: string;
+            noAssessmentBoundBody: string;
             determinationReadOnly: string;
             toolsEditor: string;
             enforcement: string;
@@ -450,6 +427,7 @@ declare const nlNL: {
             resolvedTools: string;
             provenanceSummary: string;
             perToolDecisions: string;
+            policyDiagnostics: string;
             profileReadOnly: string;
         };
         tts: {
@@ -512,12 +490,39 @@ declare const nlNL: {
             previewEnterText: string;
             previewUnavailable: string;
             browserSynthesisUnavailable: string;
-            browserSynthesisEndedEarly: string;
-            browserSynthesisQueueFailed: string;
-            browserPreviewFailed: string;
             ssmlWordTrackingDisabled: string;
             applyUnavailable: string;
             coordinatorUnavailable: string;
+            customProviderNotRegistered: string;
+            customProviderNoConfig: string;
+            httpError: string;
+            unknownError: string;
+            previewRequestFailed: string;
+            notAvailable: string;
+            voiceLocal: string;
+            voiceRemote: string;
+            voiceBrowserDefault: string;
+            browserAvailable: {
+                one: string;
+                other: string;
+            };
+            pollyAvailable: {
+                one: string;
+                other: string;
+            };
+            googleAvailable: {
+                one: string;
+                other: string;
+            };
+            headerRowReservation: string;
+            speedOptionsHelp: string;
+            usingSelectedVoice: string;
+            autoVoice: string;
+            autoVoiceWaiting: string;
+            previewHintBrowserSsml: string;
+            previewHintGoogleSsml: string;
+            previewHintCustom: string;
+            previewHintTracking: string;
         };
     };
 };