@pie-players/pie-assessment-toolkit 0.2.5 → 0.2.9

package/dist/context/assessment-toolkit-context.d.ts

@@ -0,0 +1,52 @@
+import type { IAccessibilityCatalogResolver, IElementToolStateStore, IHighlightCoordinator, IToolCoordinator, IToolkitCoordinator, ITTSService } from "../services/interfaces.js";
+export type ItemPlayerType = "iife" | "esm" | "fixed" | "custom";
+export interface ItemPlayerConfig {
+    type: ItemPlayerType;
+    tagName: string;
+    version?: string;
+    source?: string;
+    isDefault: boolean;
+}
+export interface AssessmentToolkitRuntimeContext {
+    toolkitCoordinator: IToolkitCoordinator;
+    toolCoordinator: IToolCoordinator;
+    ttsService: ITTSService;
+    highlightCoordinator: IHighlightCoordinator;
+    catalogResolver: IAccessibilityCatalogResolver;
+    elementToolStateStore: IElementToolStateStore;
+    assessmentId: string;
+    sectionId: string;
+    itemPlayer: ItemPlayerConfig;
+    reportSessionChanged?: (itemId: string, detail: unknown) => void;
+}
+export declare const assessmentToolkitRuntimeContext: {
+    __context__: AssessmentToolkitRuntimeContext;
+};
+export interface AssessmentToolkitHostRuntimeContext {
+    runtimeId: string;
+    coordinator: IToolkitCoordinator;
+}
+export declare const assessmentToolkitHostRuntimeContext: {
+    __context__: AssessmentToolkitHostRuntimeContext;
+};
+export type ShellContextKind = "item" | "passage";
+export interface AssessmentToolkitShellContext {
+    kind: ShellContextKind;
+    itemId: string;
+    canonicalItemId: string;
+    contentKind: string;
+    regionPolicy: string;
+    scopeElement: HTMLElement | null;
+    item: unknown;
+    contextVersion: number;
+}
+export declare const assessmentToolkitShellContext: {
+    __context__: AssessmentToolkitShellContext;
+};
+export interface AssessmentToolkitRegionScopeContext {
+    scopeElement: HTMLElement | null;
+}
+export declare const assessmentToolkitRegionScopeContext: {
+    __context__: AssessmentToolkitRegionScopeContext;
+};
+//# sourceMappingURL=assessment-toolkit-context.d.ts.map

package/dist/context/assessment-toolkit-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assessment-toolkit-context.d.ts","sourceRoot":"","sources":["../../src/context/assessment-toolkit-context.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACX,6BAA6B,EAC7B,sBAAsB,EACtB,qBAAqB,EACrB,gBAAgB,EAChB,mBAAmB,EACnB,WAAW,EACX,MAAM,2BAA2B,CAAC;AAEnC,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAC;AAEjE,MAAM,WAAW,gBAAgB;IAChC,IAAI,EAAE,cAAc,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,+BAA+B;IAC/C,kBAAkB,EAAE,mBAAmB,CAAC;IACxC,eAAe,EAAE,gBAAgB,CAAC;IAClC,UAAU,EAAE,WAAW,CAAC;IACxB,oBAAoB,EAAE,qBAAqB,CAAC;IAC5C,eAAe,EAAE,6BAA6B,CAAC;IAC/C,qBAAqB,EAAE,sBAAsB,CAAC;IAC9C,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,gBAAgB,CAAC;IAC7B,oBAAoB,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;CACjE;AAED,eAAO,MAAM,+BAA+B;;CAG1C,CAAC;AAEH,MAAM,WAAW,mCAAmC;IACnD,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,mBAAmB,CAAC;CACjC;AAED,eAAO,MAAM,mCAAmC;;CAG9C,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,SAAS,CAAC;AAElD,MAAM,WAAW,6BAA6B;IAC7C,IAAI,EAAE,gBAAgB,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,WAAW,GAAG,IAAI,CAAC;IACjC,IAAI,EAAE,OAAO,CAAC;IACd,cAAc,EAAE,MAAM,CAAC;CACvB;AAED,eAAO,MAAM,6BAA6B;;CAGxC,CAAC;AAEH,MAAM,WAAW,mCAAmC;IACnD,YAAY,EAAE,WAAW,GAAG,IAAI,CAAC;CACjC;AAED,eAAO,MAAM,mCAAmC;;CAG9C,CAAC"}

package/dist/context/assessment-toolkit-context.js

@@ -0,0 +1,6 @@
+import { createContext } from "@pie-players/pie-context";
+export const assessmentToolkitRuntimeContext = createContext(Symbol.for("pie.assessmentToolkit.runtimeContext"));
+export const assessmentToolkitHostRuntimeContext = createContext(Symbol.for("pie.assessmentToolkit.hostRuntimeContext"));
+export const assessmentToolkitShellContext = createContext(Symbol.for("pie.assessmentToolkit.shellContext"));
+export const assessmentToolkitRegionScopeContext = createContext(Symbol.for("pie.assessmentToolkit.regionScopeContext"));
+//# sourceMappingURL=assessment-toolkit-context.js.map

package/dist/context/assessment-toolkit-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assessment-toolkit-context.js","sourceRoot":"","sources":["../../src/context/assessment-toolkit-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAiCzD,MAAM,CAAC,MAAM,+BAA+B,GAC3C,aAAa,CACZ,MAAM,CAAC,GAAG,CAAC,sCAAsC,CAAC,CAClD,CAAC;AAOH,MAAM,CAAC,MAAM,mCAAmC,GAC/C,aAAa,CACZ,MAAM,CAAC,GAAG,CAAC,0CAA0C,CAAC,CACtD,CAAC;AAeH,MAAM,CAAC,MAAM,6BAA6B,GACzC,aAAa,CACZ,MAAM,CAAC,GAAG,CAAC,oCAAoC,CAAC,CAChD,CAAC;AAMH,MAAM,CAAC,MAAM,mCAAmC,GAC/C,aAAa,CACZ,MAAM,CAAC,GAAG,CAAC,0CAA0C,CAAC,CACtD,CAAC"}

package/dist/context/runtime-context-consumer.d.ts

@@ -0,0 +1,14 @@
+import { type AssessmentToolkitHostRuntimeContext, type AssessmentToolkitRegionScopeContext, type AssessmentToolkitShellContext, type AssessmentToolkitRuntimeContext } from "./assessment-toolkit-context.js";
+export type RuntimeContextListener = (value: AssessmentToolkitRuntimeContext) => void;
+export type HostRuntimeContextListener = (value: AssessmentToolkitHostRuntimeContext) => void;
+export type ShellContextListener = (value: AssessmentToolkitShellContext) => void;
+export type RegionScopeContextListener = (value: AssessmentToolkitRegionScopeContext) => void;
+/**
+ * Connect a DOM host element to the shared assessment toolkit runtime context.
+ * Returns a cleanup function that disconnects the underlying consumer.
+ */
+export declare function connectAssessmentToolkitRuntimeContext(host: HTMLElement, onValue: RuntimeContextListener): () => void;
+export declare function connectAssessmentToolkitHostRuntimeContext(host: HTMLElement, onValue: HostRuntimeContextListener): () => void;
+export declare function connectAssessmentToolkitShellContext(host: HTMLElement, onValue: ShellContextListener): () => void;
+export declare function connectAssessmentToolkitRegionScopeContext(host: HTMLElement, onValue: RegionScopeContextListener): () => void;
+//# sourceMappingURL=runtime-context-consumer.d.ts.map

package/dist/context/runtime-context-consumer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-context-consumer.d.ts","sourceRoot":"","sources":["../../src/context/runtime-context-consumer.ts"],"names":[],"mappings":"AAEA,OAAO,EAKN,KAAK,mCAAmC,EACxC,KAAK,mCAAmC,EACxC,KAAK,6BAA6B,EAClC,KAAK,+BAA+B,EACpC,MAAM,iCAAiC,CAAC;AAEzC,MAAM,MAAM,sBAAsB,GAAG,CACpC,KAAK,EAAE,+BAA+B,KAClC,IAAI,CAAC;AACV,MAAM,MAAM,0BAA0B,GAAG,CACxC,KAAK,EAAE,mCAAmC,KACtC,IAAI,CAAC;AACV,MAAM,MAAM,oBAAoB,GAAG,CAClC,KAAK,EAAE,6BAA6B,KAChC,IAAI,CAAC;AACV,MAAM,MAAM,0BAA0B,GAAG,CACxC,KAAK,EAAE,mCAAmC,KACtC,IAAI,CAAC;AA8CV;;;GAGG;AACH,wBAAgB,sCAAsC,CACrD,IAAI,EAAE,WAAW,EACjB,OAAO,EAAE,sBAAsB,GAC7B,MAAM,IAAI,CAMZ;AAED,wBAAgB,0CAA0C,CACzD,IAAI,EAAE,WAAW,EACjB,OAAO,EAAE,0BAA0B,GACjC,MAAM,IAAI,CAMZ;AAED,wBAAgB,oCAAoC,CACnD,IAAI,EAAE,WAAW,EACjB,OAAO,EAAE,oBAAoB,GAC3B,MAAM,IAAI,CAMZ;AAED,wBAAgB,0CAA0C,CACzD,IAAI,EAAE,WAAW,EACjB,OAAO,EAAE,0BAA0B,GACjC,MAAM,IAAI,CAMZ"}

package/dist/context/runtime-context-consumer.js

@@ -0,0 +1,52 @@
+import { ContextConsumer } from "@pie-players/pie-context";
+import { assessmentToolkitHostRuntimeContext, assessmentToolkitRegionScopeContext, assessmentToolkitShellContext, assessmentToolkitRuntimeContext, } from "./assessment-toolkit-context.js";
+function connectConsumerWithProviderRetry(host, context, onValue) {
+    let hasValue = false;
+    const consumer = new ContextConsumer(host, {
+        context,
+        subscribe: true,
+        onValue: (value) => {
+            hasValue = true;
+            onValue(value);
+        },
+    });
+    consumer.connect();
+    const onContextProvider = (event) => {
+        if (event.context !== context)
+            return;
+        consumer.requestValue();
+    };
+    host.addEventListener("context-provider", onContextProvider);
+    let attempts = 0;
+    const maxAttempts = 200;
+    const retryTimer = globalThis.setInterval(() => {
+        if (hasValue || attempts >= maxAttempts) {
+            globalThis.clearInterval(retryTimer);
+            return;
+        }
+        attempts += 1;
+        consumer.requestValue();
+    }, 50);
+    return () => {
+        globalThis.clearInterval(retryTimer);
+        host.removeEventListener("context-provider", onContextProvider);
+        consumer.disconnect();
+    };
+}
+/**
+ * Connect a DOM host element to the shared assessment toolkit runtime context.
+ * Returns a cleanup function that disconnects the underlying consumer.
+ */
+export function connectAssessmentToolkitRuntimeContext(host, onValue) {
+    return connectConsumerWithProviderRetry(host, assessmentToolkitRuntimeContext, onValue);
+}
+export function connectAssessmentToolkitHostRuntimeContext(host, onValue) {
+    return connectConsumerWithProviderRetry(host, assessmentToolkitHostRuntimeContext, onValue);
+}
+export function connectAssessmentToolkitShellContext(host, onValue) {
+    return connectConsumerWithProviderRetry(host, assessmentToolkitShellContext, onValue);
+}
+export function connectAssessmentToolkitRegionScopeContext(host, onValue) {
+    return connectConsumerWithProviderRetry(host, assessmentToolkitRegionScopeContext, onValue);
+}
+//# sourceMappingURL=runtime-context-consumer.js.map

package/dist/context/runtime-context-consumer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-context-consumer.js","sourceRoot":"","sources":["../../src/context/runtime-context-consumer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAE3D,OAAO,EACN,mCAAmC,EACnC,mCAAmC,EACnC,6BAA6B,EAC7B,+BAA+B,GAK/B,MAAM,iCAAiC,CAAC;AAmBzC,SAAS,gCAAgC,CACxC,IAAiB,EACjB,OAAU,EACV,OAAiC;IAEjC,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,MAAM,QAAQ,GAAG,IAAI,eAAe,CAAC,IAAI,EAAE;QAC1C,OAAO;QACP,SAAS,EAAE,IAAI;QACf,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;YAClB,QAAQ,GAAG,IAAI,CAAC;YAChB,OAAO,CAAC,KAAK,CAAC,CAAC;QAChB,CAAC;KACD,CAAC,CAAC;IACH,QAAQ,CAAC,OAAO,EAAE,CAAC;IAEnB,MAAM,iBAAiB,GAAG,CAAC,KAA+B,EAAE,EAAE;QAC7D,IAAI,KAAK,CAAC,OAAO,KAAK,OAAO;YAAE,OAAO;QACtC,QAAQ,CAAC,YAAY,EAAE,CAAC;IACzB,CAAC,CAAC;IACF,IAAI,CAAC,gBAAgB,CAAC,kBAAkB,EAAE,iBAAiB,CAAC,CAAC;IAE7D,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,MAAM,WAAW,GAAG,GAAG,CAAC;IACxB,MAAM,UAAU,GAAG,UAAU,CAAC,WAAW,CAAC,GAAG,EAAE;QAC9C,IAAI,QAAQ,IAAI,QAAQ,IAAI,WAAW,EAAE,CAAC;YACzC,UAAU,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;YACrC,OAAO;QACR,CAAC;QACD,QAAQ,IAAI,CAAC,CAAC;QACd,QAAQ,CAAC,YAAY,EAAE,CAAC;IACzB,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,OAAO,GAAG,EAAE;QACX,UAAU,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;QACrC,IAAI,CAAC,mBAAmB,CAAC,kBAAkB,EAAE,iBAAiB,CAAC,CAAC;QAChE,QAAQ,CAAC,UAAU,EAAE,CAAC;IACvB,CAAC,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,sCAAsC,CACrD,IAAiB,EACjB,OAA+B;IAE/B,OAAO,gCAAgC,CACtC,IAAI,EACJ,+BAA+B,EAC/B,OAAmC,CACnC,CAAC;AACH,CAAC;AAED,MAAM,UAAU,0CAA0C,CACzD,IAAiB,EACjB,OAAmC;IAEnC,OAAO,gCAAgC,CACtC,IAAI,EACJ,mCAAmC,EACnC,OAAmC,CACnC,CAAC;AACH,CAAC;AAED,MAAM,UAAU,oCAAoC,CACnD,IAAiB,EACjB,OAA6B;IAE7B,OAAO,gCAAgC,CACtC,IAAI,EACJ,6BAA6B,EAC7B,OAAmC,CACnC,CAAC;AACH,CAAC;AAED,MAAM,UAAU,0CAA0C,CACzD,IAAiB,EACjB,OAAmC;IAEnC,OAAO,gCAAgC,CACtC,IAAI,EACJ,mCAAmC,EACnC,OAAmC,CACnC,CAAC;AACH,CAAC"}

package/dist/index.d.ts

@@ -6,46 +6,57 @@
  *
  * @packageDocumentation
  */
-export { TypedEventBus } from "./core/TypedEventBus";
-export type { IAccessibilityCatalogResolver, IElementToolStateStore, IHighlightCoordinator, II18nService, IThemeProvider, IToolCoordinator, IToolkitCoordinator, ITTSService, ToolState, } from "./services/interfaces";
-export type { CatalogLookupOptions, CatalogStatistics, CatalogType, ResolvedCatalog, } from "./services/AccessibilityCatalogResolver";
-export { AccessibilityCatalogResolver } from "./services/AccessibilityCatalogResolver";
-export { AssessmentAuthoringService } from "./services/AssessmentAuthoringService";
-export { ContextVariableStore } from "./services/ContextVariableStore";
-export { ElementToolStateStore } from "./services/ElementToolStateStore";
-export type { Annotation } from "./services/HighlightCoordinator";
-export { HighlightColor, HighlightCoordinator, HighlightType, } from "./services/HighlightCoordinator";
-export type { SerializedRange } from "./services/RangeSerializer";
-export { RangeSerializer } from "./services/RangeSerializer";
-export type { AnnotationToolbarConfig, DictionaryLookupRequest, DictionaryLookupResponse, PictureDictionaryLookupRequest, PictureDictionaryLookupResponse, TranslationRequest, TranslationResponse, } from "./services/AnnotationToolbarConfig";
-export { AnnotationToolbarAPIClient } from "./services/AnnotationToolbarConfig";
-export type { I18nConfig, PluralTranslation, TranslationBundle, } from "./services/I18nService";
-export { I18nService } from "./services/I18nService";
-export type { ToolButtonDefinition, ToolButtonOptions, ToolInstanceOptions, ToolRegistration, } from "./services/ToolRegistry";
-export { ToolRegistry } from "./services/ToolRegistry";
-export type { AssessmentToolContext, BaseToolContext, ElementToolContext, ItemToolContext, PassageToolContext, RubricToolContext, SectionToolContext, ToolContext, ToolLevel, } from "./services/tool-context";
-export { extractTextContent, hasChoiceInteraction, hasMathContent, hasReadableText, isAssessmentContext, isElementContext, isItemContext, isPassageContext, isRubricContext, isSectionContext, } from "./services/tool-context";
-export { createDefaultToolRegistry, DEFAULT_TOOL_PLACEMENT, DEFAULT_TOOL_ORDER, } from "./services/createDefaultToolRegistry";
-export type { DefaultToolRegistryOptions } from "./services/createDefaultToolRegistry";
-export type { ToolComponentFactory, ToolComponentFactoryMap, ToolComponentOverrides, ToolTagMap, } from "./tools/tool-tag-map";
-export { createToolElement, DEFAULT_TOOL_TAG_MAP, resolveToolTag, toToolIdFromTag, } from "./tools/tool-tag-map";
-export type { ResolvedToolConfig, ToolResolutionResult, } from "./services/PNPToolResolver";
-export { PNPToolResolver } from "./services/PNPToolResolver";
-export type { FeatureResolutionTrail, PNPResolutionProvenance, ResolutionDecision, } from "./services/pnp-provenance";
-export { formatProvenanceAsJSON, formatProvenanceAsMarkdown, getFeatureExplanation, PNPProvenanceBuilder, } from "./services/pnp-provenance";
-export { ALL_STANDARD_ACCESS_FEATURES, EXAMPLE_PNP_CONFIGURATIONS, getFeatureCategory, getFeaturesInCategory, isStandardAccessFeature, QTI_STANDARD_ACCESS_FEATURES, } from "./services/pnp-standard-features";
-export type { ExtractionResult } from "./services/SSMLExtractor";
-export { SSMLExtractor } from "./services/SSMLExtractor";
-export type { FontSize, ThemeConfig } from "./services/ThemeProvider";
-export { ThemeProvider } from "./services/ThemeProvider";
-export { ToolCoordinator, ZIndexLayer } from "./services/ToolCoordinator";
-export type { AnswerEliminatorToolConfig, ToolConfig, ToolkitCoordinatorConfig, ToolkitServiceBundle, TTSToolConfig, } from "./services/ToolkitCoordinator";
-export { ToolkitCoordinator } from "./services/ToolkitCoordinator";
-export type { TTSConfig } from "./services/TTSService";
-export { PlaybackState, TTSService } from "./services/TTSService";
-export { BrowserTTSProvider } from "./services/tts/browser-provider";
-export type { ITTSProvider, ITTSProviderImplementation, TTSFeature, TTSProviderCapabilities, } from "./services/tts/provider-interface";
-export type { CreateLoadItemOptions, LoadItem, LoadItemOptions, } from "./item-loader";
-export { createFetchItemLoader, createLoadItem, ItemLoadError, } from "./item-loader";
-export type { AssessmentCompletedEvent, AssessmentPausedEvent, AssessmentResumedEvent, AssessmentStartedEvent, AssessmentToolkitEvents, CanNavigateChangedEvent, InteractionEvent, InteractionType, ItemChangedEvent, ItemMetadata, LoadCompleteEvent, LocaleChangedEvent, LocaleLoadingCompleteEvent, LocaleLoadingErrorEvent, LocaleLoadingStartEvent, NavigationRequestEvent, PlayerErrorEvent, SessionChangedEvent, StateRestoredEvent, StateSavedEvent, SyncFailedEvent, ToolActivatedEvent, ToolDeactivatedEvent, ToolStateChangedEvent, } from "./types/events";
+export { TypedEventBus } from "./core/TypedEventBus.js";
+export type { AssessmentToolkitHostRuntimeContext, AssessmentToolkitRegionScopeContext, AssessmentToolkitRuntimeContext, AssessmentToolkitShellContext, ItemPlayerConfig, ItemPlayerType, ShellContextKind, } from "./context/assessment-toolkit-context.js";
+export { assessmentToolkitHostRuntimeContext, assessmentToolkitRegionScopeContext, assessmentToolkitRuntimeContext, assessmentToolkitShellContext, } from "./context/assessment-toolkit-context.js";
+export { connectAssessmentToolkitHostRuntimeContext, connectAssessmentToolkitRegionScopeContext, connectAssessmentToolkitRuntimeContext, connectAssessmentToolkitShellContext, } from "./context/runtime-context-consumer.js";
+export { PIE_ITEM_SESSION_CHANGED_EVENT, PIE_REGISTER_EVENT, PIE_UNREGISTER_EVENT, type ItemSessionChangedDetail, type RuntimeRegistrationDetail, type RuntimeRegistrationKind, } from "./runtime/registration-events.js";
+export { connectToolRegionScopeContext, connectToolRuntimeContext, connectToolShellContext, createCrossBoundaryEvent, dispatchCrossBoundaryEvent, isContextValueDefined, } from "./runtime/tool-host-contract.js";
+export type { IAccessibilityCatalogResolver, IElementToolStateStore, IHighlightCoordinator, II18nService, IThemeProvider, IToolCoordinator, IToolkitCoordinator, ITTSService, ToolState, } from "./services/interfaces.js";
+export type { CatalogLookupOptions, CatalogStatistics, CatalogType, ResolvedCatalog, } from "./services/AccessibilityCatalogResolver.js";
+export { AccessibilityCatalogResolver } from "./services/AccessibilityCatalogResolver.js";
+export { ContextVariableStore } from "./services/ContextVariableStore.js";
+export { ElementToolStateStore } from "./services/ElementToolStateStore.js";
+export type { Annotation } from "./services/HighlightCoordinator.js";
+export { HighlightColor, HighlightCoordinator, HighlightType, } from "./services/HighlightCoordinator.js";
+export type { SerializedRange } from "./services/RangeSerializer.js";
+export { RangeSerializer } from "./services/RangeSerializer.js";
+export type { I18nConfig, PluralTranslation, TranslationBundle, } from "./services/I18nService.js";
+export { I18nService } from "./services/I18nService.js";
+export type { ToolbarContext, ToolModuleLoader, ToolToolbarButtonDefinition, ToolToolbarRenderResult, ToolRegistration, } from "./services/ToolRegistry.js";
+export { ToolRegistry } from "./services/ToolRegistry.js";
+export type { AssessmentToolContext, BaseToolContext, ElementToolContext, ItemToolContext, PassageToolContext, RubricToolContext, SectionToolContext, ToolContext, ToolLevel, } from "./services/tool-context.js";
+export { extractTextContent, hasChoiceInteraction, hasMathContent, hasReadableText, isAssessmentContext, isElementContext, isItemContext, isPassageContext, isRubricContext, isSectionContext, } from "./services/tool-context.js";
+export { createDefaultToolRegistry, DEFAULT_TOOL_PLACEMENT, DEFAULT_TOOL_ORDER, } from "./services/createDefaultToolRegistry.js";
+export type { DefaultToolRegistryOptions } from "./services/createDefaultToolRegistry.js";
+export { DEFAULT_PERSONAL_NEEDS_PROFILE, createDefaultPersonalNeedsProfile, } from "./services/defaultPersonalNeedsProfile.js";
+export type { ToolComponentFactory, ToolComponentFactoryMap, ToolComponentOverrides, ToolTagMap, } from "./tools/tool-tag-map.js";
+export { createToolElement, DEFAULT_TOOL_TAG_MAP, resolveToolTag, toToolIdFromTag, } from "./tools/tool-tag-map.js";
+export type { ResolvedToolConfig, ToolResolutionResult, } from "./services/PNPToolResolver.js";
+export { PNPToolResolver } from "./services/PNPToolResolver.js";
+export type { FeatureResolutionTrail, PNPResolutionProvenance, ResolutionDecision, } from "./services/pnp-provenance.js";
+export { formatProvenanceAsJSON, formatProvenanceAsMarkdown, getFeatureExplanation, PNPProvenanceBuilder, } from "./services/pnp-provenance.js";
+export { ALL_STANDARD_ACCESS_FEATURES, EXAMPLE_PNP_CONFIGURATIONS, getFeatureCategory, getFeaturesInCategory, isStandardAccessFeature, QTI_STANDARD_ACCESS_FEATURES, } from "./services/pnp-standard-features.js";
+export type { ExtractionResult } from "./services/SSMLExtractor.js";
+export { SSMLExtractor } from "./services/SSMLExtractor.js";
+export type { FontSize, ThemeConfig } from "./services/ThemeProvider.js";
+export { ThemeProvider } from "./services/ThemeProvider.js";
+export { ToolCoordinator, ZIndexLayer } from "./services/ToolCoordinator.js";
+export type { AnswerEliminatorToolConfig, ProviderLifecycleContext, SectionControllerContext, SectionControllerFactoryDefaults, SectionControllerHandle, SectionControllerKey, SectionControllerPersistenceStrategy, SectionPersistenceFactoryDefaults, ToolConfig, ToolkitCoordinatorConfig, ToolkitCoordinatorHooks, ToolkitErrorContext, ToolkitInitStatus, ToolkitServiceBundle, ToolkitToolsConfig, TTSToolConfig, } from "./services/ToolkitCoordinator.js";
+export { ToolkitCoordinator } from "./services/ToolkitCoordinator.js";
+export type { CanonicalToolsConfig, ToolPlacementConfig, ToolPlacementLevel, ToolPolicyConfig, ToolProvidersConfig, } from "./services/tools-config-normalizer.js";
+export { normalizeToolsConfig, normalizeToolAlias, normalizeToolList, parseToolList, resolveToolsForLevel, } from "./services/tools-config-normalizer.js";
+export type { ParsedToolInstanceId, ToolInstanceRole, ToolScopeLevel, } from "./services/tool-instance-id.js";
+export { createScopedToolId, parseScopedToolId, toOverlayToolId, } from "./services/tool-instance-id.js";
+export type { TTSConfig } from "./services/TTSService.js";
+export { PlaybackState, TTSService } from "./services/TTSService.js";
+export { BrowserTTSProvider } from "./services/tts/browser-provider.js";
+export type { ITTSProvider, ITTSProviderImplementation, TTSFeature, TTSProviderCapabilities, } from "./services/tts/provider-interface.js";
+export type { CreateLoadItemOptions, LoadItem, LoadItemOptions, } from "./item-loader.js";
+export { createFetchItemLoader, createLoadItem, ItemLoadError, } from "./item-loader.js";
+export type { StorageLike, TestAttemptItemSession, TestAttemptSession, TestAttemptSessionNavigationState, TestAttemptSessionRealization, } from "./attempt/TestSession.js";
+export { createMemoryStorage, createTestAttemptSessionIdentifier, createNewTestAttemptSession, getBrowserLocalStorage, getOrCreateAnonymousDeviceId, getTestAttemptSessionStorageKey, loadTestAttemptSession, saveTestAttemptSession, setCurrentPosition, upsertItemSessionFromPieSessionChange, upsertVisitedItem, } from "./attempt/TestSession.js";
+export type { ActivitySessionPatchPayload, MapActivityToTestAttemptSessionArgs, PieBackendActivityDefinition, PieBackendActivityItemRef, PieBackendActivitySession, } from "./attempt/adapters/activity-to-test-attempt-session.js";
+export { buildActivitySessionItemUpdate, buildActivitySessionPatchFromTestAttemptSession, mapActivityToTestAttemptSession, toItemSessionsRecord, } from "./attempt/adapters/activity-to-test-attempt-session.js";
+export type { AssessmentCompletedEvent, AssessmentPausedEvent, AssessmentResumedEvent, AssessmentStartedEvent, AssessmentToolkitEvents, CanNavigateChangedEvent, InteractionEvent, InteractionType, ItemChangedEvent, ItemMetadata, LoadCompleteEvent, LocaleChangedEvent, LocaleLoadingCompleteEvent, LocaleLoadingErrorEvent, LocaleLoadingStartEvent, NavigationRequestEvent, PlayerErrorEvent, SessionChangedEvent, StateRestoredEvent, StateSavedEvent, SyncFailedEvent, ToolActivatedEvent, ToolDeactivatedEvent, ToolStateChangedEvent, } from "./types/events.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -9,43 +9,45 @@
 // ============================================================================
 // Core Infrastructure
 // ============================================================================
-export { TypedEventBus } from "./core/TypedEventBus";
-export { AccessibilityCatalogResolver } from "./services/AccessibilityCatalogResolver";
-export { AssessmentAuthoringService } from "./services/AssessmentAuthoringService";
+export { TypedEventBus } from "./core/TypedEventBus.js";
+export { assessmentToolkitHostRuntimeContext, assessmentToolkitRegionScopeContext, assessmentToolkitRuntimeContext, assessmentToolkitShellContext, } from "./context/assessment-toolkit-context.js";
+export { connectAssessmentToolkitHostRuntimeContext, connectAssessmentToolkitRegionScopeContext, connectAssessmentToolkitRuntimeContext, connectAssessmentToolkitShellContext, } from "./context/runtime-context-consumer.js";
+export { PIE_ITEM_SESSION_CHANGED_EVENT, PIE_REGISTER_EVENT, PIE_UNREGISTER_EVENT, } from "./runtime/registration-events.js";
+export { connectToolRegionScopeContext, connectToolRuntimeContext, connectToolShellContext, createCrossBoundaryEvent, dispatchCrossBoundaryEvent, isContextValueDefined, } from "./runtime/tool-host-contract.js";
+export { AccessibilityCatalogResolver } from "./services/AccessibilityCatalogResolver.js";
 // Context Variable Store (QTI 3.0 Context Declarations)
-export { ContextVariableStore } from "./services/ContextVariableStore";
+export { ContextVariableStore } from "./services/ContextVariableStore.js";
 // Element Tool State Store (Element-level ephemeral tool state)
-export { ElementToolStateStore } from "./services/ElementToolStateStore";
-export { HighlightColor, HighlightCoordinator, HighlightType, } from "./services/HighlightCoordinator";
-export { RangeSerializer } from "./services/RangeSerializer";
-export { AnnotationToolbarAPIClient } from "./services/AnnotationToolbarConfig";
-export { I18nService } from "./services/I18nService";
-export { ToolRegistry } from "./services/ToolRegistry";
-export { extractTextContent, hasChoiceInteraction, hasMathContent, hasReadableText, isAssessmentContext, isElementContext, isItemContext, isPassageContext, isRubricContext, isSectionContext, } from "./services/tool-context";
-export { createDefaultToolRegistry, DEFAULT_TOOL_PLACEMENT, DEFAULT_TOOL_ORDER, } from "./services/createDefaultToolRegistry";
-export { createToolElement, DEFAULT_TOOL_TAG_MAP, resolveToolTag, toToolIdFromTag, } from "./tools/tool-tag-map";
-export { PNPToolResolver } from "./services/PNPToolResolver";
-export { formatProvenanceAsJSON, formatProvenanceAsMarkdown, getFeatureExplanation, PNPProvenanceBuilder, } from "./services/pnp-provenance";
+export { ElementToolStateStore } from "./services/ElementToolStateStore.js";
+export { HighlightColor, HighlightCoordinator, HighlightType, } from "./services/HighlightCoordinator.js";
+export { RangeSerializer } from "./services/RangeSerializer.js";
+export { I18nService } from "./services/I18nService.js";
+export { ToolRegistry } from "./services/ToolRegistry.js";
+export { extractTextContent, hasChoiceInteraction, hasMathContent, hasReadableText, isAssessmentContext, isElementContext, isItemContext, isPassageContext, isRubricContext, isSectionContext, } from "./services/tool-context.js";
+export { createDefaultToolRegistry, DEFAULT_TOOL_PLACEMENT, DEFAULT_TOOL_ORDER, } from "./services/createDefaultToolRegistry.js";
+export { DEFAULT_PERSONAL_NEEDS_PROFILE, createDefaultPersonalNeedsProfile, } from "./services/defaultPersonalNeedsProfile.js";
+export { createToolElement, DEFAULT_TOOL_TAG_MAP, resolveToolTag, toToolIdFromTag, } from "./tools/tool-tag-map.js";
+export { PNPToolResolver } from "./services/PNPToolResolver.js";
+export { formatProvenanceAsJSON, formatProvenanceAsMarkdown, getFeatureExplanation, PNPProvenanceBuilder, } from "./services/pnp-provenance.js";
 // QTI 3.0 Standard Access Features
-export { ALL_STANDARD_ACCESS_FEATURES, EXAMPLE_PNP_CONFIGURATIONS, getFeatureCategory, getFeaturesInCategory, isStandardAccessFeature, QTI_STANDARD_ACCESS_FEATURES, } from "./services/pnp-standard-features";
-export { SSMLExtractor } from "./services/SSMLExtractor";
-export { ThemeProvider } from "./services/ThemeProvider";
+export { ALL_STANDARD_ACCESS_FEATURES, EXAMPLE_PNP_CONFIGURATIONS, getFeatureCategory, getFeaturesInCategory, isStandardAccessFeature, QTI_STANDARD_ACCESS_FEATURES, } from "./services/pnp-standard-features.js";
+export { SSMLExtractor } from "./services/SSMLExtractor.js";
+export { ThemeProvider } from "./services/ThemeProvider.js";
 // Tool Coordinator
-export { ToolCoordinator, ZIndexLayer } from "./services/ToolCoordinator";
-export { ToolkitCoordinator } from "./services/ToolkitCoordinator";
-export { PlaybackState, TTSService } from "./services/TTSService";
-export { BrowserTTSProvider } from "./services/tts/browser-provider";
-export { createFetchItemLoader, createLoadItem, ItemLoadError, } from "./item-loader";
-// ============================================================================
-// Players (Optional Reference Implementations)
-// ============================================================================
-// Assessment Player - Full assessment with navigation
-// Note: Assessment player is optional and not exported by default.
-// Products can import from './player/AssessmentPlayer' if desired.
-// Section Player - Use @pie-players/pie-section-player web component instead
+export { ToolCoordinator, ZIndexLayer } from "./services/ToolCoordinator.js";
+export { ToolkitCoordinator } from "./services/ToolkitCoordinator.js";
+export { normalizeToolsConfig, normalizeToolAlias, normalizeToolList, parseToolList, resolveToolsForLevel, } from "./services/tools-config-normalizer.js";
+export { createScopedToolId, parseScopedToolId, toOverlayToolId, } from "./services/tool-instance-id.js";
+export { PlaybackState, TTSService } from "./services/TTSService.js";
+export { BrowserTTSProvider } from "./services/tts/browser-provider.js";
+export { createFetchItemLoader, createLoadItem, ItemLoadError, } from "./item-loader.js";
+export { createMemoryStorage, createTestAttemptSessionIdentifier, createNewTestAttemptSession, getBrowserLocalStorage, getOrCreateAnonymousDeviceId, getTestAttemptSessionStorageKey, loadTestAttemptSession, saveTestAttemptSession, setCurrentPosition, upsertItemSessionFromPieSessionChange, upsertVisitedItem, } from "./attempt/TestSession.js";
+export { buildActivitySessionItemUpdate, buildActivitySessionPatchFromTestAttemptSession, mapActivityToTestAttemptSession, toItemSessionsRecord, } from "./attempt/adapters/activity-to-test-attempt-session.js";
+// Section Player - Use @pie-players/pie-section-player web component
 // ============================================================================
 // Shared Components
 // ============================================================================
-// QuestionToolBar is exported via package.json exports field
-// Import using: import QuestionToolBar from '@pie-players/pie-assessment-toolkit/components/QuestionToolBar.svelte';
+// ItemToolBar custom element registration helper is exported via package.json exports field
+// Import using: import '@pie-players/pie-assessment-toolkit/components/item-toolbar-element';
+// PieAssessmentToolkit custom element registration helper is exported via package.json exports field
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,+EAA+E;AAC/E,sBAAsB;AACtB,+EAA+E;AAE/E,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AA6BrD,OAAO,EAAE,4BAA4B,EAAE,MAAM,yCAAyC,CAAC;AACvF,OAAO,EAAE,0BAA0B,EAAE,MAAM,uCAAuC,CAAC;AACnF,wDAAwD;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AACvE,gEAAgE;AAChE,OAAO,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AAGzE,OAAO,EACN,cAAc,EACd,oBAAoB,EACpB,aAAa,GACb,MAAM,iCAAiC,CAAC;AAGzC,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAW7D,OAAO,EAAE,0BAA0B,EAAE,MAAM,oCAAoC,CAAC;AAOhF,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAQrD,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAYvD,OAAO,EACN,kBAAkB,EAClB,oBAAoB,EACpB,cAAc,EACd,eAAe,EACf,mBAAmB,EACnB,gBAAgB,EAChB,aAAa,EACb,gBAAgB,EAChB,eAAe,EACf,gBAAgB,GAChB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACN,yBAAyB,EACzB,sBAAsB,EACtB,kBAAkB,GAClB,MAAM,sCAAsC,CAAC;AAQ9C,OAAO,EACN,iBAAiB,EACjB,oBAAoB,EACpB,cAAc,EACd,eAAe,GACf,MAAM,sBAAsB,CAAC;AAM9B,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAO7D,OAAO,EACN,sBAAsB,EACtB,0BAA0B,EAC1B,qBAAqB,EACrB,oBAAoB,GACpB,MAAM,2BAA2B,CAAC;AACnC,mCAAmC;AACnC,OAAO,EACN,4BAA4B,EAC5B,0BAA0B,EAC1B,kBAAkB,EAClB,qBAAqB,EACrB,uBAAuB,EACvB,4BAA4B,GAC5B,MAAM,kCAAkC,CAAC;AAG1C,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAGzD,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,mBAAmB;AACnB,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAS1E,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAGnE,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAClE,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAwBrE,OAAO,EACN,qBAAqB,EACrB,cAAc,EACd,aAAa,GACb,MAAM,eAAe,CAAC;AAmCvB,+EAA+E;AAC/E,+CAA+C;AAC/C,+EAA+E;AAE/E,sDAAsD;AACtD,mEAAmE;AACnE,mEAAmE;AAEnE,6EAA6E;AAE7E,+EAA+E;AAC/E,oBAAoB;AACpB,+EAA+E;AAE/E,6DAA6D;AAC7D,qHAAqH"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/runtime/RuntimeRegistry.d.ts

@@ -0,0 +1,13 @@
+import type { RuntimeRegistrationDetail, RuntimeRegistrationKind } from "./registration-events.js";
+export interface RegisteredShell extends RuntimeRegistrationDetail {
+    sortKey: number;
+}
+export declare class RuntimeRegistry {
+    private readonly shellsByElement;
+    register(detail: RuntimeRegistrationDetail): boolean;
+    unregister(element: HTMLElement): boolean;
+    getOrderedShells(kind?: RuntimeRegistrationKind): RegisteredShell[];
+    getCanonicalIdMap(): Record<string, string>;
+    clear(): void;
+}
+//# sourceMappingURL=RuntimeRegistry.d.ts.map

package/dist/runtime/RuntimeRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RuntimeRegistry.d.ts","sourceRoot":"","sources":["../../src/runtime/RuntimeRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,yBAAyB,EACzB,uBAAuB,EACvB,MAAM,0BAA0B,CAAC;AAElC,MAAM,WAAW,eAAgB,SAAQ,yBAAyB;IACjE,OAAO,EAAE,MAAM,CAAC;CAChB;AAUD,qBAAa,eAAe;IAC3B,OAAO,CAAC,QAAQ,CAAC,eAAe,CAA2C;IAE3E,QAAQ,CAAC,MAAM,EAAE,yBAAyB,GAAG,OAAO;IAqBpD,UAAU,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO;IAIzC,gBAAgB,CAAC,IAAI,CAAC,EAAE,uBAAuB,GAAG,eAAe,EAAE;IAQnE,iBAAiB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAS3C,KAAK,IAAI,IAAI;CAGb"}

package/dist/runtime/RuntimeRegistry.js

@@ -0,0 +1,50 @@
+function compareDocumentOrder(a, b) {
+    if (a === b)
+        return 0;
+    const position = a.compareDocumentPosition(b);
+    if (position & Node.DOCUMENT_POSITION_PRECEDING)
+        return 1;
+    if (position & Node.DOCUMENT_POSITION_FOLLOWING)
+        return -1;
+    return 0;
+}
+export class RuntimeRegistry {
+    shellsByElement = new Map();
+    register(detail) {
+        const existing = this.shellsByElement.get(detail.element);
+        const nextRecord = {
+            ...detail,
+            sortKey: Date.now(),
+        };
+        // Idempotent no-op for identical registrations.
+        if (existing &&
+            existing.kind === nextRecord.kind &&
+            existing.itemId === nextRecord.itemId &&
+            existing.canonicalItemId === nextRecord.canonicalItemId) {
+            return false;
+        }
+        this.shellsByElement.set(detail.element, nextRecord);
+        return true;
+    }
+    unregister(element) {
+        return this.shellsByElement.delete(element);
+    }
+    getOrderedShells(kind) {
+        const records = Array.from(this.shellsByElement.values()).filter((entry) => !kind || entry.kind === kind);
+        records.sort((a, b) => compareDocumentOrder(a.element, b.element));
+        return records;
+    }
+    getCanonicalIdMap() {
+        const map = {};
+        for (const entry of this.getOrderedShells("item")) {
+            if (!entry.itemId)
+                continue;
+            map[entry.itemId] = entry.canonicalItemId || entry.itemId;
+        }
+        return map;
+    }
+    clear() {
+        this.shellsByElement.clear();
+    }
+}
+//# sourceMappingURL=RuntimeRegistry.js.map

package/dist/runtime/RuntimeRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RuntimeRegistry.js","sourceRoot":"","sources":["../../src/runtime/RuntimeRegistry.ts"],"names":[],"mappings":"AASA,SAAS,oBAAoB,CAAC,CAAc,EAAE,CAAc;IAC3D,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IACtB,MAAM,QAAQ,GAAG,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC,CAAC;IAC9C,IAAI,QAAQ,GAAG,IAAI,CAAC,2BAA2B;QAAE,OAAO,CAAC,CAAC;IAC1D,IAAI,QAAQ,GAAG,IAAI,CAAC,2BAA2B;QAAE,OAAO,CAAC,CAAC,CAAC;IAC3D,OAAO,CAAC,CAAC;AACV,CAAC;AAED,MAAM,OAAO,eAAe;IACV,eAAe,GAAG,IAAI,GAAG,EAAgC,CAAC;IAE3E,QAAQ,CAAC,MAAiC;QACzC,MAAM,QAAQ,GAAG,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAC1D,MAAM,UAAU,GAAoB;YACnC,GAAG,MAAM;YACT,OAAO,EAAE,IAAI,CAAC,GAAG,EAAE;SACnB,CAAC;QAEF,gDAAgD;QAChD,IACC,QAAQ;YACR,QAAQ,CAAC,IAAI,KAAK,UAAU,CAAC,IAAI;YACjC,QAAQ,CAAC,MAAM,KAAK,UAAU,CAAC,MAAM;YACrC,QAAQ,CAAC,eAAe,KAAK,UAAU,CAAC,eAAe,EACtD,CAAC;YACF,OAAO,KAAK,CAAC;QACd,CAAC;QAED,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;QACrD,OAAO,IAAI,CAAC;IACb,CAAC;IAED,UAAU,CAAC,OAAoB;QAC9B,OAAO,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC7C,CAAC;IAED,gBAAgB,CAAC,IAA8B;QAC9C,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAC/D,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,KAAK,IAAI,CACvC,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,oBAAoB,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;QACnE,OAAO,OAAO,CAAC;IAChB,CAAC;IAED,iBAAiB;QAChB,MAAM,GAAG,GAA2B,EAAE,CAAC;QACvC,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,EAAE,CAAC;YACnD,IAAI,CAAC,KAAK,CAAC,MAAM;gBAAE,SAAS;YAC5B,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,KAAK,CAAC,eAAe,IAAI,KAAK,CAAC,MAAM,CAAC;QAC3D,CAAC;QACD,OAAO,GAAG,CAAC;IACZ,CAAC;IAED,KAAK;QACJ,IAAI,CAAC,eAAe,CAAC,KAAK,EAAE,CAAC;IAC9B,CAAC;CACD"}

package/dist/runtime/SectionRuntimeEngine.d.ts

@@ -0,0 +1,45 @@
+import type { ToolkitCoordinator } from "../services/ToolkitCoordinator.js";
+import type { SectionControllerHandle } from "../services/section-controller-types.js";
+import type { RuntimeRegistrationDetail } from "./registration-events.js";
+import { RuntimeRegistry } from "./RuntimeRegistry.js";
+interface RuntimeController extends SectionControllerHandle {
+    getCompositionModel?: () => unknown;
+    getCanonicalItemId?: (itemId: string) => string;
+    handleItemSessionChanged?: (itemId: string, session: unknown) => {
+        eventDetail?: unknown;
+    } | null;
+    subscribe?: (listener: () => void) => () => void;
+    navigateToItem?: (index: number) => unknown;
+}
+interface EngineInitArgs {
+    coordinator: ToolkitCoordinator;
+    section: unknown;
+    sectionId: string;
+    assessmentId: string;
+    view: string;
+    attemptId?: string;
+    createDefaultController: () => Promise<RuntimeController> | RuntimeController;
+    onCompositionChanged?: (composition: unknown) => void;
+}
+export declare class SectionRuntimeEngine {
+    private readonly registry;
+    private controller;
+    private coordinator;
+    private sectionId;
+    private attemptId;
+    private unsubscribeController;
+    private activeInitToken;
+    initialize(args: EngineInitArgs): Promise<void>;
+    register(detail: RuntimeRegistrationDetail): boolean;
+    unregister(element: HTMLElement): boolean;
+    getCompositionModel(): unknown;
+    getCanonicalItemId(itemId: string): string;
+    handleItemSessionChanged(itemId: string, session: unknown): unknown;
+    navigateToItem(index: number): unknown;
+    persist(): Promise<void>;
+    hydrate(): Promise<void>;
+    getRegistry(): RuntimeRegistry;
+    dispose(): Promise<void>;
+}
+export {};
+//# sourceMappingURL=SectionRuntimeEngine.d.ts.map

package/dist/runtime/SectionRuntimeEngine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SectionRuntimeEngine.d.ts","sourceRoot":"","sources":["../../src/runtime/SectionRuntimeEngine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAC5E,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,yCAAyC,CAAC;AACvF,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AAC1E,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD,UAAU,iBAAkB,SAAQ,uBAAuB;IAC1D,mBAAmB,CAAC,EAAE,MAAM,OAAO,CAAC;IACpC,kBAAkB,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,CAAC;IAChD,wBAAwB,CAAC,EAAE,CAC1B,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,OAAO,KACZ;QAAE,WAAW,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;IACtC,SAAS,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,MAAM,IAAI,CAAC;IACjD,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC;CAC5C;AAED,UAAU,cAAc;IACvB,WAAW,EAAE,kBAAkB,CAAC;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uBAAuB,EAAE,MAAM,OAAO,CAAC,iBAAiB,CAAC,GAAG,iBAAiB,CAAC;IAC9E,oBAAoB,CAAC,EAAE,CAAC,WAAW,EAAE,OAAO,KAAK,IAAI,CAAC;CACtD;AAED,qBAAa,oBAAoB;IAChC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAyB;IAClD,OAAO,CAAC,UAAU,CAAkC;IACpD,OAAO,CAAC,WAAW,CAAmC;IACtD,OAAO,CAAC,SAAS,CAAM;IACvB,OAAO,CAAC,SAAS,CAAqB;IACtC,OAAO,CAAC,qBAAqB,CAA6B;IAC1D,OAAO,CAAC,eAAe,CAAK;IAEtB,UAAU,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IA6BrD,QAAQ,CAAC,MAAM,EAAE,yBAAyB,GAAG,OAAO;IAIpD,UAAU,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO;IAIzC,mBAAmB,IAAI,OAAO;IAI9B,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAK1C,wBAAwB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO;IAKnE,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAIhC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAIxB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAI9B,WAAW;IAIL,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAc9B"}

package/dist/runtime/SectionRuntimeEngine.js

@@ -0,0 +1,81 @@
+import { RuntimeRegistry } from "./RuntimeRegistry.js";
+export class SectionRuntimeEngine {
+    registry = new RuntimeRegistry();
+    controller = null;
+    coordinator = null;
+    sectionId = "";
+    attemptId;
+    unsubscribeController = null;
+    activeInitToken = 0;
+    async initialize(args) {
+        this.activeInitToken += 1;
+        const token = this.activeInitToken;
+        this.coordinator = args.coordinator;
+        this.sectionId = args.sectionId;
+        this.attemptId = args.attemptId;
+        const resolved = (await args.coordinator.getOrCreateSectionController({
+            sectionId: args.sectionId,
+            attemptId: args.attemptId,
+            input: {
+                section: args.section,
+                sectionId: args.sectionId,
+                assessmentId: args.assessmentId,
+                view: args.view,
+            },
+            updateExisting: true,
+            createDefaultController: args.createDefaultController,
+        }));
+        if (token !== this.activeInitToken)
+            return;
+        this.unsubscribeController?.();
+        this.controller = resolved;
+        args.onCompositionChanged?.(resolved.getCompositionModel?.());
+        this.unsubscribeController = resolved.subscribe?.(() => {
+            args.onCompositionChanged?.(resolved.getCompositionModel?.());
+        }) || null;
+    }
+    register(detail) {
+        return this.registry.register(detail);
+    }
+    unregister(element) {
+        return this.registry.unregister(element);
+    }
+    getCompositionModel() {
+        return this.controller?.getCompositionModel?.() ?? null;
+    }
+    getCanonicalItemId(itemId) {
+        const map = this.registry.getCanonicalIdMap();
+        return map[itemId] || this.controller?.getCanonicalItemId?.(itemId) || itemId;
+    }
+    handleItemSessionChanged(itemId, session) {
+        const canonicalId = this.getCanonicalItemId(itemId);
+        return this.controller?.handleItemSessionChanged?.(canonicalId, session) ?? null;
+    }
+    navigateToItem(index) {
+        return this.controller?.navigateToItem?.(index) ?? null;
+    }
+    async persist() {
+        await this.controller?.persist?.();
+    }
+    async hydrate() {
+        await this.controller?.hydrate?.();
+    }
+    getRegistry() {
+        return this.registry;
+    }
+    async dispose() {
+        this.activeInitToken += 1;
+        this.unsubscribeController?.();
+        this.unsubscribeController = null;
+        if (this.coordinator && this.sectionId) {
+            await this.coordinator.disposeSectionController({
+                sectionId: this.sectionId,
+                attemptId: this.attemptId,
+            });
+        }
+        this.registry.clear();
+        this.controller = null;
+        this.coordinator = null;
+    }
+}
+//# sourceMappingURL=SectionRuntimeEngine.js.map

package/dist/runtime/SectionRuntimeEngine.js.map

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