@pie-players/pie-assessment-toolkit 0.2.0

package/dist/tools/types.d.ts

@@ -0,0 +1,427 @@
+/**
+ * Tool system type definitions
+ */
+export type { CalculationHistoryEntry, Calculator, CalculatorProvider, CalculatorProviderCapabilities, CalculatorProviderConfig, CalculatorState, CalculatorType, DesmosCalculatorConfig, TICalculatorConfig, } from "@pie-players/pie-calculator";
+export type ToolId = string;
+export interface ToolState {
+    id: ToolId;
+    name: string;
+    isVisible: boolean;
+    isActive: boolean;
+    zIndex: number;
+    element?: HTMLElement;
+}
+export interface ToolPosition {
+    x: number;
+    y: number;
+}
+export interface ToolSize {
+    width: number;
+    height: number;
+}
+export interface ToolConfig {
+    id: ToolId;
+    name: string;
+    icon?: string;
+    enabled: boolean;
+    alwaysAvailable?: boolean;
+}
+export interface AssessmentToolConfig {
+    enabledTools: ToolId[];
+    toolSettings?: Record<ToolId, any>;
+}
+/**
+ * Tool allowance: "0" = blocked, "1" = allowed
+ * Based on existing platform patterns
+ */
+export type ToolAllowance = "0" | "1";
+/**
+ * Roster/Test-level tool configuration
+ * Defines default tool availability for an assessment
+ */
+export interface RosterToolConfiguration {
+    rosterId: string;
+    testId?: string;
+    toolAllowances: Record<string, ToolAllowance>;
+    defaultToolConfigs?: Record<string, ToolConfig>;
+}
+/**
+ * Configuration source for tool resolution
+ */
+export type ConfigurationSource = "roster-block" | "item-restriction" | "item-requirement" | "student-accommodation" | "roster-default" | "system-default";
+/**
+ * Resolved tool configuration with source tracking
+ */
+export interface ResolvedToolConfig extends ToolConfig {
+    resolvedFrom: ConfigurationSource;
+    required: boolean;
+    reason: string;
+}
+/**
+ * Tool resolution result
+ */
+export interface ToolResolutionResult {
+    allowed: boolean;
+    reason: string;
+    source: ConfigurationSource;
+    config?: ToolConfig;
+}
+/**
+ * Item-level tool configuration
+ */
+export interface ItemToolConfig {
+    itemId: string;
+    requiredTools?: string[];
+    restrictedTools?: string[];
+    toolParameters?: Record<string, ItemToolParameters>;
+    variantConfig?: ItemVariantConfig;
+}
+/**
+ * Item tool parameters
+ */
+export interface ItemToolParameters {
+    config?: Partial<ToolConfig>;
+    hint?: string;
+    preOpen?: boolean;
+    variants?: Record<string, ItemToolParametersVariant>;
+}
+/**
+ * Item tool parameters variant
+ */
+export interface ItemToolParametersVariant {
+    config?: Partial<ToolConfig>;
+    hint?: string;
+    preOpen?: boolean;
+}
+/**
+ * Item variant configuration for A/B testing and scaffolding
+ */
+export interface ItemVariantConfig {
+    variantId?: string;
+    toolOverrides?: Record<string, ItemToolOverride>;
+    adaptations?: ContentAdaptation[];
+    experimental?: Record<string, any>;
+}
+/**
+ * Tool override for item variants
+ */
+export interface ItemToolOverride {
+    config?: Partial<ToolConfig>;
+    uiVariant?: string;
+    parameters?: Record<string, any>;
+    replacementTool?: string;
+}
+/**
+ * Content adaptation types
+ */
+export interface ContentAdaptation {
+    type: "scaffolding" | "difficulty" | "language" | "modality" | "custom";
+    level: string | number;
+    affectedTools?: string[];
+    config?: Record<string, any>;
+}
+/**
+ * Variant context for resolution
+ */
+export interface VariantContext {
+    studentId: string;
+    sessionId: string;
+    language?: string;
+    scaffoldingLevel?: number;
+    difficultyLevel?: string;
+    custom?: Record<string, any>;
+}
+/**
+ * Resolved item configuration with variants applied
+ */
+export interface ResolvedItemConfig {
+    itemId: string;
+    requiredTools: string[];
+    restrictedTools: string[];
+    toolParameters: Record<string, ResolvedItemToolParameters>;
+    appliedVariant?: string;
+    appliedAdaptations?: ContentAdaptation[];
+}
+/**
+ * Resolved item tool parameters
+ */
+export interface ResolvedItemToolParameters extends ItemToolParameters {
+    finalConfig: ToolConfig;
+}
+/**
+ * Library configuration for external dependencies
+ */
+export interface LibraryConfig {
+    id: string;
+    url: string;
+    fallbackUrls?: string[];
+    globalVar?: string;
+    dependencies?: string[];
+    integrity?: string;
+    crossorigin?: "anonymous" | "use-credentials";
+    timeout?: number;
+    async?: boolean;
+    defer?: boolean;
+    retry?: RetryConfig;
+}
+/**
+ * Retry configuration for library loading
+ */
+export interface RetryConfig {
+    maxAttempts: number;
+    delay: number;
+    backoffMultiplier?: number;
+}
+/**
+ * Library loader statistics
+ */
+export interface LoaderStats {
+    loaded: string[];
+    failed: string[];
+    pending: string[];
+    cacheHits: number;
+    cacheMisses: number;
+    totalLoadTime: number;
+}
+/**
+ * Base interface that all tool components should implement
+ */
+export interface Tool {
+    /** Unique identifier for this tool */
+    id: ToolId;
+    /** Display name */
+    name: string;
+    /** Show the tool */
+    show(): void;
+    /** Hide the tool */
+    hide(): void;
+    /** Toggle visibility */
+    toggle(): void;
+    /** Cleanup when tool is destroyed */
+    destroy?(): void;
+}
+/**
+ * Tool categories for organizational purposes
+ */
+export declare enum ToolCategory {
+    STANDALONE = "standalone",
+    CONTENT_INTERACTIVE = "content-interactive",
+    SERVICE_DEPENDENT = "service-dependent"
+}
+/**
+ * Tool metadata
+ */
+export interface ToolMetadata {
+    id: ToolId;
+    name: string;
+    description: string;
+    category: ToolCategory;
+    icon?: string;
+    dependencies?: string[];
+}
+/**
+ * Tool Coordinator interface
+ * Manages tool registration, visibility, and z-index coordination
+ */
+export interface ToolCoordinator {
+    /** Bring an element to the front (highest z-index) */
+    bringToFront(element: HTMLElement): void;
+    /** Register a tool with the coordinator */
+    registerTool(id: ToolId, name: string, element?: HTMLElement): void;
+    /** Unregister a tool */
+    unregisterTool(id: ToolId): void;
+    /** Show a tool */
+    showTool(id: ToolId): void;
+    /** Hide a tool */
+    hideTool(id: ToolId): void;
+    /** Toggle a tool's visibility */
+    toggleTool(id: ToolId): void;
+    /** Update a tool's element reference */
+    updateToolElement(id: ToolId, element: HTMLElement): void;
+    /** Hide all tools */
+    hideAllTools(): void;
+    /** Get the state of a specific tool */
+    getToolState(id: ToolId): ToolState | undefined;
+    /** Check if a tool is visible */
+    isToolVisible(id: ToolId): boolean;
+}
+/**
+ * Accommodation Resolver Service
+ * Resolves final tool configuration by merging roster, student, and item configs
+ * Precedence: Roster block > Item restriction > Item requirement > Student accommodation > Roster default
+ */
+export interface AccommodationResolver {
+    /**
+     * Resolve final tools for an item given all configuration sources
+     */
+    resolveToolsForItem(student: AccommodationProfile, roster: RosterToolConfiguration, item: ItemToolConfig): ResolvedToolConfig[];
+    /**
+     * Check if a specific tool is allowed
+     */
+    isToolAllowed(toolType: string, student: AccommodationProfile, roster: RosterToolConfiguration, item: ItemToolConfig): ToolResolutionResult;
+    /**
+     * Get resolution trace for debugging
+     */
+    getResolutionTrace(toolType: string, student: AccommodationProfile, roster: RosterToolConfiguration, item: ItemToolConfig): ResolutionTrace;
+}
+/**
+ * Accommodation profile (student-level tool permissions)
+ */
+export interface AccommodationProfile {
+    studentId: string;
+    testId?: string;
+    rosterId?: string;
+    accommodations: Record<string, boolean>;
+}
+/**
+ * Resolution trace for debugging
+ */
+export interface ResolutionTrace {
+    toolType: string;
+    steps: ResolutionStep[];
+    finalDecision: ToolResolutionResult;
+}
+/**
+ * Resolution step in trace
+ */
+export interface ResolutionStep {
+    source: ConfigurationSource;
+    decision: "allow" | "block" | "require" | "skip";
+    reason: string;
+    config?: Partial<ToolConfig>;
+}
+/**
+ * Variant Resolver Service
+ * Resolves item configuration considering variants
+ */
+export interface VariantResolver {
+    /**
+     * Resolve variant configuration for an item
+     */
+    resolveVariant(itemConfig: ItemToolConfig, context: VariantContext): ResolvedItemConfig;
+}
+/**
+ * Library Loader Service
+ * Dynamically loads external libraries with retry and fallback support
+ */
+export interface LibraryLoader {
+    /**
+     * Load a JavaScript library
+     */
+    loadScript(library: LibraryConfig): Promise<void>;
+    /**
+     * Load a stylesheet
+     */
+    loadStylesheet(url: string): Promise<void>;
+    /**
+     * Check if a library is already loaded
+     */
+    isLoaded(libraryId: string): boolean;
+    /**
+     * Preload multiple libraries in parallel
+     */
+    preload(libraries: LibraryConfig[]): Promise<void>;
+    /**
+     * Unload a library (remove script tag)
+     */
+    unload(libraryId: string): void;
+    /**
+     * Get loader statistics
+     */
+    getStats(): LoaderStats;
+}
+/**
+ * PIE Response Component Interface
+ * For tool-to-response integration (e.g., calculator inserting into text field)
+ */
+export interface PIEResponseComponent {
+    readonly responseId: string;
+    readonly responseType: PIEResponseType;
+    getCapabilities(): ResponseCapabilities;
+    canAccept(content: string, format: ContentFormat): boolean;
+    insertContent(content: string, options: InsertionOptions): Promise<InsertionResult>;
+    getContent(format?: ContentFormat): string;
+    getCursorPosition(): number | null;
+    setCursorPosition(position: number): void;
+    focus(): void;
+    isFocused(): boolean;
+    validate(content: string, format: ContentFormat): ValidationResult;
+}
+/**
+ * PIE response types
+ */
+export type PIEResponseType = "text-entry" | "extended-text-entry" | "math-inline" | "math-block" | "numeric" | "multiple-choice" | "custom";
+/**
+ * Response capabilities
+ */
+export interface ResponseCapabilities {
+    acceptsPlainText?: boolean;
+    acceptsLatex?: boolean;
+    acceptsNumeric?: boolean;
+    acceptsHtml?: boolean;
+    acceptsFormattedText?: boolean;
+    supportedFormats: ContentFormat[];
+    supportsReplacement?: boolean;
+    supportsInsertion?: boolean;
+    supportsAppend?: boolean;
+    maxLength?: number;
+    allowedCharacters?: string;
+}
+/**
+ * Content formats
+ */
+export type ContentFormat = "plain-text" | "latex" | "mathml" | "numeric" | "html" | "markdown" | "formatted-text";
+/**
+ * Insertion options for response content
+ */
+export interface InsertionOptions {
+    mode: "replace" | "insert" | "append";
+    format: ContentFormat;
+    position?: number;
+    select?: boolean;
+    focus?: boolean;
+    source?: {
+        toolId: string;
+        toolType: string;
+        timestamp: number;
+    };
+}
+/**
+ * Insertion result
+ */
+export interface InsertionResult {
+    success: boolean;
+    error?: string;
+    insertedLength?: number;
+    finalCursorPosition?: number;
+}
+/**
+ * Validation result
+ */
+export interface ValidationResult {
+    valid: boolean;
+    errors?: ValidationError[];
+    warnings?: string[];
+}
+/**
+ * Validation error
+ */
+export interface ValidationError {
+    code: string;
+    message: string;
+    position?: number;
+}
+/**
+ * Response Discovery Service
+ * Finds and manages PIE response components for tool integration
+ */
+export interface ResponseDiscoveryService {
+    getActiveResponse(): PIEResponseComponent | null;
+    getResponse(responseId: string): PIEResponseComponent | null;
+    getAllResponses(): PIEResponseComponent[];
+    getResponsesAccepting(format: ContentFormat): PIEResponseComponent[];
+    registerResponse(response: PIEResponseComponent): void;
+    unregisterResponse(responseId: string): void;
+    onActiveResponseChanged(listener: (response: PIEResponseComponent | null) => void): void;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/tools/types.js

@@ -0,0 +1,13 @@
+/**
+ * Tool system type definitions
+ */
+/**
+ * Tool categories for organizational purposes
+ */
+export var ToolCategory;
+(function (ToolCategory) {
+    ToolCategory["STANDALONE"] = "standalone";
+    ToolCategory["CONTENT_INTERACTIVE"] = "content-interactive";
+    ToolCategory["SERVICE_DEPENDENT"] = "service-dependent";
+})(ToolCategory || (ToolCategory = {}));
+//# sourceMappingURL=types.js.map

package/dist/tools/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/tools/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AA0PH;;GAEG;AACH,MAAM,CAAN,IAAY,YAIX;AAJD,WAAY,YAAY;IACvB,yCAAyB,CAAA;IACzB,2DAA2C,CAAA;IAC3C,uDAAuC,CAAA;AACxC,CAAC,EAJW,YAAY,KAAZ,YAAY,QAIvB"}

package/dist/tools/variant-resolver.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Variant Resolver Service
+ * Resolves item configuration considering variants for A/B testing, scaffolding, and adaptations
+ *
+ * Based on architectural enhancements for item-level variant configuration
+ */
+import type { ItemToolConfig, ResolvedItemConfig, VariantContext, VariantResolver } from "./types";
+export declare class VariantResolverImpl implements VariantResolver {
+    /**
+     * Resolve variant configuration for an item
+     */
+    resolveVariant(itemConfig: ItemToolConfig, context: VariantContext): ResolvedItemConfig;
+    /**
+     * Resolve tool parameters considering variant and context
+     */
+    private _resolveToolParameters;
+    /**
+     * Select variant parameters based on context
+     */
+    private _selectVariantParameters;
+    /**
+     * Create tool parameters from override
+     */
+    private _createToolParametersFromOverride;
+    /**
+     * Resolve required tools considering overrides
+     */
+    private _resolveRequiredTools;
+    /**
+     * Filter adaptations based on context
+     */
+    private _filterAdaptations;
+    /**
+     * Build resolved config without variants
+     */
+    private _buildResolvedConfig;
+    /**
+     * Convert tool type to human-readable name
+     */
+    private _humanizeName;
+}
+/**
+ * Singleton instance (deprecated)
+ * @deprecated Instantiate VariantResolverImpl directly instead:
+ *   const resolver = new VariantResolverImpl();
+ */
+export declare const variantResolver: VariantResolverImpl;
+//# sourceMappingURL=variant-resolver.d.ts.map

package/dist/tools/variant-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"variant-resolver.d.ts","sourceRoot":"","sources":["../../src/tools/variant-resolver.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACX,cAAc,EAEd,kBAAkB,EAGlB,cAAc,EACd,eAAe,EACf,MAAM,SAAS,CAAC;AAEjB,qBAAa,mBAAoB,YAAW,eAAe;IAC1D;;OAEG;IACH,cAAc,CACb,UAAU,EAAE,cAAc,EAC1B,OAAO,EAAE,cAAc,GACrB,kBAAkB;IA+CrB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IA8C9B;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAsChC;;OAEG;IACH,OAAO,CAAC,iCAAiC;IAiBzC;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAmB7B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IA4B1B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAkC5B;;OAEG;IACH,OAAO,CAAC,aAAa;CAKrB;AAED;;;;GAIG;AACH,eAAO,MAAM,eAAe,qBAA4B,CAAC"}