@pie-players/pie-assessment-toolkit 0.2.2 → 0.2.4

package/dist/tools/registrations/accessibility-tools.js

@@ -0,0 +1,230 @@
+/**
+ * Accessibility Tools Registrations
+ *
+ * Registers tools for visual accessibility and reading support:
+ * - Magnifier (zoom lens)
+ * - Line Reader (reading guide)
+ * - Color Scheme (theme/contrast)
+ * - Annotation Toolbar (text highlighting)
+ *
+ * Maps to QTI 3.0 standard access features from:
+ * - visual category: magnification, highContrastDisplay, colorContrast
+ * - reading category: readingMask, readingGuide, highlighting
+ */
+import { hasReadableText } from "../../services/tool-context";
+import { createToolElement, } from "../tool-tag-map";
+/**
+ * Magnifier tool registration
+ *
+ * Provides a draggable zoom lens for visual accessibility.
+ * Global tool that works across entire assessment.
+ */
+export const magnifierToolRegistration = {
+    toolId: "magnifier",
+    name: "Magnifier",
+    description: "Zoom lens for visual accessibility",
+    icon: "magnifying-glass",
+    // Magnifier is assessment-wide (global)
+    supportedLevels: ["assessment", "section"],
+    // PNP support IDs
+    // Maps to QTI 3.0 standard features: magnification, screenMagnifier, zoomable
+    pnpSupportIds: [
+        "magnification", // QTI 3.0 standard (visual.magnification)
+        "screenMagnifier", // QTI 3.0 standard (visual.screenMagnifier)
+        "zoomable", // QTI 3.0 standard (visual.zoomable)
+        "magnifier", // Common variant
+        "zoom", // Common variant
+        "visualZoom", // Common variant
+    ],
+    /**
+     * Pass 2: Magnifier is always relevant when allowed
+     */
+    isVisibleInContext(context) {
+        return true; // Always show if allowed by orchestrator
+    },
+    createButton(context, options) {
+        return {
+            toolId: this.toolId,
+            label: this.name,
+            icon: typeof this.icon === "function" ? this.icon(context) : this.icon,
+            disabled: options.disabled || false,
+            ariaLabel: options.ariaLabel || "Magnifier - Zoom in on content",
+            tooltip: options.tooltip || "Magnifier",
+            onClick: options.onClick || (() => { }),
+            className: options.className,
+        };
+    },
+    createToolInstance(context, options) {
+        const componentOverrides = options.config ?? {};
+        const magnifier = createToolElement(this.toolId, context, options, componentOverrides);
+        magnifier.visible = true;
+        if (options.config?.toolkitCoordinator) {
+            magnifier.toolkitCoordinator = options.config.toolkitCoordinator;
+        }
+        if (options.onClose) {
+            magnifier.addEventListener("close", options.onClose);
+        }
+        return magnifier;
+    },
+};
+/**
+ * Line Reader tool registration
+ *
+ * Provides a reading guide overlay to help track reading position.
+ * Useful for text-heavy passages and questions.
+ */
+export const lineReaderToolRegistration = {
+    toolId: "lineReader",
+    name: "Line Reader",
+    description: "Reading guide overlay",
+    icon: "bars-3",
+    // Line reader appears where there's text to read
+    supportedLevels: ["passage", "rubric", "item"],
+    // PNP support IDs
+    // Maps to QTI 3.0 standard features: readingMask, readingGuide, readingRuler
+    pnpSupportIds: [
+        "readingMask", // QTI 3.0 standard (reading.readingMask)
+        "readingGuide", // QTI 3.0 standard (reading.readingGuide)
+        "readingRuler", // QTI 3.0 standard (reading.readingRuler)
+        "lineReader", // Common variant
+        "trackingGuide", // Common variant
+    ],
+    /**
+     * Pass 2: Line reader is relevant when readable text is present
+     */
+    isVisibleInContext(context) {
+        return hasReadableText(context);
+    },
+    createButton(context, options) {
+        return {
+            toolId: this.toolId,
+            label: this.name,
+            icon: typeof this.icon === "function" ? this.icon(context) : this.icon,
+            disabled: options.disabled || false,
+            ariaLabel: options.ariaLabel || "Line reader - Reading guide",
+            tooltip: options.tooltip || "Line Reader",
+            onClick: options.onClick || (() => { }),
+            className: options.className,
+        };
+    },
+    createToolInstance(context, options) {
+        const componentOverrides = options.config ?? {};
+        const lineReader = createToolElement(this.toolId, context, options, componentOverrides);
+        lineReader.visible = true;
+        if (options.config?.toolkitCoordinator) {
+            lineReader.toolkitCoordinator = options.config.toolkitCoordinator;
+        }
+        if (options.onClose) {
+            lineReader.addEventListener("close", options.onClose);
+        }
+        return lineReader;
+    },
+};
+/**
+ * Color Scheme tool registration
+ *
+ * Provides Learnosity-standard accessible color schemes and theme controls.
+ * Global tool that affects entire assessment.
+ */
+export const colorSchemeToolRegistration = {
+    toolId: "colorScheme",
+    name: "Color Scheme",
+    description: "Accessible color themes and contrast",
+    icon: "swatch",
+    // Color scheme is assessment-wide
+    supportedLevels: ["assessment", "section"],
+    // PNP support IDs
+    // Maps to QTI 3.0 standard features: highContrastDisplay, colorContrast, invertColors
+    pnpSupportIds: [
+        "highContrastDisplay", // QTI 3.0 standard (visual.highContrastDisplay)
+        "colorContrast", // QTI 3.0 standard (visual.colorContrast)
+        "invertColors", // QTI 3.0 standard (visual.invertColors)
+        "colorScheme", // Common variant
+        "highContrast", // Common variant
+        "customColors", // Common variant
+    ],
+    /**
+     * Pass 2: Color scheme is always relevant when allowed
+     */
+    isVisibleInContext(context) {
+        return true; // Always show if allowed by orchestrator
+    },
+    createButton(context, options) {
+        return {
+            toolId: this.toolId,
+            label: this.name,
+            icon: typeof this.icon === "function" ? this.icon(context) : this.icon,
+            disabled: options.disabled || false,
+            ariaLabel: options.ariaLabel || "Color scheme - Change colors and contrast",
+            tooltip: options.tooltip || "Color Scheme",
+            onClick: options.onClick || (() => { }),
+            className: options.className,
+        };
+    },
+    createToolInstance(context, options) {
+        const componentOverrides = options.config ?? {};
+        const colorScheme = createToolElement(this.toolId, context, options, componentOverrides);
+        colorScheme.visible = true;
+        if (options.config?.toolkitCoordinator) {
+            colorScheme.toolkitCoordinator = options.config.toolkitCoordinator;
+        }
+        if (options.onClose) {
+            colorScheme.addEventListener("close", options.onClose);
+        }
+        return colorScheme;
+    },
+};
+/**
+ * Annotation Toolbar registration
+ *
+ * Text highlighting with CSS Custom Highlight API.
+ * Zero DOM mutation, optimal performance.
+ */
+export const annotationToolbarRegistration = {
+    toolId: "annotationToolbar",
+    name: "Highlighter",
+    description: "Highlight and annotate text",
+    icon: "highlighter",
+    // Annotation appears where there's text content
+    supportedLevels: ["passage", "rubric", "item", "element"],
+    // PNP support IDs
+    // Maps to QTI 3.0 standard features: highlighting, annotations
+    pnpSupportIds: [
+        "highlighting", // QTI 3.0 standard (cognitive.highlighting / reading.wordHighlighting)
+        "annotations", // QTI 3.0 standard (cognitive.annotations)
+        "highlighter", // Common variant
+        "textHighlight", // Common variant
+        "annotation", // Common variant
+    ],
+    /**
+     * Pass 2: Annotation is relevant when readable text is present
+     */
+    isVisibleInContext(context) {
+        return hasReadableText(context);
+    },
+    createButton(context, options) {
+        return {
+            toolId: this.toolId,
+            label: this.name,
+            icon: typeof this.icon === "function" ? this.icon(context) : this.icon,
+            disabled: options.disabled || false,
+            ariaLabel: options.ariaLabel || "Annotation toolbar - Highlight text",
+            tooltip: options.tooltip || "Highlight",
+            onClick: options.onClick || (() => { }),
+            className: options.className,
+        };
+    },
+    createToolInstance(context, options) {
+        const componentOverrides = options.config ?? {};
+        const toolbar = createToolElement(this.toolId, context, options, componentOverrides);
+        toolbar.visible = true;
+        if (options.config?.toolkitCoordinator) {
+            toolbar.toolkitCoordinator = options.config.toolkitCoordinator;
+        }
+        if (options.onClose) {
+            toolbar.addEventListener("close", options.onClose);
+        }
+        return toolbar;
+    },
+};
+//# sourceMappingURL=accessibility-tools.js.map

package/dist/tools/registrations/accessibility-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"accessibility-tools.js","sourceRoot":"","sources":["../../../src/tools/registrations/accessibility-tools.ts"],"names":[],"mappings":"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"}

package/dist/tools/registrations/calculator.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Calculator Tool Registration
+ *
+ * Registers the calculator tool with support for multiple calculator types
+ * (basic, scientific, graphing) via Desmos provider.
+ *
+ * Maps to QTI 3.0 standard access features:
+ * - calculator (cognitive support)
+ * - graphingCalculator (assessment tool)
+ */
+import type { ToolRegistration } from "../../services/ToolRegistry";
+/**
+ * Calculator tool registration
+ *
+ * Supports:
+ * - Basic, scientific, and graphing calculators via Desmos
+ * - Context-aware visibility (shows when math content is detected)
+ * - All levels except assessment (section, item, passage, rubric, element)
+ */
+export declare const calculatorToolRegistration: ToolRegistration;
+//# sourceMappingURL=calculator.d.ts.map

package/dist/tools/registrations/calculator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"calculator.d.ts","sourceRoot":"","sources":["../../../src/tools/registrations/calculator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EACX,gBAAgB,EAIhB,MAAM,6BAA6B,CAAC;AAQrC;;;;;;;GAOG;AACH,eAAO,MAAM,0BAA0B,EAAE,gBA4GxC,CAAC"}

package/dist/tools/registrations/calculator.js

@@ -0,0 +1,98 @@
+/**
+ * Calculator Tool Registration
+ *
+ * Registers the calculator tool with support for multiple calculator types
+ * (basic, scientific, graphing) via Desmos provider.
+ *
+ * Maps to QTI 3.0 standard access features:
+ * - calculator (cognitive support)
+ * - graphingCalculator (assessment tool)
+ */
+import { hasMathContent } from "../../services/tool-context";
+import { createToolElement, } from "../tool-tag-map";
+/**
+ * Calculator tool registration
+ *
+ * Supports:
+ * - Basic, scientific, and graphing calculators via Desmos
+ * - Context-aware visibility (shows when math content is detected)
+ * - All levels except assessment (section, item, passage, rubric, element)
+ */
+export const calculatorToolRegistration = {
+    toolId: "calculator",
+    name: "Calculator",
+    description: "Multi-type calculator (basic, scientific, graphing)",
+    icon: "calculator",
+    // Calculator can appear at all levels except assessment
+    supportedLevels: ["section", "item", "passage", "rubric", "element"],
+    // PNP support IDs that enable this tool
+    // Maps to QTI 3.0 standard features: calculator, graphingCalculator
+    pnpSupportIds: [
+        "calculator", // QTI 3.0 standard (cognitive.calculator)
+        "graphingCalculator", // QTI 3.0 standard (assessment.graphingCalculator)
+        "basicCalculator", // Common variant
+        "scientificCalculator", // Common variant
+    ],
+    /**
+     * Pass 2: Determine if calculator is relevant in this context
+     *
+     * Calculator is relevant when:
+     * - Context contains mathematical content (MathML, LaTeX, arithmetic)
+     * - Section/item level (always show - student might need for any problem)
+     */
+    isVisibleInContext(context) {
+        // At section/item level, always show (student might need it)
+        if (context.level === "section" || context.level === "item") {
+            return true;
+        }
+        // At passage/rubric/element level, show if math content detected
+        return hasMathContent(context);
+    },
+    /**
+     * Create calculator button for toolbar
+     */
+    createButton(context, options) {
+        const icon = typeof this.icon === "function" ? this.icon(context) : this.icon;
+        return {
+            toolId: this.toolId,
+            label: this.name,
+            icon: icon,
+            disabled: options.disabled || false,
+            ariaLabel: options.ariaLabel ||
+                "Open calculator - Press to activate calculator tool",
+            tooltip: options.tooltip || "Calculator",
+            onClick: options.onClick || (() => { }),
+            className: options.className,
+        };
+    },
+    /**
+     * Create calculator tool instance
+     *
+     * Creates a <pie-tool-calculator> web component and initializes it.
+     */
+    createToolInstance(context, options) {
+        const componentOverrides = options.config ?? {};
+        const calculator = createToolElement(this.toolId, context, options, componentOverrides);
+        // Set default calculator type (can be overridden via config)
+        const calculatorType = options.config?.calculatorType || "scientific";
+        const availableTypes = options.config?.availableTypes || [
+            "basic",
+            "scientific",
+            "graphing",
+        ];
+        // Configure calculator
+        calculator.visible = true;
+        calculator.calculatorType = calculatorType;
+        calculator.availableTypes = availableTypes;
+        // Pass toolkit coordinator if available from context
+        if (options.config?.toolkitCoordinator) {
+            calculator.toolkitCoordinator = options.config.toolkitCoordinator;
+        }
+        // Handle close callback
+        if (options.onClose) {
+            calculator.addEventListener("close", options.onClose);
+        }
+        return calculator;
+    },
+};
+//# sourceMappingURL=calculator.js.map

package/dist/tools/registrations/calculator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"calculator.js","sourceRoot":"","sources":["../../../src/tools/registrations/calculator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AASH,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EACN,iBAAiB,GAEjB,MAAM,iBAAiB,CAAC;AAEzB;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAqB;IAC3D,MAAM,EAAE,YAAY;IACpB,IAAI,EAAE,YAAY;IAClB,WAAW,EAAE,qDAAqD;IAClE,IAAI,EAAE,YAAY;IAElB,wDAAwD;IACxD,eAAe,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,CAAC;IAEpE,wCAAwC;IACxC,oEAAoE;IACpE,aAAa,EAAE;QACd,YAAY,EAAE,0CAA0C;QACxD,oBAAoB,EAAE,mDAAmD;QACzE,iBAAiB,EAAE,iBAAiB;QACpC,sBAAsB,EAAE,iBAAiB;KACzC;IAED;;;;;;OAMG;IACH,kBAAkB,CAAC,OAAoB;QACtC,6DAA6D;QAC7D,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS,IAAI,OAAO,CAAC,KAAK,KAAK,MAAM,EAAE,CAAC;YAC7D,OAAO,IAAI,CAAC;QACb,CAAC;QAED,iEAAiE;QACjE,OAAO,cAAc,CAAC,OAAO,CAAC,CAAC;IAChC,CAAC;IAED;;OAEG;IACH,YAAY,CACX,OAAoB,EACpB,OAA0B;QAE1B,MAAM,IAAI,GACT,OAAO,IAAI,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QAElE,OAAO;YACN,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,KAAK,EAAE,IAAI,CAAC,IAAI;YAChB,IAAI,EAAE,IAAI;YACV,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,KAAK;YACnC,SAAS,EACR,OAAO,CAAC,SAAS;gBACjB,qDAAqD;YACtD,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,YAAY;YACxC,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC;YACtC,SAAS,EAAE,OAAO,CAAC,SAAS;SAC5B,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,kBAAkB,CACjB,OAAoB,EACpB,OAA4B;QAE5B,MAAM,kBAAkB,GACtB,OAAO,CAAC,MAA6C,IAAI,EAAE,CAAC;QAC9D,MAAM,UAAU,GAAG,iBAAiB,CACnC,IAAI,CAAC,MAAM,EACX,OAAO,EACP,OAAO,EACP,kBAAkB,CAMlB,CAAC;QAEF,6DAA6D;QAC7D,MAAM,cAAc,GAClB,OAAO,CAAC,MAAM,EAAE,cAAyB,IAAI,YAAY,CAAC;QAC5D,MAAM,cAAc,GAAI,OAAO,CAAC,MAAM,EAAE,cAA2B,IAAI;YACtE,OAAO;YACP,YAAY;YACZ,UAAU;SACV,CAAC;QAEF,uBAAuB;QACvB,UAAU,CAAC,OAAO,GAAG,IAAI,CAAC;QAC1B,UAAU,CAAC,cAAc,GAAG,cAAc,CAAC;QAC3C,UAAU,CAAC,cAAc,GAAG,cAAc,CAAC;QAE3C,qDAAqD;QACrD,IAAI,OAAO,CAAC,MAAM,EAAE,kBAAkB,EAAE,CAAC;YACxC,UAAU,CAAC,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,kBAAkB,CAAC;QACnE,CAAC;QAED,wBAAwB;QACxB,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;YACrB,UAAU,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;QACvD,CAAC;QAED,OAAO,UAAU,CAAC;IACnB,CAAC;CACD,CAAC"}

package/dist/tools/registrations/interaction-tools.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Interaction Tools Registrations
+ *
+ * Registers tools for interacting with question content:
+ * - Answer Eliminator (strike through answer choices)
+ * - Highlighter (highlight text passages)
+ *
+ * Maps to QTI 3.0 standard access features:
+ * - answerMasking (assessment tool)
+ * - strikethrough (visual transformation)
+ * - highlighting (cognitive/reading support)
+ */
+import type { ToolRegistration } from "../../services/ToolRegistry";
+/**
+ * Answer Eliminator tool registration
+ *
+ * Allows students to strike through incorrect answer choices.
+ * Only appears on multiple-choice style questions.
+ */
+export declare const answerEliminatorToolRegistration: ToolRegistration;
+/**
+ * Highlighter tool registration
+ *
+ * Allows students to highlight text in passages and questions.
+ * Appears on items with readable text content.
+ */
+export declare const highlighterToolRegistration: ToolRegistration;
+//# sourceMappingURL=interaction-tools.d.ts.map

package/dist/tools/registrations/interaction-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interaction-tools.d.ts","sourceRoot":"","sources":["../../../src/tools/registrations/interaction-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EACX,gBAAgB,EAIhB,MAAM,6BAA6B,CAAC;AAWrC;;;;;GAKG;AACH,eAAO,MAAM,gCAAgC,EAAE,gBAiF9C,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,2BAA2B,EAAE,gBAkEzC,CAAC"}

package/dist/tools/registrations/interaction-tools.js

@@ -0,0 +1,124 @@
+/**
+ * Interaction Tools Registrations
+ *
+ * Registers tools for interacting with question content:
+ * - Answer Eliminator (strike through answer choices)
+ * - Highlighter (highlight text passages)
+ *
+ * Maps to QTI 3.0 standard access features:
+ * - answerMasking (assessment tool)
+ * - strikethrough (visual transformation)
+ * - highlighting (cognitive/reading support)
+ */
+import { hasChoiceInteraction, hasReadableText, } from "../../services/tool-context";
+import { createToolElement, } from "../tool-tag-map";
+/**
+ * Answer Eliminator tool registration
+ *
+ * Allows students to strike through incorrect answer choices.
+ * Only appears on multiple-choice style questions.
+ */
+export const answerEliminatorToolRegistration = {
+    toolId: "answerEliminator",
+    name: "Answer Eliminator",
+    description: "Strike through answer choices",
+    icon: "strikethrough",
+    // Answer eliminator appears at item and element level
+    supportedLevels: ["item", "element"],
+    // PNP support IDs
+    // Maps to QTI 3.0 standard feature: answerMasking
+    pnpSupportIds: [
+        "answerMasking", // QTI 3.0 standard (assessment.answerMasking)
+        "answerEliminator", // QTI 3.0 standard (assessment.answerEliminator)
+        "strikethrough", // Common variant
+        "choiceMasking", // Common variant
+    ],
+    /**
+     * Pass 2: Answer eliminator is relevant only for choice-based questions
+     */
+    isVisibleInContext(context) {
+        return hasChoiceInteraction(context);
+    },
+    createButton(context, options) {
+        return {
+            toolId: this.toolId,
+            label: this.name,
+            icon: typeof this.icon === "function" ? this.icon(context) : this.icon,
+            disabled: options.disabled || false,
+            ariaLabel: options.ariaLabel || "Answer eliminator - Strike through choices",
+            tooltip: options.tooltip || "Strike Through",
+            onClick: options.onClick || (() => { }),
+            className: options.className,
+        };
+    },
+    createToolInstance(context, options) {
+        const componentOverrides = options.config ?? {};
+        const answerEliminator = createToolElement(this.toolId, context, options, componentOverrides);
+        answerEliminator.visible = true;
+        answerEliminator.toolId = this.toolId;
+        if (options.config?.toolkitCoordinator) {
+            answerEliminator.coordinator = options.config.toolkitCoordinator;
+        }
+        if (options.config?.elementToolStateStore) {
+            answerEliminator.elementToolStateStore =
+                options.config.elementToolStateStore;
+        }
+        if (typeof options.config?.globalElementId === "string") {
+            answerEliminator.globalElementId = options.config.globalElementId;
+        }
+        if (options.onClose) {
+            answerEliminator.addEventListener("close", options.onClose);
+        }
+        return answerEliminator;
+    },
+};
+/**
+ * Highlighter tool registration
+ *
+ * Allows students to highlight text in passages and questions.
+ * Appears on items with readable text content.
+ */
+export const highlighterToolRegistration = {
+    toolId: "highlighter",
+    name: "Highlighter",
+    description: "Highlight text",
+    icon: "highlighter",
+    // Highlighter appears at passage, rubric, item, and element levels
+    supportedLevels: ["passage", "rubric", "item", "element"],
+    // PNP support IDs
+    pnpSupportIds: ["highlighter", "textHighlight", "annotation"],
+    /**
+     * Pass 2: Highlighter is relevant when readable text is available
+     */
+    isVisibleInContext(context) {
+        return hasReadableText(context);
+    },
+    createButton(context, options) {
+        return {
+            toolId: this.toolId,
+            label: this.name,
+            icon: typeof this.icon === "function" ? this.icon(context) : this.icon,
+            disabled: options.disabled || false,
+            ariaLabel: options.ariaLabel || "Highlighter - Highlight text",
+            tooltip: options.tooltip || "Highlight",
+            onClick: options.onClick || (() => { }),
+            className: options.className,
+        };
+    },
+    createToolInstance(context, options) {
+        const componentOverrides = options.config ?? {};
+        const highlighter = createToolElement(this.toolId, context, options, componentOverrides);
+        highlighter.enabled = true;
+        if (options.config?.highlightCoordinator) {
+            highlighter.highlightCoordinator = options.config.highlightCoordinator;
+        }
+        if (options.config?.ttsService) {
+            highlighter.ttsService = options.config.ttsService;
+        }
+        if (options.onClose) {
+            highlighter.addEventListener("close", options.onClose);
+        }
+        return highlighter;
+    },
+};
+//# sourceMappingURL=interaction-tools.js.map

package/dist/tools/registrations/interaction-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interaction-tools.js","sourceRoot":"","sources":["../../../src/tools/registrations/interaction-tools.ts"],"names":[],"mappings":"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"}

package/dist/tools/registrations/measurement-tools.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Measurement Tools Registrations
+ *
+ * Registers ruler and protractor tools for on-screen measurements.
+ *
+ * Maps to QTI 3.0 standard access features:
+ * - ruler (assessment tool)
+ * - protractor (assessment tool)
+ */
+import type { ToolRegistration } from "../../services/ToolRegistry";
+/**
+ * Ruler tool registration
+ *
+ * Provides an on-screen ruler for measuring lengths.
+ * Typically appears on geometry or measurement problems.
+ */
+export declare const rulerToolRegistration: ToolRegistration;
+/**
+ * Protractor tool registration
+ *
+ * Provides an on-screen protractor for measuring angles.
+ * Typically appears on geometry problems.
+ */
+export declare const protractorToolRegistration: ToolRegistration;
+//# sourceMappingURL=measurement-tools.d.ts.map

package/dist/tools/registrations/measurement-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"measurement-tools.d.ts","sourceRoot":"","sources":["../../../src/tools/registrations/measurement-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EACX,gBAAgB,EAIhB,MAAM,6BAA6B,CAAC;AAQrC;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,EAAE,gBAmEnC,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,0BAA0B,EAAE,gBAmExC,CAAC"}