@pie-players/pie-default-tool-loaders 0.3.67 → 0.3.69

package/dist/registrations/selection-actions.js

@@ -0,0 +1,73 @@
+/**
+ * Which capabilities appear as actions on the learner's current selection.
+ *
+ * The one place that pairs a selection gateway to the tools it can open. The gateway
+ * renders what it is handed and names nothing; the tools know nothing about
+ * selections. Composition is the only layer allowed to know both, which is why this
+ * list lives here rather than in either of them.
+ *
+ * A selection is a shortcut, never the only way in. Chromium does not extend a
+ * selection with Shift+Arrow in non-editable content unless caret browsing is on —
+ * an OS toggle that does not exist on mobile — so a sighted keyboard-only learner
+ * cannot originate one at all. Every tool named here also opens from the toolbar and
+ * carries its own term field.
+ */
+import { resolveFallbackToolIcon } from "@pie-players/pie-assessment-toolkit/tools/internal";
+function asRequestCapable(coordinator) {
+    const candidate = coordinator;
+    if (typeof candidate?.canRequestTool !== "function")
+        return null;
+    if (typeof candidate.requestTool !== "function")
+        return null;
+    return candidate;
+}
+const SELECTION_ACTION_SPECS = [
+    {
+        toolId: "dictionary",
+        label: "Look up selected text in dictionary",
+        tooltip: "Look up",
+        icon: "book-open",
+    },
+    {
+        toolId: "pictureDictionary",
+        label: "Show pictures for selected text",
+        tooltip: "Show pictures",
+        icon: "photo",
+    },
+];
+/**
+ * Actions for the gateway to render, given the services it was handed.
+ *
+ * Rebuilt on every sync rather than captured once: a host calling
+ * `updateAssessment` mid-session swaps the coordinator without remounting the
+ * gateway, and an action closing over the previous one would open a tool in a
+ * session the learner has left.
+ */
+export function buildSelectionActions(services) {
+    const coordinator = asRequestCapable(services.toolkitCoordinator);
+    if (!coordinator)
+        return [];
+    return SELECTION_ACTION_SPECS.map((spec) => {
+        const iconSvg = resolveFallbackToolIcon(spec.icon) ?? undefined;
+        return {
+            id: spec.toolId,
+            label: spec.label,
+            tooltip: spec.tooltip,
+            iconSvg,
+            // Asked per selection. A tool the PNP does not grant, or that no toolbar in
+            // this section hosts, is absent rather than present and inert.
+            isAvailable: () => coordinator.canRequestTool(spec.toolId),
+            run: (selection) => {
+                const term = selection.text.trim();
+                if (!term)
+                    return;
+                // Both panels read the selected text from `term`. No level is named, so the
+                // request takes whichever toolbar hosts the tool, preferring section scope.
+                coordinator.requestTool({
+                    toolId: spec.toolId,
+                    params: { term },
+                });
+            },
+        };
+    });
+}

package/dist/registrations/subject-specific-tools.js

@@ -13,6 +13,7 @@
 import { hasMathContent, hasScienceContent, } from "@pie-players/pie-assessment-toolkit/tools/internal";
 import { createToolElement, } from "@pie-players/pie-assessment-toolkit/tools/internal";
 import { createScopedVisibilityBinding, syncButtonAndOverlayVisibility, } from "@pie-players/pie-assessment-toolkit/tools/internal";
+import { renderOverlayToolbar } from "./overlay-toolbar-render.js";
 /**
  * Graph tool registration
  *
@@ -23,6 +24,8 @@ export const graphToolRegistration = {
     toolId: "graph",
     name: "Graph",
     description: "Graphing calculator and coordinate plane",
+    nameKey: "tools.graph.name",
+    descriptionKey: "tools.graph.description",
     icon: "chart-bar",
     // Graph is a section-level floating tool.
     supportedLevels: ["section"],
@@ -31,8 +34,6 @@ export const graphToolRegistration = {
     pnpSupportIds: [
         "graph", // QTI 3.0 standard (assessment.graph)
         "graphingCalculator", // QTI 3.0 standard (assessment.graphingCalculator)
-        "coordinatePlane", // Common variant
-        "graphingTool", // Common variant
     ],
     /**
      * Pass 2: Graph is relevant when math content is present
@@ -41,48 +42,15 @@ export const graphToolRegistration = {
         return hasMathContent(context);
     },
     renderToolbar(context, toolbarContext) {
-        const visibility = createScopedVisibilityBinding(this.toolId, toolbarContext);
-        const button = {
-            toolId: this.toolId,
-            label: this.name,
-            icon: typeof this.icon === "function" ? this.icon(context) : this.icon,
-            disabled: false,
-            ariaLabel: "Graph - Graphing calculator",
-            tooltip: "Graph",
-            onClick: () => toolbarContext.toggleTool(this.toolId),
-            active: visibility.isActive(),
-        };
-        const componentOverrides = toolbarContext.componentOverrides ?? {};
-        const overlay = createToolElement(this.toolId, context, toolbarContext, componentOverrides);
-        overlay.setAttribute("tool-id", visibility.fullToolId);
-        return {
-            toolId: this.toolId,
-            button,
-            elements: [
-                {
-                    element: overlay,
-                    mount: "after-buttons",
-                    shell: {
-                        title: this.name,
-                        draggable: true,
-                        resizable: true,
-                        closeable: true,
-                        initialWidth: 920,
-                        initialHeight: 680,
-                        minWidth: 640,
-                        minHeight: 500,
-                    },
-                },
-            ],
-            sync: () => {
-                syncButtonAndOverlayVisibility({
-                    button,
-                    overlay,
-                    isActive: visibility.isActive,
-                });
+        return renderOverlayToolbar(this, context, toolbarContext, {
+            shell: {
+                resizable: true,
+                initialWidth: 920,
+                initialHeight: 680,
+                minWidth: 640,
+                minHeight: 500,
             },
-            subscribeActive: visibility.subscribeActive,
-        };
+        });
     },
 };
 /**
@@ -95,6 +63,8 @@ export const periodicTableToolRegistration = {
     toolId: "periodicTable",
     name: "Periodic Table",
     description: "Chemistry periodic table reference",
+    nameKey: "tools.periodicTable.name",
+    descriptionKey: "tools.periodicTable.description",
     icon: "beaker",
     // Periodic table is a section-level floating tool.
     supportedLevels: ["section"],
@@ -102,8 +72,6 @@ export const periodicTableToolRegistration = {
     // Maps to QTI 3.0 standard feature: periodicTable
     pnpSupportIds: [
         "periodicTable", // QTI 3.0 standard (assessment.periodicTable)
-        "chemistryReference", // Common variant
-        "elementReference", // Common variant
     ],
     /**
      * Pass 2: Periodic table is relevant when science content is present
@@ -112,47 +80,14 @@ export const periodicTableToolRegistration = {
         return hasScienceContent(context);
     },
     renderToolbar(context, toolbarContext) {
-        const visibility = createScopedVisibilityBinding(this.toolId, toolbarContext);
-        const button = {
-            toolId: this.toolId,
-            label: this.name,
-            icon: typeof this.icon === "function" ? this.icon(context) : this.icon,
-            disabled: false,
-            ariaLabel: "Periodic table - Chemistry reference",
-            tooltip: "Periodic Table",
-            onClick: () => toolbarContext.toggleTool(this.toolId),
-            active: visibility.isActive(),
-        };
-        const componentOverrides = toolbarContext.componentOverrides ?? {};
-        const overlay = createToolElement(this.toolId, context, toolbarContext, componentOverrides);
-        overlay.setAttribute("tool-id", visibility.fullToolId);
-        return {
-            toolId: this.toolId,
-            button,
-            elements: [
-                {
-                    element: overlay,
-                    mount: "after-buttons",
-                    shell: {
-                        title: this.name,
-                        draggable: true,
-                        resizable: true,
-                        closeable: true,
-                        initialWidth: 1160,
-                        initialHeight: 760,
-                        minWidth: 920,
-                        minHeight: 620,
-                    },
-                },
-            ],
-            sync: () => {
-                syncButtonAndOverlayVisibility({
-                    button,
-                    overlay,
-                    isActive: visibility.isActive,
-                });
+        return renderOverlayToolbar(this, context, toolbarContext, {
+            shell: {
+                resizable: true,
+                initialWidth: 1160,
+                initialHeight: 760,
+                minWidth: 920,
+                minHeight: 620,
             },
-            subscribeActive: visibility.subscribeActive,
-        };
+        });
     },
 };

package/dist/registrations/tts.js

@@ -26,6 +26,8 @@ export const ttsToolRegistration = {
     toolId: "textToSpeech",
     name: "Text to Speech",
     description: "Read content aloud",
+    nameKey: "tools.textToSpeech.name",
+    descriptionKey: "tools.textToSpeech.description",
     icon: "volume-up",
     provider: {
         getProviderId: () => "tts",
@@ -84,8 +86,6 @@ export const ttsToolRegistration = {
     pnpSupportIds: [
         "textToSpeech", // QTI 3.0 standard (auditory.textToSpeech)
         "readAloud", // QTI 3.0 standard (auditory.readAloud)
-        "tts", // Common abbreviation
-        "speechOutput", // Common variant
     ],
     /**
      * Pass 2: Determine if TTS is relevant in this context

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@pie-players/pie-default-tool-loaders",
-	"version": "0.3.67",
+	"version": "0.3.69",
 	"type": "module",
 	"description": "Composition layer for the packaged PIE assessment tools: registrations, tag map, placement presets, universal supports and lazy module loaders",
 	"repository": {
@@ -33,21 +33,26 @@
 		"test": "bun test"
 	},
 	"dependencies": {
-		"@pie-players/pie-assessment-toolkit": "0.3.67",
-		"@pie-players/pie-players-shared": "0.3.67",
-		"@pie-players/pie-tool-annotation-toolbar": "0.3.67",
-		"@pie-players/pie-tool-answer-eliminator": "0.3.67",
-		"@pie-players/pie-tool-calculator-desmos": "0.3.67",
-		"@pie-players/pie-tool-graph": "0.3.67",
-		"@pie-players/pie-tool-line-reader": "0.3.67",
-		"@pie-players/pie-tool-periodic-table": "0.3.67",
-		"@pie-players/pie-tool-protractor": "0.3.67",
-		"@pie-players/pie-tool-ruler": "0.3.67",
-		"@pie-players/pie-tool-theme": "0.3.67",
-		"@pie-players/pie-tool-tts-inline": "0.3.67"
+		"@pie-players/pie-assessment-toolkit": "0.3.69",
+		"@pie-players/pie-players-shared": "0.3.69",
+		"@pie-players/pie-tool-annotation-toolbar": "0.3.69",
+		"@pie-players/pie-tool-answer-eliminator": "0.3.69",
+		"@pie-players/pie-tool-calculator-desmos": "0.3.69",
+		"@pie-players/pie-tool-calculator-cortex": "0.3.69",
+		"@pie-players/pie-tool-calculator-geogebra": "0.3.69",
+		"@pie-players/pie-tool-calculator-shared": "0.3.69",
+		"@pie-players/pie-tool-dictionary": "0.3.69",
+		"@pie-players/pie-tool-graph": "0.3.69",
+		"@pie-players/pie-tool-line-reader": "0.3.69",
+		"@pie-players/pie-tool-periodic-table": "0.3.69",
+		"@pie-players/pie-tool-picture-dictionary": "0.3.69",
+		"@pie-players/pie-tool-protractor": "0.3.69",
+		"@pie-players/pie-tool-ruler": "0.3.69",
+		"@pie-players/pie-tool-theme": "0.3.69",
+		"@pie-players/pie-tool-tts-inline": "0.3.69"
 	},
 	"devDependencies": {
-		"@biomejs/biome": "^2.5.7",
+		"@biomejs/biome": "^2.5.10",
 		"typescript": "^5.9.3"
 	},
 	"homepage": "https://github.com/pie-framework/pie-players/tree/master/packages/default-tool-loaders#readme",