@pie-players/pie-assessment-toolkit 0.3.74 → 0.3.75

package/dist/services/pnp-standard-features.js

@@ -1,338 +0,0 @@
-/**
- * QTI 3.0 / IMS Access for All (AfA) 3.0 Standard Access Features
- *
- * This file contains standardized accessibility feature identifiers from:
- * - IMS Global Access for All (AfA) 3.0 specification
- * - QTI 3.0 Personal Needs and Preferences (PNP)
- * - Schema.org accessibility features vocabulary
- * - WCAG 2.x accessibility guidelines
- *
- * These are the officially recognized values for QTI 3.0's accessibilityInfo.accessFeature
- * and can be used as a reference for PNP profile configuration and tool mapping.
- *
- * References:
- * - IMS AfA 3.0: https://www.imsglobal.org/spec/afa/v3p0
- * - QTI 3.0: https://www.imsglobal.org/spec/qti/v3p0
- * - Schema.org: https://schema.org/accessibilityFeature
- */
-/**
- * Standard QTI 3.0 accessibility features organized by category
- */
-export const QTI_STANDARD_ACCESS_FEATURES = {
-    /**
-     * Visual accessibility features
-     * For students with low vision, color blindness, or visual processing needs
-     */
-    visual: {
-        // Magnification and zoom
-        magnification: "magnification",
-        screenMagnifier: "screenMagnifier",
-        zoomable: "zoomable",
-        // Color and contrast
-        highContrastDisplay: "highContrastDisplay",
-        highContrastAudio: "highContrastAudio",
-        colorContrast: "colorContrast",
-        invertColors: "invertColors",
-        // Display customization
-        displayTransformability: "displayTransformability",
-        largePrint: "largePrint",
-        fontEnlargement: "fontEnlargement",
-        resizeText: "resizeText",
-        // Visual alternatives
-        alternativeText: "alternativeText",
-        longDescription: "longDescription",
-        describedMath: "describedMath",
-        tactileGraphic: "tactileGraphic",
-        tactileObject: "tactileObject",
-    },
-    /**
-     * Auditory accessibility features
-     * For students who are deaf, hard of hearing, or benefit from audio
-     */
-    auditory: {
-        // Audio output
-        audioDescription: "audioDescription",
-        textToSpeech: "textToSpeech",
-        readAloud: "readAloud",
-        humanVoice: "humanVoice",
-        syntheticVoice: "syntheticVoice",
-        // Speech control
-        speechRate: "speechRate",
-        speechVolume: "speechVolume",
-        voicePitch: "voicePitch",
-        // Visual alternatives for audio
-        captions: "captions",
-        closedCaptions: "closedCaptions",
-        openCaptions: "openCaptions",
-        transcript: "transcript",
-        signLanguage: "signLanguage",
-        subtitles: "subtitles",
-        // Audio adjustments
-        audioControl: "audioControl",
-        noBackgroundAudio: "noBackgroundAudio",
-    },
-    /**
-     * Motor/physical accessibility features
-     * For students with limited mobility or motor control
-     */
-    motor: {
-        // Input alternatives
-        keyboardControl: "keyboardControl",
-        mouseControl: "mouseControl",
-        touchControl: "touchControl",
-        voiceControl: "voiceControl",
-        switchControl: "switchControl",
-        eyeGazeControl: "eyeGazeControl",
-        // Keyboard features
-        singleSwitchAccess: "singleSwitchAccess",
-        stickyKeys: "stickyKeys",
-        keyboardShortcuts: "keyboardShortcuts",
-        // Timing
-        timingControl: "timingControl",
-        unlimitedTime: "unlimitedTime",
-        extendedTime: "extendedTime",
-        pauseControl: "pauseControl",
-    },
-    /**
-     * Cognitive/learning accessibility features
-     * For students with learning disabilities, ADHD, autism, etc.
-     */
-    cognitive: {
-        // Content simplification
-        simplifiedLanguage: "simplifiedLanguage",
-        reducedComplexity: "reducedComplexity",
-        structuralNavigation: "structuralNavigation",
-        tableOfContents: "tableOfContents",
-        // Focus and attention
-        reducedDistraction: "reducedDistraction",
-        noFlashing: "noFlashing",
-        pauseAnimation: "pauseAnimation",
-        // Organization and support
-        annotations: "annotations",
-        bookmarking: "bookmarking",
-        highlighting: "highlighting",
-        guidedNavigation: "guidedNavigation",
-        // Tools
-        calculator: "calculator",
-        thesaurus: "thesaurus",
-        spellingAssistance: "spellingAssistance",
-        grammarAssistance: "grammarAssistance",
-    },
-    /**
-     * Reading support features
-     * For students with dyslexia or reading challenges
-     */
-    reading: {
-        // Text presentation
-        lineSpacing: "lineSpacing",
-        wordSpacing: "wordSpacing",
-        letterSpacing: "letterSpacing",
-        fontFamily: "fontFamily",
-        readingMask: "readingMask",
-        readingGuide: "readingGuide",
-        readingRuler: "readingRuler",
-        // Highlighting and emphasis
-        wordHighlighting: "wordHighlighting",
-        lineHighlighting: "lineHighlighting",
-        focusIndicator: "focusIndicator",
-        // Content support
-        printableResource: "printableResource",
-        braille: "braille",
-        nemeth: "nemeth",
-        refreshableBraille: "refreshableBraille",
-    },
-    /**
-     * Navigation features
-     * For efficient content navigation
-     */
-    navigation: {
-        // Structure
-        index: "index",
-        pageNavigation: "pageNavigation",
-        skipContent: "skipContent",
-        breadcrumbs: "breadcrumbs",
-        // Search
-        searchable: "searchable",
-        fullTextSearch: "fullTextSearch",
-    },
-    /**
-     * Linguistic features
-     * For language support
-     */
-    linguistic: {
-        // Languages
-        multilingualText: "multilingualText",
-        translatedText: "translatedText",
-        glossary: "glossary",
-        // Sign language
-        signLanguageInterpretation: "signLanguageInterpretation",
-        visualLanguage: "visualLanguage",
-    },
-    /**
-     * Assessment-specific features
-     * Features specific to test-taking environments
-     */
-    assessment: {
-        // Tools
-        protractor: "protractor",
-        ruler: "ruler",
-        graph: "graph",
-        graphingCalculator: "graphingCalculator",
-        periodicTable: "periodicTable",
-        formulaSheet: "formulaSheet",
-        // Answer support
-        answerMasking: "answerMasking",
-        answerEliminator: "answerEliminator",
-        strikethrough: "strikethrough",
-        // Item features
-        itemGlossary: "itemGlossary",
-        tutorialAvailable: "tutorialAvailable",
-    },
-};
-/**
- * Flat list of all standard access features for validation
- */
-export const ALL_STANDARD_ACCESS_FEATURES = Object.values(QTI_STANDARD_ACCESS_FEATURES).flatMap((category) => Object.values(category));
-/**
- * Example PNP configurations for common accessibility needs
- * These are NOT official profiles but illustrative examples showing
- * how standard features can be combined for different student needs.
- */
-export const EXAMPLE_PNP_CONFIGURATIONS = {
-    /**
-     * Example: Student with low vision
-     */
-    lowVision: {
-        label: "Example: Low Vision Support",
-        features: [
-            "magnification",
-            "screenMagnifier",
-            "highContrastDisplay",
-            "colorContrast",
-            "fontEnlargement",
-            "textToSpeech",
-            "alternativeText",
-            "describedMath",
-        ],
-    },
-    /**
-     * Example: Student who is blind
-     */
-    blind: {
-        label: "Example: Blind Student Support",
-        features: [
-            "textToSpeech",
-            "screenReader",
-            "alternativeText",
-            "longDescription",
-            "describedMath",
-            "braille",
-            "refreshableBraille",
-            "keyboardControl",
-            "structuralNavigation",
-        ],
-    },
-    /**
-     * Example: Student who is deaf or hard of hearing
-     */
-    deafHardOfHearing: {
-        label: "Example: Deaf/Hard of Hearing Support",
-        features: [
-            "captions",
-            "closedCaptions",
-            "signLanguage",
-            "transcript",
-            "visualLanguage",
-            "noBackgroundAudio",
-        ],
-    },
-    /**
-     * Example: Student with dyslexia
-     */
-    dyslexia: {
-        label: "Example: Dyslexia Support",
-        features: [
-            "textToSpeech",
-            "readAloud",
-            "highlighting",
-            "wordHighlighting",
-            "lineHighlighting",
-            "readingMask",
-            "readingGuide",
-            "fontFamily",
-            "lineSpacing",
-            "wordSpacing",
-            "simplifiedLanguage",
-        ],
-    },
-    /**
-     * Example: Student with ADHD
-     */
-    adhd: {
-        label: "Example: ADHD Support",
-        features: [
-            "reducedDistraction",
-            "noFlashing",
-            "pauseAnimation",
-            "timingControl",
-            "extendedTime",
-            "highlighting",
-            "annotations",
-            "guidedNavigation",
-            "structuralNavigation",
-        ],
-    },
-    /**
-     * Example: Student with motor limitations
-     */
-    motorLimitations: {
-        label: "Example: Motor Limitations Support",
-        features: [
-            "keyboardControl",
-            "stickyKeys",
-            "keyboardShortcuts",
-            "voiceControl",
-            "switchControl",
-            "timingControl",
-            "extendedTime",
-            "unlimitedTime",
-        ],
-    },
-    /**
-     * Example: English language learner
-     */
-    englishLearner: {
-        label: "Example: English Language Learner Support",
-        features: [
-            "textToSpeech",
-            "translatedText",
-            "glossary",
-            "simplifiedLanguage",
-            "readAloud",
-            "highlighting",
-        ],
-    },
-};
-/**
- * Helper to validate if a feature ID is a standard QTI 3.0 feature
- */
-export function isStandardAccessFeature(featureId) {
-    return ALL_STANDARD_ACCESS_FEATURES.includes(featureId);
-}
-/**
- * Helper to get category for a feature
- */
-export function getFeatureCategory(featureId) {
-    for (const [category, features] of Object.entries(QTI_STANDARD_ACCESS_FEATURES)) {
-        if (Object.values(features).includes(featureId)) {
-            return category;
-        }
-    }
-    return null;
-}
-/**
- * Helper to get all features in a category
- */
-export function getFeaturesInCategory(category) {
-    return Object.values(QTI_STANDARD_ACCESS_FEATURES[category]);
-}

package/dist/tools/client.d.ts

@@ -1,10 +0,0 @@
-/**
- * Client-only tool system exports
- *
- * This entry point exports only browser-safe code for use in custom elements.
- *
- * Tools should import from '@pie-players/pie-assessment-toolkit/tools/client' instead of
- * '@pie-players/pie-assessment-toolkit' to ensure
- * they don't accidentally pull in server-side dependencies.
- */
-export type { CalculationHistoryEntry, Calculator, CalculatorProvider, CalculatorProviderCapabilities, CalculatorProviderConfig, CalculatorState, CalculatorType, } from "@pie-players/pie-calculator";

package/dist/tools/client.js

@@ -1,10 +0,0 @@
-/**
- * Client-only tool system exports
- *
- * This entry point exports only browser-safe code for use in custom elements.
- *
- * Tools should import from '@pie-players/pie-assessment-toolkit/tools/client' instead of
- * '@pie-players/pie-assessment-toolkit' to ensure
- * they don't accidentally pull in server-side dependencies.
- */
-export {};

package/dist/tools/internal.d.ts

@@ -1,44 +0,0 @@
-/**
- * Registration-authoring surface.
- *
- * What a package outside this one needs to write a `ToolRegistration`: the
- * registration types, the context predicates a tool answers `isVisibleInContext`
- * with, scoped-id and element-creation helpers, the toolbar button/overlay
- * helpers, the provider contract a registration's descriptor creates, and the
- * TTS provider.
- *
- * A separate entry point rather than additions to `.` for the same reason
- * `runtime/internal` and `policy/internal` exist: this is a surface for sibling
- * packages in this repo, not a contract offered to hosts. Widening `.` with two
- * dozen registration-authoring helpers would make every one of them something a
- * host could reasonably expect us to keep.
- *
- * It exists because the packaged registrations moved out to the composition layer
- * (`@pie-players/pie-default-tool-loaders`) so core stops naming capabilities.
- * A host writing its own capability package imports from here too, which is the
- * point — the mechanism is the same one our own registrations use.
- */
-export type { HostedToolContext, HostedToolSize, ResolvedToolContext, ToolActivation, ToolContentDependency, ToolContentDependencyContext, ToolModuleLoader, ToolProviderDescriptor, ToolRegistration, ToolRenderElement, ToolSingletonScope, ToolSurfaceRenderContext, ToolSurfaceRenderResult, ToolSurfaceServices, ToolToolbarButtonDefinition, ToolToolbarRenderResult, ToolWindowShellConfig, ToolbarContext, } from "../services/ToolRegistry.js";
-export { resolveToolProviderId, ToolRegistry, } from "../services/ToolRegistry.js";
-export { resolveToolRegistrationName } from "../services/ToolRegistry.js";
-export type { CatalogOwnerCard, CatalogOwnerSnapshot, } from "../services/AccessibilityCatalogResolver.js";
-export type { ToolSelectionAction, ToolSelectionContext, } from "../services/selection-action.js";
-export type { ToolOpenRequest, ToolRequestTarget, } from "../services/tool-request.js";
-export { resolveFallbackToolIcon, TOOL_FALLBACK_ICONS, } from "../services/tool-icons.js";
-export type { ContentCapabilityPhase, ContentCapabilityPolicy, ResolveContentCapabilitiesArgs, ResolvedContentCapability, } from "./content-capability-resolution.js";
-export { resolveContentCapabilities } from "./content-capability-resolution.js";
-export type { ToolSurfaceHost, ToolSurfaceHostInput, ToolSurfaceHostOptions, ToolSurfaceHostSnapshot, ToolSurfaceScope, } from "./tool-surface-host.js";
-export { createToolSurfaceHost } from "./tool-surface-host.js";
-export type { ToolContext, ToolLevel } from "../services/tool-context.js";
-export { hasChoiceInteraction, hasMathContent, hasReadableText, hasScienceContent, } from "../services/tool-context.js";
-export { createScopedToolId } from "../services/tool-instance-id.js";
-export type { ToolComponentFactory, ToolComponentFactoryMap, ToolComponentOverrides, ToolTagMap, } from "./tool-tag-map.js";
-export { createToolElement, resolveToolTag, toToolIdFromTag, } from "./tool-tag-map.js";
-export { applyOverlaySurface, createScopedVisibilityBinding, syncButtonAndOverlayVisibility, } from "./registrations/toolbar-registration-helpers.js";
-export type { ElementToolStateStoreApi, ToolCoordinatorApi, ToolkitCoordinatorApi, TtsServiceApi, } from "../services/interfaces.js";
-export type { CalculatorToolProviderConfig, ToolPlacementConfig, ToolProviderConfig, } from "../services/tools-config-normalizer.js";
-export type { ToolConfigDiagnostic } from "../services/tool-config-validation.js";
-export type { ToolProviderApi, ToolProviderCapabilities, } from "../services/tool-providers/ToolProviderApi.js";
-export { TTSToolProvider } from "../services/tool-providers/index.js";
-export type { NormalizedTTSSpeedOption } from "../services/tts-runtime-config.js";
-export { buildRuntimeTTSConfig, normalizeTTSLayoutMode, normalizeTTSSpeedControlOptions, resolveRuntimeProvider, resolveTTSBackend, resolveTTSHostToolbarLayout, resolveTTSLayoutMode, resolveTTSRuntimeSettings, resolveTransportMode, } from "../services/tts-runtime-config.js";

package/dist/tools/internal.js

@@ -1,39 +0,0 @@
-/**
- * Registration-authoring surface.
- *
- * What a package outside this one needs to write a `ToolRegistration`: the
- * registration types, the context predicates a tool answers `isVisibleInContext`
- * with, scoped-id and element-creation helpers, the toolbar button/overlay
- * helpers, the provider contract a registration's descriptor creates, and the
- * TTS provider.
- *
- * A separate entry point rather than additions to `.` for the same reason
- * `runtime/internal` and `policy/internal` exist: this is a surface for sibling
- * packages in this repo, not a contract offered to hosts. Widening `.` with two
- * dozen registration-authoring helpers would make every one of them something a
- * host could reasonably expect us to keep.
- *
- * It exists because the packaged registrations moved out to the composition layer
- * (`@pie-players/pie-default-tool-loaders`) so core stops naming capabilities.
- * A host writing its own capability package imports from here too, which is the
- * point — the mechanism is the same one our own registrations use.
- */
-export { resolveToolProviderId, ToolRegistry, } from "../services/ToolRegistry.js";
-// A registration's own display name in the interface locale. A tool window's
-// title is the registration's name, so the shell needs the same `nameKey`-then-
-// `name` precedence the toolbar uses rather than the raw English field.
-export { resolveToolRegistrationName } from "../services/ToolRegistry.js";
-// So a gateway button and the toolbar button for the same tool draw one icon.
-export { resolveFallbackToolIcon, TOOL_FALLBACK_ICONS, } from "../services/tool-icons.js";
-export { resolveContentCapabilities } from "./content-capability-resolution.js";
-export { createToolSurfaceHost } from "./tool-surface-host.js";
-export { hasChoiceInteraction, hasMathContent, hasReadableText, hasScienceContent, } from "../services/tool-context.js";
-// Scoped tool instance ids, so two placements of one tool do not share state.
-export { createScopedToolId } from "../services/tool-instance-id.js";
-export { createToolElement, resolveToolTag, toToolIdFromTag, } from "./tool-tag-map.js";
-// Toolbar button/overlay wiring shared by every toolbar-toggle registration.
-export { applyOverlaySurface, createScopedVisibilityBinding, syncButtonAndOverlayVisibility, } from "./registrations/toolbar-registration-helpers.js";
-// The TTS provider stays here because it is written against the `pie-tts`
-// contract package, which the toolkit's own `TTSService` also depends on.
-export { TTSToolProvider } from "../services/tool-providers/index.js";
-export { buildRuntimeTTSConfig, normalizeTTSLayoutMode, normalizeTTSSpeedControlOptions, resolveRuntimeProvider, resolveTTSBackend, resolveTTSHostToolbarLayout, resolveTTSLayoutMode, resolveTTSRuntimeSettings, resolveTransportMode, } from "../services/tts-runtime-config.js";