@pie-players/pie-default-tool-loaders 0.3.74 → 1.0.0-beta.0

package/dist/registrations/overlay-toolbar-render.js

@@ -2,21 +2,17 @@
  * The `renderToolbar` shape shared by every packaged capability that puts one
  * overlay behind one toolbar button.
  *
- * Seven registrations had this inline. What actually varies between them is the
- * three options below and nothing else: whether the overlay paints its own chrome
- * or takes a draggable window, that window's size, and whether the overlay needs
- * the coordinator re-handed on each sync. Everything else — the visibility
- * binding, the button, the component-override lookup, the `tool-id` attribute, the
- * sync — was identical, which is why one rule landing in three spellings was
- * possible: the shell title was `resolveToolRegistrationName` in two files,
- * `displayName` in a third and a raw `t(key)` in a fourth.
+ * What varies between capabilities is the two options below: whether the overlay
+ * paints its own chrome or takes a draggable window, and that window's size. The
+ * visibility binding, the button, the component-override lookup, the `tool-id`
+ * attribute and the sync are shared, so the shell title has one spelling.
  *
- * Catalog keys are derived from `toolId`, which held at all seven sites:
- * `tools.<toolId>.buttonA11y` and `tools.<toolId>.tooltip`. A capability needing a
- * different prefix — the dictionary variants, which compose several capabilities
- * off one element — keeps its own renderer.
+ * Catalog keys are derived from `toolId`: `tools.<toolId>.buttonA11y` and
+ * `tools.<toolId>.tooltip`. A capability needing a different prefix — the
+ * dictionary variants, which compose several capabilities off one element —
+ * keeps its own renderer.
  */
-import { applyOverlaySurface, createScopedVisibilityBinding, createToolElement, resolveToolRegistrationName, syncButtonAndOverlayVisibility, } from "@pie-players/pie-assessment-toolkit/tools/internal";
+import { applyOverlaySurface, createScopedVisibilityBinding, createToolElement, resolveToolRegistrationName, syncButtonAndOverlayVisibility, } from "@pie-players/pie-assessment-toolkit/tools/registration";
 import { resolveOverlayElement } from "./overlay-element-cache.js";
 export function renderOverlayToolbar(registration, context, toolbarContext, options = {}) {
     const { toolId } = registration;
@@ -74,9 +70,6 @@ export function renderOverlayToolbar(registration, context, toolbarContext, opti
                 overlay,
                 isActive: visibility.isActive,
             });
-            if (options.handsOverCoordinator && toolbarContext.toolkitCoordinator) {
-                overlay.toolkitCoordinator = toolbarContext.toolkitCoordinator;
-            }
         },
         subscribeActive: visibility.subscribeActive,
     };

package/dist/registrations/selection-actions.d.ts

@@ -12,7 +12,7 @@
  * cannot originate one at all. Every tool named here also opens from the toolbar and
  * carries its own term field.
  */
-import type { ToolSelectionAction, ToolSurfaceServices } from "@pie-players/pie-assessment-toolkit/tools/internal";
+import type { ToolSelectionAction, ToolSurfaceServices } from "@pie-players/pie-assessment-toolkit/tools/registration";
 /**
  * Actions for the gateway to render, given the services it was handed.
  *

package/dist/registrations/selection-actions.js

@@ -12,7 +12,7 @@
  * 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";
+import { resolveFallbackToolIcon } from "@pie-players/pie-assessment-toolkit/tools/registration";
 function asRequestCapable(coordinator) {
     const candidate = coordinator;
     if (typeof candidate?.canRequestTool !== "function")

package/dist/registrations/subject-specific-tools.d.ts

@@ -4,12 +4,8 @@
  * Registers tools for specific subject areas:
  * - Graph (coordinate plane)
  * - Periodic Table (chemistry reference)
- *
- * Maps to QTI 3.0 standard access features:
- * - graph (assessment tool)
- * - periodicTable (assessment tool)
  */
-import type { ToolRegistration } from "@pie-players/pie-assessment-toolkit/tools/internal";
+import type { ToolRegistration } from "@pie-players/pie-assessment-toolkit/tools/registration";
 /**
  * Graph tool registration
  *

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

@@ -4,12 +4,8 @@
  * Registers tools for specific subject areas:
  * - Graph (coordinate plane)
  * - Periodic Table (chemistry reference)
- *
- * Maps to QTI 3.0 standard access features:
- * - graph (assessment tool)
- * - periodicTable (assessment tool)
  */
-import { hasMathContent, hasScienceContent, } from "@pie-players/pie-assessment-toolkit/tools/internal";
+import { hasMathContent, hasScienceContent, } from "@pie-players/pie-assessment-toolkit/tools/registration";
 import { renderOverlayToolbar } from "./overlay-toolbar-render.js";
 /**
  * Graph tool registration
@@ -27,11 +23,6 @@ export const graphToolRegistration = {
     // A floating tool, placed on a section toolbar or on an item toolbar where
     // the toolkit runs without a section.
     supportedLevels: ["section", "item"],
-    // `graphingCalculator` grants the calculator, whose graphing type a host
-    // selects through render params; the coordinate plane is not that tool.
-    pnpSupportIds: [
-        "graph", // QTI 3.0 standard (assessment.graph)
-    ],
     /**
      * Pass 2: Graph is relevant when math content is present
      */
@@ -66,11 +57,6 @@ export const periodicTableToolRegistration = {
     // A floating tool, placed on a section toolbar or on an item toolbar where
     // the toolkit runs without a section.
     supportedLevels: ["section", "item"],
-    // PNP support IDs
-    // Maps to QTI 3.0 standard feature: periodicTable
-    pnpSupportIds: [
-        "periodicTable", // QTI 3.0 standard (assessment.periodicTable)
-    ],
     /**
      * Pass 2: Periodic table is relevant when science content is present
      */

package/dist/registrations/tts.d.ts

@@ -2,20 +2,14 @@
  * Text-to-Speech (TTS) Tool Registration
  *
  * Registers the TTS tool for reading content aloud.
- *
- * Maps to QTI 3.0 standard access features:
- * - textToSpeech (auditory support)
- * - readAloud (auditory support)
  */
-import type { ToolRegistration } from "@pie-players/pie-assessment-toolkit/tools/internal";
-export declare const TOOL_ELEMENT_UNMOUNT_CALLBACK_PROP = "__pieToolElementUnmount";
-export declare const TOOL_ACTIVE_CHANGE_EVENT = "pie-tool-active-change";
+import type { ToolRegistration } from "@pie-players/pie-assessment-toolkit/tools/registration";
 /**
  * Text-to-Speech tool registration
  *
  * Supports:
  * - Reading content aloud using browser TTS or external providers
  * - Context-aware visibility (shows when readable text is available)
- * - All levels except assessment and element
+ * - Item and passage levels
  */
 export declare const ttsToolRegistration: ToolRegistration;

package/dist/registrations/tts.js

@@ -2,28 +2,22 @@
  * Text-to-Speech (TTS) Tool Registration
  *
  * Registers the TTS tool for reading content aloud.
- *
- * Maps to QTI 3.0 standard access features:
- * - textToSpeech (auditory support)
- * - readAloud (auditory support)
  */
-import { hasReadableText } from "@pie-players/pie-assessment-toolkit/tools/internal";
-import { createScopedToolId } from "@pie-players/pie-assessment-toolkit/tools/internal";
-import { buildRuntimeTTSConfig, normalizeTTSLayoutMode, normalizeTTSSpeedControlOptions, resolveTTSHostToolbarLayout, resolveTTSLayoutMode, resolveTTSBackend, resolveTTSRuntimeSettings, resolveRuntimeProvider, resolveTransportMode, } from "@pie-players/pie-assessment-toolkit/tools/internal";
-import { TTSToolProvider } from "@pie-players/pie-assessment-toolkit/tools/internal";
+import { hasSpokenContent } from "@pie-players/pie-assessment-toolkit/tools/registration";
+import { createScopedToolId, createToolElement, TOOL_ACTIVE_CHANGE_EVENT, } from "@pie-players/pie-assessment-toolkit/tools/registration";
+import { buildRuntimeTTSConfig, normalizeTTSSpeedControlOptions, resolveTTSHostToolbarLayout, resolveTTSRuntimeSettings, } from "@pie-players/pie-assessment-toolkit/tools/registration";
+import { TTSToolProvider } from "@pie-players/pie-assessment-toolkit/tools/registration";
+import { resolveOverlayElement } from "./overlay-element-cache.js";
 // This package owns the server adapter's import, so the toolkit never names it
 // and a bundler building the toolkit alone has nothing to resolve.
 const loadServerTTSProvider = async () => (await import("@pie-players/tts-client-server")).ServerTTSProvider;
-const inlineTTSControls = new Map();
-export const TOOL_ELEMENT_UNMOUNT_CALLBACK_PROP = "__pieToolElementUnmount";
-export const TOOL_ACTIVE_CHANGE_EVENT = "pie-tool-active-change";
 /**
  * Text-to-Speech tool registration
  *
  * Supports:
  * - Reading content aloud using browser TTS or external providers
  * - Context-aware visibility (shows when readable text is available)
- * - All levels except assessment and element
+ * - Item and passage levels
  */
 export const ttsToolRegistration = {
     toolId: "textToSpeech",
@@ -33,123 +27,69 @@ export const ttsToolRegistration = {
     descriptionKey: "tools.textToSpeech.description",
     icon: "volume-up",
     provider: {
-        getProviderId: () => "tts",
         createProvider: (config) => {
-            const settings = resolveTTSRuntimeSettings(config);
-            return new TTSToolProvider(resolveTTSBackend(settings), {
+            return new TTSToolProvider(resolveTTSRuntimeSettings(config).backend, {
                 loadServerProvider: loadServerTTSProvider,
             });
         },
-        getInitConfig: (config) => {
-            const settings = resolveTTSRuntimeSettings(config);
-            const backend = resolveTTSBackend(settings);
-            const serverProvider = resolveRuntimeProvider(settings, backend);
-            const transportMode = resolveTransportMode(settings, serverProvider);
-            return {
-                backend,
-                serverProvider,
-                transportMode,
-                ...buildRuntimeTTSConfig(settings),
-            };
-        },
+        getInitConfig: (config) => buildRuntimeTTSConfig(resolveTTSRuntimeSettings(config)),
         getAuthFetcher: (config) => {
             const runtimeAuthFetcher = config?.provider?.runtime?.authFetcher;
             return typeof runtimeAuthFetcher === "function"
                 ? runtimeAuthFetcher
                 : undefined;
         },
-        sanitizeConfig: (config) => {
-            const settings = config.settings && typeof config.settings === "object"
-                ? { ...config.settings }
-                : undefined;
-            if (settings && "layoutMode" in settings) {
-                settings.layoutMode = normalizeTTSLayoutMode(settings.layoutMode);
-            }
-            if (settings && "speedOptions" in settings) {
-                settings.speedOptions = normalizeTTSSpeedControlOptions(settings.speedOptions);
-            }
-            const normalizedConfig = {
-                ...config,
-            };
-            if ("layoutMode" in normalizedConfig) {
-                normalizedConfig.layoutMode = normalizeTTSLayoutMode(normalizedConfig.layoutMode);
-            }
-            if ("speedOptions" in normalizedConfig) {
-                normalizedConfig.speedOptions = normalizeTTSSpeedControlOptions(normalizedConfig.speedOptions);
-            }
-            if (settings) {
-                normalizedConfig.settings = settings;
-            }
-            return normalizedConfig;
-        },
         lazy: true,
     },
+    sanitizeConfig: (config) => {
+        const normalizedConfig = {
+            ...config,
+        };
+        if ("speedOptions" in normalizedConfig) {
+            normalizedConfig.speedOptions = normalizeTTSSpeedControlOptions(normalizedConfig.speedOptions);
+        }
+        return normalizedConfig;
+    },
     // TTS is inline-only and scoped to item/passage contexts.
     supportedLevels: ["item", "passage"],
-    // PNP support IDs that enable this tool
-    // Maps to QTI 3.0 standard features: textToSpeech, readAloud
-    pnpSupportIds: [
-        "textToSpeech", // QTI 3.0 standard (auditory.textToSpeech)
-        "readAloud", // QTI 3.0 standard (auditory.readAloud)
-    ],
     /**
      * Pass 2: Determine if TTS is relevant in this context
      *
-     * TTS is relevant when:
-     * - Context contains readable text (at least 10 characters)
+     * TTS is relevant when the context holds readable text or a catalog idref.
      */
     isVisibleInContext(context) {
-        return hasReadableText(context);
+        return hasSpokenContent(context);
     },
-    renderToolbar(_context, toolbarContext) {
+    renderToolbar(context, toolbarContext) {
         const resolveRuntimeSettings = () => resolveTTSRuntimeSettings(toolbarContext.toolkitCoordinator?.getToolConfig(this.toolId) ||
             undefined);
         const resolveElementSpeedOptions = () => {
             const runtimeSettings = resolveRuntimeSettings();
             return normalizeTTSSpeedControlOptions(runtimeSettings.speedOptions);
         };
-        const resolveLayoutMode = () => resolveTTSLayoutMode(resolveRuntimeSettings());
-        const resolveHostLayout = () => resolveTTSHostToolbarLayout(resolveRuntimeSettings());
         const fullToolId = createScopedToolId(this.toolId, toolbarContext.scope.level, toolbarContext.scope.scopeId);
         const resolveControlSize = () => {
             const raw = toolbarContext.ui?.size;
             return raw === "sm" || raw === "lg" ? raw : "md";
         };
-        const ensureElement = () => {
-            let element = inlineTTSControls.get(fullToolId);
-            if (element &&
-                typeof element.isConnected ===
-                    "boolean" &&
-                !element.isConnected) {
-                inlineTTSControls.delete(fullToolId);
-                element = undefined;
-            }
-            if (!element) {
-                element = document.createElement("pie-tool-tts-inline");
-                element[TOOL_ELEMENT_UNMOUNT_CALLBACK_PROP] = () => {
-                    if (inlineTTSControls.get(fullToolId) === element) {
-                        inlineTTSControls.delete(fullToolId);
-                    }
-                };
-                inlineTTSControls.set(fullToolId, element);
-            }
+        const element = resolveOverlayElement(toolbarContext, fullToolId, () => createToolElement(this.toolId, context, toolbarContext, toolbarContext.componentOverrides));
+        const applyAttributes = () => {
             element.setAttribute("catalog-id", toolbarContext.catalogId || toolbarContext.itemId);
-            element.setAttribute("language", toolbarContext.language || "en-US");
             element.setAttribute("size", resolveControlSize());
-            element.setAttribute("layout-mode", resolveLayoutMode());
+            element.setAttribute("layout-mode", resolveRuntimeSettings().layoutMode);
             element.speedOptions = resolveElementSpeedOptions();
             element.showSingleSpeedOption =
                 resolveRuntimeSettings().showSingleSpeedOption === true;
-            return element;
         };
-        const hostLayout = resolveHostLayout();
+        applyAttributes();
+        const hostLayout = resolveTTSHostToolbarLayout(resolveRuntimeSettings());
         return {
             toolId: this.toolId,
             button: null,
             elements: [
                 {
-                    element: ensureElement(),
-                    mount: hostLayout.mount,
+                    element,
+                    mount: "before-buttons",
                     layoutHints: {
                         controlsRow: {
                             reserveSpace: hostLayout.controlsRow.reserveSpace,
@@ -162,7 +102,6 @@ export const ttsToolRegistration = {
                 },
             ],
             subscribeActive: (callback) => {
-                const element = ensureElement();
                 const handler = (event) => {
                     const detail = event.detail;
                     callback(detail?.active === true);
@@ -172,17 +111,7 @@ export const ttsToolRegistration = {
                     element.removeEventListener(TOOL_ACTIVE_CHANGE_EVENT, handler);
                 };
             },
-            sync: () => {
-                const element = ensureElement();
-                element.setAttribute("tool-id", fullToolId);
-                element.setAttribute("catalog-id", toolbarContext.catalogId || toolbarContext.itemId);
-                element.setAttribute("language", toolbarContext.language || "en-US");
-                element.setAttribute("size", resolveControlSize());
-                element.setAttribute("layout-mode", resolveLayoutMode());
-                element.speedOptions = resolveElementSpeedOptions();
-                element.showSingleSpeedOption =
-                    resolveRuntimeSettings().showSingleSpeedOption === true;
-            },
+            sync: applyAttributes,
         };
     },
 };

package/package.json

@@ -1,8 +1,8 @@
 {
 	"name": "@pie-players/pie-default-tool-loaders",
-	"version": "0.3.74",
+	"version": "1.0.0-beta.0",
 	"type": "module",
-	"description": "Composition layer for the packaged PIE assessment tools: registrations, tag map, placement presets, universal supports and lazy module loaders",
+	"description": "Composition layer for the packaged PIE assessment tools: registrations, tag map, placement preset, universal and empty profiles, and lazy module loaders",
 	"repository": {
 		"type": "git",
 		"url": "git+https://github.com/pie-framework/pie-players.git",
@@ -33,30 +33,29 @@
 		"test": "bun test"
 	},
 	"dependencies": {
-		"@pie-players/pie-assessment-toolkit": "0.3.74",
-		"@pie-players/pie-calculator": "0.3.74",
-		"@pie-players/pie-calculator-cortex": "0.3.74",
-		"@pie-players/pie-calculator-desmos": "0.3.74",
-		"@pie-players/pie-calculator-geogebra": "0.3.74",
-		"@pie-players/pie-players-shared": "0.3.74",
-		"@pie-players/pie-tool-annotation-toolbar": "0.3.74",
-		"@pie-players/pie-tool-answer-eliminator": "0.3.74",
-		"@pie-players/pie-tool-calculator-cortex": "0.3.74",
-		"@pie-players/pie-tool-calculator-geogebra": "0.3.74",
-		"@pie-players/pie-tool-calculator-shared": "0.3.74",
-		"@pie-players/pie-tool-dictionary": "0.3.74",
-		"@pie-players/pie-tool-graph": "0.3.74",
-		"@pie-players/pie-tool-line-reader": "0.3.74",
-		"@pie-players/pie-tool-periodic-table": "0.3.74",
-		"@pie-players/pie-tool-picture-dictionary": "0.3.74",
-		"@pie-players/pie-tool-protractor": "0.3.74",
-		"@pie-players/pie-tool-ruler": "0.3.74",
-		"@pie-players/pie-tool-theme": "0.3.74",
-		"@pie-players/pie-tool-tts-inline": "0.3.74",
-		"@pie-players/tts-client-server": "0.3.74"
+		"@pie-players/pie-assessment-toolkit": "1.0.0-beta.0",
+		"@pie-players/pie-calculator": "1.0.0-beta.0",
+		"@pie-players/pie-calculator-cortex": "1.0.0-beta.0",
+		"@pie-players/pie-calculator-desmos": "1.0.0-beta.0",
+		"@pie-players/pie-calculator-geogebra": "1.0.0-beta.0",
+		"@pie-players/pie-players-shared": "1.0.0-beta.0",
+		"@pie-players/pie-tool-annotation-toolbar": "1.0.0-beta.0",
+		"@pie-players/pie-tool-answer-eliminator": "1.0.0-beta.0",
+		"@pie-players/pie-tool-calculator-shared": "1.0.0-beta.0",
+		"@pie-players/pie-tool-dictionary": "1.0.0-beta.0",
+		"@pie-players/pie-tool-graph": "1.0.0-beta.0",
+		"@pie-players/pie-tool-line-reader": "1.0.0-beta.0",
+		"@pie-players/pie-tool-periodic-table": "1.0.0-beta.0",
+		"@pie-players/pie-tool-picture-dictionary": "1.0.0-beta.0",
+		"@pie-players/pie-tool-protractor": "1.0.0-beta.0",
+		"@pie-players/pie-tool-ruler": "1.0.0-beta.0",
+		"@pie-players/pie-tool-theme": "1.0.0-beta.0",
+		"@pie-players/pie-tool-tts-inline": "1.0.0-beta.0",
+		"@pie-players/tts-client-server": "1.0.0-beta.0"
 	},
 	"devDependencies": {
 		"@biomejs/biome": "^2.5.15",
+		"@happy-dom/global-registrator": "^20.14.5",
 		"typescript": "^5.9.3"
 	},
 	"homepage": "https://github.com/pie-framework/pie-players/tree/master/packages/default-tool-loaders#readme",