@pie-players/pie-assessment-toolkit 0.3.63 → 0.3.65

package/dist/services/catalog-media.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Validation primitives shared by every catalog card whose payload references
+ * media.
+ *
+ * Extracted from `sign-language-cards.ts` when `spoken` cards gained a recorded
+ * audio form: both card types take authored, wire-facing URLs and hand them to a
+ * media element in the learner's browser, so both need the same scheme
+ * allow-list and the same "treat as absent, never as partially valid" posture.
+ * Two copies of a URL allow-list is one copy that gets a fix and one that does
+ * not.
+ *
+ * Part of PIE Assessment Toolkit.
+ */
+import type { MediaFragmentRange, MediaSource } from "@pie-players/pie-players-shared/types";
+export declare function isSafeMediaSrc(raw: unknown): raw is string;
+export declare function normalizeMediaSources(raw: unknown): MediaSource[];
+export declare function normalizeMediaFragment(raw: unknown): MediaFragmentRange | undefined;
+export declare function trimmedOrUndefined(value: unknown): string | undefined;
+/**
+ * Apply a fragment range to a source URL as a Media Fragments URI, so one
+ * recording can serve several content nodes. Browsers honour the start offset;
+ * the end offset is enforced by the caller, because support for the end bound is
+ * inconsistent.
+ */
+export declare function applyMediaFragment(src: string, fragment?: MediaFragmentRange): string;

package/dist/services/catalog-media.js

@@ -0,0 +1,101 @@
+/**
+ * Validation primitives shared by every catalog card whose payload references
+ * media.
+ *
+ * Extracted from `sign-language-cards.ts` when `spoken` cards gained a recorded
+ * audio form: both card types take authored, wire-facing URLs and hand them to a
+ * media element in the learner's browser, so both need the same scheme
+ * allow-list and the same "treat as absent, never as partially valid" posture.
+ * Two copies of a URL allow-list is one copy that gets a fix and one that does
+ * not.
+ *
+ * Part of PIE Assessment Toolkit.
+ */
+/**
+ * Media source URLs are handed to a media element in the learner's browser. Only
+ * schemes such an element can actually fetch are allowed; anything else is
+ * dropped so an authored `javascript:` / `file:` URL cannot ride into the DOM.
+ * Relative and protocol-relative URLs are allowed — host content is commonly
+ * served from the same origin as the player.
+ */
+const DISALLOWED_SRC_SCHEME = /^[a-z][a-z0-9+.-]*:/i;
+const ALLOWED_SRC_SCHEMES = new Set(["http:", "https:", "data:", "blob:"]);
+export function isSafeMediaSrc(raw) {
+    if (typeof raw !== "string")
+        return false;
+    const src = raw.trim();
+    if (!src)
+        return false;
+    // Relative ("/video.mp4", "video.mp4") and protocol-relative ("//cdn/x.mp4")
+    // forms carry no scheme to check and inherit the document's.
+    if (src.startsWith("//") || !DISALLOWED_SRC_SCHEME.test(src))
+        return true;
+    const scheme = src.slice(0, src.indexOf(":") + 1).toLowerCase();
+    return ALLOWED_SRC_SCHEMES.has(scheme);
+}
+export function normalizeMediaSources(raw) {
+    if (!Array.isArray(raw))
+        return [];
+    const sources = [];
+    for (const entry of raw) {
+        if (!entry || typeof entry !== "object")
+            continue;
+        const candidate = entry;
+        if (!isSafeMediaSrc(candidate.src))
+            continue;
+        const source = { src: candidate.src.trim() };
+        if (typeof candidate.type === "string" && candidate.type.trim()) {
+            source.type = candidate.type.trim();
+        }
+        if (Number.isFinite(candidate.width))
+            source.width = candidate.width;
+        if (Number.isFinite(candidate.height))
+            source.height = candidate.height;
+        // Deduplicated by `src`, because the signing region renders `<source>`
+        // elements in an `{#each}` keyed on exactly that: an authored card listing
+        // one URL twice — the same file under two MIME types is the plausible way —
+        // would otherwise throw Svelte's duplicate-key error and take the whole
+        // region down rather than degrade. The first entry wins, so authored order
+        // still decides which encoding the browser is offered first.
+        if (sources.some((existing) => existing.src === source.src))
+            continue;
+        sources.push(source);
+    }
+    return sources;
+}
+export function normalizeMediaFragment(raw) {
+    if (!raw || typeof raw !== "object")
+        return undefined;
+    const candidate = raw;
+    const start = Number(candidate.startSeconds);
+    if (!Number.isFinite(start) || start < 0)
+        return undefined;
+    const end = Number(candidate.endSeconds);
+    // An end at or before the start would produce a zero/negative slice; treat
+    // it as "no end" rather than a range that can never play.
+    if (!Number.isFinite(end) || end <= start)
+        return { startSeconds: start };
+    return { startSeconds: start, endSeconds: end };
+}
+export function trimmedOrUndefined(value) {
+    if (typeof value !== "string")
+        return undefined;
+    const trimmed = value.trim();
+    return trimmed || undefined;
+}
+/**
+ * Apply a fragment range to a source URL as a Media Fragments URI, so one
+ * recording can serve several content nodes. Browsers honour the start offset;
+ * the end offset is enforced by the caller, because support for the end bound is
+ * inconsistent.
+ */
+export function applyMediaFragment(src, fragment) {
+    if (!fragment)
+        return src;
+    // Never stack a second fragment onto a URL that already carries one — the
+    // authored value wins.
+    if (src.includes("#"))
+        return src;
+    const end = fragment.endSeconds !== undefined ? `,${fragment.endSeconds}` : "";
+    return `${src}#t=${fragment.startSeconds}${end}`;
+}

package/dist/services/createDefaultToolRegistry.d.ts

@@ -1,86 +1,53 @@
 /**
- * Default Tool Registry Factory
+ * Tool Registry Factory
  *
- * Creates a ToolRegistry pre-populated with all PIE framework tools.
- * Integrators can use this as a starting point and customize as needed.
+ * Creates an empty `ToolRegistry` and installs whatever component overrides and
+ * lazy module loaders the caller supplies.
+ *
+ * It registers nothing by itself, deliberately. Eleven concrete registrations
+ * used to live in this package, which made the policy and registry core know
+ * every capability by name and left a host unable to contribute one without a PR
+ * against this package. The packaged set now lives in the composition layer:
+ * `createPackagedToolRegistry` from `@pie-players/pie-default-tool-loaders`.
  */
+import type { ToolRegistration, ToolModuleLoader } from "./ToolRegistry.js";
 import { ToolRegistry } from "./ToolRegistry.js";
-import type { ToolRegistration } from "./ToolRegistry.js";
-import type { ToolModuleLoader } from "./ToolRegistry.js";
-import { type ToolComponentFactory, type ToolComponentFactoryMap, type ToolTagMap } from "../tools/tool-tag-map.js";
-import { DEFAULT_TOOL_PLACEMENT, PACKAGED_TOOL_PLACEMENT, SECTION_PLAYER_PREFERRED_TOOL_PLACEMENT } from "./tool-config-defaults.js";
+import type { ToolComponentFactory, ToolComponentFactoryMap, ToolTagMap } from "../tools/tool-tag-map.js";
+import { DEFAULT_TOOL_PLACEMENT } from "./tool-config-defaults.js";
 export interface DefaultToolRegistryOptions {
     /**
-     * Override default tool registrations by toolId.
-     * This is the highest-precedence extension point.
+     * Registrations to register, keyed by toolId. Nothing is registered when this
+     * is absent.
      */
-    overrides?: Partial<Record<string, ToolRegistration>>;
+    registrations?: Partial<Record<string, ToolRegistration>>;
     /**
-     * Override default component tag mapping used by built-in registrations.
+     * Element tag mapping for the registrations being installed. There is no
+     * built-in default: a tag map names capabilities, so it belongs to whoever
+     * decides which capabilities exist.
      */
     toolTagMap?: Partial<ToolTagMap>;
     /**
-     * Override component factory globally (all tools) or per tool.
+     * Override component creation globally (all tools) or per tool.
      */
     toolComponentFactory?: ToolComponentFactory;
     toolComponentFactories?: Partial<ToolComponentFactoryMap>;
     /**
      * Optional lazy module loaders keyed by toolId.
-     * Hosts can inject default loaders from an external package.
      */
     toolModuleLoaders?: Partial<Record<string, ToolModuleLoader>>;
-    /**
-     * Register packaged PIE tools by default.
-     *
-     * @default false
-     */
-    includePackagedTools?: boolean;
-    /**
-     * Restrict registration to specific packaged tool IDs.
-     * Ignored when includePackagedTools is false.
-     */
-    toolIds?: string[];
 }
 /**
  * Create a tool registry.
  *
- * By default, this creates an empty registry so hosts can explicitly opt in.
- * For convenience, pass { includePackagedTools: true } to register all packaged tools,
- * or use createPackagedToolRegistry().
- *
- * @returns ToolRegistry with all default tools
+ * @returns an empty `ToolRegistry` unless `registrations` is supplied
  */
 export declare function createDefaultToolRegistry(options?: DefaultToolRegistryOptions): ToolRegistry;
-export interface RegisterPackagedToolsOptions {
-    toolIds?: string[];
-    applyOverrides?: (registration: ToolRegistration) => ToolRegistration;
-}
 /**
- * Register packaged PIE tools onto an existing registry.
- */
-export declare function registerPackagedTools(registry: ToolRegistry, options?: RegisterPackagedToolsOptions): void;
-/**
- * Convenience factory that registers all packaged PIE tools.
- */
-export declare function createPackagedToolRegistry(options?: Omit<DefaultToolRegistryOptions, "includePackagedTools">): ToolRegistry;
-/**
- * Default tool placement configuration
+ * Placement configuration with every level empty.
  *
- * Defines which tools appear at which levels by default.
- * Integrators can override this configuration.
- *
- * Categories:
- * - Global tools: theme (assessment/section level)
- * - Context-smart: calculator, graph, periodicTable (item/element, auto-detect)
- * - Reading aids: textToSpeech, lineReader, annotationToolbar (where text exists)
- * - Interaction-specific: answerEliminator (choice questions), highlighter (text)
- * - Measurement: ruler, protractor (element level, diagram/geometry)
+ * The only placement default this package can hold: a populated one would name
+ * capabilities. `PACKAGED_TOOL_PLACEMENT` and
+ * `SECTION_PLAYER_PREFERRED_TOOL_PLACEMENT` are in
+ * `@pie-players/pie-default-tool-loaders`.
  */
 export { DEFAULT_TOOL_PLACEMENT };
-export { PACKAGED_TOOL_PLACEMENT };
-export { SECTION_PLAYER_PREFERRED_TOOL_PLACEMENT };
-/**
- * Tool priority order for rendering
- * Tools will be rendered in this order when multiple tools are visible
- */
-export declare const DEFAULT_TOOL_ORDER: readonly ["theme", "calculator", "textToSpeech", "lineReader", "annotationToolbar", "highlighter", "answerEliminator", "ruler", "protractor", "graph", "periodicTable"];

package/dist/services/createDefaultToolRegistry.js

@@ -1,125 +1,45 @@
 /**
- * Default Tool Registry Factory
+ * Tool Registry Factory
  *
- * Creates a ToolRegistry pre-populated with all PIE framework tools.
- * Integrators can use this as a starting point and customize as needed.
+ * Creates an empty `ToolRegistry` and installs whatever component overrides and
+ * lazy module loaders the caller supplies.
+ *
+ * It registers nothing by itself, deliberately. Eleven concrete registrations
+ * used to live in this package, which made the policy and registry core know
+ * every capability by name and left a host unable to contribute one without a PR
+ * against this package. The packaged set now lives in the composition layer:
+ * `createPackagedToolRegistry` from `@pie-players/pie-default-tool-loaders`.
  */
 import { ToolRegistry } from "./ToolRegistry.js";
-import { calculatorToolRegistration } from "../tools/registrations/calculator.js";
-import { ttsToolRegistration } from "../tools/registrations/tts.js";
-import { rulerToolRegistration, protractorToolRegistration, } from "../tools/registrations/measurement-tools.js";
-import { answerEliminatorToolRegistration, highlighterToolRegistration, } from "../tools/registrations/interaction-tools.js";
-import { lineReaderToolRegistration, themeToolRegistration, annotationToolbarRegistration, } from "../tools/registrations/accessibility-tools.js";
-import { graphToolRegistration, periodicTableToolRegistration, } from "../tools/registrations/subject-specific-tools.js";
-import { DEFAULT_TOOL_TAG_MAP, } from "../tools/tool-tag-map.js";
-import { DEFAULT_TOOL_PLACEMENT, PACKAGED_TOOL_PLACEMENT, SECTION_PLAYER_PREFERRED_TOOL_PLACEMENT, } from "./tool-config-defaults.js";
-const PACKAGED_TOOL_REGISTRATIONS = [
-    calculatorToolRegistration,
-    ttsToolRegistration,
-    rulerToolRegistration,
-    protractorToolRegistration,
-    answerEliminatorToolRegistration,
-    highlighterToolRegistration,
-    lineReaderToolRegistration,
-    themeToolRegistration,
-    annotationToolbarRegistration,
-    graphToolRegistration,
-    periodicTableToolRegistration,
-];
+import { DEFAULT_TOOL_PLACEMENT } from "./tool-config-defaults.js";
 /**
  * Create a tool registry.
  *
- * By default, this creates an empty registry so hosts can explicitly opt in.
- * For convenience, pass { includePackagedTools: true } to register all packaged tools,
- * or use createPackagedToolRegistry().
- *
- * @returns ToolRegistry with all default tools
+ * @returns an empty `ToolRegistry` unless `registrations` is supplied
  */
 export function createDefaultToolRegistry(options = {}) {
     const registry = new ToolRegistry();
-    const componentConfig = {
-        toolTagMap: {
-            ...DEFAULT_TOOL_TAG_MAP,
-            ...(options.toolTagMap || {}),
-        },
-        toolComponentFactory: options.toolComponentFactory,
-        toolComponentFactories: options.toolComponentFactories,
-    };
-    const applyOverrides = (registration) => options.overrides?.[registration.toolId] || registration;
-    if (options.includePackagedTools) {
-        registerPackagedTools(registry, {
-            toolIds: options.toolIds,
-            applyOverrides,
-        });
+    for (const registration of Object.values(options.registrations ?? {})) {
+        if (registration)
+            registry.register(registration);
     }
     if (options.toolModuleLoaders &&
         Object.keys(options.toolModuleLoaders).length > 0) {
         registry.setToolModuleLoaders(options.toolModuleLoaders);
     }
-    registry.setComponentOverrides(componentConfig);
-    return registry;
-}
-/**
- * Register packaged PIE tools onto an existing registry.
- */
-export function registerPackagedTools(registry, options = {}) {
-    const selectedToolIds = options.toolIds && options.toolIds.length > 0
-        ? new Set(options.toolIds)
-        : null;
-    const applyOverrides = options.applyOverrides ||
-        ((registration) => registration);
-    for (const registration of PACKAGED_TOOL_REGISTRATIONS) {
-        if (selectedToolIds && !selectedToolIds.has(registration.toolId)) {
-            continue;
-        }
-        registry.register(applyOverrides(registration));
-    }
-}
-/**
- * Convenience factory that registers all packaged PIE tools.
- */
-export function createPackagedToolRegistry(options = {}) {
-    return createDefaultToolRegistry({
-        ...options,
-        includePackagedTools: true,
+    registry.setComponentOverrides({
+        toolTagMap: options.toolTagMap,
+        toolComponentFactory: options.toolComponentFactory,
+        toolComponentFactories: options.toolComponentFactories,
     });
+    return registry;
 }
 /**
- * Default tool placement configuration
- *
- * Defines which tools appear at which levels by default.
- * Integrators can override this configuration.
+ * Placement configuration with every level empty.
  *
- * Categories:
- * - Global tools: theme (assessment/section level)
- * - Context-smart: calculator, graph, periodicTable (item/element, auto-detect)
- * - Reading aids: textToSpeech, lineReader, annotationToolbar (where text exists)
- * - Interaction-specific: answerEliminator (choice questions), highlighter (text)
- * - Measurement: ruler, protractor (element level, diagram/geometry)
+ * The only placement default this package can hold: a populated one would name
+ * capabilities. `PACKAGED_TOOL_PLACEMENT` and
+ * `SECTION_PLAYER_PREFERRED_TOOL_PLACEMENT` are in
+ * `@pie-players/pie-default-tool-loaders`.
  */
 export { DEFAULT_TOOL_PLACEMENT };
-export { PACKAGED_TOOL_PLACEMENT };
-export { SECTION_PLAYER_PREFERRED_TOOL_PLACEMENT };
-/**
- * Tool priority order for rendering
- * Tools will be rendered in this order when multiple tools are visible
- */
-export const DEFAULT_TOOL_ORDER = [
-    // Global accessibility first
-    "theme",
-    // Common tools
-    "calculator",
-    "textToSpeech",
-    // Reading aids
-    "lineReader",
-    "annotationToolbar",
-    "highlighter",
-    // Interaction tools
-    "answerEliminator",
-    // Measurement tools
-    "ruler",
-    "protractor",
-    // Subject-specific
-    "graph",
-    "periodicTable",
-];

package/dist/services/defaultPersonalNeedsProfile.d.ts

@@ -1,3 +1,21 @@
 import type { PersonalNeedsProfile } from "@pie-players/pie-players-shared/types";
-export declare const DEFAULT_PERSONAL_NEEDS_PROFILE: PersonalNeedsProfile;
-export declare function createDefaultPersonalNeedsProfile(): PersonalNeedsProfile;
+/**
+ * An empty personal-needs profile: nothing granted, nothing prohibited, nothing
+ * activated at init.
+ *
+ * The core ships no populated default on purpose. It once derived one from every
+ * registered tool's `pnpSupportIds`, which read *registry membership* as
+ * *eligibility tier* — registration means "policy-addressable", not "universal,
+ * on by default" — so an accommodation-tier capability was granted to every
+ * student of every host that supplied no profile. The remedy at the time was a
+ * compile-time list of ids to exclude, which a host could not extend for its own
+ * accommodation.
+ *
+ * Which capabilities a deployment grants by default is a property of the
+ * program, not of this package: TTS is a universal feature in one program and a
+ * documented accommodation in another. That belongs in policy configuration
+ * alongside the district and test-administration levels. A named preset of
+ * today's universal set ships as data from
+ * `@pie-players/pie-default-tool-loaders`, for hosts that want it.
+ */
+export declare function createEmptyPersonalNeedsProfile(): PersonalNeedsProfile;

package/dist/services/defaultPersonalNeedsProfile.js

@@ -1,23 +1,25 @@
-import { createPackagedToolRegistry } from "./createDefaultToolRegistry.js";
-function computeDefaultSupports() {
-    const registry = createPackagedToolRegistry();
-    const supports = new Set();
-    for (const tool of registry.getAllTools()) {
-        for (const supportId of tool.pnpSupportIds || []) {
-            supports.add(supportId);
-        }
-    }
-    return [...supports].sort();
-}
-const DEFAULT_SUPPORTS = computeDefaultSupports();
-export const DEFAULT_PERSONAL_NEEDS_PROFILE = {
-    supports: [...DEFAULT_SUPPORTS],
-    prohibitedSupports: [],
-    activateAtInit: [],
-};
-export function createDefaultPersonalNeedsProfile() {
+/**
+ * An empty personal-needs profile: nothing granted, nothing prohibited, nothing
+ * activated at init.
+ *
+ * The core ships no populated default on purpose. It once derived one from every
+ * registered tool's `pnpSupportIds`, which read *registry membership* as
+ * *eligibility tier* — registration means "policy-addressable", not "universal,
+ * on by default" — so an accommodation-tier capability was granted to every
+ * student of every host that supplied no profile. The remedy at the time was a
+ * compile-time list of ids to exclude, which a host could not extend for its own
+ * accommodation.
+ *
+ * Which capabilities a deployment grants by default is a property of the
+ * program, not of this package: TTS is a universal feature in one program and a
+ * documented accommodation in another. That belongs in policy configuration
+ * alongside the district and test-administration levels. A named preset of
+ * today's universal set ships as data from
+ * `@pie-players/pie-default-tool-loaders`, for hosts that want it.
+ */
+export function createEmptyPersonalNeedsProfile() {
     return {
-        supports: [...DEFAULT_SUPPORTS],
+        supports: [],
         prohibitedSupports: [],
         activateAtInit: [],
     };

package/dist/services/interfaces.d.ts

@@ -8,7 +8,7 @@
  * Part of PIE Assessment Toolkit.
  */
 import type { I18nServiceApi } from "@pie-players/pie-players-shared/i18n";
-import type { AccessibilityCatalogResolver, CatalogLookupContext, CatalogLookupOptions, CatalogOwnerContext, CatalogStatistics, CatalogType, ResolvedCatalog } from "./AccessibilityCatalogResolver.js";
+import type { AccessibilityCatalogResolver, CatalogChangeListener, CatalogLookupContext, CatalogLookupOptions, CatalogOwnerContext, CatalogStatistics, CatalogType, ResolvedCatalog } from "./AccessibilityCatalogResolver.js";
 import type { FrameworkErrorListener } from "./framework-error-bus.js";
 import type { HighlightColor, HighlightType } from "./HighlightCoordinator.js";
 import type { SectionControllerHandle, SectionItemEventSubscriptionArgs, SectionScopedEventSubscriptionArgs, SectionEventSubscriptionArgs, ToolkitCoordinatorHooks, ToolkitInitStatus } from "./ToolkitCoordinator.js";
@@ -18,7 +18,7 @@ import type { PlaybackState, TTSConfig } from "./TTSService.js";
 import type { TTSHighlightTargetResolverProvider } from "./tts/highlight-target-resolver.js";
 import type { ToolPlacementConfig, ToolPlacementLevel, ToolProviderConfig } from "./tools-config-normalizer.js";
 import type { ToolProviderRegistry } from "./tool-providers/ToolProviderRegistry.js";
-import type { PolicySource, PnpEnforcementMode, ResolvedEngineInputs, ToolPolicyChangeListener, ToolPolicyDecision, ToolPolicyDecisionRequest } from "../policy/engine.js";
+import type { FeaturePolicyDecision, PolicySource, PnpEnforcementMode, ResolvedEngineInputs, ToolPolicyChangeListener, ToolPolicyDecision, ToolPolicyDecisionRequest } from "../policy/engine.js";
 import type { AssessmentEntity, AssessmentItemRef } from "@pie-players/pie-players-shared/types";
 import type { ITTSProvider, TTSProviderCapabilities } from "@pie-players/pie-tts";
 import type { ResolvedToolContext, ToolContextResolver, ToolContextResolverContext, ToolContextResolverMap } from "./ToolRegistry.js";
@@ -593,6 +593,16 @@ export interface ToolkitCoordinatorApi {
      * `decision.visibleTools` themselves.
      */
     decideToolPolicy(request: ToolPolicyDecisionRequest): ToolPolicyDecision;
+    /**
+     * Resolve eligibility for one PNP/AfA feature id through the six-level
+     * precedence, independent of toolbar placement — for capabilities that
+     * render as their own surface rather than a toolbar button (a signed
+     * alternate's region, for example).
+     *
+     * Optional so host-supplied coordinator stubs predating this method stay
+     * assignable; call sites must feature-detect.
+     */
+    decideFeaturePolicy?(featureId: string): FeaturePolicyDecision;
     /**
      * Subscribe to policy-engine change events. Fires whenever the
      * coordinator's bound policy inputs change (`updateToolConfig`,
@@ -602,6 +612,23 @@ export interface ToolkitCoordinatorApi {
      * call `decideToolPolicy(...)` with their level / scope.
      */
     onPolicyChange(listener: ToolPolicyChangeListener): () => void;
+    /**
+     * Subscribe to accessibility-catalog registrations and removals.
+     *
+     * The companion to {@link onPolicyChange} for the other mutable input a
+     * capability's visibility depends on. A region that renders a catalog card
+     * needs both: policy decides whether the learner may have it, catalogs decide
+     * whether the content exists, and catalogs arrive on an item shell's mount
+     * event — after a card alongside that item has already computed its first
+     * answer. Listeners re-query through
+     * {@link accessibilityCatalogResolver}; the event names only what changed.
+     *
+     * Required, unlike {@link decideFeaturePolicy}: this ships with its only
+     * consumer, so there are no pre-existing stubs to stay assignable to, and
+     * `AGENTS.md` rules out adding an internal-API compatibility shim without a
+     * documented exception.
+     */
+    onCatalogsChange(listener: CatalogChangeListener): () => void;
     /**
      * Bind (or clear) the active assessment for PNP/profile policy decisions.
      *

package/dist/services/pnp-standard-features.d.ts

@@ -167,7 +167,7 @@ export declare const QTI_STANDARD_ACCESS_FEATURES: {
 /**
  * Flat list of all standard access features for validation
  */
-export declare const ALL_STANDARD_ACCESS_FEATURES: ("braille" | "textToSpeech" | "graph" | "periodicTable" | "calculator" | "answerEliminator" | "ruler" | "protractor" | "graphingCalculator" | "readAloud" | "strikethrough" | "answerMasking" | "readingMask" | "readingGuide" | "readingRuler" | "highContrastDisplay" | "colorContrast" | "invertColors" | "highlighting" | "annotations" | "magnification" | "screenMagnifier" | "zoomable" | "highContrastAudio" | "displayTransformability" | "largePrint" | "fontEnlargement" | "resizeText" | "alternativeText" | "longDescription" | "describedMath" | "tactileGraphic" | "tactileObject" | "audioDescription" | "humanVoice" | "syntheticVoice" | "speechRate" | "speechVolume" | "voicePitch" | "captions" | "closedCaptions" | "openCaptions" | "transcript" | "signLanguage" | "subtitles" | "audioControl" | "noBackgroundAudio" | "keyboardControl" | "mouseControl" | "touchControl" | "voiceControl" | "switchControl" | "eyeGazeControl" | "singleSwitchAccess" | "stickyKeys" | "keyboardShortcuts" | "timingControl" | "unlimitedTime" | "extendedTime" | "pauseControl" | "simplifiedLanguage" | "reducedComplexity" | "structuralNavigation" | "tableOfContents" | "reducedDistraction" | "noFlashing" | "pauseAnimation" | "bookmarking" | "guidedNavigation" | "thesaurus" | "spellingAssistance" | "grammarAssistance" | "lineSpacing" | "wordSpacing" | "letterSpacing" | "fontFamily" | "wordHighlighting" | "lineHighlighting" | "focusIndicator" | "printableResource" | "nemeth" | "refreshableBraille" | "index" | "pageNavigation" | "skipContent" | "breadcrumbs" | "searchable" | "fullTextSearch" | "multilingualText" | "translatedText" | "glossary" | "signLanguageInterpretation" | "visualLanguage" | "formulaSheet" | "itemGlossary" | "tutorialAvailable")[];
+export declare const ALL_STANDARD_ACCESS_FEATURES: ("transcript" | "braille" | "textToSpeech" | "calculator" | "strikethrough" | "answerEliminator" | "magnification" | "screenMagnifier" | "zoomable" | "highContrastDisplay" | "highContrastAudio" | "colorContrast" | "invertColors" | "displayTransformability" | "largePrint" | "fontEnlargement" | "resizeText" | "alternativeText" | "longDescription" | "describedMath" | "tactileGraphic" | "tactileObject" | "audioDescription" | "readAloud" | "humanVoice" | "syntheticVoice" | "speechRate" | "speechVolume" | "voicePitch" | "captions" | "closedCaptions" | "openCaptions" | "signLanguage" | "subtitles" | "audioControl" | "noBackgroundAudio" | "keyboardControl" | "mouseControl" | "touchControl" | "voiceControl" | "switchControl" | "eyeGazeControl" | "singleSwitchAccess" | "stickyKeys" | "keyboardShortcuts" | "timingControl" | "unlimitedTime" | "extendedTime" | "pauseControl" | "simplifiedLanguage" | "reducedComplexity" | "structuralNavigation" | "tableOfContents" | "reducedDistraction" | "noFlashing" | "pauseAnimation" | "annotations" | "bookmarking" | "highlighting" | "guidedNavigation" | "thesaurus" | "spellingAssistance" | "grammarAssistance" | "lineSpacing" | "wordSpacing" | "letterSpacing" | "fontFamily" | "readingMask" | "readingGuide" | "readingRuler" | "wordHighlighting" | "lineHighlighting" | "focusIndicator" | "printableResource" | "nemeth" | "refreshableBraille" | "index" | "pageNavigation" | "skipContent" | "breadcrumbs" | "searchable" | "fullTextSearch" | "multilingualText" | "translatedText" | "glossary" | "signLanguageInterpretation" | "visualLanguage" | "protractor" | "ruler" | "graph" | "graphingCalculator" | "periodicTable" | "formulaSheet" | "answerMasking" | "itemGlossary" | "tutorialAvailable")[];
 /**
  * Example PNP configurations for common accessibility needs
  * These are NOT official profiles but illustrative examples showing

package/dist/services/spoken-audio-cards.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Recorded audio as a `spoken` catalog card.
+ *
+ * QTI 3 treats a recording and synthesized speech as the *same* support — both
+ * are `spoken`, and a card carries recorded audio through `qti-file-href` plus a
+ * MIME type — so this is not a new accommodation but the other form the existing
+ * one can take. Some programs prefer a human voice to synthesis; PIE's `spoken`
+ * card was string-only, so it had no way to say "play this file for this node".
+ *
+ * A node commonly carries both forms in the same language: the reading script
+ * *and* a recording of it. That is APIP's pattern and what QTI's migration
+ * guidance preserves, because the script is both the source the audio was
+ * generated from and the fallback for when the audio will not play. Resolution
+ * chooses between them with `CatalogLookupOptions.form`; playback treats the
+ * script as the recording's fallback.
+ *
+ * Validation posture matches sign-language cards: "treat as absent, never as
+ * partially valid". A malformed payload must not produce a silent player that
+ * looks like read-aloud is working.
+ *
+ * Part of PIE Assessment Toolkit.
+ */
+import type { CatalogCardPayload, MediaFragmentRange, MediaSource } from "@pie-players/pie-players-shared/types";
+/** Catalog type token for spoken alternates. Matches QTI 3's `support` value. */
+export declare const SPOKEN_CATALOG_TYPE = "spoken";
+/** A validated recorded spoken alternate, flattened for playback. */
+export interface SpokenAudioMedia {
+    /**
+     * Authored order preserved. Playback uses the first entry: an `<audio>` element
+     * fed alternative `<source>` children reports failure through a path that is
+     * awkward to observe reliably, and a dependable fallback to the reading script
+     * is worth more than encoding negotiation. Extra entries are kept so a future
+     * consumer can negotiate without re-reading the card.
+     */
+    sources: MediaSource[];
+    fragment?: MediaFragmentRange;
+    label?: string;
+}
+type SpokenAudioCardLike = {
+    language?: string;
+    content?: string;
+    payload?: CatalogCardPayload;
+};
+/**
+ * Validate a `spoken` card's payload into something playable, or `null`.
+ *
+ * Silent when the card simply is not a recording — a card carrying `content` is
+ * a reading script, which is the overwhelmingly common case and not a fault.
+ * Loud when a card looks like it meant to be a recording and cannot be played,
+ * because that failure is otherwise invisible to everyone but the learner who
+ * needed it.
+ */
+export declare function resolveSpokenAudioMedia(card: SpokenAudioCardLike | null | undefined): SpokenAudioMedia | null;
+export {};