npm - @pie-players/pie-assessment-toolkit - Versions diffs - 0.3.59 → 0.3.60 - Mend

@pie-players/pie-assessment-toolkit 0.3.59 → 0.3.60

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (11) hide show

package/dist/components/ItemToolBar.custom-element.js +3 -1
package/dist/components/PieAssessmentToolkit.custom-element.js +20 -4
package/dist/components/SectionToolBar.custom-element.js +3 -1
package/dist/services/ToolCoordinator.d.ts +24 -0
package/dist/services/ToolCoordinator.js +46 -3
package/dist/services/ToolCoordinator.js.map +1 -1
package/dist/services/interfaces.d.ts +7 -1
package/dist/services/interfaces.js.map +1 -1
package/dist/services/tool-context.js +2 -0
package/dist/services/tool-context.js.map +1 -1
package/package.json +7 -7

package/dist/components/ItemToolBar.custom-element.js CHANGED Viewed

@@ -5994,9 +5994,11 @@ function hasChoiceInteraction(context) {
     "pie-multiple-choice",
     "pie-inline-choice",
     "pie-select-text",
+    "pie-ebsr",
     "multiple-choice",
     "inline-choice",
-    "select-text"
+    "select-text",
+    "ebsr"
   ];
   if (isElementContext(context)) {
     const config = context.item.config;

package/dist/components/PieAssessmentToolkit.custom-element.js CHANGED Viewed

@@ -17693,9 +17693,11 @@ function hasChoiceInteraction(context) {
     "pie-multiple-choice",
     "pie-inline-choice",
     "pie-select-text",
+    "pie-ebsr",
     "multiple-choice",
     "inline-choice",
-    "select-text"
+    "select-text",
+    "ebsr"
   ];
   if (isElementContext(context)) {
     const config = context.item.config;
@@ -21427,6 +21429,7 @@ class ToolCoordinator {
   tools = new Map;
   layerCounters = new Map;
   listeners = new Set;
+  visibilityState = new Map;
   constructor(config = {}) {
     this.config = config;
     this.layerCounters.set(ZIndexLayer.BASE, 0);
@@ -21450,13 +21453,14 @@ class ToolCoordinator {
       log(`Tool ${id} is already registered`);
       return;
     }
+    const isVisible = this.visibilityState.get(id) ?? false;
     if (!element2) {
       this.tools.set(id, {
         id,
         name,
         element: null,
         layer,
-        isVisible: false,
+        isVisible,
         baseZIndex: layer
       });
       log("Tool registered without element:", id);
@@ -21464,6 +21468,7 @@ class ToolCoordinator {
     }
     const baseZIndex = layer + this.getNextLayerOffset(layer);
     element2.style.zIndex = String(baseZIndex);
+    element2.style.display = isVisible ? "" : "none";
     const mouseDownHandler = () => this.bringToFront(element2);
     element2.addEventListener("mousedown", mouseDownHandler);
     this.tools.set(id, {
@@ -21471,10 +21476,13 @@ class ToolCoordinator {
       name,
       element: element2,
       layer,
-      isVisible: false,
+      isVisible,
       baseZIndex,
       mouseDownHandler
     });
+    if (isVisible) {
+      this.bringToFront(element2);
+    }
     log("Tool registered with element:", id);
   }
   unregisterTool(id) {
@@ -21486,6 +21494,10 @@ class ToolCoordinator {
     }
     this.tools.delete(id);
   }
+  releaseTool(id) {
+    this.unregisterTool(id);
+    this.visibilityState.delete(id);
+  }
   showTool(id) {
     const tool = this.tools.get(id);
     if (!tool) {
@@ -21497,6 +21509,7 @@ class ToolCoordinator {
       this.bringToFront(tool.element);
     }
     tool.isVisible = true;
+    this.visibilityState.set(id, true);
     this.notifyListeners();
   }
   hideTool(id) {
@@ -21509,6 +21522,7 @@ class ToolCoordinator {
       tool.element.style.display = "none";
     }
     tool.isVisible = false;
+    this.visibilityState.set(id, false);
     this.notifyListeners();
   }
   toggleTool(id) {
@@ -21527,7 +21541,9 @@ class ToolCoordinator {
   }
   isToolVisible(id) {
     const tool = this.tools.get(id);
-    return tool?.isVisible ?? false;
+    if (tool)
+      return tool.isVisible;
+    return this.visibilityState.get(id) ?? false;
   }
   bringToFront(element2) {
     const tool = Array.from(this.tools.values()).find((t) => t.element === element2);

package/dist/components/SectionToolBar.custom-element.js CHANGED Viewed

@@ -10191,9 +10191,11 @@ function hasChoiceInteraction(context) {
     "pie-multiple-choice",
     "pie-inline-choice",
     "pie-select-text",
+    "pie-ebsr",
     "multiple-choice",
     "inline-choice",
-    "select-text"
+    "select-text",
+    "ebsr"
   ];
   if (isElementContext(context)) {
     const config = context.item.config;

package/dist/services/ToolCoordinator.d.ts CHANGED Viewed

@@ -33,6 +33,15 @@ export declare class ToolCoordinator implements ToolCoordinatorApi {
     private tools;
     private layerCounters;
     private listeners;
+    /**
+     * Activation (on/off) state keyed by tool id, kept independent of the
+     * element registration lifecycle. A tool's DOM element can be unregistered
+     * and re-registered as the item re-renders (e.g. a model change re-mounts
+     * the toolbar overlay); when that happens the on/off state must survive so
+     * that only an explicit toggle — the toolbar button — turns a tool off.
+     * Cleared on genuine teardown via {@link releaseTool}.
+     */
+    private visibilityState;
     constructor(config?: ToolCoordinatorConfig);
     /**
      * Subscribe to tool state changes
@@ -55,9 +64,24 @@ export declare class ToolCoordinator implements ToolCoordinatorApi {
     /**
      * Unregister a tool
      *
+     * Detaches the element binding (listeners, registration) but intentionally
+     * preserves the tool's activation state in {@link visibilityState}, so a
+     * subsequent re-registration of the same id (e.g. after an item re-render)
+     * restores whether the tool was on or off. Use {@link releaseTool} to also
+     * discard the activation state on genuine teardown.
+     *
      * @param id Tool identifier
      */
     unregisterTool(id: string): void;
+    /**
+     * Fully release a tool: unregister its element binding AND discard its
+     * preserved activation state. Call this on genuine teardown (e.g. leaving
+     * the item/section that owns the tool) rather than {@link unregisterTool},
+     * which keeps the on/off state alive across element re-registration.
+     *
+     * @param id Tool identifier
+     */
+    releaseTool(id: string): void;
     /**
      * Show a tool
      *

package/dist/services/ToolCoordinator.js CHANGED Viewed

@@ -30,6 +30,15 @@ export class ToolCoordinator {
     tools = new Map();
     layerCounters = new Map();
     listeners = new Set();
+    /**
+     * Activation (on/off) state keyed by tool id, kept independent of the
+     * element registration lifecycle. A tool's DOM element can be unregistered
+     * and re-registered as the item re-renders (e.g. a model change re-mounts
+     * the toolbar overlay); when that happens the on/off state must survive so
+     * that only an explicit toggle — the toolbar button — turns a tool off.
+     * Cleared on genuine teardown via {@link releaseTool}.
+     */
+    visibilityState = new Map();
     constructor(config = {}) {
         this.config = config;
         // Initialize layer counters
@@ -69,6 +78,10 @@ export class ToolCoordinator {
             log(`Tool ${id} is already registered`);
             return;
         }
+        // Restore prior on/off state. A re-registration (e.g. after an item
+        // re-render unmounts and re-mounts the tool element) must preserve the
+        // tool's activation state so only an explicit toggle can turn it off.
+        const isVisible = this.visibilityState.get(id) ?? false;
         // If no element provided, create a placeholder registration
         if (!element) {
             this.tools.set(id, {
@@ -76,7 +89,7 @@ export class ToolCoordinator {
                 name,
                 element: null,
                 layer,
-                isVisible: false,
+                isVisible,
                 baseZIndex: layer,
             });
             log("Tool registered without element:", id);
@@ -86,6 +99,8 @@ export class ToolCoordinator {
         const baseZIndex = layer + this.getNextLayerOffset(layer);
         // Apply z-index
         element.style.zIndex = String(baseZIndex);
+        // Reflect restored visibility onto the freshly registered element.
+        element.style.display = isVisible ? "" : "none";
         // Create and store event handler to enable proper cleanup
         const mouseDownHandler = () => this.bringToFront(element);
         element.addEventListener("mousedown", mouseDownHandler);
@@ -95,15 +110,24 @@ export class ToolCoordinator {
             name,
             element,
             layer,
-            isVisible: false,
+            isVisible,
             baseZIndex,
             mouseDownHandler,
         });
+        if (isVisible) {
+            this.bringToFront(element);
+        }
         log("Tool registered with element:", id);
     }
     /**
      * Unregister a tool
      *
+     * Detaches the element binding (listeners, registration) but intentionally
+     * preserves the tool's activation state in {@link visibilityState}, so a
+     * subsequent re-registration of the same id (e.g. after an item re-render)
+     * restores whether the tool was on or off. Use {@link releaseTool} to also
+     * discard the activation state on genuine teardown.
+     *
      * @param id Tool identifier
      */
     unregisterTool(id) {
@@ -116,6 +140,18 @@ export class ToolCoordinator {
         }
         this.tools.delete(id);
     }
+    /**
+     * Fully release a tool: unregister its element binding AND discard its
+     * preserved activation state. Call this on genuine teardown (e.g. leaving
+     * the item/section that owns the tool) rather than {@link unregisterTool},
+     * which keeps the on/off state alive across element re-registration.
+     *
+     * @param id Tool identifier
+     */
+    releaseTool(id) {
+        this.unregisterTool(id);
+        this.visibilityState.delete(id);
+    }
     /**
      * Show a tool
      *
@@ -132,6 +168,7 @@ export class ToolCoordinator {
             this.bringToFront(tool.element);
         }
         tool.isVisible = true;
+        this.visibilityState.set(id, true);
         this.notifyListeners();
     }
     /**
@@ -149,6 +186,7 @@ export class ToolCoordinator {
             tool.element.style.display = "none";
         }
         tool.isVisible = false;
+        this.visibilityState.set(id, false);
         this.notifyListeners();
     }
     /**
@@ -179,7 +217,12 @@ export class ToolCoordinator {
      */
     isToolVisible(id) {
         const tool = this.tools.get(id);
-        return tool?.isVisible ?? false;
+        if (tool)
+            return tool.isVisible;
+        // No live element registration (e.g. mid re-render, between unmount and
+        // re-mount): fall back to the preserved activation state so the tool
+        // doesn't read as "off" during the gap.
+        return this.visibilityState.get(id) ?? false;
     }
     /**
      * Bring element to front of its layer

package/dist/services/ToolCoordinator.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"ToolCoordinator.js","sourceRoot":"","sources":["../../src/services/ToolCoordinator.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n ToolCoordinator\n \n Manages z-index layering and visibility for floating tools.\n * Prevents conflicts between calculator, ruler, protractor, etc.\n \n Features:\n * - Centralized z-index management with defined layers\n * - Tool visibility state tracking\n * - Bring-to-front on interaction\n * - Framework-agnostic (works with any DOM element)\n \n Part of PIE Assessment Toolkit.\n /\n\nimport { createLogger } from \"../utils/logger.js\";\nimport type { ToolCoordinatorApi, ToolState } from \"./interfaces.js\";\n\nconst log = createLogger(\"ToolCoordinator\");\n\n/\n Z-index layers for assessment components\n /\nexport enum ZIndexLayer {\n\tBASE = 0, // PIE content, player chrome (0-999)\n\tTOOL = 1000, // Non-modal tools (ruler, protractor) (1000-1999)\n\tMODAL = 2000, // Modal tools (calculator) (2000-2999)\n\tCONTROL = 3000, // Drag handles, resize controls (3000-3999)\n\tHIGHLIGHT = 4000, // TTS and annotation highlights (4000-4999)\n}\n\n/\n Tool registration info\n /\ninterface ToolRegistration {\n\tid: string;\n\tname: string;\n\telement: HTMLElement \| null;\n\tlayer: ZIndexLayer;\n\tisVisible: boolean;\n\tbaseZIndex: number;\n\tmouseDownHandler?: (e: MouseEvent) => void;\n}\n\n/\n Configuration for ToolCoordinator\n * Currently empty but allows future extension without breaking changes\n /\nexport type ToolCoordinatorConfig = Record<string, never>;\n\nexport class ToolCoordinator implements ToolCoordinatorApi {\n\tprivate config: ToolCoordinatorConfig;\n\tprivate tools = new Map<string, ToolRegistration>();\n\tprivate layerCounters = new Map<ZIndexLayer, number>();\n\tprivate listeners = new Set<() => void>();\n\n\tconstructor(config: ToolCoordinatorConfig = {}) {\n\t\tthis.config = config;\n\t\t// Initialize layer counters\n\t\tthis.layerCounters.set(ZIndexLayer.BASE, 0);\n\t\tthis.layerCounters.set(ZIndexLayer.TOOL, 0);\n\t\tthis.layerCounters.set(ZIndexLayer.MODAL, 0);\n\t\tthis.layerCounters.set(ZIndexLayer.CONTROL, 0);\n\t\tthis.layerCounters.set(ZIndexLayer.HIGHLIGHT, 0);\n\t}\n\n\t/\n\t Subscribe to tool state changes\n\t * Returns unsubscribe function\n\t /\n\tsubscribe(listener: () => void): () => void {\n\t\tthis.listeners.add(listener);\n\t\treturn () => {\n\t\t\tthis.listeners.delete(listener);\n\t\t};\n\t}\n\n\t/\n\t Notify all listeners of state change\n\t /\n\tprivate notifyListeners(): void {\n\t\tthis.listeners.forEach((listener) => listener());\n\t}\n\n\t/\n\t Register a tool with the coordinator\n\t \n\t @param id Unique tool identifier\n\t * @param name Display name\n\t * @param element DOM element for the tool (optional)\n\t * @param layer Z-index layer (defaults to MODAL)\n\t /\n\tregisterTool(\n\t\tid: string,\n\t\tname: string,\n\t\telement?: HTMLElement,\n\t\tlayer: ZIndexLayer = ZIndexLayer.MODAL,\n\t): void {\n\t\tlog(\"registerTool called:\", { id, name, hasElement: !!element, layer });\n\n\t\tif (this.tools.has(id)) {\n\t\t\tlog(`Tool ${id} is already registered`);\n\t\t\treturn;\n\t\t}\n\n\t\t// If no element provided, create a placeholder registration\n\t\tif (!element) {\n\t\t\tthis.tools.set(id, {\n\t\t\t\tid,\n\t\t\t\tname,\n\t\t\t\telement: null,\n\t\t\t\tlayer,\n\t\t\t\tisVisible: false,\n\t\t\t\tbaseZIndex: layer,\n\t\t\t});\n\t\t\tlog(\"Tool registered without element:\", id);\n\t\t\treturn;\n\t\t}\n\n\t\t// Calculate base z-index for this layer\n\t\tconst baseZIndex = layer + this.getNextLayerOffset(layer);\n\n\t\t// Apply z-index\n\t\telement.style.zIndex = String(baseZIndex);\n\n\t\t// Create and store event handler to enable proper cleanup\n\t\tconst mouseDownHandler = () => this.bringToFront(element);\n\t\telement.addEventListener(\"mousedown\", mouseDownHandler);\n\n\t\t// Register tool with handler reference\n\t\tthis.tools.set(id, {\n\t\t\tid,\n\t\t\tname,\n\t\t\telement,\n\t\t\tlayer,\n\t\t\tisVisible: false,\n\t\t\tbaseZIndex,\n\t\t\tmouseDownHandler,\n\t\t});\n\n\t\tlog(\"Tool registered with element:\", id);\n\t}\n\n\t/\n\t Unregister a tool\n\t \n\t @param id Tool identifier\n\t /\n\tunregisterTool(id: string): void {\n\t\tconst tool = this.tools.get(id);\n\t\tif (!tool) return;\n\n\t\t// Remove event listeners using stored handler reference\n\t\tif (tool.element && tool.mouseDownHandler) {\n\t\t\ttool.element.removeEventListener(\"mousedown\", tool.mouseDownHandler);\n\t\t}\n\n\t\tthis.tools.delete(id);\n\t}\n\n\t/\n\t Show a tool\n\t \n\t @param id Tool identifier\n\t /\n\tshowTool(id: string): void {\n\t\tconst tool = this.tools.get(id);\n\t\tif (!tool) {\n\t\t\tlog(`Tool ${id} not found`);\n\t\t\treturn;\n\t\t}\n\n\t\tif (tool.element) {\n\t\t\ttool.element.style.display = \"\";\n\t\t\tthis.bringToFront(tool.element);\n\t\t}\n\t\ttool.isVisible = true;\n\t\tthis.notifyListeners();\n\t}\n\n\t/\n\t Hide a tool\n\t \n\t @param id Tool identifier\n\t /\n\thideTool(id: string): void {\n\t\tconst tool = this.tools.get(id);\n\t\tif (!tool) {\n\t\t\tlog(`Tool ${id} not found`);\n\t\t\treturn;\n\t\t}\n\n\t\tif (tool.element) {\n\t\t\ttool.element.style.display = \"none\";\n\t\t}\n\t\ttool.isVisible = false;\n\t\tthis.notifyListeners();\n\t}\n\n\t/\n\t Toggle tool visibility\n\t \n\t @param id Tool identifier\n\t /\n\ttoggleTool(id: string): void {\n\t\tlog(\"toggleTool called for:\", id);\n\t\tconst tool = this.tools.get(id);\n\t\tif (!tool) {\n\t\t\tlog(\n\t\t\t\t`Tool ${id} not found. Registered tools:`,\n\t\t\t\tArray.from(this.tools.keys()),\n\t\t\t);\n\t\t\treturn;\n\t\t}\n\n\t\tlog(\"Tool found, current visibility:\", tool.isVisible);\n\t\tif (tool.isVisible) {\n\t\t\tthis.hideTool(id);\n\t\t} else {\n\t\t\tthis.showTool(id);\n\t\t}\n\t}\n\n\t/\n\t Check if tool is visible\n\t \n\t @param id Tool identifier\n\t * @returns true if tool is visible\n\t /\n\tisToolVisible(id: string): boolean {\n\t\tconst tool = this.tools.get(id);\n\t\treturn tool?.isVisible ?? false;\n\t}\n\n\t/\n\t Bring element to front of its layer\n\t \n\t @param element DOM element to bring forward\n\t /\n\tbringToFront(element: HTMLElement): void {\n\t\t// Find tool registration\n\t\tconst tool = Array.from(this.tools.values()).find(\n\t\t\t(t) => t.element === element,\n\t\t);\n\t\tif (!tool) return;\n\n\t\t// Calculate new z-index (highest in layer + 1)\n\t\tconst maxZIndexInLayer = this.getMaxZIndexInLayer(tool.layer);\n\t\tconst newZIndex = Math.max(maxZIndexInLayer + 1, tool.layer + 1);\n\n\t\t// Update z-index\n\t\telement.style.zIndex = String(newZIndex);\n\t\ttool.baseZIndex = newZIndex;\n\t}\n\n\t/\n\t Get all registered tool IDs\n\t /\n\tgetRegisteredTools(): string[] {\n\t\treturn Array.from(this.tools.keys());\n\t}\n\n\t/\n\t Get tool element by ID\n\t /\n\tgetToolElement(id: string): HTMLElement \| null {\n\t\treturn this.tools.get(id)?.element ?? null;\n\t}\n\n\t/\n\t Get next offset within a layer\n\t /\n\tprivate getNextLayerOffset(layer: ZIndexLayer): number {\n\t\tconst current = this.layerCounters.get(layer) ?? 0;\n\t\tthis.layerCounters.set(layer, current + 1);\n\t\treturn current;\n\t}\n\n\t/\n\t Get maximum z-index currently in use in a layer\n\t /\n\tprivate getMaxZIndexInLayer(layer: ZIndexLayer): number {\n\t\tlet max = layer;\n\n\t\tfor (const tool of this.tools.values()) {\n\t\t\tif (tool.layer === layer) {\n\t\t\t\tmax = Math.max(max, tool.baseZIndex);\n\t\t\t}\n\t\t}\n\n\t\treturn max;\n\t}\n\n\t/\n\t Reset all tools to their base z-indices\n\t /\n\tresetZIndices(): void {\n\t\tfor (const tool of this.tools.values()) {\n\t\t\tif (tool.element) {\n\t\t\t\ttool.element.style.zIndex = String(tool.baseZIndex);\n\t\t\t}\n\t\t}\n\t}\n\n\t/\n\t Update tool element reference\n\t \n\t @param id Tool identifier\n\t * @param element New DOM element\n\t /\n\tupdateToolElement(id: string, element: HTMLElement): void {\n\t\tconst tool = this.tools.get(id);\n\t\tif (!tool) {\n\t\t\tlog(`Tool ${id} not found`);\n\t\t\treturn;\n\t\t}\n\n\t\t// Remove old event listener using stored handler reference\n\t\tif (tool.element && tool.mouseDownHandler) {\n\t\t\ttool.element.removeEventListener(\"mousedown\", tool.mouseDownHandler);\n\t\t}\n\n\t\t// Create new handler and add listener\n\t\tconst mouseDownHandler = () => this.bringToFront(element);\n\t\telement.addEventListener(\"mousedown\", mouseDownHandler);\n\n\t\t// Update element and handler reference\n\t\ttool.element = element;\n\t\ttool.mouseDownHandler = mouseDownHandler;\n\n\t\t// Apply z-index to new element\n\t\telement.style.zIndex = String(tool.baseZIndex);\n\t\tif (tool.isVisible) {\n\t\t\telement.style.display = \"\";\n\t\t} else {\n\t\t\telement.style.display = \"none\";\n\t\t}\n\t}\n\n\t/\n\t Hide all tools\n\t /\n\thideAllTools(): void {\n\t\tfor (const id of this.tools.keys()) {\n\t\t\tthis.hideTool(id);\n\t\t}\n\t\tthis.notifyListeners();\n\t}\n\n\t/\n\t Get tool state (interface method)\n\t \n\t @param id Tool identifier\n\t * @returns Tool state or undefined\n\t /\n\tgetToolState(id: string): ToolState \| undefined {\n\t\tconst tool = this.tools.get(id);\n\t\tif (!tool) return undefined;\n\n\t\treturn {\n\t\t\tid: tool.id,\n\t\t\tname: tool.name,\n\t\t\tisVisible: tool.isVisible,\n\t\t\telement: tool.element ?? null,\n\t\t\tlayer: tool.layer,\n\t\t};\n\t}\n\n\t/\n\t Get all visible tools (interface method)\n\t \n\t @returns Array of visible tool states\n\t */\n\tgetVisibleTools(): ToolState[] {\n\t\treturn Array.from(this.tools.values())\n\t\t\t.filter((tool) => tool.isVisible)\n\t\t\t.map((tool) => ({\n\t\t\t\tid: tool.id,\n\t\t\t\tname: tool.name,\n\t\t\t\tisVisible: tool.isVisible,\n\t\t\t\telement: tool.element ?? null,\n\t\t\t\tlayer: tool.layer,\n\t\t\t}));\n\t}\n}\n"]}
1	+ {"version":3,"file":"ToolCoordinator.js","sourceRoot":"","sources":["../../src/services/ToolCoordinator.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n ToolCoordinator\n \n Manages z-index layering and visibility for floating tools.\n * Prevents conflicts between calculator, ruler, protractor, etc.\n \n Features:\n * - Centralized z-index management with defined layers\n * - Tool visibility state tracking\n * - Bring-to-front on interaction\n * - Framework-agnostic (works with any DOM element)\n \n Part of PIE Assessment Toolkit.\n /\n\nimport { createLogger } from \"../utils/logger.js\";\nimport type { ToolCoordinatorApi, ToolState } from \"./interfaces.js\";\n\nconst log = createLogger(\"ToolCoordinator\");\n\n/\n Z-index layers for assessment components\n /\nexport enum ZIndexLayer {\n\tBASE = 0, // PIE content, player chrome (0-999)\n\tTOOL = 1000, // Non-modal tools (ruler, protractor) (1000-1999)\n\tMODAL = 2000, // Modal tools (calculator) (2000-2999)\n\tCONTROL = 3000, // Drag handles, resize controls (3000-3999)\n\tHIGHLIGHT = 4000, // TTS and annotation highlights (4000-4999)\n}\n\n/\n Tool registration info\n /\ninterface ToolRegistration {\n\tid: string;\n\tname: string;\n\telement: HTMLElement \| null;\n\tlayer: ZIndexLayer;\n\tisVisible: boolean;\n\tbaseZIndex: number;\n\tmouseDownHandler?: (e: MouseEvent) => void;\n}\n\n/\n Configuration for ToolCoordinator\n * Currently empty but allows future extension without breaking changes\n /\nexport type ToolCoordinatorConfig = Record<string, never>;\n\nexport class ToolCoordinator implements ToolCoordinatorApi {\n\tprivate config: ToolCoordinatorConfig;\n\tprivate tools = new Map<string, ToolRegistration>();\n\tprivate layerCounters = new Map<ZIndexLayer, number>();\n\tprivate listeners = new Set<() => void>();\n\t/\n\t Activation (on/off) state keyed by tool id, kept independent of the\n\t * element registration lifecycle. A tool's DOM element can be unregistered\n\t * and re-registered as the item re-renders (e.g. a model change re-mounts\n\t * the toolbar overlay); when that happens the on/off state must survive so\n\t * that only an explicit toggle — the toolbar button — turns a tool off.\n\t * Cleared on genuine teardown via {@link releaseTool}.\n\t /\n\tprivate visibilityState = new Map<string, boolean>();\n\n\tconstructor(config: ToolCoordinatorConfig = {}) {\n\t\tthis.config = config;\n\t\t// Initialize layer counters\n\t\tthis.layerCounters.set(ZIndexLayer.BASE, 0);\n\t\tthis.layerCounters.set(ZIndexLayer.TOOL, 0);\n\t\tthis.layerCounters.set(ZIndexLayer.MODAL, 0);\n\t\tthis.layerCounters.set(ZIndexLayer.CONTROL, 0);\n\t\tthis.layerCounters.set(ZIndexLayer.HIGHLIGHT, 0);\n\t}\n\n\t/\n\t Subscribe to tool state changes\n\t * Returns unsubscribe function\n\t /\n\tsubscribe(listener: () => void): () => void {\n\t\tthis.listeners.add(listener);\n\t\treturn () => {\n\t\t\tthis.listeners.delete(listener);\n\t\t};\n\t}\n\n\t/\n\t Notify all listeners of state change\n\t /\n\tprivate notifyListeners(): void {\n\t\tthis.listeners.forEach((listener) => listener());\n\t}\n\n\t/\n\t Register a tool with the coordinator\n\t \n\t @param id Unique tool identifier\n\t * @param name Display name\n\t * @param element DOM element for the tool (optional)\n\t * @param layer Z-index layer (defaults to MODAL)\n\t /\n\tregisterTool(\n\t\tid: string,\n\t\tname: string,\n\t\telement?: HTMLElement,\n\t\tlayer: ZIndexLayer = ZIndexLayer.MODAL,\n\t): void {\n\t\tlog(\"registerTool called:\", { id, name, hasElement: !!element, layer });\n\n\t\tif (this.tools.has(id)) {\n\t\t\tlog(`Tool ${id} is already registered`);\n\t\t\treturn;\n\t\t}\n\n\t\t// Restore prior on/off state. A re-registration (e.g. after an item\n\t\t// re-render unmounts and re-mounts the tool element) must preserve the\n\t\t// tool's activation state so only an explicit toggle can turn it off.\n\t\tconst isVisible = this.visibilityState.get(id) ?? false;\n\n\t\t// If no element provided, create a placeholder registration\n\t\tif (!element) {\n\t\t\tthis.tools.set(id, {\n\t\t\t\tid,\n\t\t\t\tname,\n\t\t\t\telement: null,\n\t\t\t\tlayer,\n\t\t\t\tisVisible,\n\t\t\t\tbaseZIndex: layer,\n\t\t\t});\n\t\t\tlog(\"Tool registered without element:\", id);\n\t\t\treturn;\n\t\t}\n\n\t\t// Calculate base z-index for this layer\n\t\tconst baseZIndex = layer + this.getNextLayerOffset(layer);\n\n\t\t// Apply z-index\n\t\telement.style.zIndex = String(baseZIndex);\n\n\t\t// Reflect restored visibility onto the freshly registered element.\n\t\telement.style.display = isVisible ? \"\" : \"none\";\n\n\t\t// Create and store event handler to enable proper cleanup\n\t\tconst mouseDownHandler = () => this.bringToFront(element);\n\t\telement.addEventListener(\"mousedown\", mouseDownHandler);\n\n\t\t// Register tool with handler reference\n\t\tthis.tools.set(id, {\n\t\t\tid,\n\t\t\tname,\n\t\t\telement,\n\t\t\tlayer,\n\t\t\tisVisible,\n\t\t\tbaseZIndex,\n\t\t\tmouseDownHandler,\n\t\t});\n\n\t\tif (isVisible) {\n\t\t\tthis.bringToFront(element);\n\t\t}\n\n\t\tlog(\"Tool registered with element:\", id);\n\t}\n\n\t/\n\t Unregister a tool\n\t \n\t Detaches the element binding (listeners, registration) but intentionally\n\t * preserves the tool's activation state in {@link visibilityState}, so a\n\t * subsequent re-registration of the same id (e.g. after an item re-render)\n\t * restores whether the tool was on or off. Use {@link releaseTool} to also\n\t * discard the activation state on genuine teardown.\n\t \n\t @param id Tool identifier\n\t /\n\tunregisterTool(id: string): void {\n\t\tconst tool = this.tools.get(id);\n\t\tif (!tool) return;\n\n\t\t// Remove event listeners using stored handler reference\n\t\tif (tool.element && tool.mouseDownHandler) {\n\t\t\ttool.element.removeEventListener(\"mousedown\", tool.mouseDownHandler);\n\t\t}\n\n\t\tthis.tools.delete(id);\n\t}\n\n\t/\n\t Fully release a tool: unregister its element binding AND discard its\n\t * preserved activation state. Call this on genuine teardown (e.g. leaving\n\t * the item/section that owns the tool) rather than {@link unregisterTool},\n\t * which keeps the on/off state alive across element re-registration.\n\t \n\t @param id Tool identifier\n\t /\n\treleaseTool(id: string): void {\n\t\tthis.unregisterTool(id);\n\t\tthis.visibilityState.delete(id);\n\t}\n\n\t/\n\t Show a tool\n\t \n\t @param id Tool identifier\n\t /\n\tshowTool(id: string): void {\n\t\tconst tool = this.tools.get(id);\n\t\tif (!tool) {\n\t\t\tlog(`Tool ${id} not found`);\n\t\t\treturn;\n\t\t}\n\n\t\tif (tool.element) {\n\t\t\ttool.element.style.display = \"\";\n\t\t\tthis.bringToFront(tool.element);\n\t\t}\n\t\ttool.isVisible = true;\n\t\tthis.visibilityState.set(id, true);\n\t\tthis.notifyListeners();\n\t}\n\n\t/\n\t Hide a tool\n\t \n\t @param id Tool identifier\n\t /\n\thideTool(id: string): void {\n\t\tconst tool = this.tools.get(id);\n\t\tif (!tool) {\n\t\t\tlog(`Tool ${id} not found`);\n\t\t\treturn;\n\t\t}\n\n\t\tif (tool.element) {\n\t\t\ttool.element.style.display = \"none\";\n\t\t}\n\t\ttool.isVisible = false;\n\t\tthis.visibilityState.set(id, false);\n\t\tthis.notifyListeners();\n\t}\n\n\t/\n\t Toggle tool visibility\n\t \n\t @param id Tool identifier\n\t /\n\ttoggleTool(id: string): void {\n\t\tlog(\"toggleTool called for:\", id);\n\t\tconst tool = this.tools.get(id);\n\t\tif (!tool) {\n\t\t\tlog(\n\t\t\t\t`Tool ${id} not found. Registered tools:`,\n\t\t\t\tArray.from(this.tools.keys()),\n\t\t\t);\n\t\t\treturn;\n\t\t}\n\n\t\tlog(\"Tool found, current visibility:\", tool.isVisible);\n\t\tif (tool.isVisible) {\n\t\t\tthis.hideTool(id);\n\t\t} else {\n\t\t\tthis.showTool(id);\n\t\t}\n\t}\n\n\t/\n\t Check if tool is visible\n\t \n\t @param id Tool identifier\n\t * @returns true if tool is visible\n\t /\n\tisToolVisible(id: string): boolean {\n\t\tconst tool = this.tools.get(id);\n\t\tif (tool) return tool.isVisible;\n\t\t// No live element registration (e.g. mid re-render, between unmount and\n\t\t// re-mount): fall back to the preserved activation state so the tool\n\t\t// doesn't read as \"off\" during the gap.\n\t\treturn this.visibilityState.get(id) ?? false;\n\t}\n\n\t/\n\t Bring element to front of its layer\n\t \n\t @param element DOM element to bring forward\n\t /\n\tbringToFront(element: HTMLElement): void {\n\t\t// Find tool registration\n\t\tconst tool = Array.from(this.tools.values()).find(\n\t\t\t(t) => t.element === element,\n\t\t);\n\t\tif (!tool) return;\n\n\t\t// Calculate new z-index (highest in layer + 1)\n\t\tconst maxZIndexInLayer = this.getMaxZIndexInLayer(tool.layer);\n\t\tconst newZIndex = Math.max(maxZIndexInLayer + 1, tool.layer + 1);\n\n\t\t// Update z-index\n\t\telement.style.zIndex = String(newZIndex);\n\t\ttool.baseZIndex = newZIndex;\n\t}\n\n\t/\n\t Get all registered tool IDs\n\t /\n\tgetRegisteredTools(): string[] {\n\t\treturn Array.from(this.tools.keys());\n\t}\n\n\t/\n\t Get tool element by ID\n\t /\n\tgetToolElement(id: string): HTMLElement \| null {\n\t\treturn this.tools.get(id)?.element ?? null;\n\t}\n\n\t/\n\t Get next offset within a layer\n\t /\n\tprivate getNextLayerOffset(layer: ZIndexLayer): number {\n\t\tconst current = this.layerCounters.get(layer) ?? 0;\n\t\tthis.layerCounters.set(layer, current + 1);\n\t\treturn current;\n\t}\n\n\t/\n\t Get maximum z-index currently in use in a layer\n\t /\n\tprivate getMaxZIndexInLayer(layer: ZIndexLayer): number {\n\t\tlet max = layer;\n\n\t\tfor (const tool of this.tools.values()) {\n\t\t\tif (tool.layer === layer) {\n\t\t\t\tmax = Math.max(max, tool.baseZIndex);\n\t\t\t}\n\t\t}\n\n\t\treturn max;\n\t}\n\n\t/\n\t Reset all tools to their base z-indices\n\t /\n\tresetZIndices(): void {\n\t\tfor (const tool of this.tools.values()) {\n\t\t\tif (tool.element) {\n\t\t\t\ttool.element.style.zIndex = String(tool.baseZIndex);\n\t\t\t}\n\t\t}\n\t}\n\n\t/\n\t Update tool element reference\n\t \n\t @param id Tool identifier\n\t * @param element New DOM element\n\t /\n\tupdateToolElement(id: string, element: HTMLElement): void {\n\t\tconst tool = this.tools.get(id);\n\t\tif (!tool) {\n\t\t\tlog(`Tool ${id} not found`);\n\t\t\treturn;\n\t\t}\n\n\t\t// Remove old event listener using stored handler reference\n\t\tif (tool.element && tool.mouseDownHandler) {\n\t\t\ttool.element.removeEventListener(\"mousedown\", tool.mouseDownHandler);\n\t\t}\n\n\t\t// Create new handler and add listener\n\t\tconst mouseDownHandler = () => this.bringToFront(element);\n\t\telement.addEventListener(\"mousedown\", mouseDownHandler);\n\n\t\t// Update element and handler reference\n\t\ttool.element = element;\n\t\ttool.mouseDownHandler = mouseDownHandler;\n\n\t\t// Apply z-index to new element\n\t\telement.style.zIndex = String(tool.baseZIndex);\n\t\tif (tool.isVisible) {\n\t\t\telement.style.display = \"\";\n\t\t} else {\n\t\t\telement.style.display = \"none\";\n\t\t}\n\t}\n\n\t/\n\t Hide all tools\n\t /\n\thideAllTools(): void {\n\t\tfor (const id of this.tools.keys()) {\n\t\t\tthis.hideTool(id);\n\t\t}\n\t\tthis.notifyListeners();\n\t}\n\n\t/\n\t Get tool state (interface method)\n\t \n\t @param id Tool identifier\n\t * @returns Tool state or undefined\n\t /\n\tgetToolState(id: string): ToolState \| undefined {\n\t\tconst tool = this.tools.get(id);\n\t\tif (!tool) return undefined;\n\n\t\treturn {\n\t\t\tid: tool.id,\n\t\t\tname: tool.name,\n\t\t\tisVisible: tool.isVisible,\n\t\t\telement: tool.element ?? null,\n\t\t\tlayer: tool.layer,\n\t\t};\n\t}\n\n\t/\n\t Get all visible tools (interface method)\n\t \n\t @returns Array of visible tool states\n\t */\n\tgetVisibleTools(): ToolState[] {\n\t\treturn Array.from(this.tools.values())\n\t\t\t.filter((tool) => tool.isVisible)\n\t\t\t.map((tool) => ({\n\t\t\t\tid: tool.id,\n\t\t\t\tname: tool.name,\n\t\t\t\tisVisible: tool.isVisible,\n\t\t\t\telement: tool.element ?? null,\n\t\t\t\tlayer: tool.layer,\n\t\t\t}));\n\t}\n}\n"]}

package/dist/services/interfaces.d.ts CHANGED Viewed

@@ -125,9 +125,15 @@ export interface ToolCoordinatorApi {
      */
     registerTool(id: string, name: string, element?: HTMLElement, layer?: ZIndexLayer): void;
     /**
-     * Unregister a tool
+     * Unregister a tool's element binding while preserving its activation
+     * (on/off) state, so a re-registration of the same id restores it.
      */
     unregisterTool(id: string): void;
+    /**
+     * Fully release a tool: unregister and discard its preserved activation
+     * state. Use on genuine teardown rather than `unregisterTool`.
+     */
+    releaseTool(id: string): void;
     /**
      * Show a tool
      */

package/dist/services/interfaces.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"interfaces.js","sourceRoot":"","sources":["../../src/services/interfaces.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;;AAi2BH,0EAA0E","sourcesContent":["/*\n Service Interfaces\n \n Public interfaces for all core assessment toolkit services.\n * These interfaces define the contracts that service implementations must fulfill,\n * enabling dependency injection, testing, and custom implementations.\n \n Part of PIE Assessment Toolkit.\n /\n\nimport type { I18nServiceApi } from \"@pie-players/pie-players-shared/i18n\";\nimport type {\n\tAccessibilityCatalogResolver,\n\tCatalogLookupContext,\n\tCatalogLookupOptions,\n\tCatalogOwnerContext,\n\tCatalogStatistics,\n\tCatalogType,\n\tResolvedCatalog,\n} from \"./AccessibilityCatalogResolver.js\";\nimport type { FrameworkErrorListener } from \"./framework-error-bus.js\";\nimport type { HighlightColor, HighlightType } from \"./HighlightCoordinator.js\";\nimport type {\n\tSectionControllerHandle,\n\tSectionItemEventSubscriptionArgs,\n\tSectionScopedEventSubscriptionArgs,\n\tSectionEventSubscriptionArgs,\n\tToolkitCoordinatorHooks,\n\tToolkitInitStatus,\n} from \"./ToolkitCoordinator.js\";\nimport type { FontSize, ThemeConfig } from \"./ThemeProvider.js\";\nimport type { ZIndexLayer } from \"./ToolCoordinator.js\";\nimport type { PlaybackState, TTSConfig } from \"./TTSService.js\";\nimport type { TTSHighlightTargetResolverProvider } from \"./tts/highlight-target-resolver.js\";\nimport type {\n\tToolPlacementConfig,\n\tToolPlacementLevel,\n\tToolProviderConfig,\n} from \"./tools-config-normalizer.js\";\nimport type { ToolProviderRegistry } from \"./tool-providers/ToolProviderRegistry.js\";\nimport type {\n\tPolicySource,\n\tPnpEnforcementMode,\n\tResolvedEngineInputs,\n\tToolPolicyChangeListener,\n\tToolPolicyDecision,\n\tToolPolicyDecisionRequest,\n} from \"../policy/engine.js\";\nimport type {\n\tAssessmentEntity,\n\tAssessmentItemRef,\n} from \"@pie-players/pie-players-shared/types\";\nimport type {\n\tITTSProvider,\n\tTTSProviderCapabilities,\n} from \"@pie-players/pie-tts\";\nimport type {\n\tResolvedToolContext,\n\tToolContextResolver,\n\tToolContextResolverContext,\n\tToolContextResolverMap,\n} from \"./ToolRegistry.js\";\n\n// Re-export I18nServiceApi from players-shared\nexport type { I18nServiceApi };\n\n/\n Theme provider interface\n \n Applies consistent accessibility theming across items and tools.\n /\nexport interface ThemeProviderApi {\n\t/\n\t Apply theme configuration\n\t /\n\tapplyTheme(config: ThemeConfig): void;\n\n\t/\n\t Get current theme configuration\n\t /\n\tgetCurrentTheme(): Required<ThemeConfig>;\n\n\t/\n\t Reset to default theme\n\t /\n\treset(): void;\n\n\t/\n\t Clean up and remove theme styles\n\t /\n\tdestroy(): void;\n}\n\n/\n Highlight coordinator interface\n \n Manages content highlighting for TTS, annotations, and selections.\n /\nexport interface HighlightCoordinatorApi {\n\t/\n\t Highlight a text range\n\t /\n\thighlightRange(\n\t\trange: Range,\n\t\ttype: HighlightType,\n\t\tcolor: HighlightColor,\n\t): void;\n\n\t/\n\t Highlight a word for TTS (temporary)\n\t /\n\thighlightTTSWord(\n\t\ttextNode: Text,\n\t\tstartOffset: number,\n\t\tendOffset: number,\n\t): void;\n\n\t/\n\t Highlight a single element as the active TTS word (temporary).\n\t \n\t Marks exactly the supplied element (via `data-pie-tts-word-element`)\n\t * without walking up to a containing ancestor. Used for atomic targets that\n\t * have no direct text node to range over — most notably MathJax CHTML tokens\n\t * (e.g. `<mjx-mi><mjx-c/></mjx-mi>`) and whole-expression fallbacks. Painting\n\t * the element itself is what lets a resolved math token highlight as a token\n\t * rather than escalating to the full `<math>` / `<mjx-container>`.\n\t \n\t Optional so lightweight coordinator mocks can omit it.\n\t /\n\thighlightTTSWordElement?(element: Element): void;\n\n\t/\n\t Highlight sentence(s) for TTS (background layer)\n\t /\n\thighlightTTSSentence(ranges: Range[]): void;\n\n\t/\n\t Highlight sentence/block element targets for TTS (background layer).\n\t \n\t Optional so lightweight coordinator mocks can omit it.\n\t /\n\thighlightTTSSentenceElements?(elements: Element[]): void;\n\n\t/\n\t Clear all TTS highlights (word and sentence)\n\t /\n\tclearTTS(): void;\n\n\t/\n\t Clear highlights of a specific type\n\t /\n\tclearHighlights(type: HighlightType): void;\n\n\t/\n\t Clear all highlights\n\t /\n\tclearAll(): void;\n\n\t/\n\t Check if highlighting is supported in current environment\n\t /\n\tisSupported(): boolean;\n\n\t/\n\t Update TTS highlight style dynamically\n\t /\n\tupdateTTSHighlightStyle(color: string, opacity: number): void;\n}\n\n/\n Tool state interface\n /\nexport interface ToolState {\n\tid: string;\n\tname: string;\n\tisVisible: boolean;\n\telement: HTMLElement \| null;\n\tlayer: ZIndexLayer;\n}\n\n/\n Tool coordinator interface\n \n Manages z-index layering and visibility for floating tools.\n /\nexport interface ToolCoordinatorApi {\n\t/\n\t Register a tool with the coordinator\n\t /\n\tregisterTool(\n\t\tid: string,\n\t\tname: string,\n\t\telement?: HTMLElement,\n\t\tlayer?: ZIndexLayer,\n\t): void;\n\n\t/\n\t Unregister a tool\n\t /\n\tunregisterTool(id: string): void;\n\n\t/\n\t Show a tool\n\t /\n\tshowTool(id: string): void;\n\n\t/\n\t Hide a tool\n\t /\n\thideTool(id: string): void;\n\n\t/\n\t Toggle tool visibility\n\t /\n\ttoggleTool(id: string): void;\n\n\t/\n\t Check if tool is visible\n\t /\n\tisToolVisible(id: string): boolean;\n\n\t/\n\t Bring an element to the front of its layer\n\t /\n\tbringToFront(element: HTMLElement): void;\n\n\t/\n\t Update the element reference for a tool\n\t /\n\tupdateToolElement(id: string, element: HTMLElement): void;\n\n\t/\n\t Get state for a specific tool\n\t /\n\tgetToolState(id: string): ToolState \| undefined;\n\n\t/\n\t Get all visible tools\n\t /\n\tgetVisibleTools(): ToolState[];\n\n\t/\n\t Subscribe to tool state changes\n\t /\n\tsubscribe(listener: () => void): () => void;\n}\n\n/\n TTS service interface\n \n Provides text-to-speech functionality with provider-based architecture.\n * Supports QTI 3.0 accessibility catalogs for pre-authored spoken content.\n /\nexport interface TtsServiceApi {\n\t/\n\t Initialize TTS with a provider\n\t /\n\tinitialize(\n\t\tprovider: ITTSProvider,\n\t\tconfig?: Partial<TTSConfig>,\n\t): Promise<void>;\n\n\t/\n\t Speak text with optional catalog support\n\t /\n\tspeak(\n\t\ttext: string,\n\t\toptions?: {\n\t\t\tcatalogId?: string;\n\t\t\tcatalogContext?: CatalogLookupContext;\n\t\t\tlanguage?: string;\n\t\t\tcontentElement?: Element;\n\t\t},\n\t): Promise<void>;\n\n\t/\n\t Speak a text range\n\t /\n\tspeakRange(\n\t\trange: Range,\n\t\toptions?: { contentRoot?: Element \| null },\n\t): Promise<void>;\n\n\t/\n\t Pause playback\n\t /\n\tpause(): void;\n\n\t/\n\t Resume playback\n\t /\n\tresume(): void;\n\n\t/\n\t Stop playback\n\t /\n\tstop(): void;\n\n\t/\n\t Request active TTS controls to hand off/deactivate their UI state.\n\t \n\t This is an orchestration hint for TTS tool chrome and does not replace\n\t * playback controls such as stop/pause/resume.\n\t /\n\trequestControlHandoff(): void;\n\n\t/\n\t Seek forward by sentence units\n\t /\n\tseekForward(units?: number): Promise<void>;\n\n\t/\n\t Seek backward by sentence units\n\t /\n\tseekBackward(units?: number): Promise<void>;\n\n\t/\n\t Check if currently playing\n\t /\n\tisPlaying(): boolean;\n\n\t/\n\t Check if paused\n\t /\n\tisPaused(): boolean;\n\n\t/\n\t Get current playback state\n\t /\n\tgetState(): PlaybackState;\n\n\t/\n\t Get currently speaking text\n\t /\n\tgetCurrentText(): string \| null;\n\n\t/\n\t Subscribe to state changes\n\t /\n\tonStateChange(id: string, callback: (state: PlaybackState) => void): void;\n\n\t/\n\t Unsubscribe from state changes\n\t /\n\toffStateChange(id: string, callback: (state: PlaybackState) => void): void;\n\n\t/\n\t Get capabilities of current provider\n\t /\n\tgetCapabilities(): TTSProviderCapabilities \| null;\n\n\t/\n\t Update TTS settings dynamically (rate, pitch, voice)\n\t /\n\tupdateSettings(settings: Partial<TTSConfig>): Promise<void>;\n\n\t/\n\t Update playback speed and apply it to active planned playback.\n\t /\n\tsetPlaybackRate(rate: number): Promise<void>;\n\n\t/\n\t Set highlight coordinator for word highlighting\n\t /\n\tsetHighlightCoordinator(coordinator: HighlightCoordinatorApi): void;\n\n\t/\n\t Set a late-bound provider for optional host TTS highlight target remapping.\n\t /\n\tsetHighlightTargetResolverProvider?(\n\t\tprovider: TTSHighlightTargetResolverProvider \| null,\n\t): () => void;\n\n\t/\n\t Set accessibility catalog resolver for spoken content\n\t /\n\tsetCatalogResolver(resolver: AccessibilityCatalogResolver): void;\n}\n\n/\n Accessibility catalog resolver interface\n \n Manages QTI 3.0 accessibility catalogs at assessment and item levels.\n * Provides lookup and resolution services for alternative content representations.\n /\nexport interface AccessibilityCatalogResolverApi {\n\t/\n\t Set the default language for fallback resolution\n\t /\n\tsetDefaultLanguage(language: string): void;\n\n\t/\n\t Get the default language\n\t /\n\tgetDefaultLanguage(): string;\n\n\t/\n\t Add item-level catalogs (called when rendering a new item)\n\t /\n\taddItemCatalogs(catalogs: any[]): void;\n\n\t/\n\t Register catalogs scoped to a mounted content owner.\n\t /\n\tregisterCatalogs?(context: CatalogOwnerContext, catalogs: any[]): () => void;\n\n\t/\n\t Clear item-level catalogs (called when leaving an item)\n\t /\n\tclearItemCatalogs(): void;\n\n\t/\n\t Check if a catalog exists\n\t /\n\thasCatalog(catalogId: string): boolean;\n\n\t/\n\t Get alternative content for a catalog identifier\n\t /\n\tgetAlternative(\n\t\tcatalogId: string,\n\t\toptions: CatalogLookupOptions,\n\t): ResolvedCatalog \| null;\n\n\t/\n\t Get all available alternatives for a catalog identifier\n\t /\n\tgetAllAlternatives(catalogId: string): ResolvedCatalog[];\n\n\t/\n\t Get all catalog identifiers available\n\t /\n\tgetAllCatalogIds(): string[];\n\n\t/\n\t Get statistics about available catalogs\n\t /\n\tgetStatistics(): CatalogStatistics;\n\n\t/\n\t Check if a specific catalog type is available\n\t /\n\thasAlternativeType(catalogId: string, type: CatalogType): boolean;\n\n\t/\n\t Get all catalog IDs that have a specific type of alternative\n\t /\n\tgetCatalogsByType(type: CatalogType): string[];\n\n\t/\n\t Reset all catalogs\n\t /\n\treset(): void;\n\n\t/\n\t Destroy and cleanup\n\t /\n\tdestroy(): void;\n}\n\n/\n Element tool state store interface\n \n Manages element-level ephemeral tool state using composite keys for global uniqueness.\n * Tool state is client-only and separate from PIE session data (which is sent to server for scoring).\n /\nexport interface ElementToolStateStoreApi {\n\t/\n\t Generate a globally unique element ID from components\n\t /\n\tgetGlobalElementId(\n\t\tassessmentId: string,\n\t\tsectionId: string,\n\t\titemId: string,\n\t\telementId: string,\n\t): string;\n\n\t/\n\t Parse a global element ID into its components\n\t /\n\tparseGlobalElementId(globalElementId: string): {\n\t\tassessmentId: string;\n\t\tsectionId: string;\n\t\titemId: string;\n\t\telementId: string;\n\t} \| null;\n\n\t/\n\t Set state for a specific tool on an element\n\t /\n\tsetState(globalElementId: string, toolId: string, state: any): void;\n\n\t/\n\t Get state for a specific tool on an element\n\t /\n\tgetState(globalElementId: string, toolId: string): any \| undefined;\n\n\t/\n\t Get all tool states for a specific element\n\t /\n\tgetElementState(globalElementId: string): Record<string, any>;\n\n\t/\n\t Get all element states\n\t /\n\tgetAllState(): Record<string, Record<string, any>>;\n\n\t/\n\t Subscribe to state changes\n\t /\n\tsubscribe(\n\t\tcallback: (state: Map<string, Map<string, any>>) => void,\n\t): () => void;\n\n\t/\n\t Set callback for persistence integration\n\t /\n\tsetOnStateChange(\n\t\tcallback: (state: Record<string, Record<string, any>>) => void,\n\t): void;\n\n\t/\n\t Load state from persistence\n\t /\n\tloadState(state: Record<string, Record<string, any>>): void;\n\n\t/\n\t Clear state for a specific element\n\t /\n\tclearElement(globalElementId: string): void;\n\n\t/\n\t Clear state for a specific tool across all elements\n\t /\n\tclearTool(toolId: string): void;\n\n\t/\n\t Clear all elements in a specific section\n\t /\n\tclearSection(assessmentId: string, sectionId: string): void;\n\n\t/\n\t Clear all state\n\t /\n\tclearAll(): void;\n}\n\n/\n Toolkit coordinator interface\n \n Orchestrates all toolkit services (TTS, tools, accessibility, state management) from a single entry point.\n * Provides centralized configuration for tool availability and settings.\n /\nexport interface ToolkitCoordinatorApi {\n\t/\n\t Assessment identifier\n\t /\n\treadonly assessmentId: string;\n\n\t/\n\t Configuration\n\t /\n\treadonly config: {\n\t\ttools?: {\n\t\t\tproviders?: Record<string, ToolProviderConfig \| undefined>;\n\t\t};\n\t};\n\n\t/\n\t TTS service\n\t /\n\treadonly ttsService: TtsServiceApi;\n\n\t/\n\t Tool coordinator\n\t /\n\treadonly toolCoordinator: ToolCoordinatorApi;\n\n\t/\n\t Highlight coordinator\n\t /\n\treadonly highlightCoordinator: HighlightCoordinatorApi;\n\n\t/\n\t Element tool state store\n\t /\n\treadonly elementToolStateStore: ElementToolStateStoreApi;\n\n\t/\n\t Catalog resolver\n\t /\n\treadonly catalogResolver: AccessibilityCatalogResolverApi;\n\n\t/\n\t Tool provider registry\n\t /\n\treadonly toolProviderRegistry: ToolProviderRegistry;\n\n\t/\n\t Get all services as a bundle\n\t /\n\tgetServiceBundle(): {\n\t\tttsService: TtsServiceApi;\n\t\ttoolCoordinator: ToolCoordinatorApi;\n\t\thighlightCoordinator: HighlightCoordinatorApi;\n\t\telementToolStateStore: ElementToolStateStoreApi;\n\t\tcatalogResolver: AccessibilityCatalogResolverApi;\n\t\ttoolProviderRegistry: ToolProviderRegistry;\n\t};\n\n\t/\n\t Ensure TTS service is initialized and ready.\n\t /\n\tensureTTSReady(config?: Record<string, unknown>): Promise<void>;\n\n\t/\n\t Ensure a provider is initialized and ready.\n\t /\n\tensureProviderReady(providerId: string): Promise<unknown>;\n\n\t/\n\t Wait until coordinator initialization is complete.\n\t /\n\twaitUntilReady(): Promise<void>;\n\n\t/\n\t Check if coordinator has completed initialization.\n\t /\n\tisReady(): boolean;\n\n\t/\n\t Read current initialization status.\n\t /\n\tgetInitStatus(): ToolkitInitStatus;\n\n\t/\n\t Check if a tool is enabled\n\t /\n\tisToolEnabled(toolId: string): boolean;\n\n\t/\n\t Get tool configuration\n\t /\n\tgetToolConfig(toolId: string): ToolProviderConfig \| null;\n\n\t/\n\t Update tool configuration\n\t /\n\tupdateToolConfig(toolId: string, updates: Partial<ToolProviderConfig>): void;\n\n\t/\n\t Update the enabled tool list for one placement level.\n\t /\n\tupdateToolPlacement(level: ToolPlacementLevel, toolIds: string[]): void;\n\n\t/\n\t Patch one or more placement levels in the canonical tools config.\n\t /\n\tupdateToolsPlacement(partial: ToolPlacementConfig): void;\n\n\t/\n\t Register or update lifecycle hooks at runtime.\n\t /\n\tsetHooks(hooks: ToolkitCoordinatorHooks): void;\n\n\t/\n\t Return a section controller if already created.\n\t /\n\tgetSectionController(args: {\n\t\tsectionId: string;\n\t\tattemptId?: string;\n\t}): SectionControllerHandle \| undefined;\n\n\t/\n\t Subscribe to section controller events.\n\t \n\t The listener is bound to the toolkit's active section cohort and\n\t * automatically migrates across cohort transitions\n\t * (`getOrCreateSectionController` for a different cohort). On every\n\t * migration the listener receives a snapshot replay of the new\n\t * cohort's already-loaded `content-loaded` events followed by the\n\t * aggregate `section-loading-complete`, in the canonical order a\n\t * fresh subscriber would have observed.\n\t \n\t Throws if no active section cohort exists; host code must call\n\t * `getOrCreateSectionController(...)` at least once before\n\t * subscribing. (`toolkit-ready` alone is not sufficient — it fires\n\t * once toolkit state has loaded but before any section controller\n\t * has been created.) The typical pattern is to subscribe once\n\t * immediately after the first `getOrCreateSectionController(...)`\n\t * resolves; the subscription then follows the active cohort across\n\t * all subsequent navigation without further wiring.\n\t \n\t Subscribing the same `listener` reference twice replaces the prior\n\t * subscription with the new one (filter args from the second call\n\t * win); calling the returned disposer twice is a no-op.\n\t \n\t A listener that throws is caught and `console.warn`-logged; the\n\t * throw does not interrupt fan-out to the remaining listeners.\n\t /\n\tsubscribeSectionEvents(args: SectionEventSubscriptionArgs): () => void;\n\n\t/\n\t Subscribe to item-scoped section controller events.\n\t \n\t Same active-cohort binding contract as {@link subscribeSectionEvents};\n\t * defaults `eventTypes` to the item-scoped subset.\n\t /\n\tsubscribeItemEvents(args: SectionItemEventSubscriptionArgs): () => void;\n\n\t/\n\t Subscribe to section-scoped lifecycle/loading/completion/error events.\n\t \n\t Same active-cohort binding contract as {@link subscribeSectionEvents};\n\t * defaults `eventTypes` to the section-scoped subset.\n\t /\n\tsubscribeSectionLifecycleEvents(\n\t\targs: SectionScopedEventSubscriptionArgs,\n\t): () => void;\n\n\t/\n\t Create or reuse a section controller with single-flight deduplication.\n\t /\n\tgetOrCreateSectionController(args: {\n\t\tsectionId: string;\n\t\tattemptId?: string;\n\t\tinput?: unknown;\n\t\tupdateExisting?: boolean;\n\t\tcreateDefaultController: () =>\n\t\t\t\| SectionControllerHandle\n\t\t\t\| Promise<SectionControllerHandle>;\n\t}): Promise<SectionControllerHandle>;\n\n\t/\n\t Dispose an existing section controller.\n\t /\n\tdisposeSectionController(args: {\n\t\tsectionId: string;\n\t\tattemptId?: string;\n\t\tpersistBeforeDispose?: boolean;\n\t\tclearPersistence?: boolean;\n\t}): Promise<void>;\n\n\t/\n\t Subscribe to framework-error events emitted by the coordinator.\n\t \n\t Mirrors the shape of {@link subscribeTelemetry} (see\n\t * `ToolkitCoordinator.subscribeTelemetry`): a synchronous,\n\t * multi-subscriber stream where each call to the internal bus's\n\t * `reportFrameworkError` fans out to every active listener exactly once.\n\t \n\t The returned function detaches the listener; calling it twice is a\n\t * no-op. A listener that throws is caught and logged; the throw does\n\t * not break fan-out to the remaining listeners.\n\t \n\t Use this to wire framework errors into Sentry / Datadog / a custom\n\t * banner without listening on a DOM event. The DOM event\n\t * (`framework-error`) and the canonical `onFrameworkError` prop on\n\t * `<pie-assessment-toolkit>` consume the same bus.\n\t /\n\tsubscribeFrameworkErrors(listener: FrameworkErrorListener): () => void;\n\n\t// ----------------------------------------------------------------\n\t// Tool Policy Engine — public surface (M8 PR 2 / PR 3).\n\t//\n\t// The coordinator owns a single `ToolPolicyEngine` instance and\n\t// exposes its decision and subscription surface through the API\n\t// so that toolbar custom elements (`pie-item-toolbar`,\n\t// `pie-section-toolbar`), the base section player, and bespoke\n\t// host instrumentation (PNP debugger, etc.) all flow through the\n\t// same engine. Hosts that want to drive PNP/profile inputs imperatively\n\t// (instead of binding props on `<pie-assessment-toolkit>`) call\n\t// `updateAssessment` / `updateCurrentItemRef` /\n\t// `setPnpEnforcement` directly.\n\t// ----------------------------------------------------------------\n\n\t/\n\t Resolve the visible tool set for a given placement level + scope.\n\t * Returns the engine's full decision (visible tools, diagnostics,\n\t * provenance). Hosts that only need the IDs may map\n\t * `decision.visibleTools` themselves.\n\t /\n\tdecideToolPolicy(request: ToolPolicyDecisionRequest): ToolPolicyDecision;\n\n\t/\n\t Subscribe to policy-engine change events. Fires whenever the\n\t * coordinator's bound policy inputs change (`updateToolConfig`,\n\t * `updateToolPlacement`, `updateAssessment`, `updateCurrentItemRef`,\n\t * `setPnpEnforcement`) or a custom `PolicySource` is registered /\n\t * removed. Listeners that need the new visible tool set should\n\t * call `decideToolPolicy(...)` with their level / scope.\n\t /\n\tonPolicyChange(listener: ToolPolicyChangeListener): () => void;\n\n\t/\n\t Bind (or clear) the active assessment for PNP/profile policy decisions.\n\t \n\t Under auto-mode (no host override via {@link setPnpEnforcement}),\n\t * the engine flips to `pnpEnforcement: \"on\"` iff the assessment\n\t * carries profile precedence material (`personalNeedsProfile`,\n\t * `settings.districtPolicy`, `settings.testAdministration`) or the\n\t * currently-bound item ref carries item-level profile inputs. A bare\n\t * assessment record (just `id` / `name`) keeps `\"off\"`.\n\t \n\t The host override set via {@link setPnpEnforcement} is sticky\n\t * across assessment swaps.\n\t /\n\tupdateAssessment(assessment: AssessmentEntity \| null): void;\n\n\t/\n\t Bind (or clear) the current item reference for policy decisions.\n\t * Used by item-level profile gates (item `requiredTools` /\n\t * `restrictedTools` / `toolParameters`). Item-level profile material\n\t * also feeds the auto-mode helper — navigating to an item with\n\t * profile settings can flip auto-mode to `\"on\"` even when the parent\n\t * assessment carries no profile block of its own.\n\t /\n\tupdateCurrentItemRef(itemRef: AssessmentItemRef \| null): void;\n\n\t/\n\t Override the auto-mode PNP/profile enforcement decision. Pass `\"on\"` /\n\t * `\"off\"` to pin the mode, or `null` to clear the override and\n\t * return to auto-mode (`\"on\"` iff the bound assessment / item ref\n\t * carries profile material, otherwise `\"off\"`).\n\t /\n\tsetPnpEnforcement(mode: PnpEnforcementMode \| null): void;\n\n\t/\n\t Read the engine inputs currently driving decisions. Useful for\n\t * debugging / instrumentation; do not mutate.\n\t /\n\tgetPolicyInputs(): Readonly<ResolvedEngineInputs>;\n\n\t/\n\t Register a custom `PolicySource`. The source participates in\n\t * every subsequent `decideToolPolicy(...)` call until disposed\n\t * (the returned function detaches).\n\t /\n\tregisterPolicySource(source: PolicySource): () => void;\n\n\t/\n\t Register a host-owned resolver for scoped tool render context.\n\t /\n\tregisterToolContextResolver(\n\t\ttoolId: string,\n\t\tresolver: ToolContextResolver,\n\t): () => void;\n\n\t/\n\t Replace all host-owned render-context resolvers.\n\t /\n\tsetToolContextResolvers(\n\t\tresolvers: ToolContextResolverMap \| null \| undefined,\n\t): void;\n\n\t/\n\t Whether a host resolver is registered for this tool.\n\t /\n\thasToolContextResolver(toolId: string): boolean;\n\n\t/\n\t Resolve render visibility/params for a tool that already survived policy gates.\n\t /\n\tresolveToolContext(\n\t\tcontext: ToolContextResolverContext,\n\t): ResolvedToolContext \| null;\n\n\t/\n\t Subscribe to resolver registration/removal changes.\n\t */\n\tonToolContextResolverChange(listener: () => void): () => void;\n}\n\n// I18nServiceApi is re-exported from @pie-players/pie-players-shared/i18n\n"]}
1	+ {"version":3,"file":"interfaces.js","sourceRoot":"","sources":["../../src/services/interfaces.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;;AAw2BH,0EAA0E","sourcesContent":["/*\n Service Interfaces\n \n Public interfaces for all core assessment toolkit services.\n * These interfaces define the contracts that service implementations must fulfill,\n * enabling dependency injection, testing, and custom implementations.\n \n Part of PIE Assessment Toolkit.\n /\n\nimport type { I18nServiceApi } from \"@pie-players/pie-players-shared/i18n\";\nimport type {\n\tAccessibilityCatalogResolver,\n\tCatalogLookupContext,\n\tCatalogLookupOptions,\n\tCatalogOwnerContext,\n\tCatalogStatistics,\n\tCatalogType,\n\tResolvedCatalog,\n} from \"./AccessibilityCatalogResolver.js\";\nimport type { FrameworkErrorListener } from \"./framework-error-bus.js\";\nimport type { HighlightColor, HighlightType } from \"./HighlightCoordinator.js\";\nimport type {\n\tSectionControllerHandle,\n\tSectionItemEventSubscriptionArgs,\n\tSectionScopedEventSubscriptionArgs,\n\tSectionEventSubscriptionArgs,\n\tToolkitCoordinatorHooks,\n\tToolkitInitStatus,\n} from \"./ToolkitCoordinator.js\";\nimport type { FontSize, ThemeConfig } from \"./ThemeProvider.js\";\nimport type { ZIndexLayer } from \"./ToolCoordinator.js\";\nimport type { PlaybackState, TTSConfig } from \"./TTSService.js\";\nimport type { TTSHighlightTargetResolverProvider } from \"./tts/highlight-target-resolver.js\";\nimport type {\n\tToolPlacementConfig,\n\tToolPlacementLevel,\n\tToolProviderConfig,\n} from \"./tools-config-normalizer.js\";\nimport type { ToolProviderRegistry } from \"./tool-providers/ToolProviderRegistry.js\";\nimport type {\n\tPolicySource,\n\tPnpEnforcementMode,\n\tResolvedEngineInputs,\n\tToolPolicyChangeListener,\n\tToolPolicyDecision,\n\tToolPolicyDecisionRequest,\n} from \"../policy/engine.js\";\nimport type {\n\tAssessmentEntity,\n\tAssessmentItemRef,\n} from \"@pie-players/pie-players-shared/types\";\nimport type {\n\tITTSProvider,\n\tTTSProviderCapabilities,\n} from \"@pie-players/pie-tts\";\nimport type {\n\tResolvedToolContext,\n\tToolContextResolver,\n\tToolContextResolverContext,\n\tToolContextResolverMap,\n} from \"./ToolRegistry.js\";\n\n// Re-export I18nServiceApi from players-shared\nexport type { I18nServiceApi };\n\n/\n Theme provider interface\n \n Applies consistent accessibility theming across items and tools.\n /\nexport interface ThemeProviderApi {\n\t/\n\t Apply theme configuration\n\t /\n\tapplyTheme(config: ThemeConfig): void;\n\n\t/\n\t Get current theme configuration\n\t /\n\tgetCurrentTheme(): Required<ThemeConfig>;\n\n\t/\n\t Reset to default theme\n\t /\n\treset(): void;\n\n\t/\n\t Clean up and remove theme styles\n\t /\n\tdestroy(): void;\n}\n\n/\n Highlight coordinator interface\n \n Manages content highlighting for TTS, annotations, and selections.\n /\nexport interface HighlightCoordinatorApi {\n\t/\n\t Highlight a text range\n\t /\n\thighlightRange(\n\t\trange: Range,\n\t\ttype: HighlightType,\n\t\tcolor: HighlightColor,\n\t): void;\n\n\t/\n\t Highlight a word for TTS (temporary)\n\t /\n\thighlightTTSWord(\n\t\ttextNode: Text,\n\t\tstartOffset: number,\n\t\tendOffset: number,\n\t): void;\n\n\t/\n\t Highlight a single element as the active TTS word (temporary).\n\t \n\t Marks exactly the supplied element (via `data-pie-tts-word-element`)\n\t * without walking up to a containing ancestor. Used for atomic targets that\n\t * have no direct text node to range over — most notably MathJax CHTML tokens\n\t * (e.g. `<mjx-mi><mjx-c/></mjx-mi>`) and whole-expression fallbacks. Painting\n\t * the element itself is what lets a resolved math token highlight as a token\n\t * rather than escalating to the full `<math>` / `<mjx-container>`.\n\t \n\t Optional so lightweight coordinator mocks can omit it.\n\t /\n\thighlightTTSWordElement?(element: Element): void;\n\n\t/\n\t Highlight sentence(s) for TTS (background layer)\n\t /\n\thighlightTTSSentence(ranges: Range[]): void;\n\n\t/\n\t Highlight sentence/block element targets for TTS (background layer).\n\t \n\t Optional so lightweight coordinator mocks can omit it.\n\t /\n\thighlightTTSSentenceElements?(elements: Element[]): void;\n\n\t/\n\t Clear all TTS highlights (word and sentence)\n\t /\n\tclearTTS(): void;\n\n\t/\n\t Clear highlights of a specific type\n\t /\n\tclearHighlights(type: HighlightType): void;\n\n\t/\n\t Clear all highlights\n\t /\n\tclearAll(): void;\n\n\t/\n\t Check if highlighting is supported in current environment\n\t /\n\tisSupported(): boolean;\n\n\t/\n\t Update TTS highlight style dynamically\n\t /\n\tupdateTTSHighlightStyle(color: string, opacity: number): void;\n}\n\n/\n Tool state interface\n /\nexport interface ToolState {\n\tid: string;\n\tname: string;\n\tisVisible: boolean;\n\telement: HTMLElement \| null;\n\tlayer: ZIndexLayer;\n}\n\n/\n Tool coordinator interface\n \n Manages z-index layering and visibility for floating tools.\n /\nexport interface ToolCoordinatorApi {\n\t/\n\t Register a tool with the coordinator\n\t /\n\tregisterTool(\n\t\tid: string,\n\t\tname: string,\n\t\telement?: HTMLElement,\n\t\tlayer?: ZIndexLayer,\n\t): void;\n\n\t/\n\t Unregister a tool's element binding while preserving its activation\n\t * (on/off) state, so a re-registration of the same id restores it.\n\t /\n\tunregisterTool(id: string): void;\n\n\t/\n\t Fully release a tool: unregister and discard its preserved activation\n\t * state. Use on genuine teardown rather than `unregisterTool`.\n\t /\n\treleaseTool(id: string): void;\n\n\t/\n\t Show a tool\n\t /\n\tshowTool(id: string): void;\n\n\t/\n\t Hide a tool\n\t /\n\thideTool(id: string): void;\n\n\t/\n\t Toggle tool visibility\n\t /\n\ttoggleTool(id: string): void;\n\n\t/\n\t Check if tool is visible\n\t /\n\tisToolVisible(id: string): boolean;\n\n\t/\n\t Bring an element to the front of its layer\n\t /\n\tbringToFront(element: HTMLElement): void;\n\n\t/\n\t Update the element reference for a tool\n\t /\n\tupdateToolElement(id: string, element: HTMLElement): void;\n\n\t/\n\t Get state for a specific tool\n\t /\n\tgetToolState(id: string): ToolState \| undefined;\n\n\t/\n\t Get all visible tools\n\t /\n\tgetVisibleTools(): ToolState[];\n\n\t/\n\t Subscribe to tool state changes\n\t /\n\tsubscribe(listener: () => void): () => void;\n}\n\n/\n TTS service interface\n \n Provides text-to-speech functionality with provider-based architecture.\n * Supports QTI 3.0 accessibility catalogs for pre-authored spoken content.\n /\nexport interface TtsServiceApi {\n\t/\n\t Initialize TTS with a provider\n\t /\n\tinitialize(\n\t\tprovider: ITTSProvider,\n\t\tconfig?: Partial<TTSConfig>,\n\t): Promise<void>;\n\n\t/\n\t Speak text with optional catalog support\n\t /\n\tspeak(\n\t\ttext: string,\n\t\toptions?: {\n\t\t\tcatalogId?: string;\n\t\t\tcatalogContext?: CatalogLookupContext;\n\t\t\tlanguage?: string;\n\t\t\tcontentElement?: Element;\n\t\t},\n\t): Promise<void>;\n\n\t/\n\t Speak a text range\n\t /\n\tspeakRange(\n\t\trange: Range,\n\t\toptions?: { contentRoot?: Element \| null },\n\t): Promise<void>;\n\n\t/\n\t Pause playback\n\t /\n\tpause(): void;\n\n\t/\n\t Resume playback\n\t /\n\tresume(): void;\n\n\t/\n\t Stop playback\n\t /\n\tstop(): void;\n\n\t/\n\t Request active TTS controls to hand off/deactivate their UI state.\n\t \n\t This is an orchestration hint for TTS tool chrome and does not replace\n\t * playback controls such as stop/pause/resume.\n\t /\n\trequestControlHandoff(): void;\n\n\t/\n\t Seek forward by sentence units\n\t /\n\tseekForward(units?: number): Promise<void>;\n\n\t/\n\t Seek backward by sentence units\n\t /\n\tseekBackward(units?: number): Promise<void>;\n\n\t/\n\t Check if currently playing\n\t /\n\tisPlaying(): boolean;\n\n\t/\n\t Check if paused\n\t /\n\tisPaused(): boolean;\n\n\t/\n\t Get current playback state\n\t /\n\tgetState(): PlaybackState;\n\n\t/\n\t Get currently speaking text\n\t /\n\tgetCurrentText(): string \| null;\n\n\t/\n\t Subscribe to state changes\n\t /\n\tonStateChange(id: string, callback: (state: PlaybackState) => void): void;\n\n\t/\n\t Unsubscribe from state changes\n\t /\n\toffStateChange(id: string, callback: (state: PlaybackState) => void): void;\n\n\t/\n\t Get capabilities of current provider\n\t /\n\tgetCapabilities(): TTSProviderCapabilities \| null;\n\n\t/\n\t Update TTS settings dynamically (rate, pitch, voice)\n\t /\n\tupdateSettings(settings: Partial<TTSConfig>): Promise<void>;\n\n\t/\n\t Update playback speed and apply it to active planned playback.\n\t /\n\tsetPlaybackRate(rate: number): Promise<void>;\n\n\t/\n\t Set highlight coordinator for word highlighting\n\t /\n\tsetHighlightCoordinator(coordinator: HighlightCoordinatorApi): void;\n\n\t/\n\t Set a late-bound provider for optional host TTS highlight target remapping.\n\t /\n\tsetHighlightTargetResolverProvider?(\n\t\tprovider: TTSHighlightTargetResolverProvider \| null,\n\t): () => void;\n\n\t/\n\t Set accessibility catalog resolver for spoken content\n\t /\n\tsetCatalogResolver(resolver: AccessibilityCatalogResolver): void;\n}\n\n/\n Accessibility catalog resolver interface\n \n Manages QTI 3.0 accessibility catalogs at assessment and item levels.\n * Provides lookup and resolution services for alternative content representations.\n /\nexport interface AccessibilityCatalogResolverApi {\n\t/\n\t Set the default language for fallback resolution\n\t /\n\tsetDefaultLanguage(language: string): void;\n\n\t/\n\t Get the default language\n\t /\n\tgetDefaultLanguage(): string;\n\n\t/\n\t Add item-level catalogs (called when rendering a new item)\n\t /\n\taddItemCatalogs(catalogs: any[]): void;\n\n\t/\n\t Register catalogs scoped to a mounted content owner.\n\t /\n\tregisterCatalogs?(context: CatalogOwnerContext, catalogs: any[]): () => void;\n\n\t/\n\t Clear item-level catalogs (called when leaving an item)\n\t /\n\tclearItemCatalogs(): void;\n\n\t/\n\t Check if a catalog exists\n\t /\n\thasCatalog(catalogId: string): boolean;\n\n\t/\n\t Get alternative content for a catalog identifier\n\t /\n\tgetAlternative(\n\t\tcatalogId: string,\n\t\toptions: CatalogLookupOptions,\n\t): ResolvedCatalog \| null;\n\n\t/\n\t Get all available alternatives for a catalog identifier\n\t /\n\tgetAllAlternatives(catalogId: string): ResolvedCatalog[];\n\n\t/\n\t Get all catalog identifiers available\n\t /\n\tgetAllCatalogIds(): string[];\n\n\t/\n\t Get statistics about available catalogs\n\t /\n\tgetStatistics(): CatalogStatistics;\n\n\t/\n\t Check if a specific catalog type is available\n\t /\n\thasAlternativeType(catalogId: string, type: CatalogType): boolean;\n\n\t/\n\t Get all catalog IDs that have a specific type of alternative\n\t /\n\tgetCatalogsByType(type: CatalogType): string[];\n\n\t/\n\t Reset all catalogs\n\t /\n\treset(): void;\n\n\t/\n\t Destroy and cleanup\n\t /\n\tdestroy(): void;\n}\n\n/\n Element tool state store interface\n \n Manages element-level ephemeral tool state using composite keys for global uniqueness.\n * Tool state is client-only and separate from PIE session data (which is sent to server for scoring).\n /\nexport interface ElementToolStateStoreApi {\n\t/\n\t Generate a globally unique element ID from components\n\t /\n\tgetGlobalElementId(\n\t\tassessmentId: string,\n\t\tsectionId: string,\n\t\titemId: string,\n\t\telementId: string,\n\t): string;\n\n\t/\n\t Parse a global element ID into its components\n\t /\n\tparseGlobalElementId(globalElementId: string): {\n\t\tassessmentId: string;\n\t\tsectionId: string;\n\t\titemId: string;\n\t\telementId: string;\n\t} \| null;\n\n\t/\n\t Set state for a specific tool on an element\n\t /\n\tsetState(globalElementId: string, toolId: string, state: any): void;\n\n\t/\n\t Get state for a specific tool on an element\n\t /\n\tgetState(globalElementId: string, toolId: string): any \| undefined;\n\n\t/\n\t Get all tool states for a specific element\n\t /\n\tgetElementState(globalElementId: string): Record<string, any>;\n\n\t/\n\t Get all element states\n\t /\n\tgetAllState(): Record<string, Record<string, any>>;\n\n\t/\n\t Subscribe to state changes\n\t /\n\tsubscribe(\n\t\tcallback: (state: Map<string, Map<string, any>>) => void,\n\t): () => void;\n\n\t/\n\t Set callback for persistence integration\n\t /\n\tsetOnStateChange(\n\t\tcallback: (state: Record<string, Record<string, any>>) => void,\n\t): void;\n\n\t/\n\t Load state from persistence\n\t /\n\tloadState(state: Record<string, Record<string, any>>): void;\n\n\t/\n\t Clear state for a specific element\n\t /\n\tclearElement(globalElementId: string): void;\n\n\t/\n\t Clear state for a specific tool across all elements\n\t /\n\tclearTool(toolId: string): void;\n\n\t/\n\t Clear all elements in a specific section\n\t /\n\tclearSection(assessmentId: string, sectionId: string): void;\n\n\t/\n\t Clear all state\n\t /\n\tclearAll(): void;\n}\n\n/\n Toolkit coordinator interface\n \n Orchestrates all toolkit services (TTS, tools, accessibility, state management) from a single entry point.\n * Provides centralized configuration for tool availability and settings.\n /\nexport interface ToolkitCoordinatorApi {\n\t/\n\t Assessment identifier\n\t /\n\treadonly assessmentId: string;\n\n\t/\n\t Configuration\n\t /\n\treadonly config: {\n\t\ttools?: {\n\t\t\tproviders?: Record<string, ToolProviderConfig \| undefined>;\n\t\t};\n\t};\n\n\t/\n\t TTS service\n\t /\n\treadonly ttsService: TtsServiceApi;\n\n\t/\n\t Tool coordinator\n\t /\n\treadonly toolCoordinator: ToolCoordinatorApi;\n\n\t/\n\t Highlight coordinator\n\t /\n\treadonly highlightCoordinator: HighlightCoordinatorApi;\n\n\t/\n\t Element tool state store\n\t /\n\treadonly elementToolStateStore: ElementToolStateStoreApi;\n\n\t/\n\t Catalog resolver\n\t /\n\treadonly catalogResolver: AccessibilityCatalogResolverApi;\n\n\t/\n\t Tool provider registry\n\t /\n\treadonly toolProviderRegistry: ToolProviderRegistry;\n\n\t/\n\t Get all services as a bundle\n\t /\n\tgetServiceBundle(): {\n\t\tttsService: TtsServiceApi;\n\t\ttoolCoordinator: ToolCoordinatorApi;\n\t\thighlightCoordinator: HighlightCoordinatorApi;\n\t\telementToolStateStore: ElementToolStateStoreApi;\n\t\tcatalogResolver: AccessibilityCatalogResolverApi;\n\t\ttoolProviderRegistry: ToolProviderRegistry;\n\t};\n\n\t/\n\t Ensure TTS service is initialized and ready.\n\t /\n\tensureTTSReady(config?: Record<string, unknown>): Promise<void>;\n\n\t/\n\t Ensure a provider is initialized and ready.\n\t /\n\tensureProviderReady(providerId: string): Promise<unknown>;\n\n\t/\n\t Wait until coordinator initialization is complete.\n\t /\n\twaitUntilReady(): Promise<void>;\n\n\t/\n\t Check if coordinator has completed initialization.\n\t /\n\tisReady(): boolean;\n\n\t/\n\t Read current initialization status.\n\t /\n\tgetInitStatus(): ToolkitInitStatus;\n\n\t/\n\t Check if a tool is enabled\n\t /\n\tisToolEnabled(toolId: string): boolean;\n\n\t/\n\t Get tool configuration\n\t /\n\tgetToolConfig(toolId: string): ToolProviderConfig \| null;\n\n\t/\n\t Update tool configuration\n\t /\n\tupdateToolConfig(toolId: string, updates: Partial<ToolProviderConfig>): void;\n\n\t/\n\t Update the enabled tool list for one placement level.\n\t /\n\tupdateToolPlacement(level: ToolPlacementLevel, toolIds: string[]): void;\n\n\t/\n\t Patch one or more placement levels in the canonical tools config.\n\t /\n\tupdateToolsPlacement(partial: ToolPlacementConfig): void;\n\n\t/\n\t Register or update lifecycle hooks at runtime.\n\t /\n\tsetHooks(hooks: ToolkitCoordinatorHooks): void;\n\n\t/\n\t Return a section controller if already created.\n\t /\n\tgetSectionController(args: {\n\t\tsectionId: string;\n\t\tattemptId?: string;\n\t}): SectionControllerHandle \| undefined;\n\n\t/\n\t Subscribe to section controller events.\n\t \n\t The listener is bound to the toolkit's active section cohort and\n\t * automatically migrates across cohort transitions\n\t * (`getOrCreateSectionController` for a different cohort). On every\n\t * migration the listener receives a snapshot replay of the new\n\t * cohort's already-loaded `content-loaded` events followed by the\n\t * aggregate `section-loading-complete`, in the canonical order a\n\t * fresh subscriber would have observed.\n\t \n\t Throws if no active section cohort exists; host code must call\n\t * `getOrCreateSectionController(...)` at least once before\n\t * subscribing. (`toolkit-ready` alone is not sufficient — it fires\n\t * once toolkit state has loaded but before any section controller\n\t * has been created.) The typical pattern is to subscribe once\n\t * immediately after the first `getOrCreateSectionController(...)`\n\t * resolves; the subscription then follows the active cohort across\n\t * all subsequent navigation without further wiring.\n\t \n\t Subscribing the same `listener` reference twice replaces the prior\n\t * subscription with the new one (filter args from the second call\n\t * win); calling the returned disposer twice is a no-op.\n\t \n\t A listener that throws is caught and `console.warn`-logged; the\n\t * throw does not interrupt fan-out to the remaining listeners.\n\t /\n\tsubscribeSectionEvents(args: SectionEventSubscriptionArgs): () => void;\n\n\t/\n\t Subscribe to item-scoped section controller events.\n\t \n\t Same active-cohort binding contract as {@link subscribeSectionEvents};\n\t * defaults `eventTypes` to the item-scoped subset.\n\t /\n\tsubscribeItemEvents(args: SectionItemEventSubscriptionArgs): () => void;\n\n\t/\n\t Subscribe to section-scoped lifecycle/loading/completion/error events.\n\t \n\t Same active-cohort binding contract as {@link subscribeSectionEvents};\n\t * defaults `eventTypes` to the section-scoped subset.\n\t /\n\tsubscribeSectionLifecycleEvents(\n\t\targs: SectionScopedEventSubscriptionArgs,\n\t): () => void;\n\n\t/\n\t Create or reuse a section controller with single-flight deduplication.\n\t /\n\tgetOrCreateSectionController(args: {\n\t\tsectionId: string;\n\t\tattemptId?: string;\n\t\tinput?: unknown;\n\t\tupdateExisting?: boolean;\n\t\tcreateDefaultController: () =>\n\t\t\t\| SectionControllerHandle\n\t\t\t\| Promise<SectionControllerHandle>;\n\t}): Promise<SectionControllerHandle>;\n\n\t/\n\t Dispose an existing section controller.\n\t /\n\tdisposeSectionController(args: {\n\t\tsectionId: string;\n\t\tattemptId?: string;\n\t\tpersistBeforeDispose?: boolean;\n\t\tclearPersistence?: boolean;\n\t}): Promise<void>;\n\n\t/\n\t Subscribe to framework-error events emitted by the coordinator.\n\t \n\t Mirrors the shape of {@link subscribeTelemetry} (see\n\t * `ToolkitCoordinator.subscribeTelemetry`): a synchronous,\n\t * multi-subscriber stream where each call to the internal bus's\n\t * `reportFrameworkError` fans out to every active listener exactly once.\n\t \n\t The returned function detaches the listener; calling it twice is a\n\t * no-op. A listener that throws is caught and logged; the throw does\n\t * not break fan-out to the remaining listeners.\n\t \n\t Use this to wire framework errors into Sentry / Datadog / a custom\n\t * banner without listening on a DOM event. The DOM event\n\t * (`framework-error`) and the canonical `onFrameworkError` prop on\n\t * `<pie-assessment-toolkit>` consume the same bus.\n\t /\n\tsubscribeFrameworkErrors(listener: FrameworkErrorListener): () => void;\n\n\t// ----------------------------------------------------------------\n\t// Tool Policy Engine — public surface (M8 PR 2 / PR 3).\n\t//\n\t// The coordinator owns a single `ToolPolicyEngine` instance and\n\t// exposes its decision and subscription surface through the API\n\t// so that toolbar custom elements (`pie-item-toolbar`,\n\t// `pie-section-toolbar`), the base section player, and bespoke\n\t// host instrumentation (PNP debugger, etc.) all flow through the\n\t// same engine. Hosts that want to drive PNP/profile inputs imperatively\n\t// (instead of binding props on `<pie-assessment-toolkit>`) call\n\t// `updateAssessment` / `updateCurrentItemRef` /\n\t// `setPnpEnforcement` directly.\n\t// ----------------------------------------------------------------\n\n\t/\n\t Resolve the visible tool set for a given placement level + scope.\n\t * Returns the engine's full decision (visible tools, diagnostics,\n\t * provenance). Hosts that only need the IDs may map\n\t * `decision.visibleTools` themselves.\n\t /\n\tdecideToolPolicy(request: ToolPolicyDecisionRequest): ToolPolicyDecision;\n\n\t/\n\t Subscribe to policy-engine change events. Fires whenever the\n\t * coordinator's bound policy inputs change (`updateToolConfig`,\n\t * `updateToolPlacement`, `updateAssessment`, `updateCurrentItemRef`,\n\t * `setPnpEnforcement`) or a custom `PolicySource` is registered /\n\t * removed. Listeners that need the new visible tool set should\n\t * call `decideToolPolicy(...)` with their level / scope.\n\t /\n\tonPolicyChange(listener: ToolPolicyChangeListener): () => void;\n\n\t/\n\t Bind (or clear) the active assessment for PNP/profile policy decisions.\n\t \n\t Under auto-mode (no host override via {@link setPnpEnforcement}),\n\t * the engine flips to `pnpEnforcement: \"on\"` iff the assessment\n\t * carries profile precedence material (`personalNeedsProfile`,\n\t * `settings.districtPolicy`, `settings.testAdministration`) or the\n\t * currently-bound item ref carries item-level profile inputs. A bare\n\t * assessment record (just `id` / `name`) keeps `\"off\"`.\n\t \n\t The host override set via {@link setPnpEnforcement} is sticky\n\t * across assessment swaps.\n\t /\n\tupdateAssessment(assessment: AssessmentEntity \| null): void;\n\n\t/\n\t Bind (or clear) the current item reference for policy decisions.\n\t * Used by item-level profile gates (item `requiredTools` /\n\t * `restrictedTools` / `toolParameters`). Item-level profile material\n\t * also feeds the auto-mode helper — navigating to an item with\n\t * profile settings can flip auto-mode to `\"on\"` even when the parent\n\t * assessment carries no profile block of its own.\n\t /\n\tupdateCurrentItemRef(itemRef: AssessmentItemRef \| null): void;\n\n\t/\n\t Override the auto-mode PNP/profile enforcement decision. Pass `\"on\"` /\n\t * `\"off\"` to pin the mode, or `null` to clear the override and\n\t * return to auto-mode (`\"on\"` iff the bound assessment / item ref\n\t * carries profile material, otherwise `\"off\"`).\n\t /\n\tsetPnpEnforcement(mode: PnpEnforcementMode \| null): void;\n\n\t/\n\t Read the engine inputs currently driving decisions. Useful for\n\t * debugging / instrumentation; do not mutate.\n\t /\n\tgetPolicyInputs(): Readonly<ResolvedEngineInputs>;\n\n\t/\n\t Register a custom `PolicySource`. The source participates in\n\t * every subsequent `decideToolPolicy(...)` call until disposed\n\t * (the returned function detaches).\n\t /\n\tregisterPolicySource(source: PolicySource): () => void;\n\n\t/\n\t Register a host-owned resolver for scoped tool render context.\n\t /\n\tregisterToolContextResolver(\n\t\ttoolId: string,\n\t\tresolver: ToolContextResolver,\n\t): () => void;\n\n\t/\n\t Replace all host-owned render-context resolvers.\n\t /\n\tsetToolContextResolvers(\n\t\tresolvers: ToolContextResolverMap \| null \| undefined,\n\t): void;\n\n\t/\n\t Whether a host resolver is registered for this tool.\n\t /\n\thasToolContextResolver(toolId: string): boolean;\n\n\t/\n\t Resolve render visibility/params for a tool that already survived policy gates.\n\t /\n\tresolveToolContext(\n\t\tcontext: ToolContextResolverContext,\n\t): ResolvedToolContext \| null;\n\n\t/\n\t Subscribe to resolver registration/removal changes.\n\t */\n\tonToolContextResolverChange(listener: () => void): () => void;\n}\n\n// I18nServiceApi is re-exported from @pie-players/pie-players-shared/i18n\n"]}

package/dist/services/tool-context.js CHANGED Viewed

@@ -228,9 +228,11 @@ export function hasChoiceInteraction(context) {
         "pie-multiple-choice",
         "pie-inline-choice",
         "pie-select-text",
+        "pie-ebsr",
         "multiple-choice",
         "inline-choice",
         "select-text",
+        "ebsr",
     ];
     if (isElementContext(context)) {
         const config = context.item.config;

package/dist/services/tool-context.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"tool-context.js","sourceRoot":"","sources":["../../src/services/tool-context.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA4IH;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAClC,OAAoB;IAEpB,OAAO,OAAO,CAAC,KAAK,KAAK,YAAY,CAAC;AACvC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAC/B,OAAoB;IAEpB,OAAO,OAAO,CAAC,KAAK,KAAK,SAAS,CAAC;AACpC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAC5B,OAAoB;IAEpB,OAAO,OAAO,CAAC,KAAK,KAAK,MAAM,CAAC;AACjC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAC/B,OAAoB;IAEpB,OAAO,OAAO,CAAC,KAAK,KAAK,SAAS,CAAC;AACpC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAC9B,OAAoB;IAEpB,OAAO,OAAO,CAAC,KAAK,KAAK,QAAQ,CAAC;AACnC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAC/B,OAAoB;IAEpB,OAAO,OAAO,CAAC,KAAK,KAAK,SAAS,CAAC;AACpC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAoB;IACtD,IAAI,gBAAgB,CAAC,OAAO,CAAC,EAAE,CAAC;QAC/B,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC;QACnC,IAAI,CAAC,MAAM;YAAE,OAAO,EAAE,CAAC;QACvB,MAAM,UAAU,GAAa,EAAE,CAAC;QAChC,MAAM,SAAS,GAAG,CAAC,KAAa,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;QAE3E,4CAA4C;QAC5C,MAAM,aAAa,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAC3D,IAAI,aAAa,EAAE,CAAC;YACnB,IAAI,OAAO,aAAa,KAAK,QAAQ,EAAE,CAAC;gBACvC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC,CAAC;YAC3C,CAAC;QACF,CAAC;QAED,oDAAoD;QACpD,sFAAsF;QACtF,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC;QAChC,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC;YACtC,CAAC,CAAC,SAAS;YACX,CAAC,CAAC,SAAS,IAAI,OAAO,SAAS,KAAK,QAAQ;gBAC3C,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,SAAoC,CAAC;gBACrD,CAAC,CAAC,EAAE,CAAC;QACP,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CACxB,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,EAAE,KAAK,OAAO,CAAC,SAAS,CAC7B,CAAC;QACzC,IAAI,KAAK,EAAE,CAAC;YACX,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC1C,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;oBAC/B,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;gBACnC,CAAC;gBACD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;oBAC1B,KAAK,MAAM,KAAK,IAAI,KAAK,EAAE,CAAC;wBAC3B,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;4BACxC,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,MAAM,CACjC,KAAgC,CAChC,EAAE,CAAC;gCACH,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;oCAChC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC;gCACpC,CAAC;4BACF,CAAC;wBACF,CAAC;oBACF,CAAC;gBACF,CAAC;YACF,CAAC;QACF,CAAC;QAED,OAAO,UAAU,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IACpD,CAAC;IAED,IAAI,aAAa,CAAC,OAAO,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;QAC1B,IAAI,CAAC,IAAI,EAAE,MAAM;YAAE,OAAO,EAAE,CAAC;QAE7B,MAAM,MAAM,GAAG,IAAI,CAAC,MAAiC,CAAC;QACtD,MAAM,UAAU,GAAa,EAAE,CAAC;QAChC,MAAM,SAAS,GAAG,CAAC,KAAa,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;QAE3E,sBAAsB;QACtB,IAAI,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;YACvC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;QAC3C,CAAC;QAED,0BAA0B;QAC1B,MAAM,QAAQ,GAAG,MAAM,CAAC,QAA+C,CAAC;QACxE,IAAI,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;YAC9C,KAAK,MAAM,aAAa,IAAI,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACrD,IAAI,OAAO,aAAa,KAAK,QAAQ,EAAE,CAAC;oBACvC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC,CAAC;gBAC3C,CAAC;YACF,CAAC;QACF,CAAC;QAED,2CAA2C;QAC3C,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC;QAChC,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC;YACtC,CAAC,CAAC,SAAS;YACX,CAAC,CAAC,SAAS,IAAI,OAAO,SAAS,KAAK,QAAQ;gBAC3C,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,SAAoC,CAAC;gBACrD,CAAC,CAAC,EAAE,CAAC;QACP,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC5B,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;gBAAE,SAAS;YAClD,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,KAAgC,CAAC,EAAE,CAAC;gBACrE,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;oBAC/B,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;gBACnC,CAAC;gBACD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;oBAC1B,KAAK,MAAM,KAAK,IAAI,KAAK,EAAE,CAAC;wBAC3B,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;4BACxC,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,MAAM,CACjC,KAAgC,CAChC,EAAE,CAAC;gCACH,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;oCAChC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC;gCACpC,CAAC;4BACF,CAAC;wBACF,CAAC;oBACF,CAAC;gBACF,CAAC;YACF,CAAC;QACF,CAAC;QAED,OAAO,UAAU,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IACpD,CAAC;IAED,IAAI,gBAAgB,CAAC,OAAO,CAAC,EAAE,CAAC;QAC/B,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QAChC,IAAI,CAAC,OAAO,EAAE,MAAM;YAAE,OAAO,EAAE,CAAC;QAEhC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAiC,CAAC;QACzD,MAAM,UAAU,GAAa,EAAE,CAAC;QAChC,MAAM,SAAS,GAAG,CAAC,KAAa,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;QAE3E,iCAAiC;QACjC,IAAI,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;YACvC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;QAC3C,CAAC;QACD,IAAI,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;YACxC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;QAC5C,CAAC;QACD,IAAI,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;YACvC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;QAC3C,CAAC;QAED,0BAA0B;QAC1B,MAAM,QAAQ,GAAG,MAAM,CAAC,QAA+C,CAAC;QACxE,IAAI,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;YAC9C,KAAK,MAAM,aAAa,IAAI,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACrD,IAAI,OAAO,aAAa,KAAK,QAAQ,EAAE,CAAC;oBACvC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC,CAAC;gBAC3C,CAAC;YACF,CAAC;QACF,CAAC;QAED,2CAA2C;QAC3C,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC;QAChC,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC;YACtC,CAAC,CAAC,SAAS;YACX,CAAC,CAAC,SAAS,IAAI,OAAO,SAAS,KAAK,QAAQ;gBAC3C,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,SAAoC,CAAC;gBACrD,CAAC,CAAC,EAAE,CAAC;QACP,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC5B,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;gBAAE,SAAS;YAClD,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,KAAgC,CAAC,EAAE,CAAC;gBACrE,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;oBAC/B,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;gBACnC,CAAC;gBACD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;oBAC1B,KAAK,MAAM,KAAK,IAAI,KAAK,EAAE,CAAC;wBAC3B,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;4BACxC,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,MAAM,CACjC,KAAgC,CAChC,EAAE,CAAC;gCACH,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;oCAChC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC;gCACpC,CAAC;4BACF,CAAC;wBACF,CAAC;oBACF,CAAC;gBACF,CAAC;YACF,CAAC;QACF,CAAC;QAED,OAAO,UAAU,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IACpD,CAAC;IAED,IAAI,eAAe,CAAC,OAAO,CAAC,EAAE,CAAC;QAC9B,MAAM,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;QAEnC,8DAA8D;QAC9D,IAAI,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;YAC5B,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC;YAClD,OAAO,MAAM,CAAC,OAAO,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;QAC/C,CAAC;QAED,uCAAuC;QACvC,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC;QACrC,OAAO,OAAO,CAAC,OAAO,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IAChD,CAAC;IAED,OAAO,EAAE,CAAC;AACX,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,OAAoB;IAClD,MAAM,IAAI,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC;IAEzC,kCAAkC;IAClC,MAAM,cAAc,GAAG;QACtB,aAAa,EAAE,SAAS;QACxB,kBAAkB,EAAE,qBAAqB;QACzC,eAAe,EAAE,+BAA+B;QAChD,MAAM,EAAE,oBAAoB;QAC5B,kBAAkB,EAAE,eAAe;QACnC,sBAAsB,EAAE,oBAAoB;KAC5C,CAAC;IAEF,OAAO,cAAc,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;AAC7D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAAoB;IACxD,MAAM,gBAAgB,GAAG;QACxB,qBAAqB;QACrB,mBAAmB;QACnB,iBAAiB;QACjB,iBAAiB;QACjB,eAAe;QACf,aAAa;KACb,CAAC;IAEF,IAAI,gBAAgB,CAAC,OAAO,CAAC,EAAE,CAAC;QAC/B,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC;QACnC,IAAI,CAAC,MAAM,EAAE,MAAM;YAAE,OAAO,KAAK,CAAC;QAElC,8BAA8B;QAC9B,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC;YAC1C,CAAC,CAAC,MAAM,CAAC,MAAM;YACf,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAiC,CAAC,CAAC;QAC3D,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CACxB,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,EAAE,KAAK,OAAO,CAAC,SAAS,CACpE,CAAC;QACF,IAAI,CAAC,KAAK;YAAE,OAAO,KAAK,CAAC;QAEzB,MAAM,IAAI,GAAI,KAAa,CAAC,OAAO,IAAI,EAAE,CAAC;QAC1C,OAAO,gBAAgB,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACxC,CAAC;IAED,IAAI,aAAa,CAAC,OAAO,CAAC,EAAE,CAAC;QAC5B,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC;QAC9C,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC;YACtC,CAAC,CAAC,SAAS;YACX,CAAC,CAAC,SAAS,IAAI,OAAO,SAAS,KAAK,QAAQ;gBAC3C,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,SAAoC,CAAC;gBACrD,CAAC,CAAC,EAAE,CAAC;QACP,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,CAAM,EAAE,EAAE;YAC7B,IAAI,CAAC,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ;gBAAE,OAAO,KAAK,CAAC;YAC9C,MAAM,IAAI,GAAG,CAAC,CAAC,OAAO,IAAI,EAAE,CAAC;YAC7B,IAAI,gBAAgB,CAAC,QAAQ,CAAC,IAAI,CAAC;gBAAE,OAAO,IAAI,CAAC;YACjD,mEAAmE;YACnE,OAAO,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;QACzD,CAAC,CAAC,CAAC;IACJ,CAAC;IAED,OAAO,KAAK,CAAC;AACd,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,OAAoB;IACnD,MAAM,IAAI,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC;IACzC,iEAAiE;IACjE,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,IAAI,EAAE,CAAC;AACjC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAoB;IACrD,MAAM,IAAI,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC;IAEzC,qCAAqC;IACrC,MAAM,iBAAiB,GAAG;QACzB,oDAAoD;QACpD,mBAAmB;QACnB,qBAAqB,EAAE,oBAAoB;QAC3C,oBAAoB,EAAE,oCAAoC;QAC1D,wCAAwC;QACxC,6CAA6C;KAC7C,CAAC;IAEF,OAAO,iBAAiB,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;AAChE,CAAC","sourcesContent":["/*\n Tool Context Types\n \n Defines the context types passed to tools for making visibility and behavior decisions.\n * Each context level provides increasingly specific information about where the tool is being used.\n /\n\nimport type {\n\tAssessmentEntity,\n\tAssessmentItemRef,\n\tAssessmentSection,\n\tItemEntity,\n\tPassageEntity,\n\tRubricBlock,\n} from \"@pie-players/pie-players-shared/types\";\n\n/\n Tool placement levels - where a tool can appear in the UI\n /\nexport type ToolLevel =\n\t\| \"assessment\" // Assessment-wide tools (e.g., global calculator)\n\t\| \"section\" // Section toolbar tools\n\t\| \"item\" // Item-level tools (question toolbar)\n\t\| \"passage\" // Passage header tools (stimulus rubric blocks)\n\t\| \"rubric\" // Rubric block tools (instructions, rubrics)\n\t\| \"element\"; // Element-specific tools (inline with interaction)\n\n/\n Base context available to all tools\n /\nexport interface BaseToolContext {\n\t/* The level at which this tool is being evaluated /\n\tlevel: ToolLevel;\n\n\t/* The full assessment entity /\n\tassessment: AssessmentEntity;\n\n\t/* Current section, if applicable /\n\tsection?: AssessmentSection;\n\n\t/* Reference to the current item (always available except at assessment level) /\n\titemRef?: AssessmentItemRef;\n\n\t/* DOM container where the tool will be rendered /\n\tcontainer?: HTMLElement;\n}\n\n/\n Context for assessment-level tools\n /\nexport interface AssessmentToolContext extends BaseToolContext {\n\tlevel: \"assessment\";\n}\n\n/\n Context for section-level tools\n /\nexport interface SectionToolContext extends BaseToolContext {\n\tlevel: \"section\";\n\tsection: AssessmentSection;\n}\n\n/\n Context for item-level tools (question toolbar)\n /\nexport interface ItemToolContext extends BaseToolContext {\n\tlevel: \"item\";\n\titemRef: AssessmentItemRef;\n\titem: ItemEntity;\n\n\t/* Passage entity if this item is associated with a passage /\n\tpassage?: PassageEntity;\n}\n\n/\n Context for passage-level tools (passage header)\n \n Passages can appear as:\n * - Standalone passage entities associated with items\n * - RubricBlock with class=\"stimulus\" containing embedded passage\n /\nexport interface PassageToolContext extends BaseToolContext {\n\tlevel: \"passage\";\n\titemRef?: AssessmentItemRef;\n\tpassage: PassageEntity;\n\n\t/* Items associated with this passage (if applicable) /\n\titems?: ItemEntity[];\n\n\t/* RubricBlock containing this passage (if from rubric) /\n\trubricBlock?: RubricBlock;\n}\n\n/\n Context for rubric block tools\n \n RubricBlocks can contain:\n * - Instructions (class=\"instructions\")\n * - Rubrics (class=\"rubric\")\n * - Stimulus/passages (class=\"stimulus\" with embedded passage)\n * - Simple HTML content\n /\nexport interface RubricToolContext extends BaseToolContext {\n\tlevel: \"rubric\";\n\trubricBlock: RubricBlock;\n\n\t/* Section containing this rubric block /\n\tsection: AssessmentSection;\n\n\t/* If rubric contains a passage (class=\"stimulus\") /\n\tpassage?: PassageEntity;\n}\n\n/\n Context for element-level tools (inline with interaction)\n \n Note: Element-level context uses the PIE interaction element ID\n * and provides access to the full item config for content inspection.\n /\nexport interface ElementToolContext extends BaseToolContext {\n\tlevel: \"element\";\n\titemRef: AssessmentItemRef;\n\titem: ItemEntity;\n\n\t/* The PIE element/interaction ID /\n\telementId: string;\n\n\t/* Passage entity if this item is associated with a passage /\n\tpassage?: PassageEntity;\n\n\t/* DOM element that triggered the tool (e.g., the specific input field) /\n\ttriggerElement?: HTMLElement;\n}\n\n/\n Union type of all tool contexts\n /\nexport type ToolContext =\n\t\| AssessmentToolContext\n\t\| SectionToolContext\n\t\| ItemToolContext\n\t\| PassageToolContext\n\t\| RubricToolContext\n\t\| ElementToolContext;\n\n/\n Type guard to check if context is at assessment level\n /\nexport function isAssessmentContext(\n\tcontext: ToolContext,\n): context is AssessmentToolContext {\n\treturn context.level === \"assessment\";\n}\n\n/\n Type guard to check if context is at section level\n /\nexport function isSectionContext(\n\tcontext: ToolContext,\n): context is SectionToolContext {\n\treturn context.level === \"section\";\n}\n\n/\n Type guard to check if context is at item level\n /\nexport function isItemContext(\n\tcontext: ToolContext,\n): context is ItemToolContext {\n\treturn context.level === \"item\";\n}\n\n/\n Type guard to check if context is at passage level\n /\nexport function isPassageContext(\n\tcontext: ToolContext,\n): context is PassageToolContext {\n\treturn context.level === \"passage\";\n}\n\n/\n Type guard to check if context is at rubric level\n /\nexport function isRubricContext(\n\tcontext: ToolContext,\n): context is RubricToolContext {\n\treturn context.level === \"rubric\";\n}\n\n/\n Type guard to check if context is at element level\n /\nexport function isElementContext(\n\tcontext: ToolContext,\n): context is ElementToolContext {\n\treturn context.level === \"element\";\n}\n\n/\n Helper to extract text content from an item or element for analysis\n /\nexport function extractTextContent(context: ToolContext): string {\n\tif (isElementContext(context)) {\n\t\tconst config = context.item.config;\n\t\tif (!config) return \"\";\n\t\tconst textChunks: string[] = [];\n\t\tconst stripHtml = (value: string) => value.replace(/<[^>]>/g, \" \").trim();\n\n\t\t// Try to find element markup by element id.\n\t\tconst elementMarkup = config.elements?.[context.elementId];\n\t\tif (elementMarkup) {\n\t\t\tif (typeof elementMarkup === \"string\") {\n\t\t\t\ttextChunks.push(stripHtml(elementMarkup));\n\t\t\t}\n\t\t}\n\n\t\t// Also inspect model data keyed by this element id.\n\t\t// In many items, math appears in model.prompt/labels rather than elements[elementId].\n\t\tconst modelsRaw = config.models;\n\t\tconst models = Array.isArray(modelsRaw)\n\t\t\t? modelsRaw\n\t\t\t: modelsRaw && typeof modelsRaw === \"object\"\n\t\t\t\t? Object.values(modelsRaw as Record<string, unknown>)\n\t\t\t\t: [];\n\t\tconst model = models.find(\n\t\t\t(m: any) => m && typeof m === \"object\" && m.id === context.elementId,\n\t\t) as Record<string, unknown> \| undefined;\n\t\tif (model) {\n\t\t\tfor (const value of Object.values(model)) {\n\t\t\t\tif (typeof value === \"string\") {\n\t\t\t\t\ttextChunks.push(stripHtml(value));\n\t\t\t\t}\n\t\t\t\tif (Array.isArray(value)) {\n\t\t\t\t\tfor (const entry of value) {\n\t\t\t\t\t\tif (entry && typeof entry === \"object\") {\n\t\t\t\t\t\t\tfor (const nested of Object.values(\n\t\t\t\t\t\t\t\tentry as Record<string, unknown>,\n\t\t\t\t\t\t\t)) {\n\t\t\t\t\t\t\t\tif (typeof nested === \"string\") {\n\t\t\t\t\t\t\t\t\ttextChunks.push(stripHtml(nested));\n\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\treturn textChunks.filter(Boolean).join(\" \").trim();\n\t}\n\n\tif (isItemContext(context)) {\n\t\tconst item = context.item;\n\t\tif (!item?.config) return \"\";\n\n\t\tconst config = item.config as Record<string, unknown>;\n\t\tconst textChunks: string[] = [];\n\t\tconst stripHtml = (value: string) => value.replace(/<[^>]>/g, \" \").trim();\n\n\t\t// Primary item markup\n\t\tif (typeof config.markup === \"string\") {\n\t\t\ttextChunks.push(stripHtml(config.markup));\n\t\t}\n\n\t\t// Element markup snippets\n\t\tconst elements = config.elements as Record<string, unknown> \| undefined;\n\t\tif (elements && typeof elements === \"object\") {\n\t\t\tfor (const elementMarkup of Object.values(elements)) {\n\t\t\t\tif (typeof elementMarkup === \"string\") {\n\t\t\t\t\ttextChunks.push(stripHtml(elementMarkup));\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\t// Model-level text (prompts, labels, etc.)\n\t\tconst modelsRaw = config.models;\n\t\tconst models = Array.isArray(modelsRaw)\n\t\t\t? modelsRaw\n\t\t\t: modelsRaw && typeof modelsRaw === \"object\"\n\t\t\t\t? Object.values(modelsRaw as Record<string, unknown>)\n\t\t\t\t: [];\n\t\tfor (const model of models) {\n\t\t\tif (!model \|\| typeof model !== \"object\") continue;\n\t\t\tfor (const value of Object.values(model as Record<string, unknown>)) {\n\t\t\t\tif (typeof value === \"string\") {\n\t\t\t\t\ttextChunks.push(stripHtml(value));\n\t\t\t\t}\n\t\t\t\tif (Array.isArray(value)) {\n\t\t\t\t\tfor (const entry of value) {\n\t\t\t\t\t\tif (entry && typeof entry === \"object\") {\n\t\t\t\t\t\t\tfor (const nested of Object.values(\n\t\t\t\t\t\t\t\tentry as Record<string, unknown>,\n\t\t\t\t\t\t\t)) {\n\t\t\t\t\t\t\t\tif (typeof nested === \"string\") {\n\t\t\t\t\t\t\t\t\ttextChunks.push(stripHtml(nested));\n\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\treturn textChunks.filter(Boolean).join(\" \").trim();\n\t}\n\n\tif (isPassageContext(context)) {\n\t\tconst passage = context.passage;\n\t\tif (!passage?.config) return \"\";\n\n\t\tconst config = passage.config as Record<string, unknown>;\n\t\tconst textChunks: string[] = [];\n\t\tconst stripHtml = (value: string) => value.replace(/<[^>]>/g, \" \").trim();\n\n\t\t// Primary passage markup/content\n\t\tif (typeof config.markup === \"string\") {\n\t\t\ttextChunks.push(stripHtml(config.markup));\n\t\t}\n\t\tif (typeof config.content === \"string\") {\n\t\t\ttextChunks.push(stripHtml(config.content));\n\t\t}\n\t\tif (typeof config.prompt === \"string\") {\n\t\t\ttextChunks.push(stripHtml(config.prompt));\n\t\t}\n\n\t\t// Element markup snippets\n\t\tconst elements = config.elements as Record<string, unknown> \| undefined;\n\t\tif (elements && typeof elements === \"object\") {\n\t\t\tfor (const elementMarkup of Object.values(elements)) {\n\t\t\t\tif (typeof elementMarkup === \"string\") {\n\t\t\t\t\ttextChunks.push(stripHtml(elementMarkup));\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\t// Model-level text (prompts, labels, etc.)\n\t\tconst modelsRaw = config.models;\n\t\tconst models = Array.isArray(modelsRaw)\n\t\t\t? modelsRaw\n\t\t\t: modelsRaw && typeof modelsRaw === \"object\"\n\t\t\t\t? Object.values(modelsRaw as Record<string, unknown>)\n\t\t\t\t: [];\n\t\tfor (const model of models) {\n\t\t\tif (!model \|\| typeof model !== \"object\") continue;\n\t\t\tfor (const value of Object.values(model as Record<string, unknown>)) {\n\t\t\t\tif (typeof value === \"string\") {\n\t\t\t\t\ttextChunks.push(stripHtml(value));\n\t\t\t\t}\n\t\t\t\tif (Array.isArray(value)) {\n\t\t\t\t\tfor (const entry of value) {\n\t\t\t\t\t\tif (entry && typeof entry === \"object\") {\n\t\t\t\t\t\t\tfor (const nested of Object.values(\n\t\t\t\t\t\t\t\tentry as Record<string, unknown>,\n\t\t\t\t\t\t\t)) {\n\t\t\t\t\t\t\t\tif (typeof nested === \"string\") {\n\t\t\t\t\t\t\t\t\ttextChunks.push(stripHtml(nested));\n\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\treturn textChunks.filter(Boolean).join(\" \").trim();\n\t}\n\n\tif (isRubricContext(context)) {\n\t\tconst rubric = context.rubricBlock;\n\n\t\t// If rubric has embedded passage, extract from passage config\n\t\tif (rubric.passage?.config) {\n\t\t\tconst markup = rubric.passage.config.markup \|\| \"\";\n\t\t\treturn markup.replace(/<[^>]>/g, \" \").trim();\n\t\t}\n\n\t\t// Otherwise, use simple content string\n\t\tconst content = rubric.content \|\| \"\";\n\t\treturn content.replace(/<[^>]>/g, \" \").trim();\n\t}\n\n\treturn \"\";\n}\n\n/*\n Helper to check if context contains mathematical content\n * (Basic heuristic - can be overridden by tools)\n /\nexport function hasMathContent(context: ToolContext): boolean {\n\tconst text = extractTextContent(context);\n\n\t// Look for common math indicators\n\tconst mathIndicators = [\n\t\t/<math[>\\s]/i, // MathML\n\t\t/\\\\\\[([^\\]]+)\\\\\\]/, // LaTeX display math\n\t\t/\\$\\$[^$]+\\$\\$/, // LaTeX display math ($$...$$)\n\t\t/\\\\\\(/, // LaTeX inline math\n\t\t/[+\\-/=<>≤≥∑∫√π]/, // Math symbols\n\t\t/\\d+\\s[+\\-/=]\\s\\d+/, // Simple arithmetic\n\t];\n\n\treturn mathIndicators.some((pattern) => pattern.test(text));\n}\n\n/\n Helper to check if context contains choice-based interactions\n /\nexport function hasChoiceInteraction(context: ToolContext): boolean {\n\tconst interactionTypes = [\n\t\t\"pie-multiple-choice\",\n\t\t\"pie-inline-choice\",\n\t\t\"pie-select-text\",\n\t\t\"multiple-choice\",\n\t\t\"inline-choice\",\n\t\t\"select-text\",\n\t];\n\n\tif (isElementContext(context)) {\n\t\tconst config = context.item.config;\n\t\tif (!config?.models) return false;\n\n\t\t// Find model for this element\n\t\tconst models = Array.isArray(config.models)\n\t\t\t? config.models\n\t\t\t: Object.values(config.models as Record<string, unknown>);\n\t\tconst model = models.find(\n\t\t\t(m: any) => m && typeof m === \"object\" && m.id === context.elementId,\n\t\t);\n\t\tif (!model) return false;\n\n\t\tconst type = (model as any).element \|\| \"\";\n\t\treturn interactionTypes.includes(type);\n\t}\n\n\tif (isItemContext(context)) {\n\t\tconst modelsRaw = context.item.config?.models;\n\t\tconst models = Array.isArray(modelsRaw)\n\t\t\t? modelsRaw\n\t\t\t: modelsRaw && typeof modelsRaw === \"object\"\n\t\t\t\t? Object.values(modelsRaw as Record<string, unknown>)\n\t\t\t\t: [];\n\t\treturn models.some((m: any) => {\n\t\t\tif (!m \|\| typeof m !== \"object\") return false;\n\t\t\tconst type = m.element \|\| \"\";\n\t\t\tif (interactionTypes.includes(type)) return true;\n\t\t\t// Fallback for configs that don't provide canonical element names.\n\t\t\treturn Array.isArray(m.choices) && m.choices.length > 0;\n\t\t});\n\t}\n\n\treturn false;\n}\n\n/\n Helper to check if context contains text that can be read aloud\n /\nexport function hasReadableText(context: ToolContext): boolean {\n\tconst text = extractTextContent(context);\n\t// Must have at least 10 characters of text (arbitrary threshold)\n\treturn text.trim().length >= 10;\n}\n\n/\n Helper to check if context contains science content\n * (Basic heuristic - can be overridden by tools)\n /\nexport function hasScienceContent(context: ToolContext): boolean {\n\tconst text = extractTextContent(context);\n\n\t// Look for common science indicators\n\tconst scienceIndicators = [\n\t\t/chemistry\|chemical\|element\|atom\|molecule\|compound/i,\n\t\t/periodic\\s+table/i,\n\t\t/H₂O\|CO₂\|NaCl\|O₂\|N₂/i, // Chemical formulas\n\t\t/\\b[A-Z][a-z]?\\d\\b/, // Element symbols (H, He, Li, etc.)\n\t\t/biology\|organism\|cell\|DNA\|RNA\|protein/i,\n\t\t/physics\|force\|energy\|velocity\|acceleration/i,\n\t];\n\n\treturn scienceIndicators.some((pattern) => pattern.test(text));\n}\n"]}
1	+ {"version":3,"file":"tool-context.js","sourceRoot":"","sources":["../../src/services/tool-context.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n Tool Context Types\n \n Defines the context types passed to tools for making visibility and behavior decisions.\n * Each context level provides increasingly specific information about where the tool is being used.\n /\n\nimport type {\n\tAssessmentEntity,\n\tAssessmentItemRef,\n\tAssessmentSection,\n\tItemEntity,\n\tPassageEntity,\n\tRubricBlock,\n} from \"@pie-players/pie-players-shared/types\";\n\n/\n Tool placement levels - where a tool can appear in the UI\n /\nexport type ToolLevel =\n\t\| \"assessment\" // Assessment-wide tools (e.g., global calculator)\n\t\| \"section\" // Section toolbar tools\n\t\| \"item\" // Item-level tools (question toolbar)\n\t\| \"passage\" // Passage header tools (stimulus rubric blocks)\n\t\| \"rubric\" // Rubric block tools (instructions, rubrics)\n\t\| \"element\"; // Element-specific tools (inline with interaction)\n\n/\n Base context available to all tools\n /\nexport interface BaseToolContext {\n\t/* The level at which this tool is being evaluated /\n\tlevel: ToolLevel;\n\n\t/* The full assessment entity /\n\tassessment: AssessmentEntity;\n\n\t/* Current section, if applicable /\n\tsection?: AssessmentSection;\n\n\t/* Reference to the current item (always available except at assessment level) /\n\titemRef?: AssessmentItemRef;\n\n\t/* DOM container where the tool will be rendered /\n\tcontainer?: HTMLElement;\n}\n\n/\n Context for assessment-level tools\n /\nexport interface AssessmentToolContext extends BaseToolContext {\n\tlevel: \"assessment\";\n}\n\n/\n Context for section-level tools\n /\nexport interface SectionToolContext extends BaseToolContext {\n\tlevel: \"section\";\n\tsection: AssessmentSection;\n}\n\n/\n Context for item-level tools (question toolbar)\n /\nexport interface ItemToolContext extends BaseToolContext {\n\tlevel: \"item\";\n\titemRef: AssessmentItemRef;\n\titem: ItemEntity;\n\n\t/* Passage entity if this item is associated with a passage /\n\tpassage?: PassageEntity;\n}\n\n/\n Context for passage-level tools (passage header)\n \n Passages can appear as:\n * - Standalone passage entities associated with items\n * - RubricBlock with class=\"stimulus\" containing embedded passage\n /\nexport interface PassageToolContext extends BaseToolContext {\n\tlevel: \"passage\";\n\titemRef?: AssessmentItemRef;\n\tpassage: PassageEntity;\n\n\t/* Items associated with this passage (if applicable) /\n\titems?: ItemEntity[];\n\n\t/* RubricBlock containing this passage (if from rubric) /\n\trubricBlock?: RubricBlock;\n}\n\n/\n Context for rubric block tools\n \n RubricBlocks can contain:\n * - Instructions (class=\"instructions\")\n * - Rubrics (class=\"rubric\")\n * - Stimulus/passages (class=\"stimulus\" with embedded passage)\n * - Simple HTML content\n /\nexport interface RubricToolContext extends BaseToolContext {\n\tlevel: \"rubric\";\n\trubricBlock: RubricBlock;\n\n\t/* Section containing this rubric block /\n\tsection: AssessmentSection;\n\n\t/* If rubric contains a passage (class=\"stimulus\") /\n\tpassage?: PassageEntity;\n}\n\n/\n Context for element-level tools (inline with interaction)\n \n Note: Element-level context uses the PIE interaction element ID\n * and provides access to the full item config for content inspection.\n /\nexport interface ElementToolContext extends BaseToolContext {\n\tlevel: \"element\";\n\titemRef: AssessmentItemRef;\n\titem: ItemEntity;\n\n\t/* The PIE element/interaction ID /\n\telementId: string;\n\n\t/* Passage entity if this item is associated with a passage /\n\tpassage?: PassageEntity;\n\n\t/* DOM element that triggered the tool (e.g., the specific input field) /\n\ttriggerElement?: HTMLElement;\n}\n\n/\n Union type of all tool contexts\n /\nexport type ToolContext =\n\t\| AssessmentToolContext\n\t\| SectionToolContext\n\t\| ItemToolContext\n\t\| PassageToolContext\n\t\| RubricToolContext\n\t\| ElementToolContext;\n\n/\n Type guard to check if context is at assessment level\n /\nexport function isAssessmentContext(\n\tcontext: ToolContext,\n): context is AssessmentToolContext {\n\treturn context.level === \"assessment\";\n}\n\n/\n Type guard to check if context is at section level\n /\nexport function isSectionContext(\n\tcontext: ToolContext,\n): context is SectionToolContext {\n\treturn context.level === \"section\";\n}\n\n/\n Type guard to check if context is at item level\n /\nexport function isItemContext(\n\tcontext: ToolContext,\n): context is ItemToolContext {\n\treturn context.level === \"item\";\n}\n\n/\n Type guard to check if context is at passage level\n /\nexport function isPassageContext(\n\tcontext: ToolContext,\n): context is PassageToolContext {\n\treturn context.level === \"passage\";\n}\n\n/\n Type guard to check if context is at rubric level\n /\nexport function isRubricContext(\n\tcontext: ToolContext,\n): context is RubricToolContext {\n\treturn context.level === \"rubric\";\n}\n\n/\n Type guard to check if context is at element level\n /\nexport function isElementContext(\n\tcontext: ToolContext,\n): context is ElementToolContext {\n\treturn context.level === \"element\";\n}\n\n/\n Helper to extract text content from an item or element for analysis\n /\nexport function extractTextContent(context: ToolContext): string {\n\tif (isElementContext(context)) {\n\t\tconst config = context.item.config;\n\t\tif (!config) return \"\";\n\t\tconst textChunks: string[] = [];\n\t\tconst stripHtml = (value: string) => value.replace(/<[^>]>/g, \" \").trim();\n\n\t\t// Try to find element markup by element id.\n\t\tconst elementMarkup = config.elements?.[context.elementId];\n\t\tif (elementMarkup) {\n\t\t\tif (typeof elementMarkup === \"string\") {\n\t\t\t\ttextChunks.push(stripHtml(elementMarkup));\n\t\t\t}\n\t\t}\n\n\t\t// Also inspect model data keyed by this element id.\n\t\t// In many items, math appears in model.prompt/labels rather than elements[elementId].\n\t\tconst modelsRaw = config.models;\n\t\tconst models = Array.isArray(modelsRaw)\n\t\t\t? modelsRaw\n\t\t\t: modelsRaw && typeof modelsRaw === \"object\"\n\t\t\t\t? Object.values(modelsRaw as Record<string, unknown>)\n\t\t\t\t: [];\n\t\tconst model = models.find(\n\t\t\t(m: any) => m && typeof m === \"object\" && m.id === context.elementId,\n\t\t) as Record<string, unknown> \| undefined;\n\t\tif (model) {\n\t\t\tfor (const value of Object.values(model)) {\n\t\t\t\tif (typeof value === \"string\") {\n\t\t\t\t\ttextChunks.push(stripHtml(value));\n\t\t\t\t}\n\t\t\t\tif (Array.isArray(value)) {\n\t\t\t\t\tfor (const entry of value) {\n\t\t\t\t\t\tif (entry && typeof entry === \"object\") {\n\t\t\t\t\t\t\tfor (const nested of Object.values(\n\t\t\t\t\t\t\t\tentry as Record<string, unknown>,\n\t\t\t\t\t\t\t)) {\n\t\t\t\t\t\t\t\tif (typeof nested === \"string\") {\n\t\t\t\t\t\t\t\t\ttextChunks.push(stripHtml(nested));\n\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\treturn textChunks.filter(Boolean).join(\" \").trim();\n\t}\n\n\tif (isItemContext(context)) {\n\t\tconst item = context.item;\n\t\tif (!item?.config) return \"\";\n\n\t\tconst config = item.config as Record<string, unknown>;\n\t\tconst textChunks: string[] = [];\n\t\tconst stripHtml = (value: string) => value.replace(/<[^>]>/g, \" \").trim();\n\n\t\t// Primary item markup\n\t\tif (typeof config.markup === \"string\") {\n\t\t\ttextChunks.push(stripHtml(config.markup));\n\t\t}\n\n\t\t// Element markup snippets\n\t\tconst elements = config.elements as Record<string, unknown> \| undefined;\n\t\tif (elements && typeof elements === \"object\") {\n\t\t\tfor (const elementMarkup of Object.values(elements)) {\n\t\t\t\tif (typeof elementMarkup === \"string\") {\n\t\t\t\t\ttextChunks.push(stripHtml(elementMarkup));\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\t// Model-level text (prompts, labels, etc.)\n\t\tconst modelsRaw = config.models;\n\t\tconst models = Array.isArray(modelsRaw)\n\t\t\t? modelsRaw\n\t\t\t: modelsRaw && typeof modelsRaw === \"object\"\n\t\t\t\t? Object.values(modelsRaw as Record<string, unknown>)\n\t\t\t\t: [];\n\t\tfor (const model of models) {\n\t\t\tif (!model \|\| typeof model !== \"object\") continue;\n\t\t\tfor (const value of Object.values(model as Record<string, unknown>)) {\n\t\t\t\tif (typeof value === \"string\") {\n\t\t\t\t\ttextChunks.push(stripHtml(value));\n\t\t\t\t}\n\t\t\t\tif (Array.isArray(value)) {\n\t\t\t\t\tfor (const entry of value) {\n\t\t\t\t\t\tif (entry && typeof entry === \"object\") {\n\t\t\t\t\t\t\tfor (const nested of Object.values(\n\t\t\t\t\t\t\t\tentry as Record<string, unknown>,\n\t\t\t\t\t\t\t)) {\n\t\t\t\t\t\t\t\tif (typeof nested === \"string\") {\n\t\t\t\t\t\t\t\t\ttextChunks.push(stripHtml(nested));\n\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\treturn textChunks.filter(Boolean).join(\" \").trim();\n\t}\n\n\tif (isPassageContext(context)) {\n\t\tconst passage = context.passage;\n\t\tif (!passage?.config) return \"\";\n\n\t\tconst config = passage.config as Record<string, unknown>;\n\t\tconst textChunks: string[] = [];\n\t\tconst stripHtml = (value: string) => value.replace(/<[^>]>/g, \" \").trim();\n\n\t\t// Primary passage markup/content\n\t\tif (typeof config.markup === \"string\") {\n\t\t\ttextChunks.push(stripHtml(config.markup));\n\t\t}\n\t\tif (typeof config.content === \"string\") {\n\t\t\ttextChunks.push(stripHtml(config.content));\n\t\t}\n\t\tif (typeof config.prompt === \"string\") {\n\t\t\ttextChunks.push(stripHtml(config.prompt));\n\t\t}\n\n\t\t// Element markup snippets\n\t\tconst elements = config.elements as Record<string, unknown> \| undefined;\n\t\tif (elements && typeof elements === \"object\") {\n\t\t\tfor (const elementMarkup of Object.values(elements)) {\n\t\t\t\tif (typeof elementMarkup === \"string\") {\n\t\t\t\t\ttextChunks.push(stripHtml(elementMarkup));\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\t// Model-level text (prompts, labels, etc.)\n\t\tconst modelsRaw = config.models;\n\t\tconst models = Array.isArray(modelsRaw)\n\t\t\t? modelsRaw\n\t\t\t: modelsRaw && typeof modelsRaw === \"object\"\n\t\t\t\t? Object.values(modelsRaw as Record<string, unknown>)\n\t\t\t\t: [];\n\t\tfor (const model of models) {\n\t\t\tif (!model \|\| typeof model !== \"object\") continue;\n\t\t\tfor (const value of Object.values(model as Record<string, unknown>)) {\n\t\t\t\tif (typeof value === \"string\") {\n\t\t\t\t\ttextChunks.push(stripHtml(value));\n\t\t\t\t}\n\t\t\t\tif (Array.isArray(value)) {\n\t\t\t\t\tfor (const entry of value) {\n\t\t\t\t\t\tif (entry && typeof entry === \"object\") {\n\t\t\t\t\t\t\tfor (const nested of Object.values(\n\t\t\t\t\t\t\t\tentry as Record<string, unknown>,\n\t\t\t\t\t\t\t)) {\n\t\t\t\t\t\t\t\tif (typeof nested === \"string\") {\n\t\t\t\t\t\t\t\t\ttextChunks.push(stripHtml(nested));\n\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\treturn textChunks.filter(Boolean).join(\" \").trim();\n\t}\n\n\tif (isRubricContext(context)) {\n\t\tconst rubric = context.rubricBlock;\n\n\t\t// If rubric has embedded passage, extract from passage config\n\t\tif (rubric.passage?.config) {\n\t\t\tconst markup = rubric.passage.config.markup \|\| \"\";\n\t\t\treturn markup.replace(/<[^>]>/g, \" \").trim();\n\t\t}\n\n\t\t// Otherwise, use simple content string\n\t\tconst content = rubric.content \|\| \"\";\n\t\treturn content.replace(/<[^>]>/g, \" \").trim();\n\t}\n\n\treturn \"\";\n}\n\n/*\n Helper to check if context contains mathematical content\n * (Basic heuristic - can be overridden by tools)\n /\nexport function hasMathContent(context: ToolContext): boolean {\n\tconst text = extractTextContent(context);\n\n\t// Look for common math indicators\n\tconst mathIndicators = [\n\t\t/<math[>\\s]/i, // MathML\n\t\t/\\\\\\[([^\\]]+)\\\\\\]/, // LaTeX display math\n\t\t/\\$\\$[^$]+\\$\\$/, // LaTeX display math ($$...$$)\n\t\t/\\\\\\(/, // LaTeX inline math\n\t\t/[+\\-/=<>≤≥∑∫√π]/, // Math symbols\n\t\t/\\d+\\s[+\\-/=]\\s\\d+/, // Simple arithmetic\n\t];\n\n\treturn mathIndicators.some((pattern) => pattern.test(text));\n}\n\n/\n Helper to check if context contains choice-based interactions\n /\nexport function hasChoiceInteraction(context: ToolContext): boolean {\n\tconst interactionTypes = [\n\t\t\"pie-multiple-choice\",\n\t\t\"pie-inline-choice\",\n\t\t\"pie-select-text\",\n\t\t\"pie-ebsr\",\n\t\t\"multiple-choice\",\n\t\t\"inline-choice\",\n\t\t\"select-text\",\n\t\t\"ebsr\",\n\t];\n\n\tif (isElementContext(context)) {\n\t\tconst config = context.item.config;\n\t\tif (!config?.models) return false;\n\n\t\t// Find model for this element\n\t\tconst models = Array.isArray(config.models)\n\t\t\t? config.models\n\t\t\t: Object.values(config.models as Record<string, unknown>);\n\t\tconst model = models.find(\n\t\t\t(m: any) => m && typeof m === \"object\" && m.id === context.elementId,\n\t\t);\n\t\tif (!model) return false;\n\n\t\tconst type = (model as any).element \|\| \"\";\n\t\treturn interactionTypes.includes(type);\n\t}\n\n\tif (isItemContext(context)) {\n\t\tconst modelsRaw = context.item.config?.models;\n\t\tconst models = Array.isArray(modelsRaw)\n\t\t\t? modelsRaw\n\t\t\t: modelsRaw && typeof modelsRaw === \"object\"\n\t\t\t\t? Object.values(modelsRaw as Record<string, unknown>)\n\t\t\t\t: [];\n\t\treturn models.some((m: any) => {\n\t\t\tif (!m \|\| typeof m !== \"object\") return false;\n\t\t\tconst type = m.element \|\| \"\";\n\t\t\tif (interactionTypes.includes(type)) return true;\n\t\t\t// Fallback for configs that don't provide canonical element names.\n\t\t\treturn Array.isArray(m.choices) && m.choices.length > 0;\n\t\t});\n\t}\n\n\treturn false;\n}\n\n/\n Helper to check if context contains text that can be read aloud\n /\nexport function hasReadableText(context: ToolContext): boolean {\n\tconst text = extractTextContent(context);\n\t// Must have at least 10 characters of text (arbitrary threshold)\n\treturn text.trim().length >= 10;\n}\n\n/\n Helper to check if context contains science content\n * (Basic heuristic - can be overridden by tools)\n /\nexport function hasScienceContent(context: ToolContext): boolean {\n\tconst text = extractTextContent(context);\n\n\t// Look for common science indicators\n\tconst scienceIndicators = [\n\t\t/chemistry\|chemical\|element\|atom\|molecule\|compound/i,\n\t\t/periodic\\s+table/i,\n\t\t/H₂O\|CO₂\|NaCl\|O₂\|N₂/i, // Chemical formulas\n\t\t/\\b[A-Z][a-z]?\\d\\b/, // Element symbols (H, He, Li, etc.)\n\t\t/biology\|organism\|cell\|DNA\|RNA\|protein/i,\n\t\t/physics\|force\|energy\|velocity\|acceleration/i,\n\t];\n\n\treturn scienceIndicators.some((pattern) => pattern.test(text));\n}\n"]}

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
 	"name": "@pie-players/pie-assessment-toolkit",
-	"version": "0.3.59",
+	"version": "0.3.60",
 	"type": "module",
 	"description": "PIE assessment toolkit: composable services + reference implementation for assessment players and tool coordination",
 	"license": "MIT",
@@ -75,15 +75,15 @@
 		"test": "bun test"
 	},
 	"dependencies": {
-		"@pie-players/pie-calculator": "0.3.59",
-		"@pie-players/pie-context": "0.3.59",
-		"@pie-players/pie-players-shared": "0.3.59",
-		"@pie-players/pie-tts": "0.3.59",
+		"@pie-players/pie-calculator": "0.3.60",
+		"@pie-players/pie-context": "0.3.60",
+		"@pie-players/pie-players-shared": "0.3.60",
+		"@pie-players/pie-tts": "0.3.60",
 		"speech-rule-engine": "^5.0.0-rc.1"
 	},
 	"peerDependencies": {
-		"@pie-players/pie-calculator-desmos": "0.3.59",
-		"@pie-players/tts-client-server": "0.3.59"
+		"@pie-players/pie-calculator-desmos": "0.3.60",
+		"@pie-players/tts-client-server": "0.3.60"
 	},
 	"peerDependenciesMeta": {
 		"@pie-players/pie-calculator-desmos": {