@pie-players/pie-assessment-toolkit 0.2.7 → 0.2.10

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: (event: unknown) => 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,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,KAAK,MAAM,IAAI,CAAC;IAC/D,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":"AAGA,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAwBvD,MAAM,OAAO,oBAAoB;IACf,QAAQ,GAAG,IAAI,eAAe,EAAE,CAAC;IAC1C,UAAU,GAA6B,IAAI,CAAC;IAC5C,WAAW,GAA8B,IAAI,CAAC;IAC9C,SAAS,GAAG,EAAE,CAAC;IACf,SAAS,CAAqB;IAC9B,qBAAqB,GAAwB,IAAI,CAAC;IAClD,eAAe,GAAG,CAAC,CAAC;IAE5B,KAAK,CAAC,UAAU,CAAC,IAAoB;QACpC,IAAI,CAAC,eAAe,IAAI,CAAC,CAAC;QAC1B,MAAM,KAAK,GAAG,IAAI,CAAC,eAAe,CAAC;QACnC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;QACpC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;QAChC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;QAEhC,MAAM,QAAQ,GAAG,CAAC,MAAM,IAAI,CAAC,WAAW,CAAC,4BAA4B,CAAC;YACrE,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,KAAK,EAAE;gBACN,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,YAAY,EAAE,IAAI,CAAC,YAAY;gBAC/B,IAAI,EAAE,IAAI,CAAC,IAAI;aACf;YACD,cAAc,EAAE,IAAI;YACpB,uBAAuB,EAAE,IAAI,CAAC,uBAAuB;SACrD,CAAC,CAAsB,CAAC;QAEzB,IAAI,KAAK,KAAK,IAAI,CAAC,eAAe;YAAE,OAAO;QAC3C,IAAI,CAAC,qBAAqB,EAAE,EAAE,CAAC;QAC/B,IAAI,CAAC,UAAU,GAAG,QAAQ,CAAC;QAC3B,IAAI,CAAC,oBAAoB,EAAE,CAAC,QAAQ,CAAC,mBAAmB,EAAE,EAAE,CAAC,CAAC;QAC9D,IAAI,CAAC,qBAAqB,GAAG,QAAQ,CAAC,SAAS,EAAE,CAAC,GAAG,EAAE;YACtD,IAAI,CAAC,oBAAoB,EAAE,CAAC,QAAQ,CAAC,mBAAmB,EAAE,EAAE,CAAC,CAAC;QAC/D,CAAC,CAAC,IAAI,IAAI,CAAC;IACZ,CAAC;IAED,QAAQ,CAAC,MAAiC;QACzC,OAAO,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IACvC,CAAC;IAED,UAAU,CAAC,OAAoB;QAC9B,OAAO,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;IAC1C,CAAC;IAED,mBAAmB;QAClB,OAAO,IAAI,CAAC,UAAU,EAAE,mBAAmB,EAAE,EAAE,IAAI,IAAI,CAAC;IACzD,CAAC;IAED,kBAAkB,CAAC,MAAc;QAChC,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,iBAAiB,EAAE,CAAC;QAC9C,OAAO,GAAG,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,UAAU,EAAE,kBAAkB,EAAE,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC;IAC/E,CAAC;IAED,wBAAwB,CAAC,MAAc,EAAE,OAAgB;QACxD,MAAM,WAAW,GAAG,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC;QACpD,OAAO,IAAI,CAAC,UAAU,EAAE,wBAAwB,EAAE,CAAC,WAAW,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC;IAClF,CAAC;IAED,cAAc,CAAC,KAAa;QAC3B,OAAO,IAAI,CAAC,UAAU,EAAE,cAAc,EAAE,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC;IACzD,CAAC;IAED,KAAK,CAAC,OAAO;QACZ,MAAM,IAAI,CAAC,UAAU,EAAE,OAAO,EAAE,EAAE,CAAC;IACpC,CAAC;IAED,KAAK,CAAC,OAAO;QACZ,MAAM,IAAI,CAAC,UAAU,EAAE,OAAO,EAAE,EAAE,CAAC;IACpC,CAAC;IAED,WAAW;QACV,OAAO,IAAI,CAAC,QAAQ,CAAC;IACtB,CAAC;IAED,KAAK,CAAC,OAAO;QACZ,IAAI,CAAC,eAAe,IAAI,CAAC,CAAC;QAC1B,IAAI,CAAC,qBAAqB,EAAE,EAAE,CAAC;QAC/B,IAAI,CAAC,qBAAqB,GAAG,IAAI,CAAC;QAClC,IAAI,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACxC,MAAM,IAAI,CAAC,WAAW,CAAC,wBAAwB,CAAC;gBAC/C,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,SAAS,EAAE,IAAI,CAAC,SAAS;aACzB,CAAC,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;QACtB,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;QACvB,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;IACzB,CAAC;CACD"}

package/dist/runtime/registration-events.d.ts

@@ -0,0 +1,19 @@
+export declare const PIE_REGISTER_EVENT = "pie-register";
+export declare const PIE_UNREGISTER_EVENT = "pie-unregister";
+export declare const PIE_ITEM_SESSION_CHANGED_EVENT = "item-session-changed";
+export type RuntimeRegistrationKind = "item" | "passage";
+export interface RuntimeRegistrationDetail {
+    kind: RuntimeRegistrationKind;
+    itemId: string;
+    canonicalItemId?: string;
+    contentKind?: string;
+    item?: unknown;
+    element: HTMLElement;
+}
+export interface ItemSessionChangedDetail {
+    itemId: string;
+    canonicalItemId?: string;
+    session: unknown;
+    sourceRuntimeId?: string;
+}
+//# sourceMappingURL=registration-events.d.ts.map

package/dist/runtime/registration-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registration-events.d.ts","sourceRoot":"","sources":["../../src/runtime/registration-events.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,kBAAkB,iBAAiB,CAAC;AACjD,eAAO,MAAM,oBAAoB,mBAAmB,CAAC;AACrD,eAAO,MAAM,8BAA8B,yBAAyB,CAAC;AAErE,MAAM,MAAM,uBAAuB,GAAG,MAAM,GAAG,SAAS,CAAC;AAEzD,MAAM,WAAW,yBAAyB;IACzC,IAAI,EAAE,uBAAuB,CAAC;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,WAAW,CAAC;CACrB;AAED,MAAM,WAAW,wBAAwB;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;CACzB"}

package/dist/runtime/registration-events.js

@@ -0,0 +1,4 @@
+export const PIE_REGISTER_EVENT = "pie-register";
+export const PIE_UNREGISTER_EVENT = "pie-unregister";
+export const PIE_ITEM_SESSION_CHANGED_EVENT = "item-session-changed";
+//# sourceMappingURL=registration-events.js.map

package/dist/runtime/registration-events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registration-events.js","sourceRoot":"","sources":["../../src/runtime/registration-events.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,kBAAkB,GAAG,cAAc,CAAC;AACjD,MAAM,CAAC,MAAM,oBAAoB,GAAG,gBAAgB,CAAC;AACrD,MAAM,CAAC,MAAM,8BAA8B,GAAG,sBAAsB,CAAC"}

package/dist/runtime/runtime-event-guards.d.ts

@@ -0,0 +1,3 @@
+export declare function createRuntimeId(prefix?: string): string;
+export declare function shouldHandleBySourceRuntime(sourceRuntimeId: string | undefined, currentRuntimeId: string): boolean;
+//# sourceMappingURL=runtime-event-guards.d.ts.map

package/dist/runtime/runtime-event-guards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-event-guards.d.ts","sourceRoot":"","sources":["../../src/runtime/runtime-event-guards.ts"],"names":[],"mappings":"AAAA,wBAAgB,eAAe,CAAC,MAAM,SAAY,GAAG,MAAM,CAE1D;AAED,wBAAgB,2BAA2B,CAC1C,eAAe,EAAE,MAAM,GAAG,SAAS,EACnC,gBAAgB,EAAE,MAAM,GACtB,OAAO,CAGT"}

package/dist/runtime/runtime-event-guards.js

@@ -0,0 +1,9 @@
+export function createRuntimeId(prefix = "runtime") {
+    return `${prefix}-${Math.random().toString(16).slice(2)}-${Date.now()}`;
+}
+export function shouldHandleBySourceRuntime(sourceRuntimeId, currentRuntimeId) {
+    if (!sourceRuntimeId)
+        return true;
+    return sourceRuntimeId !== currentRuntimeId;
+}
+//# sourceMappingURL=runtime-event-guards.js.map

package/dist/runtime/runtime-event-guards.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-event-guards.js","sourceRoot":"","sources":["../../src/runtime/runtime-event-guards.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,eAAe,CAAC,MAAM,GAAG,SAAS;IACjD,OAAO,GAAG,MAAM,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;AACzE,CAAC;AAED,MAAM,UAAU,2BAA2B,CAC1C,eAAmC,EACnC,gBAAwB;IAExB,IAAI,CAAC,eAAe;QAAE,OAAO,IAAI,CAAC;IAClC,OAAO,eAAe,KAAK,gBAAgB,CAAC;AAC7C,CAAC"}

package/dist/runtime/tool-host-contract.d.ts

@@ -0,0 +1,30 @@
+import type { UnknownContext } from "@pie-players/pie-context";
+import { type RegionScopeContextListener, type RuntimeContextListener, type ShellContextListener } from "../context/runtime-context-consumer.js";
+type BaseEventInit = Pick<EventInit, "bubbles" | "composed" | "cancelable">;
+/**
+ * Contract helper for all toolkit/tool events that must cross custom-element boundaries.
+ */
+export declare function createCrossBoundaryEvent<T>(name: string, detail: T, init?: Partial<BaseEventInit>): CustomEvent<T>;
+/**
+ * Dispatches a cross-boundary event with toolkit defaults.
+ */
+export declare function dispatchCrossBoundaryEvent<T>(target: EventTarget, name: string, detail: T, init?: Partial<BaseEventInit>): boolean;
+/**
+ * Shared runtime-context connection contract for tools and shells.
+ * Uses retry + provider announcements so late providers are tolerated.
+ */
+export declare function connectToolRuntimeContext(host: HTMLElement, onValue: RuntimeContextListener): () => void;
+/**
+ * Shared shell-context connection contract for tools needing item/passage scope.
+ */
+export declare function connectToolShellContext(host: HTMLElement, onValue: ShellContextListener): () => void;
+/**
+ * Shared region-scope context contract for tools targeting content subregions.
+ */
+export declare function connectToolRegionScopeContext(host: HTMLElement, onValue: RegionScopeContextListener): () => void;
+/**
+ * Guard utility: narrows unknown context payloads when needed by callers.
+ */
+export declare function isContextValueDefined<T extends UnknownContext>(value: unknown): value is T["__context__"];
+export {};
+//# sourceMappingURL=tool-host-contract.d.ts.map

package/dist/runtime/tool-host-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-host-contract.d.ts","sourceRoot":"","sources":["../../src/runtime/tool-host-contract.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAIN,KAAK,0BAA0B,EAC/B,KAAK,sBAAsB,EAC3B,KAAK,oBAAoB,EACzB,MAAM,wCAAwC,CAAC;AAEhD,KAAK,aAAa,GAAG,IAAI,CAAC,SAAS,EAAE,SAAS,GAAG,UAAU,GAAG,YAAY,CAAC,CAAC;AAQ5E;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,CAAC,EACzC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,CAAC,EACT,IAAI,GAAE,OAAO,CAAC,aAAa,CAAM,GAC/B,WAAW,CAAC,CAAC,CAAC,CAMhB;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,CAAC,EAC3C,MAAM,EAAE,WAAW,EACnB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,CAAC,EACT,IAAI,GAAE,OAAO,CAAC,aAAa,CAAM,GAC/B,OAAO,CAET;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CACxC,IAAI,EAAE,WAAW,EACjB,OAAO,EAAE,sBAAsB,GAC7B,MAAM,IAAI,CAEZ;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACtC,IAAI,EAAE,WAAW,EACjB,OAAO,EAAE,oBAAoB,GAC3B,MAAM,IAAI,CAEZ;AAED;;GAEG;AACH,wBAAgB,6BAA6B,CAC5C,IAAI,EAAE,WAAW,EACjB,OAAO,EAAE,0BAA0B,GACjC,MAAM,IAAI,CAEZ;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,SAAS,cAAc,EAC7D,KAAK,EAAE,OAAO,GACZ,KAAK,IAAI,CAAC,CAAC,aAAa,CAAC,CAE3B"}

package/dist/runtime/tool-host-contract.js

@@ -0,0 +1,48 @@
+import { connectAssessmentToolkitRegionScopeContext, connectAssessmentToolkitRuntimeContext, connectAssessmentToolkitShellContext, } from "../context/runtime-context-consumer.js";
+const CROSS_BOUNDARY_EVENT_INIT = {
+    bubbles: true,
+    composed: true,
+    cancelable: false,
+};
+/**
+ * Contract helper for all toolkit/tool events that must cross custom-element boundaries.
+ */
+export function createCrossBoundaryEvent(name, detail, init = {}) {
+    return new CustomEvent(name, {
+        detail,
+        ...CROSS_BOUNDARY_EVENT_INIT,
+        ...init,
+    });
+}
+/**
+ * Dispatches a cross-boundary event with toolkit defaults.
+ */
+export function dispatchCrossBoundaryEvent(target, name, detail, init = {}) {
+    return target.dispatchEvent(createCrossBoundaryEvent(name, detail, init));
+}
+/**
+ * Shared runtime-context connection contract for tools and shells.
+ * Uses retry + provider announcements so late providers are tolerated.
+ */
+export function connectToolRuntimeContext(host, onValue) {
+    return connectAssessmentToolkitRuntimeContext(host, onValue);
+}
+/**
+ * Shared shell-context connection contract for tools needing item/passage scope.
+ */
+export function connectToolShellContext(host, onValue) {
+    return connectAssessmentToolkitShellContext(host, onValue);
+}
+/**
+ * Shared region-scope context contract for tools targeting content subregions.
+ */
+export function connectToolRegionScopeContext(host, onValue) {
+    return connectAssessmentToolkitRegionScopeContext(host, onValue);
+}
+/**
+ * Guard utility: narrows unknown context payloads when needed by callers.
+ */
+export function isContextValueDefined(value) {
+    return value !== null && value !== undefined;
+}
+//# sourceMappingURL=tool-host-contract.js.map

package/dist/runtime/tool-host-contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-host-contract.js","sourceRoot":"","sources":["../../src/runtime/tool-host-contract.ts"],"names":[],"mappings":"AACA,OAAO,EACN,0CAA0C,EAC1C,sCAAsC,EACtC,oCAAoC,GAIpC,MAAM,wCAAwC,CAAC;AAIhD,MAAM,yBAAyB,GAAkB;IAChD,OAAO,EAAE,IAAI;IACb,QAAQ,EAAE,IAAI;IACd,UAAU,EAAE,KAAK;CACjB,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,wBAAwB,CACvC,IAAY,EACZ,MAAS,EACT,OAA+B,EAAE;IAEjC,OAAO,IAAI,WAAW,CAAI,IAAI,EAAE;QAC/B,MAAM;QACN,GAAG,yBAAyB;QAC5B,GAAG,IAAI;KACP,CAAC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,0BAA0B,CACzC,MAAmB,EACnB,IAAY,EACZ,MAAS,EACT,OAA+B,EAAE;IAEjC,OAAO,MAAM,CAAC,aAAa,CAAC,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC;AAC3E,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,yBAAyB,CACxC,IAAiB,EACjB,OAA+B;IAE/B,OAAO,sCAAsC,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AAC9D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB,CACtC,IAAiB,EACjB,OAA6B;IAE7B,OAAO,oCAAoC,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AAC5D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,6BAA6B,CAC5C,IAAiB,EACjB,OAAmC;IAEnC,OAAO,0CAA0C,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AAClE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CACpC,KAAc;IAEd,OAAO,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,CAAC;AAC9C,CAAC"}

package/dist/services/HighlightCoordinator.d.ts

@@ -65,7 +65,16 @@ export declare class HighlightCoordinator implements IHighlightCoordinator {
     private nextAnnotationId;
     private supported;
     private rangeSerializer;
+    private themeObserver;
+    private explicitTTSColorOverride;
     constructor(config?: HighlightCoordinatorConfig);
+    private setupThemeObservation;
+    private parseColor;
+    private relativeLuminance;
+    private contrastRatio;
+    private blend;
+    private resolveAdaptiveTTSStyle;
+    private applyAdaptiveTTSStyle;
     /**
      * Initialize CSS Custom Highlights
      */

package/dist/services/HighlightCoordinator.d.ts.map

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

package/dist/services/HighlightCoordinator.js

@@ -52,6 +52,8 @@ export class HighlightCoordinator {
     nextAnnotationId = 1;
     supported = false;
     rangeSerializer;
+    themeObserver = null;
+    explicitTTSColorOverride = null;
     constructor(config = {}) {
         this.config = config;
         this.rangeSerializer = new RangeSerializer();
@@ -63,6 +65,176 @@ export class HighlightCoordinator {
         this.supported = true;
         this.initializeHighlights();
         this.registerStyles();
+        this.applyAdaptiveTTSStyle();
+        this.setupThemeObservation();
+    }
+    setupThemeObservation() {
+        if (typeof document === "undefined")
+            return;
+        if (typeof MutationObserver === "undefined")
+            return;
+        const refresh = () => this.applyAdaptiveTTSStyle();
+        this.themeObserver = new MutationObserver(refresh);
+        this.themeObserver.observe(document.documentElement, {
+            attributes: true,
+            attributeFilter: ["style", "data-theme", "data-color-scheme", "class"],
+        });
+        for (const host of document.querySelectorAll("pie-theme")) {
+            this.themeObserver.observe(host, {
+                attributes: true,
+                attributeFilter: [
+                    "theme",
+                    "scheme",
+                    "provider",
+                    "variables",
+                    "style",
+                    "data-theme",
+                    "data-color-scheme",
+                ],
+            });
+        }
+    }
+    parseColor(input) {
+        if (!input)
+            return null;
+        const value = input.trim();
+        if (!value)
+            return null;
+        const hexMatch = /^#([a-f\d]{3}|[a-f\d]{6})$/i.exec(value);
+        if (hexMatch) {
+            const hex = hexMatch[1];
+            if (hex.length === 3) {
+                return [
+                    parseInt(hex[0] + hex[0], 16),
+                    parseInt(hex[1] + hex[1], 16),
+                    parseInt(hex[2] + hex[2], 16),
+                ];
+            }
+            return [
+                parseInt(hex.slice(0, 2), 16),
+                parseInt(hex.slice(2, 4), 16),
+                parseInt(hex.slice(4, 6), 16),
+            ];
+        }
+        const rgbMatch = /^rgba?\((.+)\)$/i.exec(value);
+        if (rgbMatch) {
+            const normalized = rgbMatch[1].replace(/\//g, ",");
+            const parts = normalized
+                .split(/[,\s]+/)
+                .map((part) => part.trim())
+                .filter(Boolean);
+            const r = Number(parts[0]);
+            const g = Number(parts[1]);
+            const b = Number(parts[2]);
+            if (Number.isFinite(r) && Number.isFinite(g) && Number.isFinite(b)) {
+                return [r, g, b];
+            }
+        }
+        // Browser parser fallback (covers formats like oklch()).
+        if (typeof document !== "undefined") {
+            const parserEl = document.createElement("span");
+            parserEl.style.color = value;
+            if (typeof parserEl.style.color === "string" && parserEl.style.color) {
+                document.body?.appendChild(parserEl);
+                const resolved = typeof getComputedStyle === "function"
+                    ? getComputedStyle(parserEl).color
+                    : "";
+                parserEl.remove();
+                const normalizedResolved = resolved.trim();
+                // Guard against recursive loops when computed style returns the same
+                // unresolved function syntax (observed with certain color formats).
+                if (normalizedResolved && normalizedResolved !== value) {
+                    return this.parseColor(resolved);
+                }
+            }
+        }
+        return null;
+    }
+    relativeLuminance([r, g, b]) {
+        const toLinear = (channel) => {
+            const n = channel / 255;
+            return n <= 0.03928 ? n / 12.92 : ((n + 0.055) / 1.055) ** 2.4;
+        };
+        const lr = toLinear(r);
+        const lg = toLinear(g);
+        const lb = toLinear(b);
+        return 0.2126 * lr + 0.7152 * lg + 0.0722 * lb;
+    }
+    contrastRatio(a, b) {
+        const la = this.relativeLuminance(a);
+        const lb = this.relativeLuminance(b);
+        const lighter = Math.max(la, lb);
+        const darker = Math.min(la, lb);
+        return (lighter + 0.05) / (darker + 0.05);
+    }
+    blend(fg, bg, alpha) {
+        return [
+            Math.round(fg[0] * alpha + bg[0] * (1 - alpha)),
+            Math.round(fg[1] * alpha + bg[1] * (1 - alpha)),
+            Math.round(fg[2] * alpha + bg[2] * (1 - alpha)),
+        ];
+    }
+    resolveAdaptiveTTSStyle(sourceEl) {
+        const fallbackMissing = [255, 235, 59];
+        const fallbackText = [17, 24, 39];
+        const fallbackBackground = [255, 255, 255];
+        const target = sourceEl ||
+            (typeof document !== "undefined" ? document.documentElement : null);
+        const computed = target && typeof getComputedStyle === "function"
+            ? getComputedStyle(target)
+            : null;
+        const background = this.parseColor(computed?.getPropertyValue("--pie-background") || computed?.backgroundColor) || fallbackBackground;
+        const text = this.parseColor(computed?.getPropertyValue("--pie-text")) || fallbackText;
+        const accent = this.explicitTTSColorOverride
+            ? this.parseColor(this.explicitTTSColorOverride.color) || fallbackMissing
+            : this.parseColor(computed?.getPropertyValue("--pie-missing")) ||
+                fallbackMissing;
+        const opacityCandidates = this.explicitTTSColorOverride
+            ? [Math.max(0.3, Math.min(0.95, this.explicitTTSColorOverride.opacity))]
+            : [0.8, 0.72, 0.68, 0.62, 0.56, 0.5];
+        let selectedOpacity = opacityCandidates[opacityCandidates.length - 1];
+        let bestScore = -Infinity;
+        for (const opacity of opacityCandidates) {
+            const blended = this.blend(accent, background, opacity);
+            const backgroundDelta = this.contrastRatio(blended, background);
+            const textContrast = this.contrastRatio(blended, text);
+            const score = backgroundDelta * 1.2 + textContrast * 0.8;
+            if (backgroundDelta >= 1.25 && textContrast >= 2.4) {
+                selectedOpacity = opacity;
+                break;
+            }
+            if (score > bestScore) {
+                bestScore = score;
+                selectedOpacity = opacity;
+            }
+        }
+        const sentenceOpacity = Math.max(0.24, Math.min(0.85, selectedOpacity * 0.55));
+        const underlineOpacity = Math.max(0.55, Math.min(0.95, selectedOpacity + 0.2));
+        const shadowOpacity = Math.max(0.22, Math.min(0.6, selectedOpacity * 0.45));
+        const underlineColor = text;
+        const underlineBlend = this.blend(underlineColor, background, underlineOpacity);
+        const underlineDelta = this.contrastRatio(underlineBlend, background);
+        const fallbackUnderline = this.relativeLuminance(background) > 0.45 ? [0, 0, 0] : [255, 255, 255];
+        const finalUnderline = underlineDelta >= 1.35 ? underlineColor : fallbackUnderline;
+        const wordHighlight = `rgba(${accent[0]}, ${accent[1]}, ${accent[2]}, ${selectedOpacity})`;
+        const sentenceHighlight = `rgba(${accent[0]}, ${accent[1]}, ${accent[2]}, ${sentenceOpacity})`;
+        const wordUnderline = `rgba(${finalUnderline[0]}, ${finalUnderline[1]}, ${finalUnderline[2]}, ${underlineOpacity})`;
+        const wordShadow = `rgba(${finalUnderline[0]}, ${finalUnderline[1]}, ${finalUnderline[2]}, ${shadowOpacity})`;
+        return {
+            wordHighlight,
+            sentenceHighlight,
+            wordUnderline,
+            wordShadow,
+        };
+    }
+    applyAdaptiveTTSStyle(sourceEl) {
+        if (typeof document === "undefined")
+            return;
+        const vars = this.resolveAdaptiveTTSStyle(sourceEl);
+        document.documentElement.style.setProperty("--pie-tts-word-highlight", vars.wordHighlight);
+        document.documentElement.style.setProperty("--pie-tts-sentence-highlight", vars.sentenceHighlight);
+        document.documentElement.style.setProperty("--pie-tts-word-underline", vars.wordUnderline);
+        document.documentElement.style.setProperty("--pie-tts-word-shadow", vars.wordShadow);
     }
     /**
      * Initialize CSS Custom Highlights
@@ -99,44 +271,47 @@ export class HighlightCoordinator {
         style.textContent = `
       /* TTS highlights - temporary */
       ::highlight(tts-word) {
-        background-color: rgba(255, 235, 59, 0.4);
+        background-color: var(--pie-tts-word-highlight, color-mix(in srgb, var(--pie-missing, #ffeb3b) 68%, transparent));
+        text-decoration: underline 2px solid var(--pie-tts-word-underline, color-mix(in srgb, var(--pie-text, #111827) 70%, transparent));
+        text-underline-offset: 2px;
+        text-shadow: 0 0 1px var(--pie-tts-word-shadow, color-mix(in srgb, var(--pie-text, #111827) 35%, transparent));
         color: inherit;
       }
 
       ::highlight(tts-sentence) {
-        background-color: rgba(173, 216, 230, 0.3);
+        background-color: var(--pie-tts-sentence-highlight, color-mix(in srgb, var(--pie-missing, #ffeb3b) 38%, transparent));
         color: inherit;
       }
 
       /* Annotation highlights - persistent */
       ::highlight(annotation-yellow) {
-        background-color: rgba(255, 255, 0, 0.3);
+        background-color: color-mix(in srgb, var(--pie-missing, #ffff00) 35%, transparent);
         color: inherit;
       }
 
       ::highlight(annotation-green) {
-        background-color: rgba(144, 238, 144, 0.3);
+        background-color: color-mix(in srgb, var(--pie-correct, #90ee90) 35%, transparent);
         color: inherit;
       }
 
       ::highlight(annotation-blue) {
-        background-color: rgba(173, 216, 230, 0.3);
+        background-color: color-mix(in srgb, var(--pie-tertiary, #add8e6) 35%, transparent);
         color: inherit;
       }
 
       ::highlight(annotation-pink) {
-        background-color: rgba(255, 182, 193, 0.3);
+        background-color: color-mix(in srgb, var(--pie-secondary-light, #ffb6c1) 35%, transparent);
         color: inherit;
       }
 
       ::highlight(annotation-orange) {
-        background-color: rgba(255, 165, 0, 0.3);
+        background-color: color-mix(in srgb, var(--pie-incorrect, #ffa500) 35%, transparent);
         color: inherit;
       }
 
       ::highlight(annotation-underline) {
         background-color: transparent;
-        text-decoration: underline 2px solid #0066cc;
+        text-decoration: underline 2px solid var(--pie-primary, #0066cc);
         text-underline-offset: 2px;
         color: inherit;
       }
@@ -153,6 +328,7 @@ export class HighlightCoordinator {
     highlightTTSWord(textNode, startOffset, endOffset) {
         if (!this.ttsWordHighlight)
             return;
+        this.applyAdaptiveTTSStyle(textNode.parentElement);
         // Clear previous word highlight
         this.clearTTSWord();
         // Create range for word
@@ -170,6 +346,11 @@ export class HighlightCoordinator {
     highlightTTSSentence(ranges) {
         if (!this.ttsSentenceHighlight)
             return;
+        const source = ranges[0]?.startContainer;
+        const sourceElement = source?.nodeType === Node.ELEMENT_NODE
+            ? source
+            : source?.parentElement;
+        this.applyAdaptiveTTSStyle(sourceElement);
         // Clear previous sentence highlight
         this.clearTTSSentence();
         // Add all ranges
@@ -425,53 +606,11 @@ export class HighlightCoordinator {
         const rgb = hexToRgb(color);
         if (!rgb)
             return;
-        const rgbaColor = `rgba(${rgb.r}, ${rgb.g}, ${rgb.b}, ${opacity})`;
-        // Update the style element
-        styleEl.textContent = `
-      /* TTS highlights - temporary */
-      ::highlight(tts-word) {
-        background-color: ${rgbaColor};
-        color: inherit;
-      }
-
-      ::highlight(tts-sentence) {
-        background-color: rgba(173, 216, 230, 0.3);
-        color: inherit;
-      }
-
-      /* Annotation highlights - persistent */
-      ::highlight(annotation-yellow) {
-        background-color: rgba(255, 255, 0, 0.3);
-        color: inherit;
-      }
-
-      ::highlight(annotation-green) {
-        background-color: rgba(144, 238, 144, 0.3);
-        color: inherit;
-      }
-
-      ::highlight(annotation-blue) {
-        background-color: rgba(173, 216, 230, 0.3);
-        color: inherit;
-      }
-
-      ::highlight(annotation-pink) {
-        background-color: rgba(255, 182, 193, 0.3);
-        color: inherit;
-      }
-
-      ::highlight(annotation-orange) {
-        background-color: rgba(255, 165, 0, 0.3);
-        color: inherit;
-      }
-
-      ::highlight(annotation-underline) {
-        background-color: transparent;
-        text-decoration: underline 2px solid #0066cc;
-        text-underline-offset: 2px;
-        color: inherit;
-      }
-    `;
+        this.explicitTTSColorOverride = {
+            color: `rgb(${rgb.r}, ${rgb.g}, ${rgb.b})`,
+            opacity: Math.max(0.2, Math.min(0.95, opacity)),
+        };
+        this.applyAdaptiveTTSStyle();
     }
     /**
      * Cleanup - remove all highlights
@@ -488,6 +627,8 @@ export class HighlightCoordinator {
                 styleEl.remove();
             }
         }
+        this.themeObserver?.disconnect();
+        this.themeObserver = null;
     }
 }
 //# sourceMappingURL=HighlightCoordinator.js.map