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

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

@@ -0,0 +1,112 @@
+/**
+ * Measurement Tools Registrations
+ *
+ * Registers ruler and protractor tools for on-screen measurements.
+ *
+ * Maps to QTI 3.0 standard access features:
+ * - ruler (assessment tool)
+ * - protractor (assessment tool)
+ */
+import { hasMathContent } from "../../services/tool-context";
+import { createToolElement, } from "../tool-tag-map";
+/**
+ * Ruler tool registration
+ *
+ * Provides an on-screen ruler for measuring lengths.
+ * Typically appears on geometry or measurement problems.
+ */
+export const rulerToolRegistration = {
+    toolId: "ruler",
+    name: "Ruler",
+    description: "On-screen ruler for measurements",
+    icon: "ruler",
+    // Ruler typically appears at item/element level
+    supportedLevels: ["item", "element"],
+    // PNP support IDs
+    // Maps to QTI 3.0 standard feature: ruler
+    pnpSupportIds: [
+        "ruler", // QTI 3.0 standard (assessment.ruler)
+        "measurement", // Common variant
+    ],
+    /**
+     * Pass 2: Ruler is relevant when math content is present
+     */
+    isVisibleInContext(context) {
+        return hasMathContent(context);
+    },
+    createButton(context, options) {
+        return {
+            toolId: this.toolId,
+            label: this.name,
+            icon: typeof this.icon === "function" ? this.icon(context) : this.icon,
+            disabled: options.disabled || false,
+            ariaLabel: options.ariaLabel || "Open ruler tool",
+            tooltip: options.tooltip || "Ruler",
+            onClick: options.onClick || (() => { }),
+            className: options.className,
+        };
+    },
+    createToolInstance(context, options) {
+        const componentOverrides = options.config ?? {};
+        const ruler = createToolElement(this.toolId, context, options, componentOverrides);
+        ruler.visible = true;
+        if (options.config?.toolkitCoordinator) {
+            ruler.toolkitCoordinator = options.config.toolkitCoordinator;
+        }
+        if (options.onClose) {
+            ruler.addEventListener("close", options.onClose);
+        }
+        return ruler;
+    },
+};
+/**
+ * Protractor tool registration
+ *
+ * Provides an on-screen protractor for measuring angles.
+ * Typically appears on geometry problems.
+ */
+export const protractorToolRegistration = {
+    toolId: "protractor",
+    name: "Protractor",
+    description: "On-screen protractor for angle measurements",
+    icon: "protractor",
+    // Protractor typically appears at item/element level
+    supportedLevels: ["item", "element"],
+    // PNP support IDs
+    // Maps to QTI 3.0 standard feature: protractor
+    pnpSupportIds: [
+        "protractor", // QTI 3.0 standard (assessment.protractor)
+        "angleMeasurement", // Common variant
+    ],
+    /**
+     * Pass 2: Protractor is relevant when math content is present
+     */
+    isVisibleInContext(context) {
+        return hasMathContent(context);
+    },
+    createButton(context, options) {
+        return {
+            toolId: this.toolId,
+            label: this.name,
+            icon: typeof this.icon === "function" ? this.icon(context) : this.icon,
+            disabled: options.disabled || false,
+            ariaLabel: options.ariaLabel || "Open protractor tool",
+            tooltip: options.tooltip || "Protractor",
+            onClick: options.onClick || (() => { }),
+            className: options.className,
+        };
+    },
+    createToolInstance(context, options) {
+        const componentOverrides = options.config ?? {};
+        const protractor = createToolElement(this.toolId, context, options, componentOverrides);
+        protractor.visible = true;
+        if (options.config?.toolkitCoordinator) {
+            protractor.toolkitCoordinator = options.config.toolkitCoordinator;
+        }
+        if (options.onClose) {
+            protractor.addEventListener("close", options.onClose);
+        }
+        return protractor;
+    },
+};
+//# sourceMappingURL=measurement-tools.js.map

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

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

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

@@ -0,0 +1,28 @@
+/**
+ * Subject-Specific Tools Registrations
+ *
+ * Registers tools for specific subject areas:
+ * - Graph (graphing calculator/coordinate plane)
+ * - Periodic Table (chemistry reference)
+ *
+ * Maps to QTI 3.0 standard access features:
+ * - graphingCalculator (assessment tool)
+ * - graph (assessment tool)
+ * - periodicTable (assessment tool)
+ */
+import type { ToolRegistration } from "../../services/ToolRegistry";
+/**
+ * Graph tool registration
+ *
+ * Provides graphing calculator and coordinate plane functionality.
+ * Context-smart: appears automatically for math content or when explicitly enabled.
+ */
+export declare const graphToolRegistration: ToolRegistration;
+/**
+ * Periodic Table tool registration
+ *
+ * Provides chemistry periodic table reference.
+ * Context-smart: appears automatically for science content or when explicitly enabled.
+ */
+export declare const periodicTableToolRegistration: ToolRegistration;
+//# sourceMappingURL=subject-specific-tools.d.ts.map

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

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

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

@@ -0,0 +1,118 @@
+/**
+ * Subject-Specific Tools Registrations
+ *
+ * Registers tools for specific subject areas:
+ * - Graph (graphing calculator/coordinate plane)
+ * - Periodic Table (chemistry reference)
+ *
+ * Maps to QTI 3.0 standard access features:
+ * - graphingCalculator (assessment tool)
+ * - graph (assessment tool)
+ * - periodicTable (assessment tool)
+ */
+import { hasMathContent, hasScienceContent } from "../../services/tool-context";
+import { createToolElement, } from "../tool-tag-map";
+/**
+ * Graph tool registration
+ *
+ * Provides graphing calculator and coordinate plane functionality.
+ * Context-smart: appears automatically for math content or when explicitly enabled.
+ */
+export const graphToolRegistration = {
+    toolId: "graph",
+    name: "Graph",
+    description: "Graphing calculator and coordinate plane",
+    icon: "chart-bar",
+    // Graph appears at item and element level where graphing might be needed
+    supportedLevels: ["item", "element"],
+    // PNP support IDs
+    // Maps to QTI 3.0 standard features: graph, graphingCalculator
+    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
+     */
+    isVisibleInContext(context) {
+        return hasMathContent(context);
+    },
+    createButton(context, options) {
+        return {
+            toolId: this.toolId,
+            label: this.name,
+            icon: typeof this.icon === "function" ? this.icon(context) : this.icon,
+            disabled: options.disabled || false,
+            ariaLabel: options.ariaLabel || "Graph - Graphing calculator",
+            tooltip: options.tooltip || "Graph",
+            onClick: options.onClick || (() => { }),
+            className: options.className,
+        };
+    },
+    createToolInstance(context, options) {
+        const componentOverrides = options.config ?? {};
+        const graph = createToolElement(this.toolId, context, options, componentOverrides);
+        graph.visible = true;
+        if (options.config?.toolkitCoordinator) {
+            graph.toolkitCoordinator = options.config.toolkitCoordinator;
+        }
+        if (options.onClose) {
+            graph.addEventListener("close", options.onClose);
+        }
+        return graph;
+    },
+};
+/**
+ * Periodic Table tool registration
+ *
+ * Provides chemistry periodic table reference.
+ * Context-smart: appears automatically for science content or when explicitly enabled.
+ */
+export const periodicTableToolRegistration = {
+    toolId: "periodicTable",
+    name: "Periodic Table",
+    description: "Chemistry periodic table reference",
+    icon: "beaker",
+    // Periodic table appears at item and element level
+    supportedLevels: ["item", "element"],
+    // PNP support IDs
+    // 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
+     */
+    isVisibleInContext(context) {
+        return hasScienceContent(context);
+    },
+    createButton(context, options) {
+        return {
+            toolId: this.toolId,
+            label: this.name,
+            icon: typeof this.icon === "function" ? this.icon(context) : this.icon,
+            disabled: options.disabled || false,
+            ariaLabel: options.ariaLabel || "Periodic table - Chemistry reference",
+            tooltip: options.tooltip || "Periodic Table",
+            onClick: options.onClick || (() => { }),
+            className: options.className,
+        };
+    },
+    createToolInstance(context, options) {
+        const componentOverrides = options.config ?? {};
+        const periodicTable = createToolElement(this.toolId, context, options, componentOverrides);
+        periodicTable.visible = true;
+        if (options.config?.toolkitCoordinator) {
+            periodicTable.toolkitCoordinator = options.config.toolkitCoordinator;
+        }
+        if (options.onClose) {
+            periodicTable.addEventListener("close", options.onClose);
+        }
+        return periodicTable;
+    },
+};
+//# sourceMappingURL=subject-specific-tools.js.map

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

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

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

@@ -0,0 +1,20 @@
+/**
+ * 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 "../../services/ToolRegistry";
+/**
+ * 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 (section, item, passage, rubric, element)
+ */
+export declare const ttsToolRegistration: ToolRegistration;
+//# sourceMappingURL=tts.d.ts.map

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

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

package/dist/tools/registrations/tts.js

@@ -0,0 +1,86 @@
+/**
+ * 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 "../../services/tool-context";
+import { createToolElement, } from "../tool-tag-map";
+/**
+ * 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 (section, item, passage, rubric, element)
+ */
+export const ttsToolRegistration = {
+    toolId: "textToSpeech",
+    name: "Text to Speech",
+    description: "Read content aloud",
+    icon: "volume-up",
+    // TTS can appear at all levels except assessment
+    supportedLevels: ["section", "item", "passage", "rubric", "element"],
+    // PNP support IDs that enable this tool
+    // Maps to QTI 3.0 standard features: textToSpeech, readAloud
+    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
+     *
+     * TTS is relevant when:
+     * - Context contains readable text (at least 10 characters)
+     */
+    isVisibleInContext(context) {
+        return hasReadableText(context);
+    },
+    /**
+     * Create TTS button for toolbar
+     */
+    createButton(context, options) {
+        const icon = typeof this.icon === "function" ? this.icon(context) : this.icon;
+        return {
+            toolId: this.toolId,
+            label: this.name,
+            icon: icon,
+            disabled: options.disabled || false,
+            ariaLabel: options.ariaLabel || "Read aloud - Press to activate text-to-speech",
+            tooltip: options.tooltip || "Read Aloud",
+            onClick: options.onClick || (() => { }),
+            className: options.className,
+        };
+    },
+    /**
+     * Create TTS tool instance
+     *
+     * Creates a <pie-tool-tts> web component or activates TTS service.
+     * Note: TTS often works as a service rather than a visible component.
+     */
+    createToolInstance(context, options) {
+        const componentOverrides = options.config ?? {};
+        const tts = createToolElement(this.toolId, context, options, componentOverrides);
+        tts.visible = true;
+        tts.toolId = this.toolId;
+        if (options.config?.toolkitCoordinator) {
+            tts.coordinator = options.config.toolkitCoordinator;
+        }
+        if (options.config?.ttsService) {
+            tts.ttsService = options.config.ttsService;
+        }
+        if (options.config?.contentElement) {
+            tts.contentElement = options.config.contentElement;
+        }
+        if (options.onClose) {
+            tts.addEventListener("close", options.onClose);
+        }
+        return tts;
+    },
+};
+//# sourceMappingURL=tts.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tts.js","sourceRoot":"","sources":["../../../src/tools/registrations/tts.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AASH,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EACN,iBAAiB,GAEjB,MAAM,iBAAiB,CAAC;AAEzB;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAqB;IACpD,MAAM,EAAE,cAAc;IACtB,IAAI,EAAE,gBAAgB;IACtB,WAAW,EAAE,oBAAoB;IACjC,IAAI,EAAE,WAAW;IAEjB,iDAAiD;IACjD,eAAe,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,CAAC;IAEpE,wCAAwC;IACxC,6DAA6D;IAC7D,aAAa,EAAE;QACd,cAAc,EAAE,2CAA2C;QAC3D,WAAW,EAAE,wCAAwC;QACrD,KAAK,EAAE,sBAAsB;QAC7B,cAAc,EAAE,iBAAiB;KACjC;IAED;;;;;OAKG;IACH,kBAAkB,CAAC,OAAoB;QACtC,OAAO,eAAe,CAAC,OAAO,CAAC,CAAC;IACjC,CAAC;IAED;;OAEG;IACH,YAAY,CACX,OAAoB,EACpB,OAA0B;QAE1B,MAAM,IAAI,GACT,OAAO,IAAI,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QAElE,OAAO;YACN,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,KAAK,EAAE,IAAI,CAAC,IAAI;YAChB,IAAI,EAAE,IAAI;YACV,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,KAAK;YACnC,SAAS,EACR,OAAO,CAAC,SAAS,IAAI,+CAA+C;YACrE,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,YAAY;YACxC,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC;YACtC,SAAS,EAAE,OAAO,CAAC,SAAS;SAC5B,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACH,kBAAkB,CACjB,OAAoB,EACpB,OAA4B;QAE5B,MAAM,kBAAkB,GACtB,OAAO,CAAC,MAA6C,IAAI,EAAE,CAAC;QAC9D,MAAM,GAAG,GAAG,iBAAiB,CAC5B,IAAI,CAAC,MAAM,EACX,OAAO,EACP,OAAO,EACP,kBAAkB,CAOlB,CAAC;QAEF,GAAG,CAAC,OAAO,GAAG,IAAI,CAAC;QACnB,GAAG,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAEzB,IAAI,OAAO,CAAC,MAAM,EAAE,kBAAkB,EAAE,CAAC;YACxC,GAAG,CAAC,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,kBAAkB,CAAC;QACrD,CAAC;QACD,IAAI,OAAO,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC;YAChC,GAAG,CAAC,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC;QAC5C,CAAC;QACD,IAAI,OAAO,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC;YACpC,GAAG,CAAC,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,cAA6B,CAAC;QACnE,CAAC;QAED,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;YACrB,GAAG,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;QAChD,CAAC;QAED,OAAO,GAAG,CAAC;IACZ,CAAC;CACD,CAAC"}

package/dist/tools/tool-tag-map.d.ts

@@ -0,0 +1,24 @@
+import type { ToolContext } from "../services/tool-context";
+import type { ToolInstanceOptions } from "../services/ToolRegistry";
+export type ToolTagMap = Record<string, string>;
+export type ToolComponentFactory = (args: {
+    toolId: string;
+    tagName: string;
+    context: ToolContext;
+    options: ToolInstanceOptions;
+}) => HTMLElement;
+export type ToolComponentFactoryMap = Record<string, ToolComponentFactory>;
+export interface ToolComponentOverrides {
+    toolTagMap?: Partial<ToolTagMap>;
+    toolComponentFactory?: ToolComponentFactory;
+    toolComponentFactories?: Partial<ToolComponentFactoryMap>;
+}
+/**
+ * Canonical default web component tag mapping for toolkit tools.
+ * Integrators can override any entry via ToolComponentOverrides.
+ */
+export declare const DEFAULT_TOOL_TAG_MAP: ToolTagMap;
+export declare const resolveToolTag: (toolId: string, overrides?: ToolComponentOverrides) => string;
+export declare const createToolElement: (toolId: string, context: ToolContext, options: ToolInstanceOptions, overrides?: ToolComponentOverrides) => HTMLElement;
+export declare const toToolIdFromTag: (tagName: string, overrides?: ToolComponentOverrides) => string | undefined;
+//# sourceMappingURL=tool-tag-map.d.ts.map

package/dist/tools/tool-tag-map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-tag-map.d.ts","sourceRoot":"","sources":["../../src/tools/tool-tag-map.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAEpE,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAEhD,MAAM,MAAM,oBAAoB,GAAG,CAAC,IAAI,EAAE;IACzC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,WAAW,CAAC;IACrB,OAAO,EAAE,mBAAmB,CAAC;CAC7B,KAAK,WAAW,CAAC;AAElB,MAAM,MAAM,uBAAuB,GAAG,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC;AAE3E,MAAM,WAAW,sBAAsB;IACtC,UAAU,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;IACjC,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;IAC5C,sBAAsB,CAAC,EAAE,OAAO,CAAC,uBAAuB,CAAC,CAAC;CAC1D;AAED;;;GAGG;AACH,eAAO,MAAM,oBAAoB,EAAE,UAalC,CAAC;AAEF,eAAO,MAAM,cAAc,GAC1B,QAAQ,MAAM,EACd,YAAY,sBAAsB,KAChC,MAIF,CAAC;AAKF,eAAO,MAAM,iBAAiB,GAC7B,QAAQ,MAAM,EACd,SAAS,WAAW,EACpB,SAAS,mBAAmB,EAC5B,YAAY,sBAAsB,KAChC,WAOF,CAAC;AAEF,eAAO,MAAM,eAAe,GAC3B,SAAS,MAAM,EACf,YAAY,sBAAsB,KAChC,MAAM,GAAG,SAIX,CAAC"}

package/dist/tools/tool-tag-map.js

@@ -0,0 +1,38 @@
+import { validateCustomElementTag } from "@pie-players/pie-players-shared/pie/tag-names";
+/**
+ * Canonical default web component tag mapping for toolkit tools.
+ * Integrators can override any entry via ToolComponentOverrides.
+ */
+export const DEFAULT_TOOL_TAG_MAP = {
+    calculator: "pie-tool-calculator",
+    textToSpeech: "pie-tool-text-to-speech",
+    ruler: "pie-tool-ruler",
+    protractor: "pie-tool-protractor",
+    answerEliminator: "pie-tool-answer-eliminator",
+    highlighter: "pie-tool-annotation-toolbar",
+    magnifier: "pie-tool-magnifier",
+    lineReader: "pie-tool-line-reader",
+    colorScheme: "pie-tool-color-scheme",
+    annotationToolbar: "pie-tool-annotation-toolbar",
+    graph: "pie-tool-graph",
+    periodicTable: "pie-tool-periodic-table",
+};
+export const resolveToolTag = (toolId, overrides) => {
+    const mapped = overrides?.toolTagMap?.[toolId] ?? DEFAULT_TOOL_TAG_MAP[toolId] ?? toolId;
+    return validateCustomElementTag(mapped, `tool component tag for "${toolId}"`);
+};
+const createDefaultToolElement = (tagName) => document.createElement(tagName);
+export const createToolElement = (toolId, context, options, overrides) => {
+    const tagName = resolveToolTag(toolId, overrides);
+    const factoryForTool = overrides?.toolComponentFactories?.[toolId];
+    const factory = factoryForTool ?? overrides?.toolComponentFactory;
+    return factory
+        ? factory({ toolId, tagName, context, options })
+        : createDefaultToolElement(tagName);
+};
+export const toToolIdFromTag = (tagName, overrides) => {
+    const validTag = validateCustomElementTag(tagName, "tool component tag");
+    const map = { ...DEFAULT_TOOL_TAG_MAP, ...overrides?.toolTagMap };
+    return Object.entries(map).find(([, tag]) => tag === validTag)?.[0];
+};
+//# sourceMappingURL=tool-tag-map.js.map

package/dist/tools/tool-tag-map.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-tag-map.js","sourceRoot":"","sources":["../../src/tools/tool-tag-map.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,+CAA+C,CAAC;AAqBzF;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAe;IAC/C,UAAU,EAAE,qBAAqB;IACjC,YAAY,EAAE,yBAAyB;IACvC,KAAK,EAAE,gBAAgB;IACvB,UAAU,EAAE,qBAAqB;IACjC,gBAAgB,EAAE,4BAA4B;IAC9C,WAAW,EAAE,6BAA6B;IAC1C,SAAS,EAAE,oBAAoB;IAC/B,UAAU,EAAE,sBAAsB;IAClC,WAAW,EAAE,uBAAuB;IACpC,iBAAiB,EAAE,6BAA6B;IAChD,KAAK,EAAE,gBAAgB;IACvB,aAAa,EAAE,yBAAyB;CACxC,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAG,CAC7B,MAAc,EACd,SAAkC,EACzB,EAAE;IACX,MAAM,MAAM,GACX,SAAS,EAAE,UAAU,EAAE,CAAC,MAAM,CAAC,IAAI,oBAAoB,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC;IAC3E,OAAO,wBAAwB,CAAC,MAAM,EAAE,2BAA2B,MAAM,GAAG,CAAC,CAAC;AAC/E,CAAC,CAAC;AAEF,MAAM,wBAAwB,GAAG,CAAC,OAAe,EAAe,EAAE,CACjE,QAAQ,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;AAEjC,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAChC,MAAc,EACd,OAAoB,EACpB,OAA4B,EAC5B,SAAkC,EACpB,EAAE;IAChB,MAAM,OAAO,GAAG,cAAc,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAClD,MAAM,cAAc,GAAG,SAAS,EAAE,sBAAsB,EAAE,CAAC,MAAM,CAAC,CAAC;IACnE,MAAM,OAAO,GAAG,cAAc,IAAI,SAAS,EAAE,oBAAoB,CAAC;IAClE,OAAO,OAAO;QACb,CAAC,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;QAChD,CAAC,CAAC,wBAAwB,CAAC,OAAO,CAAC,CAAC;AACtC,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,eAAe,GAAG,CAC9B,OAAe,EACf,SAAkC,EACb,EAAE;IACvB,MAAM,QAAQ,GAAG,wBAAwB,CAAC,OAAO,EAAE,oBAAoB,CAAC,CAAC;IACzE,MAAM,GAAG,GAAG,EAAE,GAAG,oBAAoB,EAAE,GAAG,SAAS,EAAE,UAAU,EAAE,CAAC;IAClE,OAAO,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC,GAAG,KAAK,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;AACrE,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@pie-players/pie-assessment-toolkit",
-	"version": "0.2.3",
+	"version": "0.2.4",
 	"type": "module",
 	"description": "PIE assessment toolkit: composable services + reference implementation for assessment players and tool coordination",
 	"license": "MIT",
@@ -36,6 +36,14 @@
 			"svelte": "./src/components/QuestionToolBar.svelte",
 			"import": "./src/components/QuestionToolBar.svelte"
 		},
+		"./components/PNPProvenanceViewer.svelte": {
+			"svelte": "./src/components/PNPProvenanceViewer.svelte",
+			"import": "./src/components/PNPProvenanceViewer.svelte"
+		},
+		"./components/PNPProfileTester.svelte": {
+			"svelte": "./src/components/PNPProfileTester.svelte",
+			"import": "./src/components/PNPProfileTester.svelte"
+		},
 		"./services/I18nService": {
 			"types": "./dist/services/I18nService.d.ts",
 			"import": "./dist/services/I18nService.js"
@@ -55,14 +63,14 @@
 		"test": "bun test"
 	},
 	"dependencies": {
-		"@pie-players/pie-calculator": "workspace:*",
-		"@pie-players/pie-calculator-desmos": "workspace:*",
-		"@pie-players/pie-players-shared": "workspace:*",
-		"@pie-players/pie-tts": "workspace:*",
-		"@pie-players/tts-client-server": "workspace:*"
+		"@pie-players/pie-calculator": "0.1.1",
+		"@pie-players/pie-calculator-desmos": "0.1.2",
+		"@pie-players/pie-players-shared": "0.2.2",
+		"@pie-players/pie-tts": "0.1.1",
+		"@pie-players/tts-client-server": "0.2.1"
 	},
 	"peerDependencies": {
-		"svelte": "^5.0.0"
+		"svelte": "^5.51.0"
 	},
 	"devDependencies": {
 		"@biomejs/biome": "^2.3.10",

package/src/README.md

@@ -541,21 +541,35 @@ const player = new AssessmentPlayer({ assessment, loadItem });
 // Or use PNPToolResolver directly
 const resolver = new PNPToolResolver();
 const tools = resolver.resolveTools(assessment, currentItemRef);
-// Returns: [{ id: 'pie-tool-text-to-speech', enabled: true, ... }, ...]
+// Returns: [{ id: 'textToSpeech', enabled: true, ... }, ...]
 ```
 
-**Standard PNP Support IDs:**
+**Standard PNP Support IDs -> toolkit tool IDs (semantic):**
 
 ```typescript
-'textToSpeech'    → 'pie-tool-text-to-speech'
-'calculator'      → 'pie-tool-calculator'
-'ruler'           → 'pie-tool-ruler'
-'protractor'      → 'pie-tool-protractor'
-'highlighter'     → 'pie-tool-annotation-toolbar'
-'lineReader'      → 'pie-tool-line-reader'
-'magnifier'       → 'pie-tool-magnifier'
-'colorContrast'   → 'pie-theme-contrast'
-'answerMasking'   → 'pie-tool-answer-eliminator'
+'textToSpeech'    → 'textToSpeech'
+'calculator'      → 'calculator'
+'ruler'           → 'ruler'
+'protractor'      → 'protractor'
+'highlighter'     → 'highlighter'
+'lineReader'      → 'lineReader'
+'magnifier'       → 'magnifier'
+'colorContrast'   → 'colorScheme'
+'answerMasking'   → 'answerEliminator'
+```
+
+Toolkit tool IDs resolve to default web component tags through `DEFAULT_TOOL_TAG_MAP`
+and can be overridden via `createDefaultToolRegistry(...)`:
+
+```typescript
+import { createDefaultToolRegistry } from '@pie-players/pie-assessment-toolkit';
+
+const toolRegistry = createDefaultToolRegistry({
+  toolTagMap: {
+    calculator: 'my-calculator-tool',
+    textToSpeech: 'my-tts-tool'
+  }
+});
 ```
 
 ### Context Declarations