@pie-players/pie-tool-answer-eliminator 1.0.0-beta.0 → 1.0.0-beta.2

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@pie-players/pie-tool-answer-eliminator",
-	"version": "1.0.0-beta.0",
+	"version": "1.0.0-beta.2",
 	"type": "module",
 	"description": "Answer eliminator tool for PIE assessment player - supports process-of-elimination test-taking strategy",
 	"repository": {
@@ -25,10 +25,6 @@
 		".": {
 			"types": "./dist/index.d.ts",
 			"import": "./dist/tool-answer-eliminator.js"
-		},
-		"./adapters/adapter-registry": {
-			"types": "./dist/adapters/adapter-registry.d.ts",
-			"import": "./dist/adapters/adapter-registry.js"
 		}
 	},
 	"customElements": "custom-elements.json",
@@ -41,12 +37,12 @@
 	"unpkg": "./dist/tool-answer-eliminator.js",
 	"jsdelivr": "./dist/tool-answer-eliminator.js",
 	"dependencies": {
-		"@pie-players/pie-assessment-toolkit": "1.0.0-beta.0",
-		"@pie-players/pie-players-shared": "1.0.0-beta.0"
+		"@pie-players/pie-assessment-toolkit": "1.0.0-beta.2",
+		"@pie-players/pie-players-shared": "1.0.0-beta.2"
 	},
 	"types": "./dist/index.d.ts",
 	"scripts": {
-		"build": "vite build && tsc -p tsconfig.adapters.json",
+		"build": "vite build",
 		"dev": "vite build --watch",
 		"test": "bun test tests",
 		"typecheck": "tsc --noEmit",
@@ -57,7 +53,7 @@
 		"@biomejs/biome": "^2.5.15",
 		"@happy-dom/global-registrator": "^20.14.5",
 		"@sveltejs/vite-plugin-svelte": "^7.3.1",
-		"svelte": "^5.57.1",
+		"svelte": "^5.57.2",
 		"svelte-check": "^4.7.6",
 		"typescript": "^5.9.3",
 		"vite": "^8.3.3",

package/dist/adapters/adapter-registry.d.ts

@@ -1,25 +0,0 @@
-import { ChoiceAdapter } from './choice-adapter.js';
-export interface ChoiceWithAdapter {
-    choice: HTMLElement;
-    adapter: ChoiceAdapter;
-}
-/**
- * Registry for choice adapters
- * Automatically detects which adapter to use for different PIE elements
- */
-export declare class AdapterRegistry {
-    private adapters;
-    constructor();
-    /**
-     * Find the appropriate adapter for an element
-     */
-    findAdapter(element: HTMLElement): ChoiceAdapter | null;
-    /**
-     * Find all choices with their adapters within a root element
-     */
-    findAllChoicesWithAdapters(root: HTMLElement): ChoiceWithAdapter[];
-    /**
-     * Register a custom adapter
-     */
-    registerAdapter(adapter: ChoiceAdapter): void;
-}

package/dist/adapters/adapter-registry.js

@@ -1,50 +0,0 @@
-import { EBSRAdapter } from "./ebsr-adapter.js";
-import { InlineDropdownAdapter } from "./inline-dropdown-adapter.js";
-import { MultipleChoiceAdapter } from "./multiple-choice-adapter.js";
-/**
- * Registry for choice adapters
- * Automatically detects which adapter to use for different PIE elements
- */
-export class AdapterRegistry {
-    adapters;
-    constructor() {
-        // Register adapters in priority order (higher priority first)
-        this.adapters = [
-            new MultipleChoiceAdapter(),
-            new EBSRAdapter(),
-            new InlineDropdownAdapter(),
-        ].sort((a, b) => b.priority - a.priority);
-    }
-    /**
-     * Find the appropriate adapter for an element
-     */
-    findAdapter(element) {
-        return this.adapters.find((adapter) => adapter.canHandle(element)) || null;
-    }
-    /**
-     * Find all choices with their adapters within a root element
-     */
-    findAllChoicesWithAdapters(root) {
-        const results = [];
-        const processedChoices = new Set();
-        // Try each adapter
-        for (const adapter of this.adapters) {
-            const choices = adapter.findChoices(root);
-            for (const choice of choices) {
-                // Avoid duplicates (in case adapters overlap)
-                if (processedChoices.has(choice))
-                    continue;
-                processedChoices.add(choice);
-                results.push({ choice, adapter });
-            }
-        }
-        return results;
-    }
-    /**
-     * Register a custom adapter
-     */
-    registerAdapter(adapter) {
-        this.adapters.push(adapter);
-        this.adapters.sort((a, b) => b.priority - a.priority);
-    }
-}

package/dist/adapters/choice-adapter.d.ts

@@ -1,55 +0,0 @@
-/**
- * Adapter interface for detecting and working with choice elements
- * from different PIE element types.
- *
- * Adapters enable the answer eliminator to work generically with
- * multiple-choice, EBSR, inline-dropdown, and future choice elements.
- */
-export interface ChoiceAdapter {
-    /** Element type this adapter handles */
-    readonly elementType: string;
-    /** Priority (higher = checked first) */
-    readonly priority: number;
-    /**
-     * Check if this adapter can handle the given element
-     */
-    canHandle(element: HTMLElement): boolean;
-    /**
-     * Find all choice elements within the root
-     */
-    findChoices(root: HTMLElement): HTMLElement[];
-    /**
-     * Create a Range covering the choice content (for CSS Highlight API)
-     */
-    createChoiceRange(choice: HTMLElement): Range | null;
-    /**
-     * Get unique identifier for this choice (for persistence)
-     */
-    getChoiceId(choice: HTMLElement): string;
-    /**
-     * Get human-readable label (for screen readers)
-     */
-    getChoiceLabel(choice: HTMLElement): string;
-    /**
-     * Check if the choice is currently selected by the student
-     * (radio/checkbox checked). Optional: adapters that support hiding the
-     * eliminate control on a selected choice implement this.
-     */
-    isSelected?(choice: HTMLElement): boolean;
-    /**
-     * Check if choice can be eliminated
-     * (not already selected, not in evaluate mode, etc.)
-     */
-    canEliminate(choice: HTMLElement): boolean;
-    /**
-     * Enable or disable the student's ability to select this choice.
-     * A struck-through choice is made non-selectable (grayed out) so a
-     * student cannot pick an answer they have eliminated. Optional: only
-     * adapters backed by a real input (radio/checkbox) implement this.
-     */
-    setSelectable?(choice: HTMLElement, selectable: boolean): void;
-    /**
-     * Get the container element to attach elimination button
-     */
-    getButtonContainer(choice: HTMLElement): HTMLElement | null;
-}

package/dist/adapters/choice-adapter.js

@@ -1 +0,0 @@
-export {};

package/dist/adapters/ebsr-adapter.d.ts

@@ -1,21 +0,0 @@
-import { ChoiceAdapter } from './choice-adapter.js';
-/**
- * Adapter for EBSR (Evidence-Based Selected Response) elements
- *
- * EBSR contains two multiple-choice questions (Part A and Part B),
- * so we delegate to MultipleChoiceAdapter and prefix IDs with part identifier
- */
-export declare class EBSRAdapter implements ChoiceAdapter {
-    readonly elementType = "ebsr";
-    readonly priority = 110;
-    private mcAdapter;
-    canHandle(element: HTMLElement): boolean;
-    findChoices(root: HTMLElement): HTMLElement[];
-    createChoiceRange(choice: HTMLElement): Range | null;
-    getChoiceId(choice: HTMLElement): string;
-    getChoiceLabel(choice: HTMLElement): string;
-    isSelected(choice: HTMLElement): boolean;
-    canEliminate(choice: HTMLElement): boolean;
-    setSelectable(choice: HTMLElement, selectable: boolean): void;
-    getButtonContainer(choice: HTMLElement): HTMLElement | null;
-}

package/dist/adapters/ebsr-adapter.js

@@ -1,69 +0,0 @@
-import { parseVersionedTagName } from "@pie-players/pie-players-shared/pie/tag-names";
-import { MultipleChoiceAdapter } from "./multiple-choice-adapter.js";
-const EBSR_MULTIPLE_CHOICE_TAG = "ebsr-multiple-choice";
-const isEbsrMultipleChoiceElement = (element) => element instanceof HTMLElement &&
-    parseVersionedTagName(element.tagName.toLowerCase()).baseName ===
-        EBSR_MULTIPLE_CHOICE_TAG;
-const findEbsrMultipleChoicePart = (root, id) => Array.from(root.querySelectorAll(`[id="${id}"]`)).find(isEbsrMultipleChoiceElement) ?? null;
-const findClosestEbsrMultipleChoicePart = (choice) => {
-    let element = choice.parentElement;
-    while (element !== null) {
-        if (isEbsrMultipleChoiceElement(element)) {
-            return element;
-        }
-        element = element.parentElement;
-    }
-    return null;
-};
-/**
- * Adapter for EBSR (Evidence-Based Selected Response) elements
- *
- * EBSR contains two multiple-choice questions (Part A and Part B),
- * so we delegate to MultipleChoiceAdapter and prefix IDs with part identifier
- */
-export class EBSRAdapter {
-    elementType = "ebsr";
-    priority = 110;
-    mcAdapter = new MultipleChoiceAdapter();
-    canHandle(element) {
-        return (element.tagName.toLowerCase() === "ebsr" ||
-            Array.from(element.querySelectorAll("*")).some(isEbsrMultipleChoiceElement));
-    }
-    findChoices(root) {
-        // EBSR contains private multiple-choice elements, version-scoped in modern bundles.
-        // Find choices in both Part A and Part B
-        const partA = findEbsrMultipleChoicePart(root, "a");
-        const partB = findEbsrMultipleChoicePart(root, "b");
-        const choices = [];
-        if (partA)
-            choices.push(...this.mcAdapter.findChoices(partA));
-        if (partB)
-            choices.push(...this.mcAdapter.findChoices(partB));
-        return choices;
-    }
-    // Delegate all other methods to MultipleChoiceAdapter
-    createChoiceRange(choice) {
-        return this.mcAdapter.createChoiceRange(choice);
-    }
-    getChoiceId(choice) {
-        // Prefix with part ID (a or b)
-        const part = findClosestEbsrMultipleChoicePart(choice)?.id || "unknown";
-        const choiceId = this.mcAdapter.getChoiceId(choice);
-        return `${part}-${choiceId}`;
-    }
-    getChoiceLabel(choice) {
-        return this.mcAdapter.getChoiceLabel(choice);
-    }
-    isSelected(choice) {
-        return this.mcAdapter.isSelected(choice);
-    }
-    canEliminate(choice) {
-        return this.mcAdapter.canEliminate(choice);
-    }
-    setSelectable(choice, selectable) {
-        this.mcAdapter.setSelectable(choice, selectable);
-    }
-    getButtonContainer(choice) {
-        return this.mcAdapter.getButtonContainer(choice);
-    }
-}

package/dist/adapters/inline-dropdown-adapter.d.ts

@@ -1,17 +0,0 @@
-import { ChoiceAdapter } from './choice-adapter.js';
-/**
- * Adapter for PIE inline-dropdown elements
- *
- * Works with dropdown menu items (role="option")
- */
-export declare class InlineDropdownAdapter implements ChoiceAdapter {
-    readonly elementType = "inline-dropdown";
-    readonly priority = 90;
-    canHandle(element: HTMLElement): boolean;
-    findChoices(root: HTMLElement): HTMLElement[];
-    createChoiceRange(choice: HTMLElement): Range | null;
-    getChoiceId(choice: HTMLElement): string;
-    getChoiceLabel(choice: HTMLElement): string;
-    canEliminate(choice: HTMLElement): boolean;
-    getButtonContainer(choice: HTMLElement): HTMLElement | null;
-}

package/dist/adapters/inline-dropdown-adapter.js

@@ -1,35 +0,0 @@
-/**
- * Adapter for PIE inline-dropdown elements
- *
- * Works with dropdown menu items (role="option")
- */
-export class InlineDropdownAdapter {
-    elementType = "inline-dropdown";
-    priority = 90;
-    canHandle(element) {
-        return (element.tagName.toLowerCase() === "inline-dropdown" ||
-            element.querySelector('[role="combobox"]') !== null);
-    }
-    findChoices(root) {
-        // Find dropdown menu items
-        return Array.from(root.querySelectorAll('[role="option"]'));
-    }
-    createChoiceRange(choice) {
-        const range = document.createRange();
-        range.selectNodeContents(choice);
-        return range;
-    }
-    getChoiceId(choice) {
-        return choice.id || choice.getAttribute("data-value") || "";
-    }
-    getChoiceLabel(choice) {
-        return choice.textContent?.trim() || "Unlabeled option";
-    }
-    canEliminate(choice) {
-        // Can't eliminate if already selected
-        return choice.getAttribute("aria-selected") !== "true";
-    }
-    getButtonContainer(choice) {
-        return choice;
-    }
-}

package/dist/adapters/multiple-choice-adapter.d.ts

@@ -1,31 +0,0 @@
-import { ChoiceAdapter } from './choice-adapter.js';
-/**
- * Adapter for PIE multiple-choice elements
- *
- * Works with both single-select (radio) and multiple-select (checkbox) modes
- * Detects PIE's corespring-checkbox and corespring-radio-button classes
- */
-export declare class MultipleChoiceAdapter implements ChoiceAdapter {
-    readonly elementType = "multiple-choice";
-    readonly priority = 100;
-    private static readonly CHOICE_HOOK_ATTR;
-    private static readonly LABEL_HOOK_ATTR;
-    private static readonly ROOT_HOOK_ATTR;
-    private static readonly FEEDBACK_HOOK_ATTR;
-    private static readonly CHOICE_SELECTOR;
-    private static readonly MUI_BUTTON_SELECTOR;
-    private static readonly MUI_DISABLED_CLASS;
-    canHandle(element: HTMLElement): boolean;
-    findChoices(root: HTMLElement): HTMLElement[];
-    createChoiceRange(choice: HTMLElement): Range | null;
-    getChoiceId(choice: HTMLElement): string;
-    getChoiceLabel(choice: HTMLElement): string;
-    isSelected(choice: HTMLElement): boolean;
-    canEliminate(choice: HTMLElement): boolean;
-    setSelectable(choice: HTMLElement, selectable: boolean): void;
-    getButtonContainer(choice: HTMLElement): HTMLElement | null;
-    private generateFallbackId;
-    private annotateChoice;
-    private resolveLabelElement;
-    private annotateFeedbackTicks;
-}

package/dist/adapters/multiple-choice-adapter.js

@@ -1,130 +0,0 @@
-/**
- * Adapter for PIE multiple-choice elements
- *
- * Works with both single-select (radio) and multiple-select (checkbox) modes
- * Detects PIE's corespring-checkbox and corespring-radio-button classes
- */
-export class MultipleChoiceAdapter {
-    elementType = "multiple-choice";
-    priority = 100;
-    static CHOICE_HOOK_ATTR = "data-pie-answer-eliminator-choice";
-    static LABEL_HOOK_ATTR = "data-pie-answer-eliminator-label";
-    static ROOT_HOOK_ATTR = "data-pie-answer-eliminator-root";
-    static FEEDBACK_HOOK_ATTR = "data-pie-answer-eliminator-feedback-tick";
-    static CHOICE_SELECTOR = `[${MultipleChoiceAdapter.CHOICE_HOOK_ATTR}="true"], .corespring-checkbox, .corespring-radio-button`;
-    // Material-UI radio/checkbox controls gray out via the `Mui-disabled`
-    // class on the button root; toggling the native `disabled` alone doesn't
-    // restyle them.
-    static MUI_BUTTON_SELECTOR = ".MuiButtonBase-root, .MuiRadio-root, .MuiCheckbox-root";
-    static MUI_DISABLED_CLASS = "Mui-disabled";
-    canHandle(element) {
-        return (element.tagName.toLowerCase() === "multiple-choice" ||
-            element.classList.contains("multiple-choice"));
-    }
-    findChoices(root) {
-        root.setAttribute(MultipleChoiceAdapter.ROOT_HOOK_ATTR, "true");
-        const choices = Array.from(root.querySelectorAll(MultipleChoiceAdapter.CHOICE_SELECTOR));
-        for (const choice of choices) {
-            this.annotateChoice(choice);
-        }
-        this.annotateFeedbackTicks(root);
-        return choices;
-    }
-    createChoiceRange(choice) {
-        // Create range covering the label content
-        // Try multiple possible selectors for the label
-        const labelElement = this.resolveLabelElement(choice);
-        if (!labelElement) {
-            return null;
-        }
-        const range = document.createRange();
-        range.selectNodeContents(labelElement);
-        return range;
-    }
-    getChoiceId(choice) {
-        // Get value from input element
-        const input = choice.querySelector('input[type="checkbox"], input[type="radio"]');
-        return (input?.getAttribute("value") ||
-            input?.id ||
-            this.generateFallbackId(choice));
-    }
-    getChoiceLabel(choice) {
-        const label = this.resolveLabelElement(choice);
-        return label?.textContent?.trim() || "Unlabeled choice";
-    }
-    isSelected(choice) {
-        const input = choice.querySelector('input[type="checkbox"], input[type="radio"]');
-        if (!input)
-            return false;
-        // Prefer the live `checked` property (works for radio and checkbox);
-        // fall back to the aria-checked attribute for custom/ARIA widgets.
-        return input.checked || input.getAttribute("aria-checked") === "true";
-    }
-    canEliminate(choice) {
-        const input = choice.querySelector('input[type="checkbox"], input[type="radio"]');
-        if (!input)
-            return false;
-        // Can't eliminate if:
-        // 1. Already selected (checked)
-        if (this.isSelected(choice))
-            return false;
-        // 2. Disabled
-        if (input.disabled)
-            return false;
-        // 3. In evaluate/view mode (has feedback tick)
-        const root = choice.closest(`[${MultipleChoiceAdapter.ROOT_HOOK_ATTR}="true"]`) ||
-            choice.closest("multiple-choice");
-        if (root?.querySelector(`[${MultipleChoiceAdapter.FEEDBACK_HOOK_ATTR}="true"]`))
-            return false;
-        return true;
-    }
-    setSelectable(choice, selectable) {
-        const input = choice.querySelector('input[type="checkbox"], input[type="radio"]');
-        if (!input)
-            return;
-        // Native `disabled` makes the control non-selectable and grays it out;
-        // aria-disabled keeps the state exposed to assistive tech.
-        input.disabled = !selectable;
-        if (selectable) {
-            input.removeAttribute("aria-disabled");
-        }
-        else {
-            input.setAttribute("aria-disabled", "true");
-        }
-        // If the input lives inside a Material-UI control, mirror MUI's own
-        // disabled styling by toggling `Mui-disabled` on the button root.
-        const muiButton = input.closest(MultipleChoiceAdapter.MUI_BUTTON_SELECTOR);
-        if (muiButton) {
-            muiButton.classList.toggle(MultipleChoiceAdapter.MUI_DISABLED_CLASS, !selectable);
-        }
-    }
-    getButtonContainer(choice) {
-        // Return the choice-input container
-        return choice;
-    }
-    generateFallbackId(choice) {
-        // Generate stable ID based on choice position
-        const parent = choice.closest(`[${MultipleChoiceAdapter.ROOT_HOOK_ATTR}="true"]`) ||
-            choice.closest("multiple-choice");
-        const choices = parent?.querySelectorAll(`[${MultipleChoiceAdapter.CHOICE_HOOK_ATTR}="true"]`) || [];
-        const index = Array.from(choices).indexOf(choice);
-        return `choice-${index}`;
-    }
-    annotateChoice(choice) {
-        choice.setAttribute(MultipleChoiceAdapter.CHOICE_HOOK_ATTR, "true");
-        const label = this.resolveLabelElement(choice);
-        if (label) {
-            label.setAttribute(MultipleChoiceAdapter.LABEL_HOOK_ATTR, "true");
-        }
-    }
-    resolveLabelElement(choice) {
-        return (choice.querySelector(`[${MultipleChoiceAdapter.LABEL_HOOK_ATTR}="true"]`) ||
-            choice.querySelector("label") ||
-            choice.querySelector("span"));
-    }
-    annotateFeedbackTicks(root) {
-        for (const feedbackTick of root.querySelectorAll(".feedback-tick")) {
-            feedbackTick.setAttribute(MultipleChoiceAdapter.FEEDBACK_HOOK_ATTR, "true");
-        }
-    }
-}