@pie-players/pie-assessment-toolkit 0.2.0

package/dist/tools/variant-resolver.js

@@ -0,0 +1,214 @@
+/**
+ * Variant Resolver Service
+ * Resolves item configuration considering variants for A/B testing, scaffolding, and adaptations
+ *
+ * Based on architectural enhancements for item-level variant configuration
+ */
+export class VariantResolverImpl {
+    /**
+     * Resolve variant configuration for an item
+     */
+    resolveVariant(itemConfig, context) {
+        // If no variant config, return item as-is
+        if (!itemConfig.variantConfig) {
+            return this._buildResolvedConfig(itemConfig, null, []);
+        }
+        const { variantConfig } = itemConfig;
+        const { variantId, toolOverrides, adaptations } = variantConfig;
+        // Apply tool overrides if variant specified
+        const resolvedToolParameters = {};
+        if (itemConfig.toolParameters) {
+            for (const [toolType, params] of Object.entries(itemConfig.toolParameters)) {
+                resolvedToolParameters[toolType] = this._resolveToolParameters(toolType, params, toolOverrides, context);
+            }
+        }
+        // Apply tool overrides that aren't in original tool parameters
+        if (toolOverrides) {
+            for (const [toolType, override] of Object.entries(toolOverrides)) {
+                if (!resolvedToolParameters[toolType]) {
+                    resolvedToolParameters[toolType] =
+                        this._createToolParametersFromOverride(toolType, override);
+                }
+            }
+        }
+        // Build final resolved config
+        return {
+            itemId: itemConfig.itemId,
+            requiredTools: this._resolveRequiredTools(itemConfig, toolOverrides),
+            restrictedTools: itemConfig.restrictedTools || [],
+            toolParameters: resolvedToolParameters,
+            appliedVariant: variantId,
+            appliedAdaptations: this._filterAdaptations(adaptations, context),
+        };
+    }
+    /**
+     * Resolve tool parameters considering variant and context
+     */
+    _resolveToolParameters(toolType, params, toolOverrides, context) {
+        // Start with base parameters
+        let finalConfig = params.config || {};
+        let finalHint = params.hint;
+        let finalPreOpen = params.preOpen;
+        // Apply variant-specific parameters if they exist
+        if (params.variants) {
+            const variantParams = this._selectVariantParameters(params.variants, context);
+            if (variantParams) {
+                finalConfig = { ...finalConfig, ...variantParams.config };
+                if (variantParams.hint !== undefined)
+                    finalHint = variantParams.hint;
+                if (variantParams.preOpen !== undefined)
+                    finalPreOpen = variantParams.preOpen;
+            }
+        }
+        // Apply tool override from variant config
+        if (toolOverrides && toolOverrides[toolType]) {
+            const override = toolOverrides[toolType];
+            if (override.config) {
+                finalConfig = { ...finalConfig, ...override.config };
+            }
+            if (override.parameters) {
+                // Merge additional parameters
+                finalConfig = { ...finalConfig, ...override.parameters };
+            }
+        }
+        return {
+            config: params.config,
+            hint: finalHint,
+            preOpen: finalPreOpen,
+            variants: params.variants,
+            finalConfig: finalConfig,
+        };
+    }
+    /**
+     * Select variant parameters based on context
+     */
+    _selectVariantParameters(variants, context) {
+        // Strategy: Select based on context properties
+        // 1. Check for scaffolding level match
+        if (context.scaffoldingLevel !== undefined) {
+            const scaffoldKey = `scaffolding-${context.scaffoldingLevel}`;
+            if (variants[scaffoldKey])
+                return variants[scaffoldKey];
+        }
+        // 2. Check for difficulty level match
+        if (context.difficultyLevel) {
+            const difficultyKey = `difficulty-${context.difficultyLevel}`;
+            if (variants[difficultyKey])
+                return variants[difficultyKey];
+        }
+        // 3. Check for language match
+        if (context.language) {
+            const langKey = `lang-${context.language}`;
+            if (variants[langKey])
+                return variants[langKey];
+        }
+        // 4. Check custom context keys
+        if (context.custom) {
+            for (const [key, value] of Object.entries(context.custom)) {
+                const customKey = `${key}-${value}`;
+                if (variants[customKey])
+                    return variants[customKey];
+            }
+        }
+        // 5. Check for default variant
+        if (variants.default)
+            return variants.default;
+        return null;
+    }
+    /**
+     * Create tool parameters from override
+     */
+    _createToolParametersFromOverride(toolType, override) {
+        return {
+            config: override.config,
+            hint: override.hint,
+            preOpen: override.preOpen,
+            finalConfig: {
+                id: toolType,
+                name: this._humanizeName(toolType),
+                enabled: true,
+                ...override.config,
+            },
+        };
+    }
+    /**
+     * Resolve required tools considering overrides
+     */
+    _resolveRequiredTools(itemConfig, toolOverrides) {
+        const required = new Set(itemConfig.requiredTools || []);
+        // Add tools that have replacements via overrides
+        if (toolOverrides) {
+            for (const [toolType, override] of Object.entries(toolOverrides)) {
+                if (override.replacementTool) {
+                    required.delete(toolType);
+                    required.add(override.replacementTool);
+                }
+            }
+        }
+        return Array.from(required);
+    }
+    /**
+     * Filter adaptations based on context
+     */
+    _filterAdaptations(adaptations, context) {
+        if (!adaptations)
+            return [];
+        return adaptations.filter((adaptation) => {
+            // Check if adaptation matches context
+            if (adaptation.type === "scaffolding" &&
+                context.scaffoldingLevel !== undefined) {
+                return adaptation.level === context.scaffoldingLevel;
+            }
+            if (adaptation.type === "difficulty" && context.difficultyLevel) {
+                return adaptation.level === context.difficultyLevel;
+            }
+            if (adaptation.type === "language" && context.language) {
+                return adaptation.level === context.language;
+            }
+            // Include custom adaptations by default
+            return true;
+        });
+    }
+    /**
+     * Build resolved config without variants
+     */
+    _buildResolvedConfig(itemConfig, variantId, adaptations) {
+        const resolvedToolParameters = {};
+        if (itemConfig.toolParameters) {
+            for (const [toolType, params] of Object.entries(itemConfig.toolParameters)) {
+                resolvedToolParameters[toolType] = {
+                    ...params,
+                    finalConfig: {
+                        id: toolType,
+                        name: this._humanizeName(toolType),
+                        enabled: true,
+                        ...params.config,
+                    },
+                };
+            }
+        }
+        return {
+            itemId: itemConfig.itemId,
+            requiredTools: itemConfig.requiredTools || [],
+            restrictedTools: itemConfig.restrictedTools || [],
+            toolParameters: resolvedToolParameters,
+            appliedVariant: variantId || undefined,
+            appliedAdaptations: adaptations,
+        };
+    }
+    /**
+     * Convert tool type to human-readable name
+     */
+    _humanizeName(toolType) {
+        return toolType
+            .replace(/[-_]/g, " ")
+            .replace(/\b\w/g, (char) => char.toUpperCase());
+    }
+}
+/**
+ * Singleton instance (deprecated)
+ * @deprecated Instantiate VariantResolverImpl directly instead:
+ *   const resolver = new VariantResolverImpl();
+ */
+export const variantResolver = new VariantResolverImpl();
+//# sourceMappingURL=variant-resolver.js.map

package/dist/tools/variant-resolver.js.map

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

package/dist/types/events.d.ts

@@ -0,0 +1,157 @@
+/**
+ * PIE Assessment Toolkit - Event Types
+ *
+ * Type-safe event definitions for the assessment toolkit event system.
+ * Uses discriminated unions for type safety across event bus.
+ *
+ * These events are standard contracts between toolkit services,
+ * PIE players, tools, and product implementations.
+ */
+export interface SessionChangedEvent {
+    itemId: string;
+    component: string;
+    complete: boolean;
+    session: {
+        id: string;
+        data: any[];
+    };
+    timestamp: number;
+}
+export interface LoadCompleteEvent {
+    itemId: string;
+    loadTime: number;
+    timestamp: number;
+}
+export interface PlayerErrorEvent {
+    itemId: string;
+    error: string;
+    timestamp: number;
+}
+export interface ToolActivatedEvent {
+    toolId: string;
+    toolType: string;
+    itemId?: string;
+    timestamp: number;
+}
+export interface ToolDeactivatedEvent {
+    toolId: string;
+    timestamp: number;
+}
+export interface ToolStateChangedEvent {
+    toolId: string;
+    state: any;
+    timestamp: number;
+}
+export interface NavigationRequestEvent {
+    direction: "next" | "previous" | "index";
+    targetIndex?: number;
+    timestamp: number;
+}
+export interface ItemChangedEvent {
+    previousItemId: string | null;
+    currentItemId: string;
+    itemIndex: number;
+    totalItems: number;
+    metadata?: ItemMetadata;
+    timestamp: number;
+}
+export interface CanNavigateChangedEvent {
+    canNext: boolean;
+    canPrevious: boolean;
+    timestamp: number;
+}
+export interface ItemMetadata {
+    timeLimit?: number;
+    isLastItem: boolean;
+    hasPassage: boolean;
+    questionNumber?: number;
+}
+export interface AssessmentStartedEvent {
+    assessmentId: string;
+    studentId: string;
+    timestamp: number;
+}
+export interface AssessmentPausedEvent {
+    assessmentId: string;
+    timestamp: number;
+}
+export interface AssessmentResumedEvent {
+    assessmentId: string;
+    timestamp: number;
+}
+export interface AssessmentCompletedEvent {
+    assessmentId: string;
+    totalTime: number;
+    itemsCompleted: number;
+    timestamp: number;
+}
+export interface StateSavedEvent {
+    type: "session" | "tool" | "assessment";
+    itemId?: string;
+    toolId?: string;
+    timestamp: number;
+}
+export interface StateRestoredEvent {
+    type: "session" | "tool" | "assessment";
+    timestamp: number;
+}
+export interface SyncFailedEvent {
+    type: "session" | "tool" | "assessment";
+    itemId?: string;
+    toolId?: string;
+    error: string;
+    timestamp: number;
+}
+export type InteractionType = "response-changed" | "tool-activated" | "tool-deactivated" | "item-viewed" | "navigation-attempted" | "navigation-blocked" | "focus-lost" | "focus-gained" | "copy-attempted" | "paste-attempted" | "fullscreen-exited";
+export interface InteractionEvent {
+    type: InteractionType;
+    timestamp: number;
+    itemId?: string;
+    toolId?: string;
+    metadata?: Record<string, any>;
+}
+export interface LocaleChangedEvent {
+    locale: string;
+    previousLocale: string;
+    direction: "ltr" | "rtl";
+    timestamp: number;
+}
+export interface LocaleLoadingStartEvent {
+    locale: string;
+    timestamp: number;
+}
+export interface LocaleLoadingCompleteEvent {
+    locale: string;
+    success: boolean;
+    timestamp: number;
+}
+export interface LocaleLoadingErrorEvent {
+    locale: string;
+    error: string;
+    timestamp: number;
+}
+export interface AssessmentToolkitEvents {
+    "player:session-changed": SessionChangedEvent;
+    "player:load-complete": LoadCompleteEvent;
+    "player:error": PlayerErrorEvent;
+    "tool:activated": ToolActivatedEvent;
+    "tool:deactivated": ToolDeactivatedEvent;
+    "tool:state-changed": ToolStateChangedEvent;
+    "nav:next-requested": NavigationRequestEvent;
+    "nav:previous-requested": NavigationRequestEvent;
+    "nav:item-changed": ItemChangedEvent;
+    "nav:can-navigate-changed": CanNavigateChangedEvent;
+    "assessment:started": AssessmentStartedEvent;
+    "assessment:paused": AssessmentPausedEvent;
+    "assessment:resumed": AssessmentResumedEvent;
+    "assessment:completed": AssessmentCompletedEvent;
+    "state:saved": StateSavedEvent;
+    "state:restored": StateRestoredEvent;
+    "state:sync-failed": SyncFailedEvent;
+    "interaction:tracked": InteractionEvent;
+    "i18n:locale-changed": LocaleChangedEvent;
+    "i18n:loading-start": LocaleLoadingStartEvent;
+    "i18n:loading-complete": LocaleLoadingCompleteEvent;
+    "i18n:loading-error": LocaleLoadingErrorEvent;
+}
+//# sourceMappingURL=events.d.ts.map

package/dist/types/events.d.ts.map

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

package/dist/types/events.js

@@ -0,0 +1,11 @@
+/**
+ * PIE Assessment Toolkit - Event Types
+ *
+ * Type-safe event definitions for the assessment toolkit event system.
+ * Uses discriminated unions for type safety across event bus.
+ *
+ * These events are standard contracts between toolkit services,
+ * PIE players, tools, and product implementations.
+ */
+export {};
+//# sourceMappingURL=events.js.map

package/dist/types/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/types/events.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/dist/utils/logger.d.ts

@@ -0,0 +1,7 @@
+export type Logger = (...args: unknown[]) => void;
+/**
+ * Minimal logger helper (replacement for PIEOneer’s internal debug logger).
+ * We intentionally keep this lightweight and browser-safe.
+ */
+export declare function createLogger(namespace: string): Logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,MAAM,GAAG,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;AAElD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAKtD"}

package/dist/utils/logger.js

@@ -0,0 +1,11 @@
+/**
+ * Minimal logger helper (replacement for PIEOneer’s internal debug logger).
+ * We intentionally keep this lightweight and browser-safe.
+ */
+export function createLogger(namespace) {
+    return (...args) => {
+        // eslint-disable-next-line no-console
+        console.debug(`[${namespace}]`, ...args);
+    };
+}
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,SAAiB;IAC7C,OAAO,CAAC,GAAG,IAAI,EAAE,EAAE;QAClB,sCAAsC;QACtC,OAAO,CAAC,KAAK,CAAC,IAAI,SAAS,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;IAC1C,CAAC,CAAC;AACH,CAAC"}

package/package.json

@@ -0,0 +1,71 @@
+{
+	"name": "@pie-players/pie-assessment-toolkit",
+	"version": "0.2.0",
+	"type": "module",
+	"description": "PIE assessment toolkit: composable services + reference implementation for assessment players and tool coordination",
+	"license": "MIT",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/pie-framework/pie-players.git"
+	},
+	"publishConfig": {
+		"access": "public"
+	},
+	"main": "./dist/index.js",
+	"types": "./dist/index.d.ts",
+	"unpkg": "./dist/index.js",
+	"jsdelivr": "./dist/index.js",
+	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"import": "./dist/index.js"
+		},
+		"./tools/client": {
+			"types": "./dist/tools/client.d.ts",
+			"import": "./dist/tools/client.js"
+		},
+		"./assessment-player": {
+			"types": "./dist/player/index.d.ts",
+			"import": "./dist/player/index.js"
+		},
+		"./assessment-player/Layout.svelte": {
+			"svelte": "./src/player/AssessmentLayout.svelte",
+			"import": "./src/player/AssessmentLayout.svelte"
+		},
+		"./components/QuestionToolBar.svelte": {
+			"svelte": "./src/components/QuestionToolBar.svelte",
+			"import": "./src/components/QuestionToolBar.svelte"
+		},
+		"./services/I18nService": {
+			"types": "./dist/services/I18nService.d.ts",
+			"import": "./dist/services/I18nService.js"
+		}
+	},
+	"files": [
+		"dist",
+		"src/**/*.svelte",
+		"README.md"
+	],
+	"scripts": {
+		"build": "tsc -p tsconfig.json",
+		"dev": "tsc -p tsconfig.json --watch",
+		"typecheck": "tsc -p tsconfig.json --noEmit",
+		"lint": "biome check .",
+		"check": "tsc -p tsconfig.json --noEmit",
+		"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:*"
+	},
+	"peerDependencies": {
+		"svelte": "^5.0.0"
+	},
+	"devDependencies": {
+		"@biomejs/biome": "^2.3.10",
+		"typescript": "^5.9.3"
+	}
+}