@pie-players/pie-tool-answer-eliminator 0.3.50 → 0.3.52

package/README.md

@@ -179,18 +179,21 @@ if (saved) {
 
 ### 1. Choice Detection
 
-The tool automatically detects answer choices within the scoped element:
+The tool detects choices through an **adapter registry** (`AdapterRegistry`), not a fixed selector list. Each adapter knows how to find and operate on choices for a specific PIE element type, and the registry runs them in priority order (`canHandle()`, then `findChoices()`), so a single question can mix element types:
+
+| Adapter | Element type | How it finds choices |
+| --- | --- | --- |
+| `MultipleChoiceAdapter` | `multiple-choice` (single- or multi-select) | `.corespring-checkbox` / `.corespring-radio-button` choices |
+| `EBSRAdapter` | `ebsr` | delegates to the multiple-choice adapter for each `ebsr-multiple-choice` part (Part A/B), prefixing choice IDs with the part |
+| `InlineDropdownAdapter` | `inline-dropdown` | dropdown items with `role="option"` |
+
+Support more element types at runtime by registering your own adapter (any object implementing the `ChoiceAdapter` interface: `canHandle`, `findChoices`, `getChoiceId`, `getChoiceLabel`, `canEliminate`, `createChoiceRange`, `getButtonContainer`):
 
 ```typescript
-// Searches for choice elements with these patterns
-const choiceSelectors = [
-  '[data-choice-id]',           // PIE standard
-  '.choice',                     // Common class
-  '[role="radio"]',              // Accessibility
-  '[role="checkbox"]',           // Accessibility
-  'input[type="radio"]',         // Native inputs
-  'input[type="checkbox"]'       // Native inputs
-];
+import { AdapterRegistry } from '@pie-players/pie-tool-answer-eliminator';
+
+const registry = new AdapterRegistry();
+registry.registerAdapter(myCustomChoiceAdapter);
 ```
 
 ### 2. State Storage
@@ -205,26 +208,16 @@ Eliminated choices are stored by choice ID:
 
 ### 3. Visual Feedback
 
-Eliminated choices receive the `eliminated` CSS class:
-
-```css
-.choice.eliminated {
-  text-decoration: line-through;
-  opacity: 0.5;
-}
-```
+Elimination styling is applied by a pluggable `EliminationStrategy` built on the **CSS Custom Highlight API** (zero DOM mutation, so the choice text and structure stay intact for screen readers). Two strategies ship today:
 
-### 4. Toggle Behavior
+- `strikethrough` (default): a `::highlight(pie-answer-eliminated-<id>)` rule renders a line-through over the choice label.
+- `mask`: a `::highlight(pie-answer-masked-<id>)` rule dims and blurs the choice.
 
-Clicking a choice toggles its elimination state:
+For browsers without the Highlight API, each strategy falls back to a class on the choice container. Either way the eliminated choice also receives ARIA hooks (`data-pie-answer-eliminated`, plus `aria-disabled`/`aria-hidden` and an offscreen "(eliminated)" announcement) for assistive technology.
 
-```typescript
-// First click: eliminate
-choiceElement.classList.add('eliminated');
+### 4. Toggle Behavior
 
-// Second click: restore
-choiceElement.classList.remove('eliminated');
-```
+Each detected choice gets its own elimination toggle button (class `pie-answer-eliminator-toggle`, rendered as `⊗`) placed via the adapter's `getButtonContainer()`. Clicking the button toggles that choice through the active strategy. Eliminating is blocked when the adapter's `canEliminate()` returns false — for example when the choice is already selected, disabled, or the item is in evaluate/view mode. An active button is marked with `pie-answer-eliminator-toggle--active` and `aria-pressed="true"`; clicking again restores the choice.
 
 ## Cleanup
 

package/dist/{dist-DfQrc9XY.js → dist-BV1q85ZL.js}

@@ -37,22 +37,20 @@ function R(t) {
 var I = (t) => {
   const e = (t.providerOptions && typeof t.providerOptions == "object" ? t.providerOptions : {}).__pieTelemetry;
   return typeof e == "function" ? e : void 0;
-}, E = {
+}, M = {
   pie: 3e3,
   custom: 3e3
-}, M = /* @__PURE__ */ new Set(["polly", "google"]), P = (t) => {
+}, P = /* @__PURE__ */ new Set(["polly", "google"]), O = (t) => {
   if (!t || b(t) !== "pie") return !1;
   const e = (t.provider || "polly").toLowerCase();
-  return M.has(e);
-}, S = (t) => t.replace(/\/+$/, ""), O = (t) => {
+  return P.has(e);
+}, S = (t) => t.replace(/\/+$/, ""), U = (t) => {
   const e = S(t.apiEndpoint), r = (t.provider || "").toLowerCase();
   return r === "polly" || r === "google" ? `${e}/${r}/voices` : `${e}/voices`;
-}, b = (t) => t.transportMode === "custom" ? "custom" : t.transportMode === "pie" ? "pie" : t.provider === "custom" ? "custom" : "pie", k = (t, e) => t.endpointMode ? t.endpointMode : e === "custom" ? "rootPost" : "synthesizePath", U = (t, e) => t.endpointValidationMode ? t.endpointValidationMode : e === "custom" ? "none" : "voices", L = (t) => {
+}, b = (t) => t.transportMode === "custom" ? "custom" : t.transportMode === "pie" ? "pie" : t.provider === "custom" ? "custom" : "pie", k = (t, e) => t.endpointMode ? t.endpointMode : e === "custom" ? "rootPost" : "synthesizePath", L = (t, e) => t.endpointValidationMode ? t.endpointValidationMode : e === "custom" ? "none" : "voices", E = (t) => Number.isFinite(t) ? t < 1 ? "slow" : t > 1 ? "fast" : "medium" : "medium", B = (t) => {
   const e = t.providerOptions || {};
-  if (typeof e.speedRate == "string") return e.speedRate;
-  const r = Number(t.rate ?? 1);
-  return !Number.isFinite(r) || r <= 0.95 ? "slow" : r >= 1.5 ? "fast" : "medium";
-}, B = (t) => {
+  return typeof e.speedRate == "string" ? e.speedRate : E(Number(t.rate ?? 1));
+}, C = (t) => {
   const e = [];
   let r = 0;
   const i = t.split(`
@@ -69,7 +67,7 @@ var I = (t) => {
   } catch {
   }
   return e;
-}, C = (t) => {
+}, z = (t) => {
   if (!Array.isArray(t)) return [];
   const e = [];
   let r = 0;
@@ -85,7 +83,7 @@ var I = (t) => {
     });
   }
   return e.sort((i, o) => i.time !== o.time ? i.time - o.time : i.start !== o.start ? i.start - o.start : i.end - o.end);
-}, z = {
+}, x = {
   pie: {
     id: "pie",
     resolveSynthesisUrl: (t) => {
@@ -129,7 +127,7 @@ var I = (t) => {
       const r = e.providerOptions || {}, i = typeof r.lang_id == "string" ? r.lang_id : e.language || "en-US", o = typeof r.cache == "boolean" ? r.cache : !0;
       return {
         text: t,
-        speedRate: L(e),
+        speedRate: B(e),
         lang_id: i,
         cache: o
       };
@@ -139,7 +137,7 @@ var I = (t) => {
       if (e.includeAuthOnAssetFetch)
         for (const [l, u] of Object.entries(r)) l.toLowerCase() === "authorization" && (s[l] = u);
       let a = [];
-      const n = C(o.speechMarks);
+      const n = z(o.speechMarks);
       if (n.length > 0) a = n;
       else if (typeof o.word == "string" && o.word.length > 0) {
         const l = T(o.word, e);
@@ -149,7 +147,7 @@ var I = (t) => {
             signal: i,
             redirect: "error"
           });
-          y.ok && (a = B(await y.text()));
+          y.ok && (a = C(await y.text()));
         }
       }
       const h = T(o.audioContent, e);
@@ -163,7 +161,7 @@ var I = (t) => {
       };
     }
   }
-}, x = class {
+}, N = class {
   constructor(t, e) {
     d(this, "config", void 0), d(this, "adapter", void 0), d(this, "currentAudio", null), d(this, "pausedState", !1), d(this, "wordTimings", []), d(this, "highlightInterval", null), d(this, "intentionallyStopped", !1), d(this, "activeSynthesisController", null), d(this, "synthesisRunId", 0), d(this, "telemetryReporter", void 0), d(this, "onWordBoundary", void 0), this.config = t, this.adapter = e, this.telemetryReporter = I(t);
   }
@@ -390,9 +388,12 @@ var I = (t) => {
     return this.pausedState;
   }
   updateSettings(t) {
-    t.rate !== void 0 && (this.config.rate = t.rate), t.pitch !== void 0 && (this.config.pitch = t.pitch), t.voice !== void 0 && (this.config.voice = t.voice);
+    t.rate !== void 0 && (this.config.rate = t.rate, this.config.providerOptions = {
+      ...this.config.providerOptions || {},
+      speedRate: E(Number(t.rate))
+    }), t.pitch !== void 0 && (this.config.pitch = t.pitch), t.voice !== void 0 && (this.config.voice = t.voice);
   }
-}, N = class {
+}, F = class {
   constructor() {
     d(this, "providerId", "server-tts"), d(this, "providerName", "Server TTS"), d(this, "version", "1.0.0"), d(this, "config", null), d(this, "adapter", null), d(this, "telemetryReporter", void 0);
   }
@@ -408,7 +409,7 @@ var I = (t) => {
     if (!e.apiEndpoint) throw new Error("apiEndpoint is required for ServerTTSProvider");
     this.config = e, this.telemetryReporter = I(e);
     const r = b(e);
-    if (this.adapter = z[r], e.validateEndpoint) {
+    if (this.adapter = x[r], e.validateEndpoint) {
       const i = Date.now();
       if (await this.emitTelemetry("pie-tool-backend-call-start", {
         toolId: "tts",
@@ -430,17 +431,17 @@ var I = (t) => {
         duration: Date.now() - i
       });
     }
-    return new x(e, this.adapter);
+    return new N(e, this.adapter);
   }
   async testAPIAvailability() {
     if (!this.config || !this.adapter) return !1;
     try {
       const t = { ...this.config.headers };
       this.config.authToken && (t.Authorization = `Bearer ${this.config.authToken}`);
-      const e = new AbortController(), r = setTimeout(() => e.abort(), 5e3), i = U(this.config, this.adapter.id);
+      const e = new AbortController(), r = setTimeout(() => e.abort(), 5e3), i = L(this.config, this.adapter.id);
       if (i === "none")
         return clearTimeout(r), !0;
-      const o = i === "voices" ? O(this.config) : this.adapter.resolveSynthesisUrl(this.config), s = i === "voices" ? "GET" : "OPTIONS";
+      const o = i === "voices" ? U(this.config) : this.adapter.resolveSynthesisUrl(this.config), s = i === "voices" ? "GET" : "OPTIONS";
       try {
         const a = await fetch(o, {
           method: s,
@@ -478,8 +479,8 @@ var I = (t) => {
       supportsVoiceSelection: !0,
       supportsRateControl: !0,
       supportsPitchControl: !1,
-      supportsSSML: P(this.config),
-      maxTextLength: E[t]
+      supportsSSML: O(this.config),
+      maxTextLength: M[t]
     };
   }
   destroy() {
@@ -487,5 +488,5 @@ var I = (t) => {
   }
 };
 export {
-  N as ServerTTSProvider
+  F as ServerTTSProvider
 };