@pie-players/pie-assessment-toolkit 0.3.60 → 0.3.62

package/dist/services/tts/highlight-pipeline/rendered-math-target-resolver.js

@@ -195,4 +195,3 @@ export const createRenderedMathTargetResolver = () => {
         return rendered;
     };
 };
-//# sourceMappingURL=rendered-math-target-resolver.js.map

package/dist/services/tts/highlight-pipeline/types.js

@@ -1,2 +1 @@
 export {};
-//# sourceMappingURL=types.js.map

package/dist/services/tts/highlight-pipeline/visible-map-range.js

@@ -19,4 +19,3 @@ export const createRangeFromVisibleMap = (visibleMap, start, end) => {
         return null;
     }
 };
-//# sourceMappingURL=visible-map-range.js.map

package/dist/services/tts/highlight-target-resolver.js

@@ -1,2 +1 @@
 export {};
-//# sourceMappingURL=highlight-target-resolver.js.map

package/dist/services/tts/math-alignment/index.js

@@ -63,4 +63,3 @@ export const resolveUniqueMathTargetForBoundaryWord = (alignment, args) => {
     });
     return matches.length === 1 ? matches[0].target : null;
 };
-//# sourceMappingURL=index.js.map

package/dist/services/tts/math-alignment/mathml-tokenizer.js

@@ -314,4 +314,3 @@ export const tokenizeMathML = (mathElement) => {
         expressionTarget: elementTarget(mathElement, "region-fallback"),
     };
 };
-//# sourceMappingURL=mathml-tokenizer.js.map

package/dist/services/tts/math-alignment/range-resolver.js

@@ -10,4 +10,3 @@ export const resolveMatchedHighlightTargetForBoundary = (args) => {
     const segment = args.alignment.segments.find((candidate) => candidate.speechTokenIds.includes(args.boundary.token.id));
     return segment?.target || null;
 };
-//# sourceMappingURL=range-resolver.js.map

package/dist/services/tts/math-alignment/sequence-aligner.js

@@ -116,4 +116,3 @@ export const alignSpeechToMath = (args) => {
         fallbackTarget: args.math.expressionTarget,
     };
 };
-//# sourceMappingURL=sequence-aligner.js.map

package/dist/services/tts/math-alignment/speech-tokenizer.js

@@ -140,4 +140,3 @@ export const resolveSpokenOffsetToSpeechToken = (args) => {
     }
     return spokenCandidate;
 };
-//# sourceMappingURL=speech-tokenizer.js.map

package/dist/services/tts/math-alignment/types.js

@@ -1,2 +1 @@
 export {};
-//# sourceMappingURL=types.js.map

package/dist/services/tts/math-aware-text-processing.js

@@ -348,4 +348,3 @@ export const collectMathAwareTextAndMap = (element, options) => {
     }
     return collectMathAware(element, options);
 };
-//# sourceMappingURL=math-aware-text-processing.js.map

package/dist/services/tts/math-speech.js

@@ -146,4 +146,3 @@ export const resolveMathSpeechFromChunks = async (chunks, options = {}) => {
         ssml,
     };
 };
-//# sourceMappingURL=math-speech.js.map

package/dist/services/tts/mathml-sanitization.js

@@ -167,4 +167,3 @@ export const canonicalizeMathML = (input) => {
         return null;
     return serializeMathNode(root);
 };
-//# sourceMappingURL=mathml-sanitization.js.map

package/dist/services/tts/ssml/spoken-text.js

@@ -156,4 +156,3 @@ export const extractSpokenText = (speechText) => {
         hasMarkup,
     };
 };
-//# sourceMappingURL=spoken-text.js.map

package/dist/services/tts/text-processing.js

@@ -167,4 +167,3 @@ export const collectVisibleTextAndMap = (element, options) => {
     return { text, map };
 };
 export const extractVisibleText = (element, options) => collectVisibleTextAndMap(element, options).text;
-//# sourceMappingURL=text-processing.js.map

package/dist/services/tts/text-segmentation.js

@@ -35,4 +35,3 @@ export const segmentSentences = (text, options) => {
     }
     return parsed.length > 0 ? parsed : [{ text, offset: 0 }];
 };
-//# sourceMappingURL=text-segmentation.js.map

package/dist/services/tts/visual-line-ranges.js

@@ -224,4 +224,3 @@ export function visualLineRangesForFocusInRoot(root, focus) {
     }
     return out.length > 0 ? out : [intersected.cloneRange()];
 }
-//# sourceMappingURL=visual-line-ranges.js.map

package/dist/services/tts-control-events.js

@@ -5,4 +5,3 @@
  * playback controls such as stop/pause/resume.
  */
 export const PIE_TTS_CONTROL_HANDOFF_EVENT = "pie-tts-control-handoff";
-//# sourceMappingURL=tts-control-events.js.map

package/dist/services/tts-runtime-config.js

@@ -352,4 +352,3 @@ export const resolveTTSHostToolbarLayout = (config) => {
             };
     }
 };
-//# sourceMappingURL=tts-runtime-config.js.map

package/dist/tools/calculators/desmos-provider.js

@@ -391,4 +391,3 @@ class DesmosCalculator {
         }
     }
 }
-//# sourceMappingURL=desmos-provider.js.map

package/dist/tools/client.js

@@ -16,4 +16,3 @@ export { COMMON_LIBRARIES, LibraryLoaderImpl, libraryLoader, } from "./library-l
 export { ResponseDiscoveryServiceImpl, responseDiscovery, } from "./response-discovery.js";
 // Core types (client-safe)
 export * from "./types.js";
-//# sourceMappingURL=client.js.map

package/dist/tools/index.js

@@ -8,4 +8,3 @@
 export * from "./client.js";
 // Variant resolver
 export { VariantResolverImpl } from "./variant-resolver.js";
-//# sourceMappingURL=index.js.map

package/dist/tools/library-loader.js

@@ -259,4 +259,3 @@ export const COMMON_LIBRARIES = {
         timeout: 5000,
     },
 };
-//# sourceMappingURL=library-loader.js.map

package/dist/tools/registrations/accessibility-tools.js

@@ -215,4 +215,3 @@ export const annotationToolbarRegistration = {
         };
     },
 };
-//# sourceMappingURL=accessibility-tools.js.map

package/dist/tools/registrations/calculator.js

@@ -226,4 +226,3 @@ export const calculatorToolRegistration = {
         };
     },
 };
-//# sourceMappingURL=calculator.js.map

package/dist/tools/registrations/interaction-tools.js

@@ -141,4 +141,3 @@ export const highlighterToolRegistration = {
         };
     },
 };
-//# sourceMappingURL=interaction-tools.js.map

package/dist/tools/registrations/measurement-tools.js

@@ -128,4 +128,3 @@ export const protractorToolRegistration = {
         };
     },
 };
-//# sourceMappingURL=measurement-tools.js.map

package/dist/tools/registrations/subject-specific-tools.js

@@ -156,4 +156,3 @@ export const periodicTableToolRegistration = {
         };
     },
 };
-//# sourceMappingURL=subject-specific-tools.js.map

package/dist/tools/registrations/toolbar-registration-helpers.js

@@ -22,4 +22,3 @@ export function syncButtonAndOverlayVisibility(args) {
 export function applyOverlaySurface(overlay, surface) {
     overlay.setAttribute("data-pie-tool-surface", surface);
 }
-//# sourceMappingURL=toolbar-registration-helpers.js.map

package/dist/tools/registrations/tts.js

@@ -182,4 +182,3 @@ export const ttsToolRegistration = {
         };
     },
 };
-//# sourceMappingURL=tts.js.map

package/dist/tools/response-discovery.js

@@ -111,4 +111,3 @@ export class ResponseDiscoveryServiceImpl {
  * Singleton instance
  */
 export const responseDiscovery = new ResponseDiscoveryServiceImpl();
-//# sourceMappingURL=response-discovery.js.map

package/dist/tools/tool-tag-map.js

@@ -34,4 +34,3 @@ export const toToolIdFromTag = (tagName, overrides) => {
     const map = { ...DEFAULT_TOOL_TAG_MAP, ...overrides?.toolTagMap };
     return Object.entries(map).find(([, tag]) => tag === validTag)?.[0];
 };
-//# sourceMappingURL=tool-tag-map.js.map

package/dist/tools/types.js

@@ -10,4 +10,3 @@ export var ToolCategory;
     ToolCategory["CONTENT_INTERACTIVE"] = "content-interactive";
     ToolCategory["SERVICE_DEPENDENT"] = "service-dependent";
 })(ToolCategory || (ToolCategory = {}));
-//# sourceMappingURL=types.js.map

package/dist/tools/variant-resolver.js

@@ -205,4 +205,3 @@ export class VariantResolverImpl {
             .replace(/\b\w/g, (char) => char.toUpperCase());
     }
 }
-//# sourceMappingURL=variant-resolver.js.map

package/dist/utils/logger.js

@@ -8,4 +8,3 @@ export function createLogger(namespace) {
         console.debug(`[${namespace}]`, ...args);
     };
 }
-//# sourceMappingURL=logger.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@pie-players/pie-assessment-toolkit",
-	"version": "0.3.60",
+	"version": "0.3.62",
 	"type": "module",
 	"description": "PIE assessment toolkit: composable services + reference implementation for assessment players and tool coordination",
 	"license": "MIT",
@@ -75,15 +75,15 @@
 		"test": "bun test"
 	},
 	"dependencies": {
-		"@pie-players/pie-calculator": "0.3.60",
-		"@pie-players/pie-context": "0.3.60",
-		"@pie-players/pie-players-shared": "0.3.60",
-		"@pie-players/pie-tts": "0.3.60",
-		"speech-rule-engine": "^5.0.0-rc.1"
+		"@pie-players/pie-calculator": "0.3.62",
+		"@pie-players/pie-context": "0.3.62",
+		"@pie-players/pie-players-shared": "0.3.62",
+		"@pie-players/pie-tts": "0.3.62",
+		"speech-rule-engine": "^5.0.0-rc.4"
 	},
 	"peerDependencies": {
-		"@pie-players/pie-calculator-desmos": "0.3.60",
-		"@pie-players/tts-client-server": "0.3.60"
+		"@pie-players/pie-calculator-desmos": "0.3.62",
+		"@pie-players/tts-client-server": "0.3.62"
 	},
 	"peerDependenciesMeta": {
 		"@pie-players/pie-calculator-desmos": {
@@ -94,9 +94,11 @@
 		}
 	},
 	"devDependencies": {
-		"@biomejs/biome": "^2.4.12",
-		"@happy-dom/global-registrator": "^20.9.0",
-		"svelte": "^5.54.0",
+		"@biomejs/biome": "^2.5.6",
+		"@happy-dom/global-registrator": "^20.11.1",
+		"@pie-players/pie-calculator-desmos": "0.3.62",
+		"@pie-players/tts-client-server": "0.3.62",
+		"svelte": "^5.56.8",
 		"typescript": "^5.9.3"
 	},
 	"homepage": "https://github.com/pie-framework/pie-players/tree/master/packages/assessment-toolkit#readme",

package/dist/attempt/AssessmentSession.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"AssessmentSession.js","sourceRoot":"","sources":["../../src/attempt/AssessmentSession.ts"],"names":[],"mappings":"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","sourcesContent":["import type { SectionControllerSessionState } from \"../services/section-controller-types.js\";\nimport type { StorageLike } from \"./TestSession.js\";\n\nexport interface AssessmentSessionNavigationState {\n\tcurrentSectionIndex: number;\n\tvisitedSectionIdentifiers: string[];\n\tcurrentSectionIdentifier?: string;\n}\n\nexport interface AssessmentSessionRealization {\n\tseed: string;\n\tsectionIdentifiers: string[];\n}\n\nexport interface AssessmentSectionSessionState {\n\tsectionIdentifier: string;\n\tupdatedAt: string;\n\tsession: SectionControllerSessionState | null;\n}\n\nexport interface AssessmentSession {\n\tversion: 1;\n\tassessmentAttemptSessionIdentifier: string;\n\tassessmentId: string;\n\tstartedAt: string;\n\tupdatedAt: string;\n\tcompletedAt?: string;\n\tnavigationState: AssessmentSessionNavigationState;\n\trealization: AssessmentSessionRealization;\n\tsectionSessions: Record<string, AssessmentSectionSessionState>;\n\tcontextVariables?: Record<string, unknown>;\n}\n\nconst ASSESSMENT_SESSION_VERSION = 1 as const;\nconst STORAGE_PREFIX = \"pie:assessment-session:v1:\";\n\nfunction nowIso(): string {\n\treturn new Date().toISOString();\n}\n\nexport function getAssessmentSessionStorageKey(\n\tassessmentAttemptSessionIdentifier: string,\n): string {\n\treturn `${STORAGE_PREFIX}${assessmentAttemptSessionIdentifier}`;\n}\n\nexport function loadAssessmentSession(\n\tstorage: StorageLike,\n\tassessmentAttemptSessionIdentifier: string,\n): AssessmentSession | null {\n\tconst raw = storage.getItem(\n\t\tgetAssessmentSessionStorageKey(assessmentAttemptSessionIdentifier),\n\t);\n\tif (!raw) return null;\n\ttry {\n\t\tconst parsed = JSON.parse(raw) as AssessmentSession;\n\t\tif (!parsed || parsed.version !== ASSESSMENT_SESSION_VERSION) return null;\n\t\tif (\n\t\t\tparsed.assessmentAttemptSessionIdentifier !==\n\t\t\tassessmentAttemptSessionIdentifier\n\t\t) {\n\t\t\treturn null;\n\t\t}\n\t\treturn parsed;\n\t} catch {\n\t\treturn null;\n\t}\n}\n\nexport function saveAssessmentSession(\n\tstorage: StorageLike,\n\tsession: AssessmentSession,\n): void {\n\tconst updated: AssessmentSession = {\n\t\t...session,\n\t\tupdatedAt: nowIso(),\n\t};\n\tstorage.setItem(\n\t\tgetAssessmentSessionStorageKey(session.assessmentAttemptSessionIdentifier),\n\t\tJSON.stringify(updated),\n\t);\n}\n\nexport function createNewAssessmentSession(args: {\n\tassessmentAttemptSessionIdentifier: string;\n\tassessmentId: string;\n\tseed: string;\n\tsectionIdentifiers: string[];\n}): AssessmentSession {\n\tconst startedAt = nowIso();\n\tconst initialSectionIdentifier = args.sectionIdentifiers[0];\n\treturn {\n\t\tversion: ASSESSMENT_SESSION_VERSION,\n\t\tassessmentAttemptSessionIdentifier: args.assessmentAttemptSessionIdentifier,\n\t\tassessmentId: args.assessmentId,\n\t\tstartedAt,\n\t\tupdatedAt: startedAt,\n\t\tnavigationState: {\n\t\t\tcurrentSectionIndex: 0,\n\t\t\tvisitedSectionIdentifiers: initialSectionIdentifier\n\t\t\t\t? [initialSectionIdentifier]\n\t\t\t\t: [],\n\t\t\tcurrentSectionIdentifier: initialSectionIdentifier,\n\t\t},\n\t\trealization: {\n\t\t\tseed: args.seed,\n\t\t\tsectionIdentifiers: args.sectionIdentifiers,\n\t\t},\n\t\tsectionSessions: {},\n\t};\n}\n\nexport function upsertSectionSession(\n\tsession: AssessmentSession,\n\targs: {\n\t\tsectionIdentifier: string;\n\t\tsectionSession: SectionControllerSessionState | null;\n\t},\n): AssessmentSession {\n\tif (!args.sectionIdentifier) return session;\n\tconst updatedAt = nowIso();\n\treturn {\n\t\t...session,\n\t\tupdatedAt,\n\t\tsectionSessions: {\n\t\t\t...session.sectionSessions,\n\t\t\t[args.sectionIdentifier]: {\n\t\t\t\tsectionIdentifier: args.sectionIdentifier,\n\t\t\t\tupdatedAt,\n\t\t\t\tsession: args.sectionSession,\n\t\t\t},\n\t\t},\n\t};\n}\n\nexport function setCurrentSectionPosition(\n\tsession: AssessmentSession,\n\targs: {\n\t\tcurrentSectionIndex: number;\n\t\tcurrentSectionIdentifier?: string;\n\t},\n): AssessmentSession {\n\tconst visited = new Set(\n\t\tsession.navigationState.visitedSectionIdentifiers || [],\n\t);\n\tif (args.currentSectionIdentifier) {\n\t\tvisited.add(args.currentSectionIdentifier);\n\t}\n\treturn {\n\t\t...session,\n\t\tnavigationState: {\n\t\t\t...session.navigationState,\n\t\t\tcurrentSectionIndex: args.currentSectionIndex,\n\t\t\tcurrentSectionIdentifier: args.currentSectionIdentifier,\n\t\t\tvisitedSectionIdentifiers: Array.from(visited),\n\t\t},\n\t};\n}\n"]}

package/dist/attempt/TestSession.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"TestSession.js","sourceRoot":"","sources":["../../src/attempt/TestSession.ts"],"names":[],"mappings":"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","sourcesContent":["export interface StorageLike {\n\tgetItem(key: string): string | null;\n\tsetItem(key: string, value: string): void;\n\tremoveItem(key: string): void;\n}\n\nexport interface TestAttemptSessionNavigationState {\n\tcurrentItemIndex: number;\n\tvisitedItemIdentifiers: string[];\n\tcurrentSectionIdentifier?: string;\n}\n\nexport interface TestAttemptSessionRealization {\n\t/**\n\t * Deterministic seed for shuffling/selection.\n\t * (Future: use for QTI ordering.shuffle / selection rules.)\n\t */\n\tseed: string;\n\t/**\n\t * Realized item order for this attempt (QTI item identifiers).\n\t */\n\titemIdentifiers: string[];\n}\n\nexport interface TestAttemptItemSession {\n\t/**\n\t * QTI assessmentItemRef identifier (same as questionRef.identifier).\n\t */\n\titemIdentifier: string;\n\n\t/**\n\t * PIE session id for the underlying item attempt (if/when created).\n\t */\n\tpieSessionId?: string;\n\n\tattemptCount: number;\n\tisCompleted: boolean;\n\n\tstartedAt?: string;\n\tupdatedAt?: string;\n\tcompletedAt?: string;\n\tsession?: unknown;\n}\n\nexport interface TestAttemptSession {\n\tversion: 1;\n\n\t/**\n\t * QTI-like identifier for the delivery attempt (administration).\n\t */\n\ttestAttemptSessionIdentifier: string;\n\n\tassessmentId: string;\n\n\tstartedAt: string;\n\tupdatedAt: string;\n\tcompletedAt?: string;\n\n\tnavigationState: TestAttemptSessionNavigationState;\n\trealization: TestAttemptSessionRealization;\n\n\t/**\n\t * Keyed by QTI item identifier (questionRef.identifier).\n\t */\n\titemSessions: Record<string, TestAttemptItemSession>;\n\n\t/**\n\t * QTI 3.0 context variables (global assessment-level variables).\n\t * Managed by ContextVariableStore.\n\t */\n\tcontextVariables?: Record<string, any>;\n}\n\nconst TEST_ATTEMPT_SESSION_VERSION = 1 as const;\nconst STORAGE_PREFIX = \"pieoneer:testAttemptSession:v1:\";\nconst ANON_DEVICE_ID_KEY = \"pieoneer:anonymousDeviceId:v1\";\n\nexport function createMemoryStorage(\n\tinitial: Record<string, string> = {},\n): StorageLike {\n\tconst store = new Map(Object.entries(initial));\n\treturn {\n\t\tgetItem: (k) => (store.has(k) ? (store.get(k) as string) : null),\n\t\tsetItem: (k, v) => {\n\t\t\tstore.set(k, v);\n\t\t},\n\t\tremoveItem: (k) => {\n\t\t\tstore.delete(k);\n\t\t},\n\t};\n}\n\nexport function getBrowserLocalStorage(): StorageLike | null {\n\ttry {\n\t\t// eslint-disable-next-line no-undef\n\t\tif (typeof window === \"undefined\") return null;\n\t\t// eslint-disable-next-line no-undef\n\t\tif (!window.localStorage) return null;\n\t\t// eslint-disable-next-line no-undef\n\t\treturn window.localStorage;\n\t} catch {\n\t\treturn null;\n\t}\n}\n\nfunction nowIso(): string {\n\treturn new Date().toISOString();\n}\n\n// Lightweight, deterministic hash for IDs (no crypto dependency).\nfunction fnv1a32Hex(input: string): string {\n\tlet hash = 0x811c9dc5; // offset basis\n\tfor (let i = 0; i < input.length; i++) {\n\t\thash ^= input.charCodeAt(i);\n\t\t// hash *= 16777619 (with 32-bit overflow)\n\t\thash =\n\t\t\t(hash +\n\t\t\t\t((hash << 1) +\n\t\t\t\t\t(hash << 4) +\n\t\t\t\t\t(hash << 7) +\n\t\t\t\t\t(hash << 8) +\n\t\t\t\t\t(hash << 24))) >>>\n\t\t\t0;\n\t}\n\treturn hash.toString(16).padStart(8, \"0\");\n}\n\nfunction randomId(): string {\n\tconst cryptoAny = (globalThis as any)?.crypto;\n\tconst uuid = cryptoAny?.randomUUID?.();\n\tif (typeof uuid === \"string\" && uuid.length > 0) {\n\t\treturn uuid;\n\t}\n\treturn `anon_${Math.random().toString(16).slice(2)}_${Date.now().toString(16)}`;\n}\n\nexport function getOrCreateAnonymousDeviceId(storage: StorageLike): string {\n\tconst existing = storage.getItem(ANON_DEVICE_ID_KEY);\n\tif (existing) return existing;\n\tconst created = randomId();\n\tstorage.setItem(ANON_DEVICE_ID_KEY, created);\n\treturn created;\n}\n\nexport function createTestAttemptSessionIdentifier(args: {\n\tassessmentId: string;\n\tassignmentId?: string | null;\n\tuserId?: string | null;\n\tstorage: StorageLike;\n}): { testAttemptSessionIdentifier: string; seed: string } {\n\tconst { assessmentId, assignmentId, userId, storage } = args;\n\tif (!assessmentId) {\n\t\tthrow new Error(\n\t\t\t\"assessmentId is required to create a TestSession identifier\",\n\t\t);\n\t}\n\n\tconst subject = userId || getOrCreateAnonymousDeviceId(storage);\n\tconst source = `v1|${assessmentId}|${assignmentId || \"\"}|${subject}`;\n\tconst seed = fnv1a32Hex(source);\n\treturn { testAttemptSessionIdentifier: `tas_v1_${seed}`, seed };\n}\n\nexport function getTestAttemptSessionStorageKey(\n\ttestAttemptSessionIdentifier: string,\n): string {\n\treturn `${STORAGE_PREFIX}${testAttemptSessionIdentifier}`;\n}\n\nexport function loadTestAttemptSession(\n\tstorage: StorageLike,\n\ttestAttemptSessionIdentifier: string,\n): TestAttemptSession | null {\n\tconst raw = storage.getItem(\n\t\tgetTestAttemptSessionStorageKey(testAttemptSessionIdentifier),\n\t);\n\tif (!raw) return null;\n\ttry {\n\t\tconst parsed = JSON.parse(raw) as TestAttemptSession;\n\t\tif (!parsed || parsed.version !== TEST_ATTEMPT_SESSION_VERSION) return null;\n\t\tif (parsed.testAttemptSessionIdentifier !== testAttemptSessionIdentifier) {\n\t\t\treturn null;\n\t\t}\n\t\treturn parsed;\n\t} catch {\n\t\treturn null;\n\t}\n}\n\nexport function saveTestAttemptSession(\n\tstorage: StorageLike,\n\tsession: TestAttemptSession,\n): void {\n\tconst updated: TestAttemptSession = {\n\t\t...session,\n\t\tupdatedAt: nowIso(),\n\t};\n\tstorage.setItem(\n\t\tgetTestAttemptSessionStorageKey(session.testAttemptSessionIdentifier),\n\t\tJSON.stringify(updated),\n\t);\n}\n\nexport function createNewTestAttemptSession(args: {\n\ttestAttemptSessionIdentifier: string;\n\tassessmentId: string;\n\tseed: string;\n\titemIdentifiers: string[];\n}): TestAttemptSession {\n\tconst startedAt = nowIso();\n\treturn {\n\t\tversion: TEST_ATTEMPT_SESSION_VERSION,\n\t\ttestAttemptSessionIdentifier: args.testAttemptSessionIdentifier,\n\t\tassessmentId: args.assessmentId,\n\t\tstartedAt,\n\t\tupdatedAt: startedAt,\n\t\tnavigationState: {\n\t\t\tcurrentItemIndex: -1,\n\t\t\tvisitedItemIdentifiers: [],\n\t\t},\n\t\trealization: {\n\t\t\tseed: args.seed,\n\t\t\titemIdentifiers: args.itemIdentifiers,\n\t\t},\n\t\titemSessions: {},\n\t};\n}\n\nexport function upsertVisitedItem(\n\tsession: TestAttemptSession,\n\titemIdentifier: string,\n): TestAttemptSession {\n\tif (!itemIdentifier) return session;\n\tconst visited = new Set(session.navigationState.visitedItemIdentifiers || []);\n\tvisited.add(itemIdentifier);\n\treturn {\n\t\t...session,\n\t\tnavigationState: {\n\t\t\t...session.navigationState,\n\t\t\tvisitedItemIdentifiers: Array.from(visited),\n\t\t},\n\t};\n}\n\nexport function setCurrentPosition(\n\tsession: TestAttemptSession,\n\targs: {\n\t\tcurrentItemIndex: number;\n\t\tcurrentSectionIdentifier?: string;\n\t},\n): TestAttemptSession {\n\treturn {\n\t\t...session,\n\t\tnavigationState: {\n\t\t\t...session.navigationState,\n\t\t\tcurrentItemIndex: args.currentItemIndex,\n\t\t\tcurrentSectionIdentifier: args.currentSectionIdentifier,\n\t\t},\n\t};\n}\n\nexport function upsertItemSessionFromPieSessionChange(\n\tsession: TestAttemptSession,\n\targs: {\n\t\titemIdentifier: string;\n\t\tpieSessionId: string;\n\t\tisCompleted?: boolean;\n\t\tsession?: unknown;\n\t},\n): TestAttemptSession {\n\tconst { itemIdentifier, pieSessionId, isCompleted } = args;\n\tif (!itemIdentifier || !pieSessionId) return session;\n\n\tconst now = nowIso();\n\tconst existing = session.itemSessions[itemIdentifier];\n\n\tconst attemptCount =\n\t\texisting && existing.pieSessionId && existing.pieSessionId !== pieSessionId\n\t\t\t? existing.attemptCount + 1\n\t\t\t: existing\n\t\t\t\t? existing.attemptCount\n\t\t\t\t: 1;\n\n\tconst completed = !!(isCompleted ?? existing?.isCompleted);\n\n\tconst next: TestAttemptItemSession = {\n\t\titemIdentifier,\n\t\tpieSessionId,\n\t\tattemptCount,\n\t\tisCompleted: completed,\n\t\tstartedAt: existing?.startedAt || now,\n\t\tupdatedAt: now,\n\t\tcompletedAt: completed ? existing?.completedAt || now : undefined,\n\t\tsession: args.session ?? existing?.session,\n\t};\n\n\treturn {\n\t\t...session,\n\t\titemSessions: {\n\t\t\t...session.itemSessions,\n\t\t\t[itemIdentifier]: next,\n\t\t},\n\t};\n}\n"]}

package/dist/attempt/adapters/activity-to-test-attempt-session.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"activity-to-test-attempt-session.js","sourceRoot":"","sources":["../../../src/attempt/adapters/activity-to-test-attempt-session.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n\tTestAttemptItemSession,\n\tTestAttemptSession,\n} from \"../TestSession.js\";\n\nexport interface PieBackendActivityItemRef {\n\tidentifier?: string;\n\titem?: {\n\t\tid?: string;\n\t\tidentifier?: string;\n\t};\n}\n\nexport interface PieBackendActivityDefinition {\n\tid?: string;\n\tidentifier?: string;\n\tassessmentId?: string;\n\tassessmentItemRefs?: PieBackendActivityItemRef[];\n}\n\nexport interface PieBackendActivitySession {\n\tid?: string;\n\tactivitySessionId?: string;\n\tstartedAt?: string;\n\tupdatedAt?: string;\n\tcompletedAt?: string;\n\tcurrentItemIndex?: number;\n\tcurrentSectionIdentifier?: string;\n\tvisitedItemIdentifiers?: string[];\n\titemSessions?: Record<string, unknown>;\n}\n\nexport interface MapActivityToTestAttemptSessionArgs {\n\tactivityDefinition?: PieBackendActivityDefinition | null;\n\tactivitySession?: PieBackendActivitySession | null;\n\titemRefs?: PieBackendActivityItemRef[];\n\titemSessionsByItemIdentifier?: Record<string, unknown>;\n\tassessmentId?: string;\n\ttestAttemptSessionIdentifier?: string;\n}\n\nexport interface ActivitySessionPatchPayload {\n\tactivitySession: {\n\t\tid: string;\n\t\tstartedAt?: string;\n\t\tupdatedAt?: string;\n\t\tcompletedAt?: string;\n\t\tcurrentItemIndex: number;\n\t\tcurrentSectionIdentifier?: string;\n\t\tvisitedItemIdentifiers: string[];\n\t\titemSessions: Record<string, unknown>;\n\t};\n}\n\nfunction nowIso(): string {\n\treturn new Date().toISOString();\n}\n\nfunction getItemIdentifier(itemRef: PieBackendActivityItemRef): string | null {\n\treturn (\n\t\titemRef.identifier || itemRef.item?.identifier || itemRef.item?.id || null\n\t);\n}\n\nfunction resolveItemIdentifiers(\n\targs: MapActivityToTestAttemptSessionArgs,\n): string[] {\n\tconst refs =\n\t\targs.itemRefs || args.activityDefinition?.assessmentItemRefs || [];\n\tconst identifiers = refs\n\t\t.map((itemRef) => getItemIdentifier(itemRef))\n\t\t.filter((itemIdentifier): itemIdentifier is string => !!itemIdentifier);\n\treturn Array.from(new Set(identifiers));\n}\n\nfunction resolveAssessmentId(\n\targs: MapActivityToTestAttemptSessionArgs,\n): string {\n\treturn (\n\t\targs.assessmentId ||\n\t\targs.activityDefinition?.assessmentId ||\n\t\targs.activityDefinition?.identifier ||\n\t\targs.activityDefinition?.id ||\n\t\t\"unknown-assessment\"\n\t);\n}\n\nfunction resolveTestAttemptSessionIdentifier(\n\targs: MapActivityToTestAttemptSessionArgs,\n\tassessmentId: string,\n): string {\n\treturn (\n\t\targs.testAttemptSessionIdentifier ||\n\t\targs.activitySession?.activitySessionId ||\n\t\targs.activitySession?.id ||\n\t\t`tas_${assessmentId}`\n\t);\n}\n\nfunction resolveBackendItemSessions(\n\targs: MapActivityToTestAttemptSessionArgs,\n): Record<string, unknown> {\n\treturn {\n\t\t...(args.activitySession?.itemSessions || {}),\n\t\t...(args.itemSessionsByItemIdentifier || {}),\n\t};\n}\n\nfunction mapItemSessions(\n\titemIdentifiers: string[],\n\tbackendItemSessions: Record<string, unknown>,\n): Record<string, TestAttemptItemSession> {\n\treturn itemIdentifiers.reduce<Record<string, TestAttemptItemSession>>(\n\t\t(acc, itemIdentifier) => {\n\t\t\tconst rawSession = backendItemSessions[itemIdentifier] as\n\t\t\t\t| Record<string, unknown>\n\t\t\t\t| undefined;\n\t\t\tif (!rawSession) return acc;\n\n\t\t\tconst pieSessionId =\n\t\t\t\ttypeof rawSession.id === \"string\" ? rawSession.id : undefined;\n\t\t\tconst attemptCount =\n\t\t\t\ttypeof rawSession.attemptCount === \"number\" &&\n\t\t\t\trawSession.attemptCount > 0\n\t\t\t\t\t? rawSession.attemptCount\n\t\t\t\t\t: pieSessionId\n\t\t\t\t\t\t? 1\n\t\t\t\t\t\t: 0;\n\t\t\tconst isCompleted =\n\t\t\t\ttypeof rawSession.isCompleted === \"boolean\"\n\t\t\t\t\t? rawSession.isCompleted\n\t\t\t\t\t: Boolean(rawSession.complete);\n\t\t\tconst startedAt =\n\t\t\t\ttypeof rawSession.startedAt === \"string\"\n\t\t\t\t\t? rawSession.startedAt\n\t\t\t\t\t: undefined;\n\t\t\tconst updatedAt =\n\t\t\t\ttypeof rawSession.updatedAt === \"string\"\n\t\t\t\t\t? rawSession.updatedAt\n\t\t\t\t\t: undefined;\n\t\t\tconst completedAt =\n\t\t\t\ttypeof rawSession.completedAt === \"string\"\n\t\t\t\t\t? rawSession.completedAt\n\t\t\t\t\t: undefined;\n\n\t\t\tacc[itemIdentifier] = {\n\t\t\t\titemIdentifier,\n\t\t\t\tpieSessionId,\n\t\t\t\tattemptCount,\n\t\t\t\tisCompleted,\n\t\t\t\tstartedAt,\n\t\t\t\tupdatedAt,\n\t\t\t\tcompletedAt,\n\t\t\t\tsession: rawSession,\n\t\t\t};\n\t\t\treturn acc;\n\t\t},\n\t\t{},\n\t);\n}\n\nexport function mapActivityToTestAttemptSession(\n\targs: MapActivityToTestAttemptSessionArgs,\n): TestAttemptSession {\n\tconst assessmentId = resolveAssessmentId(args);\n\tconst itemIdentifiers = resolveItemIdentifiers(args);\n\tconst testAttemptSessionIdentifier = resolveTestAttemptSessionIdentifier(\n\t\targs,\n\t\tassessmentId,\n\t);\n\tconst backendItemSessions = resolveBackendItemSessions(args);\n\tconst now = nowIso();\n\tconst startedAt = args.activitySession?.startedAt || now;\n\tconst updatedAt = args.activitySession?.updatedAt || startedAt;\n\n\treturn {\n\t\tversion: 1,\n\t\ttestAttemptSessionIdentifier,\n\t\tassessmentId,\n\t\tstartedAt,\n\t\tupdatedAt,\n\t\tcompletedAt: args.activitySession?.completedAt,\n\t\tnavigationState: {\n\t\t\tcurrentItemIndex: args.activitySession?.currentItemIndex ?? -1,\n\t\t\tvisitedItemIdentifiers: [\n\t\t\t\t...(args.activitySession?.visitedItemIdentifiers || []),\n\t\t\t],\n\t\t\tcurrentSectionIdentifier: args.activitySession?.currentSectionIdentifier,\n\t\t},\n\t\trealization: {\n\t\t\tseed: testAttemptSessionIdentifier,\n\t\t\titemIdentifiers,\n\t\t},\n\t\titemSessions: mapItemSessions(itemIdentifiers, backendItemSessions),\n\t};\n}\n\nexport function toItemSessionsRecord(\n\ttestAttemptSession: TestAttemptSession,\n): Record<string, unknown> {\n\treturn Object.entries(testAttemptSession.itemSessions).reduce<\n\t\tRecord<string, unknown>\n\t>((acc, [itemIdentifier, itemSession]) => {\n\t\tif (itemSession.session) {\n\t\t\tacc[itemIdentifier] = itemSession.session;\n\t\t}\n\t\treturn acc;\n\t}, {});\n}\n\nexport function buildActivitySessionPatchFromTestAttemptSession(\n\ttestAttemptSession: TestAttemptSession,\n): ActivitySessionPatchPayload {\n\treturn {\n\t\tactivitySession: {\n\t\t\tid: testAttemptSession.testAttemptSessionIdentifier,\n\t\t\tstartedAt: testAttemptSession.startedAt,\n\t\t\tupdatedAt: testAttemptSession.updatedAt,\n\t\t\tcompletedAt: testAttemptSession.completedAt,\n\t\t\tcurrentItemIndex: testAttemptSession.navigationState.currentItemIndex,\n\t\t\tcurrentSectionIdentifier:\n\t\t\t\ttestAttemptSession.navigationState.currentSectionIdentifier,\n\t\t\tvisitedItemIdentifiers: [\n\t\t\t\t...testAttemptSession.navigationState.visitedItemIdentifiers,\n\t\t\t],\n\t\t\titemSessions: toItemSessionsRecord(testAttemptSession),\n\t\t},\n\t};\n}\n\nexport function buildActivitySessionItemUpdate(\n\ttestAttemptSession: TestAttemptSession,\n\titemIdentifier: string,\n): ActivitySessionPatchPayload {\n\tconst itemSession = testAttemptSession.itemSessions[itemIdentifier];\n\treturn {\n\t\tactivitySession: {\n\t\t\tid: testAttemptSession.testAttemptSessionIdentifier,\n\t\t\tcurrentItemIndex: testAttemptSession.navigationState.currentItemIndex,\n\t\t\tcurrentSectionIdentifier:\n\t\t\t\ttestAttemptSession.navigationState.currentSectionIdentifier,\n\t\t\tvisitedItemIdentifiers: [\n\t\t\t\t...testAttemptSession.navigationState.visitedItemIdentifiers,\n\t\t\t],\n\t\t\titemSessions: itemSession?.session\n\t\t\t\t? { [itemIdentifier]: itemSession.session }\n\t\t\t\t: {},\n\t\t},\n\t};\n}\n"]}

package/dist/components/item-toolbar-element.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"item-toolbar-element.js","sourceRoot":"","sources":["../../src/components/item-toolbar-element.ts"],"names":[],"mappings":"AAAA,OAAO,iCAAiC,CAAC","sourcesContent":["import \"./ItemToolBar.custom-element.js\";\n\nexport {};\n"]}

package/dist/components/pie-assessment-toolkit-element.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"pie-assessment-toolkit-element.js","sourceRoot":"","sources":["../../src/components/pie-assessment-toolkit-element.ts"],"names":[],"mappings":"AAAA,OAAO,0CAA0C,CAAC","sourcesContent":["import \"./PieAssessmentToolkit.custom-element.js\";\n\nexport {};\n"]}

package/dist/components/section-toolbar-element.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"section-toolbar-element.js","sourceRoot":"","sources":["../../src/components/section-toolbar-element.ts"],"names":[],"mappings":"AAAA,OAAO,oCAAoC,CAAC","sourcesContent":["import \"./SectionToolBar.custom-element.js\";\n\nexport {};\n"]}

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

@@ -1 +0,0 @@
-{"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;AA4CzD,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;AAOH,MAAM,CAAC,MAAM,mCAAmC,GAC/C,aAAa,CACZ,MAAM,CAAC,GAAG,CAAC,0CAA0C,CAAC,CACtD,CAAC","sourcesContent":["import { createContext } from \"@pie-players/pie-context\";\nimport type { LoaderConfig } from \"@pie-players/pie-players-shared/loader-config\";\nimport type {\n\tAccessibilityCatalogResolverApi,\n\tElementToolStateStoreApi,\n\tHighlightCoordinatorApi,\n\tToolCoordinatorApi,\n\tToolkitCoordinatorApi,\n\tTtsServiceApi,\n} from \"../services/interfaces.js\";\nimport type { TTSHighlightTargetResolver } from \"../services/tts/highlight-target-resolver.js\";\n\nexport type ItemPlayerType = \"iife\" | \"esm\" | \"preloaded\" | \"custom\";\n\nexport interface ItemPlayerConfig {\n\ttype: ItemPlayerType;\n\ttagName: string;\n\tversion?: string;\n\tsource?: string;\n\tloaderConfig?: LoaderConfig;\n\tloaderOptions?: Record<string, unknown>;\n\tisDefault: boolean;\n}\n\nexport interface AssessmentToolkitRuntimeContext {\n\ttoolkitCoordinator: ToolkitCoordinatorApi;\n\ttoolCoordinator: ToolCoordinatorApi;\n\tttsService: TtsServiceApi;\n\thighlightCoordinator: HighlightCoordinatorApi;\n\tcatalogResolver: AccessibilityCatalogResolverApi;\n\telementToolStateStore: ElementToolStateStoreApi;\n\tassessmentId: string;\n\tsectionId: string;\n\titemPlayer: ItemPlayerConfig;\n\t/**\n\t * Opt-in flag: context consumers render the vendored `<nds-icon-button>`\n\t * only when this is `true`; otherwise (unset/`false`, the default) they\n\t * render plain `<button>` controls. Sourced from the host's\n\t * `runtime.ndsIcons` (or the `nds-icons` attribute on the toolkit).\n\t */\n\tndsIcons?: boolean;\n\treportSessionChanged?: (itemId: string, detail: unknown) => void;\n}\n\nexport const assessmentToolkitRuntimeContext =\n\tcreateContext<AssessmentToolkitRuntimeContext>(\n\t\tSymbol.for(\"pie.assessmentToolkit.runtimeContext\"),\n\t);\n\nexport interface AssessmentToolkitHostRuntimeContext {\n\truntimeId: string;\n\tcoordinator: ToolkitCoordinatorApi;\n}\n\nexport const assessmentToolkitHostRuntimeContext =\n\tcreateContext<AssessmentToolkitHostRuntimeContext>(\n\t\tSymbol.for(\"pie.assessmentToolkit.hostRuntimeContext\"),\n\t);\n\nexport type ShellContextKind = \"item\" | \"passage\";\n\nexport interface AssessmentToolkitShellContext {\n\tkind: ShellContextKind;\n\titemId: string;\n\tcanonicalItemId: string;\n\tcontentKind: string;\n\tregionPolicy: string;\n\tscopeElement: HTMLElement | null;\n\titem: unknown;\n\tcontextVersion: number;\n}\n\nexport const assessmentToolkitShellContext =\n\tcreateContext<AssessmentToolkitShellContext>(\n\t\tSymbol.for(\"pie.assessmentToolkit.shellContext\"),\n\t);\n\nexport interface AssessmentToolkitRegionScopeContext {\n\tscopeElement: HTMLElement | null;\n\tttsHighlightTargetResolver?: TTSHighlightTargetResolver | null;\n}\n\nexport const assessmentToolkitRegionScopeContext =\n\tcreateContext<AssessmentToolkitRegionScopeContext>(\n\t\tSymbol.for(\"pie.assessmentToolkit.regionScopeContext\"),\n\t);\n"]}

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

@@ -1 +0,0 @@
-{"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","sourcesContent":["import { ContextConsumer } from \"@pie-players/pie-context\";\nimport type { UnknownContext } from \"@pie-players/pie-context\";\nimport {\n\tassessmentToolkitHostRuntimeContext,\n\tassessmentToolkitRegionScopeContext,\n\tassessmentToolkitShellContext,\n\tassessmentToolkitRuntimeContext,\n\ttype AssessmentToolkitHostRuntimeContext,\n\ttype AssessmentToolkitRegionScopeContext,\n\ttype AssessmentToolkitShellContext,\n\ttype AssessmentToolkitRuntimeContext,\n} from \"./assessment-toolkit-context.js\";\n\nexport type RuntimeContextListener = (\n\tvalue: AssessmentToolkitRuntimeContext,\n) => void;\nexport type HostRuntimeContextListener = (\n\tvalue: AssessmentToolkitHostRuntimeContext,\n) => void;\nexport type ShellContextListener = (\n\tvalue: AssessmentToolkitShellContext,\n) => void;\nexport type RegionScopeContextListener = (\n\tvalue: AssessmentToolkitRegionScopeContext,\n) => void;\n\ntype ContextProviderLikeEvent = Event & {\n\tcontext?: unknown;\n};\n\nfunction connectConsumerWithProviderRetry<T extends UnknownContext>(\n\thost: HTMLElement,\n\tcontext: T,\n\tonValue: (value: unknown) => void,\n): () => void {\n\tlet hasValue = false;\n\tconst consumer = new ContextConsumer(host, {\n\t\tcontext,\n\t\tsubscribe: true,\n\t\tonValue: (value) => {\n\t\t\thasValue = true;\n\t\t\tonValue(value);\n\t\t},\n\t});\n\tconsumer.connect();\n\n\tconst onContextProvider = (event: ContextProviderLikeEvent) => {\n\t\tif (event.context !== context) return;\n\t\tconsumer.requestValue();\n\t};\n\thost.addEventListener(\"context-provider\", onContextProvider);\n\n\tlet attempts = 0;\n\tconst maxAttempts = 200;\n\tconst retryTimer = globalThis.setInterval(() => {\n\t\tif (hasValue || attempts >= maxAttempts) {\n\t\t\tglobalThis.clearInterval(retryTimer);\n\t\t\treturn;\n\t\t}\n\t\tattempts += 1;\n\t\tconsumer.requestValue();\n\t}, 50);\n\n\treturn () => {\n\t\tglobalThis.clearInterval(retryTimer);\n\t\thost.removeEventListener(\"context-provider\", onContextProvider);\n\t\tconsumer.disconnect();\n\t};\n}\n\n/**\n * Connect a DOM host element to the shared assessment toolkit runtime context.\n * Returns a cleanup function that disconnects the underlying consumer.\n */\nexport function connectAssessmentToolkitRuntimeContext(\n\thost: HTMLElement,\n\tonValue: RuntimeContextListener,\n): () => void {\n\treturn connectConsumerWithProviderRetry(\n\t\thost,\n\t\tassessmentToolkitRuntimeContext,\n\t\tonValue as (value: unknown) => void,\n\t);\n}\n\nexport function connectAssessmentToolkitHostRuntimeContext(\n\thost: HTMLElement,\n\tonValue: HostRuntimeContextListener,\n): () => void {\n\treturn connectConsumerWithProviderRetry(\n\t\thost,\n\t\tassessmentToolkitHostRuntimeContext,\n\t\tonValue as (value: unknown) => void,\n\t);\n}\n\nexport function connectAssessmentToolkitShellContext(\n\thost: HTMLElement,\n\tonValue: ShellContextListener,\n): () => void {\n\treturn connectConsumerWithProviderRetry(\n\t\thost,\n\t\tassessmentToolkitShellContext,\n\t\tonValue as (value: unknown) => void,\n\t);\n}\n\nexport function connectAssessmentToolkitRegionScopeContext(\n\thost: HTMLElement,\n\tonValue: RegionScopeContextListener,\n): () => void {\n\treturn connectConsumerWithProviderRetry(\n\t\thost,\n\t\tassessmentToolkitRegionScopeContext,\n\t\tonValue as (value: unknown) => void,\n\t);\n}\n"]}

package/dist/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * PIE Assessment Toolkit\n *\n * Independent, composable services for coordinating tools, accommodations,\n * and item players in assessment applications.\n *\n * @packageDocumentation\n */\n\n// ============================================================================\n// Core Infrastructure\n// ============================================================================\n\nexport type {\n\tAssessmentToolkitHostRuntimeContext,\n\tAssessmentToolkitRegionScopeContext,\n\tAssessmentToolkitRuntimeContext,\n\tAssessmentToolkitShellContext,\n\tItemPlayerConfig,\n\tItemPlayerType,\n\tShellContextKind,\n} from \"./context/assessment-toolkit-context.js\";\nexport type {\n\tTTSHighlightContext,\n\tTTSHighlightTargetResolver,\n\tTTSHighlightTargetResolverProvider,\n\tTTSHighlightTargetResolverRuntime,\n} from \"./services/tts/highlight-target-resolver.js\";\nexport {\n\tassessmentToolkitHostRuntimeContext,\n\tassessmentToolkitRegionScopeContext,\n\tassessmentToolkitRuntimeContext,\n\tassessmentToolkitShellContext,\n} from \"./context/assessment-toolkit-context.js\";\nexport {\n\tconnectAssessmentToolkitHostRuntimeContext,\n\tconnectAssessmentToolkitRegionScopeContext,\n\tconnectAssessmentToolkitRuntimeContext,\n\tconnectAssessmentToolkitShellContext,\n} from \"./context/runtime-context-consumer.js\";\nexport {\n\tPIE_INTERNAL_CONTENT_LOADED_EVENT,\n\tPIE_INTERNAL_ITEM_SESSION_CHANGED_EVENT,\n\tPIE_INTERNAL_ITEM_PLAYER_ERROR_EVENT,\n\tPIE_ITEM_SESSION_CHANGED_EVENT,\n\tPIE_REGISTER_EVENT,\n\tPIE_UNREGISTER_EVENT,\n\ttype InternalContentLoadedDetail,\n\ttype InternalItemSessionChangedDetail,\n\ttype InternalItemPlayerErrorDetail,\n\ttype ItemSessionChangedDetail,\n\ttype RuntimeRegistrationDetail,\n\ttype RuntimeRegistrationKind,\n} from \"./runtime/registration-events.js\";\nexport {\n\tconnectToolRegionScopeContext,\n\tconnectToolRuntimeContext,\n\tconnectToolShellContext,\n\tcreateCrossBoundaryEvent,\n\tdispatchCrossBoundaryEvent,\n\tisContextValueDefined,\n} from \"./runtime/tool-host-contract.js\";\n\n// ============================================================================\n// Service Interfaces\n// ============================================================================\n\nexport type {\n\tAccessibilityCatalogResolverApi,\n\tElementToolStateStoreApi,\n\tHighlightCoordinatorApi,\n\tI18nServiceApi,\n\tThemeProviderApi,\n\tToolCoordinatorApi,\n\tToolkitCoordinatorApi,\n\tTtsServiceApi,\n\tToolState,\n} from \"./services/interfaces.js\";\n\n// ============================================================================\n// Toolkit Services\n// ============================================================================\n\n// Accessibility Catalog Resolver (QTI 3.0 Accessibility Catalogs)\nexport type {\n\tCatalogLookupContext,\n\tCatalogLookupOptions,\n\tCatalogOwnerContext,\n\tCatalogOwnerKind,\n\tCatalogStatistics,\n\tCatalogType,\n\tResolvedCatalog,\n} from \"./services/AccessibilityCatalogResolver.js\";\nexport { AccessibilityCatalogResolver } from \"./services/AccessibilityCatalogResolver.js\";\n// Context Variable Store (QTI 3.0 Context Declarations)\nexport { ContextVariableStore } from \"./services/ContextVariableStore.js\";\n// Element Tool State Store (Element-level ephemeral tool state)\nexport { ElementToolStateStore } from \"./services/ElementToolStateStore.js\";\n// Highlight Coordinator\nexport type { Annotation } from \"./services/HighlightCoordinator.js\";\nexport {\n\tHighlightColor,\n\tHighlightCoordinator,\n\tHighlightType,\n} from \"./services/HighlightCoordinator.js\";\n// Range Serializer (for annotation persistence)\nexport type { SerializedRange } from \"./services/RangeSerializer.js\";\nexport { RangeSerializer } from \"./services/RangeSerializer.js\";\n// I18n Service\nexport type {\n\tI18nConfig,\n\tPluralTranslation,\n\tTranslationBundle,\n} from \"./services/I18nService.js\";\nexport { I18nService } from \"./services/I18nService.js\";\n// Tool Registry (Registry-based tool system)\nexport type {\n\tResolvedToolContext,\n\tToolbarContext,\n\tToolContextResolver,\n\tToolContextResolverContext,\n\tToolContextResolverMap,\n\tToolContextResolverResult,\n\tToolModuleLoader,\n\tToolToolbarButtonDefinition,\n\tToolToolbarRenderResult,\n\tToolWindowShellAction,\n\tToolWindowShellAlign,\n\tToolWindowShellConfig,\n\tToolWindowShellContentConfig,\n\tToolRegistration,\n} from \"./services/ToolRegistry.js\";\nexport { ToolRegistry } from \"./services/ToolRegistry.js\";\nexport type {\n\tAssessmentToolContext,\n\tBaseToolContext,\n\tElementToolContext,\n\tItemToolContext,\n\tPassageToolContext,\n\tRubricToolContext,\n\tSectionToolContext,\n\tToolContext,\n\tToolLevel,\n} from \"./services/tool-context.js\";\nexport {\n\textractTextContent,\n\thasChoiceInteraction,\n\thasMathContent,\n\thasReadableText,\n\tisAssessmentContext,\n\tisElementContext,\n\tisItemContext,\n\tisPassageContext,\n\tisRubricContext,\n\tisSectionContext,\n} from \"./services/tool-context.js\";\nexport {\n\tDEFAULT_TOOL_PLACEMENT,\n\tDEFAULT_TOOL_ORDER,\n\tcreatePackagedToolRegistry,\n\tPACKAGED_TOOL_PLACEMENT,\n\tregisterPackagedTools,\n\tSECTION_PLAYER_PREFERRED_TOOL_PLACEMENT,\n} from \"./services/createDefaultToolRegistry.js\";\nexport type { CreateToolsConfigArgs } from \"./services/create-tools-config.js\";\nexport { createToolsConfig } from \"./services/create-tools-config.js\";\nexport {\n\tDEFAULT_PERSONAL_NEEDS_PROFILE,\n\tcreateDefaultPersonalNeedsProfile,\n} from \"./services/defaultPersonalNeedsProfile.js\";\nexport type {\n\tToolComponentFactory,\n\tToolComponentFactoryMap,\n\tToolComponentOverrides,\n\tToolTagMap,\n} from \"./tools/tool-tag-map.js\";\nexport {\n\tcreateToolElement,\n\tDEFAULT_TOOL_TAG_MAP,\n\tresolveToolTag,\n\ttoToolIdFromTag,\n} from \"./tools/tool-tag-map.js\";\n// QTI 3.0 Standard Access Features\nexport {\n\tALL_STANDARD_ACCESS_FEATURES,\n\tEXAMPLE_PNP_CONFIGURATIONS,\n\tgetFeatureCategory,\n\tgetFeaturesInCategory,\n\tisStandardAccessFeature,\n\tQTI_STANDARD_ACCESS_FEATURES,\n} from \"./services/pnp-standard-features.js\";\n// SSML Extractor (Auto-generates catalogs from embedded SSML)\nexport type { ExtractionResult } from \"./services/SSMLExtractor.js\";\nexport { SSMLExtractor } from \"./services/SSMLExtractor.js\";\n// Theme Provider\nexport type { FontSize, ThemeConfig } from \"./services/ThemeProvider.js\";\nexport { ThemeProvider } from \"./services/ThemeProvider.js\";\n// Tool Coordinator\nexport { ToolCoordinator, ZIndexLayer } from \"./services/ToolCoordinator.js\";\n// Toolkit Coordinator (Centralized service management)\nexport type {\n\tAnswerEliminatorToolConfig,\n\tProviderLifecycleContext,\n\tSectionControllerContext,\n\tSectionControllerEvent,\n\tSectionControllerEventType,\n\tSectionItemEvent,\n\tSectionItemEventType,\n\tSectionControllerFactoryDefaults,\n\tSectionControllerHandle,\n\tSectionControllerKey,\n\tSectionScopedEvent,\n\tSectionScopedEventType,\n\tSectionSessionPersistenceConfig,\n\tSectionItemEventSubscriptionArgs,\n\tSectionScopedEventSubscriptionArgs,\n\tSectionEventSubscriptionArgs,\n\tSectionSessionPersistenceStrategy,\n\tSectionControllerLoadedRenderable,\n\tSectionControllerRuntimeState,\n\tSectionControllerSessionState,\n\tSectionPersistenceFactoryDefaults,\n\tToolConfig,\n\tToolkitCoordinatorConfig,\n\tToolkitCoordinatorHooks,\n\tToolkitErrorContext,\n\tToolkitInitStatus,\n\tToolkitServiceBundle,\n\tToolkitToolsConfig,\n\tTTSToolConfig,\n} from \"./services/ToolkitCoordinator.js\";\nexport { ToolkitCoordinator } from \"./services/ToolkitCoordinator.js\";\nexport type {\n\tCanonicalToolsConfig,\n\tToolPlacementConfig,\n\tToolPlacementLevel,\n\tToolPolicyConfig,\n\tToolProvidersConfig,\n} from \"./services/tools-config-normalizer.js\";\nexport type {\n\tFrameworkErrorKind,\n\tFrameworkErrorModel,\n\tFrameworkErrorSeverity,\n} from \"./services/framework-error.js\";\nexport {\n\tformatFrameworkErrorForConsole,\n\tframeworkErrorFromToolConfigDiagnostics,\n\tframeworkErrorFromUnknown,\n\ttoFrameworkErrorModel,\n} from \"./services/framework-error.js\";\nexport type { FrameworkErrorListener } from \"./services/framework-error-bus.js\";\nexport type {\n\tToolConfigDiagnostic,\n\tToolConfigDiagnosticSeverity,\n\tToolConfigStrictness,\n\tToolConfigValidationOptions,\n\tToolConfigValidationResult,\n} from \"./services/tool-config-validation.js\";\nexport type {\n\tToolbarButtonItem,\n\tToolbarItem,\n\tToolbarItemBase,\n\tToolbarLinkItem,\n} from \"./services/toolbar-items.js\";\nexport {\n\tisExternalIconUrl,\n\tisInlineSvgIcon,\n\tisToolbarLinkItem,\n\tisValidToolbarItemShape,\n} from \"./services/toolbar-items.js\";\nexport {\n\tnormalizeToolsConfig,\n\tnormalizeToolAlias,\n\tnormalizeToolList,\n\tparseToolList,\n} from \"./services/tools-config-normalizer.js\";\nexport {\n\tframeworkErrorFromToolConfigValidation,\n\tnormalizeAndValidateToolsConfig,\n} from \"./services/tool-config-validation.js\";\nexport type {\n\tParsedToolInstanceId,\n\tToolScopeLevel,\n} from \"./services/tool-instance-id.js\";\nexport {\n\tcreateScopedToolId,\n\tparseScopedToolId,\n\ttoOverlayToolId,\n} from \"./services/tool-instance-id.js\";\n// Text-to-Speech Service\nexport type { TTSConfig } from \"./services/TTSService.js\";\nexport { PlaybackState, TTSService } from \"./services/TTSService.js\";\nexport {\n\tPIE_TTS_CONTROL_HANDOFF_EVENT,\n\ttype TTSControlHandoffDetail,\n} from \"./services/tts-control-events.js\";\nexport { BrowserTTSProvider } from \"./services/tts/browser-provider.js\";\nexport type { SREMathSpeechOptions } from \"./services/tts/math-speech.js\";\nexport type {\n\tNormalizedTTSSpeedOption,\n\tTTSHostToolbarLayout,\n\tTTSLayoutMode,\n\tTTSRuntimeSettings,\n\tTTSSpeedOption,\n\tTTSSpeedOptionConfig,\n} from \"./services/tts-runtime-config.js\";\nexport {\n\tDEFAULT_TTS_SPEED_OPTIONS,\n\tformatTTSSpeedOptionsAsText,\n\tnormalizeTTSLayoutMode,\n\tnormalizeTTSSpeedControlOptions,\n\tnormalizeTTSSpeedOptionConfigs,\n\tnormalizeTTSSpeedOptions,\n\tparseTTSSpeedOptionsFromText,\n\tresolveTTSHostToolbarLayout,\n\tresolveTTSLayoutMode,\n\tresolveTTSRuntimeSettings,\n} from \"./services/tts-runtime-config.js\";\n// TTS Provider System\nexport type {\n\tITTSProvider,\n\tITTSProviderImplementation,\n\tTTSSpeechSegment,\n\tTTSFeature,\n\tTTSProviderCapabilities,\n} from \"@pie-players/pie-tts\";\n\n// ============================================================================\n// Item loading (client-resolvable default; optional backend hook)\n// ============================================================================\n\nexport type {\n\tCreateLoadItemOptions,\n\tLoadItem,\n\tLoadItemOptions,\n} from \"./item-loader.js\";\nexport {\n\tcreateFetchItemLoader,\n\tcreateLoadItem,\n\tItemLoadError,\n} from \"./item-loader.js\";\n\n// ============================================================================\n// Attempt Session\n// ============================================================================\n\nexport type {\n\tStorageLike,\n\tTestAttemptItemSession,\n\tTestAttemptSession,\n\tTestAttemptSessionNavigationState,\n\tTestAttemptSessionRealization,\n} from \"./attempt/TestSession.js\";\nexport {\n\tcreateMemoryStorage,\n\tcreateTestAttemptSessionIdentifier,\n\tcreateNewTestAttemptSession,\n\tgetBrowserLocalStorage,\n\tgetOrCreateAnonymousDeviceId,\n\tgetTestAttemptSessionStorageKey,\n\tloadTestAttemptSession,\n\tsaveTestAttemptSession,\n\tsetCurrentPosition,\n\tupsertItemSessionFromPieSessionChange,\n\tupsertVisitedItem,\n} from \"./attempt/TestSession.js\";\nexport type {\n\tAssessmentSession,\n\tAssessmentSectionSessionState,\n\tAssessmentSessionNavigationState,\n\tAssessmentSessionRealization,\n} from \"./attempt/AssessmentSession.js\";\nexport {\n\tcreateNewAssessmentSession,\n\tgetAssessmentSessionStorageKey,\n\tloadAssessmentSession,\n\tsaveAssessmentSession,\n\tsetCurrentSectionPosition,\n\tupsertSectionSession,\n} from \"./attempt/AssessmentSession.js\";\nexport type {\n\tActivitySessionPatchPayload,\n\tMapActivityToTestAttemptSessionArgs,\n\tPieBackendActivityDefinition,\n\tPieBackendActivityItemRef,\n\tPieBackendActivitySession,\n} from \"./attempt/adapters/activity-to-test-attempt-session.js\";\nexport {\n\tbuildActivitySessionItemUpdate,\n\tbuildActivitySessionPatchFromTestAttemptSession,\n\tmapActivityToTestAttemptSession,\n\ttoItemSessionsRecord,\n} from \"./attempt/adapters/activity-to-test-attempt-session.js\";\n\n// Section Player - Use @pie-players/pie-section-player web component\n\n// ============================================================================\n// Shared Components\n// ============================================================================\n\n// ItemToolBar custom element registration helper is exported via package.json exports field\n// Import using: import '@pie-players/pie-assessment-toolkit/components/item-toolbar-element';\n// PieAssessmentToolkit custom element registration helper is exported via package.json exports field\n"]}

package/dist/item-loader.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"item-loader.js","sourceRoot":"","sources":["../src/item-loader.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ItemEntity } from \"@pie-players/pie-players-shared\";\n\nexport type LoadItemOptions = {\n\torganizationId?: string | null;\n};\n\nexport type LoadItem = (\n\titemVId: string,\n\topts?: LoadItemOptions,\n) => Promise<ItemEntity>;\n\nexport class ItemLoadError extends Error {\n\treadonly code:\n\t\t| \"ITEM_NOT_FOUND\"\n\t\t| \"NO_ITEM_BANK_OR_FETCH_CONFIG\"\n\t\t| \"FETCH_NOT_AVAILABLE\"\n\t\t| \"FETCH_FAILED\";\n\n\tconstructor(code: ItemLoadError[\"code\"], message: string) {\n\t\tsuper(message);\n\t\tthis.name = \"ItemLoadError\";\n\t\tthis.code = code;\n\t}\n}\n\nexport type CreateLoadItemOptions = {\n\t/**\n\t * Optional in-memory item bank. Keys are itemVId.\n\t * This enables a no-backend default for demos/tests.\n\t */\n\titemBank?: Record<string, ItemEntity>;\n\n\t/**\n\t * Optional base URL for an item API. If set, `createLoadItem` will fetch when\n\t * an item is not present in `itemBank`.\n\t *\n\t * Example: `https://host.example.com`\n\t */\n\tfetchBaseUrl?: string;\n\n\t/**\n\t * Optional endpoint builder.\n\t * Defaults to `/api/item/:itemVId` (and appends `?organizationId=...` if provided).\n\t */\n\titemEndpoint?: string | ((itemVId: string, opts?: LoadItemOptions) => string);\n\n\t/**\n\t * Custom fetch implementation (useful for tests or hosts).\n\t * Defaults to `globalThis.fetch`.\n\t */\n\tfetchImpl?: typeof fetch;\n};\n\nfunction defaultItemEndpoint(itemVId: string, opts?: LoadItemOptions) {\n\tconst url = new URL(`/api/item/${itemVId}`, \"https://placeholder.invalid\");\n\tif (opts?.organizationId)\n\t\turl.searchParams.set(\"organizationId\", opts.organizationId);\n\treturn url.pathname + url.search;\n}\n\nexport function createFetchItemLoader(opts: {\n\tbaseUrl: string;\n\titemEndpoint?: CreateLoadItemOptions[\"itemEndpoint\"];\n\tfetchImpl?: typeof fetch;\n}): LoadItem {\n\tconst fetchImpl = opts.fetchImpl ?? globalThis.fetch;\n\tif (!fetchImpl) {\n\t\tthrow new ItemLoadError(\n\t\t\t\"FETCH_NOT_AVAILABLE\",\n\t\t\t\"globalThis.fetch is not available in this environment\",\n\t\t);\n\t}\n\n\treturn async (itemVId, loadOpts) => {\n\t\tconst endpointBuilder =\n\t\t\ttypeof opts.itemEndpoint === \"function\"\n\t\t\t\t? opts.itemEndpoint\n\t\t\t\t: typeof opts.itemEndpoint === \"string\"\n\t\t\t\t\t? () => opts.itemEndpoint as string\n\t\t\t\t\t: defaultItemEndpoint;\n\n\t\tconst endpoint = endpointBuilder(itemVId, loadOpts);\n\t\tconst url = new URL(endpoint, opts.baseUrl);\n\n\t\tconst res = await fetchImpl(url.toString());\n\t\tif (!res.ok) {\n\t\t\tthrow new ItemLoadError(\n\t\t\t\t\"FETCH_FAILED\",\n\t\t\t\t`Failed to load item ${itemVId}: ${res.status} ${res.statusText}`,\n\t\t\t);\n\t\t}\n\t\treturn (await res.json()) as ItemEntity;\n\t};\n}\n\n/**\n * Client-resolvable default loader:\n * - resolve from `itemBank` first (no backend required)\n * - optionally fallback to fetch (encouraged backend hook)\n */\nexport function createLoadItem(opts: CreateLoadItemOptions): LoadItem {\n\tconst itemBank = opts.itemBank;\n\tconst fetchBaseUrl = opts.fetchBaseUrl;\n\n\tconst fetchImpl =\n\t\topts.fetchImpl ?? (globalThis.fetch as typeof fetch | undefined);\n\tconst fetchLoader =\n\t\tfetchBaseUrl && typeof fetchImpl === \"function\"\n\t\t\t? createFetchItemLoader({\n\t\t\t\t\tbaseUrl: fetchBaseUrl,\n\t\t\t\t\titemEndpoint: opts.itemEndpoint,\n\t\t\t\t\tfetchImpl,\n\t\t\t\t})\n\t\t\t: null;\n\n\treturn async (itemVId, loadOpts) => {\n\t\tif (itemBank?.[itemVId]) return itemBank[itemVId];\n\n\t\tif (fetchLoader) return await fetchLoader(itemVId, loadOpts);\n\n\t\tif (fetchBaseUrl && typeof fetchImpl !== \"function\") {\n\t\t\tthrow new ItemLoadError(\n\t\t\t\t\"FETCH_NOT_AVAILABLE\",\n\t\t\t\t\"fetchBaseUrl was provided but globalThis.fetch is not available\",\n\t\t\t);\n\t\t}\n\n\t\tthrow new ItemLoadError(\n\t\t\t\"NO_ITEM_BANK_OR_FETCH_CONFIG\",\n\t\t\t\"No itemBank entry and no fetchBaseUrl configured for item loading\",\n\t\t);\n\t};\n}\n"]}

package/dist/policy/core/PolicySource.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"PolicySource.js","sourceRoot":"","sources":["../../../src/policy/core/PolicySource.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG","sourcesContent":["/**\n * Custom `PolicySource` extension point (M8 — see\n * `.cursor/plans/m8-design.md` § 5).\n *\n * Custom sources run in step 6 of the composition pipeline — *after*\n * placement membership, provider veto, host policy, and PNP/profile gates.\n * That ordering is deliberate: custom rules can only further *narrow*\n * the candidate set or add advisory provenance entries; they cannot\n * promote a tool that the host already removed.\n *\n * Sources MUST be pure with respect to `decide(...)`: given the same\n * `(candidates, context)` input they should produce the same\n * `(refinedCandidates, decisions)` output. Side-effects are reserved\n * for the engine's own subscription bus (`onPolicyChange`).\n */\n\nimport type { ToolPolicyDecisionRequest } from \"./decision-types.js\";\nimport type {\n\tToolPolicyDecisionRule,\n\tToolPolicyResolutionDecision,\n\tToolPolicySourceType,\n} from \"./provenance.js\";\n\nexport interface PolicySourceDecisionContext {\n\trequest: ToolPolicyDecisionRequest;\n\t/**\n\t * Snapshot of the candidate set as it enters this source. Sources\n\t * SHOULD treat this as read-only and return a fresh array via\n\t * `result.refinedCandidates`. Mutating `candidates` in place is\n\t * not supported and will be flagged in tests.\n\t */\n\tcandidates: readonly string[];\n}\n\nexport interface PolicySourceProvenanceEntry {\n\trule: ToolPolicyDecisionRule;\n\tfeatureId: string;\n\taction: ToolPolicyResolutionDecision[\"action\"];\n\tsourceType: ToolPolicySourceType;\n\treason: string;\n\tvalue?: unknown;\n\t/**\n\t * Custom precedence value used for the decision log. Defaults to\n\t * `100 + sourceIndex` (engine-assigned) when `undefined`. Sources\n\t * MAY override only if they know what they are doing — overriding\n\t * to a value `<= 6` lets the source masquerade as a PNP/profile rule and\n\t * is generally a bug.\n\t */\n\tprecedence?: number;\n}\n\nexport interface PolicySourceResult {\n\t/**\n\t * Refined candidate set. MUST be a subset of `context.candidates`.\n\t * Returning a superset is unsupported and will be normalized away\n\t * by the engine (with an `tool-policy.placementMissing` diagnostic\n\t * for any added IDs).\n\t */\n\trefinedCandidates: string[];\n\t/**\n\t * Provenance entries to append to the decision log. Each entry is\n\t * recorded under `featureId` whether or not it survives — sources\n\t * MAY emit advisory entries for blocked tools to document why.\n\t */\n\tdecisions?: PolicySourceProvenanceEntry[];\n}\n\nexport interface PolicySource {\n\t/** Stable identifier — used for `custom.${id}` source tags. */\n\treadonly id: string;\n\n\trefine(context: PolicySourceDecisionContext): PolicySourceResult;\n}\n"]}

package/dist/policy/core/ToolPolicyEngine.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ToolPolicyEngine.js","sourceRoot":"","sources":["../../../src/policy/core/ToolPolicyEngine.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Tool Policy Engine — facade class (M8 — see\n * `.cursor/plans/m8-design.md` § 2).\n *\n * Wraps `composeDecision(...)` with engine-instance state:\n *   - bound inputs (`tools`, `assessment`, `currentItemRef`, ...)\n *   - registered custom `PolicySource`s\n *   - `onPolicyChange` subscriber bus\n *   - `dispose()` clean-up\n *\n * The class has no DOM dependency and no Svelte runes. It is safe to\n * instantiate inside a worker, in a Node test, or inside a CE\n * connectedCallback. The Svelte context glue (`TOOL_POLICY_ENGINE_KEY`)\n * lives in `engine-context.ts`.\n *\n * PR 1 ships the engine *without callers*. PR 2 wires it into\n * `ToolkitCoordinator`. PR 3 switches `<pie-item-toolbar>` over.\n */\n\nimport type {\n\tAssessmentEntity,\n\tAssessmentItemRef,\n} from \"@pie-players/pie-players-shared/types\";\n\nimport type {\n\tCanonicalToolsConfig,\n\tToolPlacementLevel,\n} from \"../../services/tools-config-normalizer.js\";\nimport { normalizeToolsConfig } from \"../../services/tools-config-normalizer.js\";\nimport type { ToolRegistry } from \"../../services/ToolRegistry.js\";\n\nimport type {\n\tToolPolicyDecision,\n\tToolPolicyDecisionRequest,\n} from \"./decision-types.js\";\nimport type { PolicySource } from \"./PolicySource.js\";\nimport { composeDecision } from \"./compose-decision.js\";\nimport { resolveDefaultPnpEnforcement } from \"./pnp-policy-inputs.js\";\nimport { PnpPolicySource } from \"../sources/PnpPolicySource.js\";\n\nexport type PnpEnforcementMode = \"on\" | \"off\";\n\nexport interface ToolPolicyEngineInputs {\n\ttools?: CanonicalToolsConfig | null;\n\tassessment?: AssessmentEntity | null;\n\tcurrentItemRef?: AssessmentItemRef | null;\n\t/**\n\t * Explicit PNP/profile override. When omitted (or `undefined`), the engine\n\t * defaults to {@link resolveDefaultPnpEnforcement} over the bound\n\t * `assessment` and `currentItemRef`: `\"on\"` if they carry any\n\t * PNP/profile policy material (PNP, district policy, test\n\t * administration, item-level required/restricted/parameters),\n\t * `\"off\"` otherwise. See `.cursor/plans/m8-design.md` F2.\n\t *\n\t * Hosts that want to force a mode pass `\"on\"` or `\"off\"`\n\t * explicitly. Embedded under `<pie-section-player-*>` the preferred\n\t * override flows through `runtime.tools.pnpEnforcement`.\n\t */\n\tpnpEnforcement?: PnpEnforcementMode;\n}\n\nexport interface ToolPolicyEngineArgs {\n\ttoolRegistry: ToolRegistry;\n\tinputs?: ToolPolicyEngineInputs;\n\tcustomSources?: readonly PolicySource[];\n\t/** Stable context label used in provenance trails. Defaults to \"tool-policy\". */\n\tcontextId?: string;\n}\n\nexport interface ToolPolicyChangeEvent {\n\t/** What changed in this update. */\n\treason:\n\t\t| \"inputs\"\n\t\t| \"policy-source-added\"\n\t\t| \"policy-source-removed\"\n\t\t| \"pnp-enforcement\"\n\t\t| \"disposed\";\n\t/** Snapshot of the engine's inputs after the change. */\n\tinputs: Readonly<ResolvedEngineInputs>;\n}\n\nexport interface ResolvedEngineInputs {\n\ttools: CanonicalToolsConfig;\n\tassessment: AssessmentEntity | null;\n\tcurrentItemRef: AssessmentItemRef | null;\n\tpnpEnforcement: PnpEnforcementMode;\n}\n\nexport type ToolPolicyChangeListener = (event: ToolPolicyChangeEvent) => void;\n\nconst DEFAULT_TOOLS: CanonicalToolsConfig = normalizeToolsConfig({\n\tpolicy: { allowed: [], blocked: [] },\n\tplacement: { section: [], item: [], passage: [] },\n\tproviders: {},\n});\n\nexport class ToolPolicyEngine {\n\tprivate readonly toolRegistry: ToolRegistry;\n\tprivate readonly contextId: string;\n\tprivate readonly pnpPolicySource: PnpPolicySource;\n\tprivate readonly customSources: PolicySource[];\n\tprivate readonly listeners = new Set<ToolPolicyChangeListener>();\n\n\tprivate tools: CanonicalToolsConfig;\n\tprivate assessment: AssessmentEntity | null;\n\tprivate currentItemRef: AssessmentItemRef | null;\n\tprivate pnpEnforcement: PnpEnforcementMode;\n\tprivate disposed = false;\n\n\tconstructor(args: ToolPolicyEngineArgs) {\n\t\tthis.toolRegistry = args.toolRegistry;\n\t\tthis.contextId = args.contextId ?? \"tool-policy\";\n\t\tthis.pnpPolicySource = new PnpPolicySource(this.toolRegistry);\n\t\tthis.customSources = args.customSources ? [...args.customSources] : [];\n\n\t\tconst inputs = args.inputs ?? {};\n\t\tthis.tools = inputs.tools ?? DEFAULT_TOOLS;\n\t\tthis.assessment = inputs.assessment ?? null;\n\t\tthis.currentItemRef = inputs.currentItemRef ?? null;\n\t\tthis.pnpEnforcement =\n\t\t\tinputs.pnpEnforcement ??\n\t\t\tresolveDefaultPnpEnforcement({\n\t\t\t\tassessment: this.assessment,\n\t\t\t\tcurrentItemRef: this.currentItemRef,\n\t\t\t});\n\t}\n\n\t/**\n\t * Resolve the visible tool set for a given placement level and\n\t * scope.\n\t *\n\t * `visibleTools` and `diagnostics` are deterministic with respect\n\t * to the engine's currently-bound inputs — calling `decide(...)`\n\t * twice with identical inputs returns structurally equal\n\t * `visibleTools` and `diagnostics`. The returned `provenance`\n\t * carries call-time `evaluatedAt` timestamps generated by\n\t * `ToolPolicyProvenanceBuilder` (one per `decide(...)`); two\n\t * back-to-back calls therefore produce different `evaluatedAt`\n\t * values even though the policy decision itself is identical.\n\t * Hosts that want timestamp-stable provenance should reuse a\n\t * cached `ToolPolicyDecision` rather than re-call `decide(...)`.\n\t */\n\tdecide(request: ToolPolicyDecisionRequest): ToolPolicyDecision {\n\t\tthis.assertNotDisposed();\n\t\tconst requestContextId = request.scope.scopeId\n\t\t\t? `${this.contextId}:${request.level}:${request.scope.scopeId}`\n\t\t\t: `${this.contextId}:${request.level}`;\n\t\treturn composeDecision({\n\t\t\trequest,\n\t\t\ttools: this.tools,\n\t\t\tpnpPolicy: {\n\t\t\t\tsource: this.pnpPolicySource,\n\t\t\t\tassessment: this.assessment ?? undefined,\n\t\t\t\tcurrentItemRef: this.currentItemRef ?? undefined,\n\t\t\t\tenforcement: this.pnpEnforcement,\n\t\t\t},\n\t\t\tcustomSources: this.customSources,\n\t\t\tcontextId: requestContextId,\n\t\t});\n\t}\n\n\t/**\n\t * Convenience wrapper for hosts that just want the visible tool\n\t * IDs. Equivalent to `decide(...).visibleTools.map(e => e.toolId)`.\n\t */\n\tgetVisibleToolIds(level: ToolPlacementLevel, scopeId: string): string[] {\n\t\treturn this.decide({\n\t\t\tlevel,\n\t\t\tscope: { level, scopeId },\n\t\t}).visibleTools.map((entry) => entry.toolId);\n\t}\n\n\t/**\n\t * Apply a partial input update.\n\t *\n\t * Each key is value-diffed via `Object.is` before storing, so callers\n\t * may safely re-push the same reference (e.g. on Svelte effect\n\t * re-runs caused by unrelated tracked reads): no-op patches do not\n\t * fire `onPolicyChange` listeners. This contract is relied on by\n\t * `PieAssessmentToolkit.svelte`'s prop-forwarding effect and by the\n\t * coordinator's `decideToolPolicy()` tests.\n\t *\n\t * `pnpEnforcement` is stored on its own field and always emits with\n\t * a distinct `\"pnp-enforcement\"` reason when no other key changed,\n\t * so PR 4's auto-on flip can target that reason without a separate\n\t * event channel.\n\t */\n\tupdateInputs(patch: Partial<ToolPolicyEngineInputs>): void {\n\t\tthis.assertNotDisposed();\n\t\tlet changed = false;\n\t\tlet pnpChanged = false;\n\t\tif (\"tools\" in patch) {\n\t\t\tconst next = patch.tools ?? DEFAULT_TOOLS;\n\t\t\tif (!Object.is(this.tools, next)) {\n\t\t\t\tthis.tools = next;\n\t\t\t\tchanged = true;\n\t\t\t}\n\t\t}\n\t\tif (\"assessment\" in patch) {\n\t\t\tconst next = patch.assessment ?? null;\n\t\t\tif (!Object.is(this.assessment, next)) {\n\t\t\t\tthis.assessment = next;\n\t\t\t\tchanged = true;\n\t\t\t}\n\t\t}\n\t\tif (\"currentItemRef\" in patch) {\n\t\t\tconst next = patch.currentItemRef ?? null;\n\t\t\tif (!Object.is(this.currentItemRef, next)) {\n\t\t\t\tthis.currentItemRef = next;\n\t\t\t\tchanged = true;\n\t\t\t}\n\t\t}\n\t\tif (\"pnpEnforcement\" in patch && patch.pnpEnforcement) {\n\t\t\tif (this.pnpEnforcement !== patch.pnpEnforcement) {\n\t\t\t\tthis.pnpEnforcement = patch.pnpEnforcement;\n\t\t\t\tpnpChanged = true;\n\t\t\t}\n\t\t}\n\t\tif (changed || pnpChanged) {\n\t\t\tthis.emit({\n\t\t\t\treason: pnpChanged && !changed ? \"pnp-enforcement\" : \"inputs\",\n\t\t\t\tinputs: this.snapshotInputs(),\n\t\t\t});\n\t\t}\n\t}\n\n\tregisterPolicySource(source: PolicySource): () => void {\n\t\tthis.assertNotDisposed();\n\t\tthis.customSources.push(source);\n\t\tthis.emit({\n\t\t\treason: \"policy-source-added\",\n\t\t\tinputs: this.snapshotInputs(),\n\t\t});\n\t\treturn () => {\n\t\t\tconst idx = this.customSources.indexOf(source);\n\t\t\tif (idx !== -1) {\n\t\t\t\tthis.customSources.splice(idx, 1);\n\t\t\t\tif (!this.disposed) {\n\t\t\t\t\tthis.emit({\n\t\t\t\t\t\treason: \"policy-source-removed\",\n\t\t\t\t\t\tinputs: this.snapshotInputs(),\n\t\t\t\t\t});\n\t\t\t\t}\n\t\t\t}\n\t\t};\n\t}\n\n\tonPolicyChange(listener: ToolPolicyChangeListener): () => void {\n\t\tthis.listeners.add(listener);\n\t\treturn () => {\n\t\t\tthis.listeners.delete(listener);\n\t\t};\n\t}\n\n\tgetInputs(): Readonly<ResolvedEngineInputs> {\n\t\treturn this.snapshotInputs();\n\t}\n\n\tdispose(): void {\n\t\tif (this.disposed) return;\n\t\tthis.disposed = true;\n\t\tthis.emit({\n\t\t\treason: \"disposed\",\n\t\t\tinputs: this.snapshotInputs(),\n\t\t});\n\t\tthis.listeners.clear();\n\t\tthis.customSources.length = 0;\n\t}\n\n\tprivate snapshotInputs(): Readonly<ResolvedEngineInputs> {\n\t\treturn Object.freeze({\n\t\t\ttools: this.tools,\n\t\t\tassessment: this.assessment,\n\t\t\tcurrentItemRef: this.currentItemRef,\n\t\t\tpnpEnforcement: this.pnpEnforcement,\n\t\t});\n\t}\n\n\tprivate emit(event: ToolPolicyChangeEvent): void {\n\t\tfor (const listener of Array.from(this.listeners)) {\n\t\t\ttry {\n\t\t\t\tlistener(event);\n\t\t\t} catch {\n\t\t\t\t// Subscriber errors must not break the engine. Hosts that\n\t\t\t\t// want error telemetry should wrap their listener.\n\t\t\t}\n\t\t}\n\t}\n\n\tprivate assertNotDisposed(): void {\n\t\tif (this.disposed) {\n\t\t\tthrow new Error(\"ToolPolicyEngine has been disposed.\");\n\t\t}\n\t}\n}\n"]}

package/dist/policy/core/compose-decision.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"compose-decision.js","sourceRoot":"","sources":["../../../src/policy/core/compose-decision.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAOH,OAAO,EAEN,iBAAiB,GACjB,MAAM,2CAA2C,CAAC;AAWnD,OAAO,EAAE,2BAA2B,EAAE,MAAM,iBAAiB,CAAC;AAsB9D,MAAM,UAAU,eAAe,CAC9B,MAA6B;IAE7B,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,SAAS,EAAE,GAAG,MAAM,CAAC;IACvE,MAAM,OAAO,GAAG,IAAI,2BAA2B,CAAC,SAAS,CAAC,CAAC;IAE3D,OAAO,CAAC,SAAS,CAAC,MAAM,EAAE;QACzB,EAAE,EAAE,OAAO,CAAC,KAAK,CAAC,OAAO;QACzB,IAAI,EAAE,GAAG,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE;QACjD,MAAM,EAAE;YACP,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,MAAM,EAAE,KAAK,CAAC,MAAM;SACpB;KACD,CAAC,CAAC;IAEH,MAAM,SAAS,GAAG,iBAAiB,CAAC,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;IACpE,MAAM,OAAO,GAAG,iBAAiB,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACxD,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,iBAAiB,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;IAEjE,8BAA8B;IAC9B,EAAE;IACF,gEAAgE;IAChE,mEAAmE;IACnE,iEAAiE;IACjE,4DAA4D;IAC5D,mEAAmE;IACnE,kEAAkE;IAClE,oEAAoE;IACpE,sDAAsD;IACtD,IAAI,UAAU,GAAa,EAAE,CAAC;IAC9B,KAAK,MAAM,MAAM,IAAI,SAAS,EAAE,CAAC;QAChC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACxB,OAAO,CAAC,WAAW,CAAC;YACnB,UAAU,EAAE,CAAC;YACb,IAAI,EAAE,sBAAsB;YAC5B,SAAS,EAAE,MAAM;YACjB,MAAM,EAAE,MAAM;YACd,UAAU,EAAE,MAAM;YAClB,MAAM,EAAE,6BAA6B,OAAO,CAAC,KAAK,EAAE;SACpD,CAAC,CAAC;IACJ,CAAC;IAED,0BAA0B;IAC1B,UAAU,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE;QACzC,MAAM,eAAe,GAAG,KAAK,CAAC,SAAS,EAAE,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;QAC3D,IAAI,eAAe,KAAK,KAAK,EAAE,CAAC;YAC/B,OAAO,CAAC,WAAW,CAAC;gBACnB,UAAU,EAAE,CAAC;gBACb,IAAI,EAAE,mBAAmB;gBACzB,SAAS,EAAE,MAAM;gBACjB,MAAM,EAAE,OAAO;gBACf,UAAU,EAAE,MAAM;gBAClB,MAAM,EAAE,mBAAmB,MAAM,oBAAoB;gBACrD,KAAK,EAAE,KAAK;aACZ,CAAC,CAAC;YACH,OAAO,KAAK,CAAC;QACd,CAAC;QACD,OAAO,IAAI,CAAC;IACb,CAAC,CAAC,CAAC;IAEH,iDAAiD;IACjD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC;QACpC,UAAU,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE;YACzC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC7B,OAAO,CAAC,WAAW,CAAC;oBACnB,UAAU,EAAE,CAAC;oBACb,IAAI,EAAE,gBAAgB;oBACtB,SAAS,EAAE,MAAM;oBACjB,MAAM,EAAE,OAAO;oBACf,UAAU,EAAE,MAAM;oBAClB,MAAM,EAAE,qCAAqC;oBAC7C,KAAK,EAAE,OAAO;iBACd,CAAC,CAAC;gBACH,OAAO,KAAK,CAAC;YACd,CAAC;YACD,OAAO,IAAI,CAAC;QACb,CAAC,CAAC,CAAC;IACJ,CAAC;IAED,sCAAsC;IACtC,UAAU,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE;QACzC,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YACzB,OAAO,CAAC,WAAW,CAAC;gBACnB,UAAU,EAAE,CAAC;gBACb,IAAI,EAAE,cAAc;gBACpB,SAAS,EAAE,MAAM;gBACjB,MAAM,EAAE,OAAO;gBACf,UAAU,EAAE,MAAM;gBAClB,MAAM,EAAE,gCAAgC;gBACxC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,OAAO;aAC3B,CAAC,CAAC;YACH,OAAO,KAAK,CAAC;QACd,CAAC;QACD,OAAO,IAAI,CAAC;IACb,CAAC,CAAC,CAAC;IAEH,qCAAqC;IACrC,MAAM,WAAW,GAA2B,EAAE,CAAC;IAC/C,MAAM,aAAa,GAAG,IAAI,GAAG,EAA6B,CAAC;IAC3D,KAAK,MAAM,MAAM,IAAI,UAAU,EAAE,CAAC;QACjC,aAAa,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC;IAC1C,CAAC;IAED,kEAAkE;IAClE,6DAA6D;IAC7D,sEAAsE;IACtE,gEAAgE;IAChE,uBAAuB;IACvB,MAAM,kBAAkB,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC;IAE/C,IAAI,eAAe,GAAgD,IAAI,CAAC;IACxE,IACC,SAAS,CAAC,WAAW,KAAK,IAAI;QAC9B,SAAS,CAAC,MAAM;QAChB,CAAC,SAAS,CAAC,UAAU,IAAI,SAAS,CAAC,cAAc,CAAC,EACjD,CAAC;QACF,eAAe,GAAG,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC;YACxC,UAAU,EAAE,SAAS,CAAC,UAAU;YAChC,cAAc,EAAE,SAAS,CAAC,cAAc;SACxC,CAAC,CAAC;QAEH,IAAI,eAAe,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;YACxC,OAAO,CAAC,SAAS,CAAC,YAAY,EAAE,eAAe,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QACrE,CAAC;QACD,IAAI,eAAe,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;YACrC,OAAO,CAAC,SAAS,CAAC,SAAS,EAAE,eAAe,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAC/D,CAAC;QACD,IAAI,eAAe,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;YAClC,OAAO,CAAC,SAAS,CAAC,MAAM,EAAE,eAAe,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACzD,CAAC;QAED,KAAK,MAAM,QAAQ,IAAI,eAAe,CAAC,SAAS,EAAE,CAAC;YAClD,OAAO,CAAC,WAAW,CAAC;gBACnB,UAAU,EAAE,QAAQ,CAAC,UAAU;gBAC/B,IAAI,EAAE,QAAQ,CAAC,IAAI;gBACnB,SAAS,EAAE,QAAQ,CAAC,SAAS;gBAC7B,MAAM,EAAE,QAAQ,CAAC,MAAM;gBACvB,UAAU,EAAE,QAAQ,CAAC,UAAU;gBAC/B,MAAM,EAAE,QAAQ,CAAC,MAAM;gBACvB,KAAK,EAAE,QAAQ,CAAC,KAAK;aACrB,CAAC,CAAC;QACJ,CAAC;QAED,gEAAgE;QAChE,UAAU,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE;YACzC,OAAO,CAAC,eAAgB,CAAC,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACrD,CAAC,CAAC,CAAC;QACH,KAAK,MAAM,MAAM,IAAI,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;YACvD,IAAI,eAAe,CAAC,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;gBAChD,aAAa,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YAC9B,CAAC;QACF,CAAC;QAED,wDAAwD;QACxD,uEAAuE;QACvE,0DAA0D;QAC1D,sEAAsE;QACtE,6DAA6D;QAC7D,+DAA+D;QAC/D,6DAA6D;QAC7D,cAAc;QACd,EAAE;QACF,iEAAiE;QACjE,uDAAuD;QACvD,4DAA4D;QAC5D,oDAAoD;QACpD,KAAK,MAAM,cAAc,IAAI,eAAe,CAAC,eAAe,EAAE,CAAC;YAC9D,MAAM,aAAa,GAAG,CAAC,kBAAkB,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;YAC9D,IAAI,CAAC,aAAa;gBAAE,SAAS;YAC7B,MAAM,IAAI,GAAG,eAAe,CAAC,YAAY,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;YAC9D,MAAM,QAAQ,GAAG,IAAI,EAAE,IAAI,IAAI,eAAe,CAAC;YAC/C,MAAM,QAAQ,GAAG,qBAAqB,CAAC,cAAc,EAAE;gBACtD,SAAS;gBACT,OAAO;gBACP,OAAO;gBACP,SAAS,EAAE,KAAK,CAAC,SAAS;aAC1B,CAAC,CAAC;YACH,MAAM,OAAO,GAA+B;gBAC3C,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,QAAQ,CAAC,QAAQ;gBAC3B,SAAS,EAAE,QAAQ,CAAC,SAAS;aAC7B,CAAC;YACF,WAAW,CAAC,IAAI,CAAC;gBAChB,IAAI,EAAE,iCAAiC;gBACvC,KAAK,EAAE,OAAO,CAAC,KAAK;gBACpB,MAAM,EAAE,cAAc;gBACtB,OAAO,EAAE,4BAA4B,cAAc,MAAM,QAAQ,4CAA4C,OAAO,CAAC,KAAK,SAAS,QAAQ,CAAC,QAAQ,GAAG;gBACvJ,OAAO;aACP,CAAC,CAAC;YACH,OAAO,CAAC,WAAW,CAAC;gBACnB,UAAU,EAAE,CAAC;gBACb,IAAI,EAAE,uBAAuB;gBAC7B,SAAS,EAAE,cAAc;gBACzB,MAAM,EAAE,UAAU;gBAClB,UAAU,EAAE,MAAM;gBAClB,MAAM,EAAE,+BAA+B,cAAc,SAAS,QAAQ,CAAC,QAAQ,EAAE;gBACjF,KAAK,EAAE,OAAO;aACd,CAAC,CAAC;QACJ,CAAC;QAED,2DAA2D;QAC3D,KAAK,MAAM,MAAM,IAAI,UAAU,EAAE,CAAC;YACjC,MAAM,IAAI,GAAG,eAAe,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YACtD,IAAI,IAAI,EAAE,CAAC;gBACV,MAAM,IAAI,GAAG,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;gBAC7C,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,EAA4B,CAAC,CAAC;gBACxD,aAAa,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;YACjC,CAAC;QACF,CAAC;IACF,CAAC;IAED,iCAAiC;IACjC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,aAAa,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC/C,MAAM,MAAM,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC;QAChC,MAAM,MAAM,GAAG,UAAU,CAAC,KAAK,EAAE,CAAC;QAClC,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;YAC5B,OAAO;YACP,UAAU,EAAE,MAAM;SAClB,CAAC,CAAC;QACH,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC;QACrD,kEAAkE;QAClE,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,iBAAiB,EAAE,CAAC;YAC/C,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC9B,WAAW,CAAC,IAAI,CAAC;oBAChB,IAAI,EAAE,8BAA8B;oBACpC,KAAK,EAAE,OAAO,CAAC,KAAK;oBACpB,MAAM;oBACN,OAAO,EAAE,kBAAkB,MAAM,CAAC,EAAE,wBAAwB,MAAM,wCAAwC;oBAC1G,MAAM,EAAE,UAAU,MAAM,CAAC,EAAE,EAA4B;iBACvD,CAAC,CAAC;gBACH,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YAC3B,CAAC;QACF,CAAC;QACD,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;QAEvD,gEAAgE;QAChE,+DAA+D;QAC/D,+DAA+D;QAC/D,6DAA6D;QAC7D,4DAA4D;QAC5D,+DAA+D;QAC/D,yCAAyC;QACzC,MAAM,cAAc,GAAG,IAAI,GAAG,EAAU,CAAC;QACzC,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;YACtB,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;gBACtC,OAAO,CAAC,WAAW,CAAC;oBACnB,UAAU,EAAE,KAAK,CAAC,UAAU,IAAI,GAAG,GAAG,CAAC;oBACvC,IAAI,EAAE,KAAK,CAAC,IAAI;oBAChB,SAAS,EAAE,KAAK,CAAC,SAAS;oBAC1B,MAAM,EAAE,KAAK,CAAC,MAAM;oBACpB,UAAU,EAAE,KAAK,CAAC,UAAU;oBAC5B,MAAM,EAAE,KAAK,CAAC,MAAM;oBACpB,KAAK,EAAE,KAAK,CAAC,KAAK;iBAClB,CAAC,CAAC;gBACH,IAAI,KAAK,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;oBAC9B,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;gBACrC,CAAC;YACF,CAAC;QACF,CAAC;QAED,mEAAmE;QACnE,KAAK,MAAM,MAAM,IAAI,MAAM,EAAE,CAAC;YAC7B,IAAI,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC;gBAAE,SAAS;YACrC,IAAI,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC;gBAAE,SAAS;YACzC,OAAO,CAAC,WAAW,CAAC;gBACnB,UAAU,EAAE,GAAG,GAAG,CAAC;gBACnB,IAAI,EAAE,eAAe;gBACrB,SAAS,EAAE,MAAM;gBACjB,MAAM,EAAE,OAAO;gBACf,UAAU,EAAE,QAAQ;gBACpB,MAAM,EAAE,yBAAyB,MAAM,CAAC,EAAE,mBAAmB,MAAM,oFAAoF;gBACvJ,KAAK,EAAE,EAAE,cAAc,EAAE,MAAM,CAAC,EAAE,EAAE;aACpC,CAAC,CAAC;QACJ,CAAC;QAED,iEAAiE;QACjE,oCAAoC;QACpC,KAAK,MAAM,MAAM,IAAI,UAAU,EAAE,CAAC;YACjC,MAAM,IAAI,GAAG,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YACxD,IAAI,CAAC,IAAI,CAAC,UAAU,MAAM,CAAC,EAAE,EAA4B,CAAC,CAAC;YAC3D,aAAa,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QACjC,CAAC;QACD,mDAAmD;QACnD,KAAK,MAAM,MAAM,IAAI,MAAM,EAAE,CAAC;YAC7B,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC7B,aAAa,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YAC9B,CAAC;QACF,CAAC;IACF,CAAC;IAED,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC;IACzC,MAAM,YAAY,GAAsB,UAAU,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE;QACjE,MAAM,IAAI,GAAG,eAAe,EAAE,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACvD,OAAO;YACN,MAAM;YACN,QAAQ,EAAE,IAAI,EAAE,QAAQ,IAAI,KAAK;YACjC,eAAe,EAAE,IAAI,EAAE,eAAe,IAAI,KAAK;YAC/C,QAAQ,EAAE,IAAI,EAAE,QAAQ;YACxB,OAAO,EAAE,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC;SACnD,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO,CAAC,oBAAoB,CAAC,YAAY,CAAC,CAAC;IAE3C,OAAO;QACN,YAAY;QACZ,WAAW;QACX,UAAU,EAAE,OAAO,CAAC,KAAK,EAAE;KAC3B,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,qBAAqB,CAC7B,MAAc,EACd,IAKC;IAED,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QACtC,OAAO,EAAE,QAAQ,EAAE,mBAAmB,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC;IACrE,CAAC;IACD,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC,MAAM,CAAC,EAAE,OAAO,KAAK,KAAK,EAAE,CAAC;QACjD,OAAO,EAAE,QAAQ,EAAE,mBAAmB,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;IAC5D,CAAC;IACD,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QAC/D,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,SAAS,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC;IAChE,CAAC;IACD,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;QAC9B,OAAO;YACN,QAAQ,EAAE,cAAc;YACxB,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC;SACnC,CAAC;IACH,CAAC;IACD,mEAAmE;IACnE,mEAAmE;IACnE,8DAA8D;IAC9D,kEAAkE;IAClE,OAAO,EAAE,QAAQ,EAAE,mBAAmB,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC;AACrE,CAAC","sourcesContent":["/**\n * Compose-decision pipeline (M8 — see `.cursor/plans/m8-design.md` § 3).\n *\n * Pure function: given a decision request, the host's tools config,\n * an optional PNP policy source, and the registered custom sources, returns\n * a `ToolPolicyDecision`. The function performs no I/O, holds no\n * mutable state, and never reaches into Svelte / DOM — that is the\n * `ToolPolicyEngine` class's job.\n *\n * The six steps below mirror the design doc exactly. The tests in\n * `tests/policy/compose-decision.test.ts` lock the orchestration in.\n */\n\nimport type {\n\tAssessmentEntity,\n\tAssessmentItemRef,\n} from \"@pie-players/pie-players-shared/types\";\n\nimport {\n\ttype CanonicalToolsConfig,\n\tnormalizeToolList,\n} from \"../../services/tools-config-normalizer.js\";\nimport type {\n\tRequiredToolBlockedDetails,\n\tToolPolicyDecision,\n\tToolPolicyDecisionRequest,\n\tToolPolicyDiagnostic,\n\tToolPolicyEntry,\n\tToolPolicyHostGate,\n} from \"./decision-types.js\";\nimport type { PolicySource } from \"./PolicySource.js\";\nimport type { PolicySourceTag } from \"./policy-source-tag.js\";\nimport { ToolPolicyProvenanceBuilder } from \"./provenance.js\";\nimport type { PnpPolicySource } from \"../sources/PnpPolicySource.js\";\n\nexport interface ComposeDecisionInputs {\n\trequest: ToolPolicyDecisionRequest;\n\ttools: CanonicalToolsConfig;\n\tpnpPolicy: {\n\t\tsource: PnpPolicySource | null;\n\t\tassessment?: AssessmentEntity;\n\t\tcurrentItemRef?: AssessmentItemRef;\n\t\t/**\n\t\t * \"on\" applies the PNP/profile precedence rules; \"off\" skips step 5\n\t\t * entirely. Defaults to \"on\" when an assessment is present\n\t\t * and the source is non-null (see M8 design Q5).\n\t\t */\n\t\tenforcement: \"on\" | \"off\";\n\t};\n\tcustomSources: readonly PolicySource[];\n\t/** Stable identifier used as the provenance `contextId`. */\n\tcontextId: string;\n}\n\nexport function composeDecision(\n\tinputs: ComposeDecisionInputs,\n): ToolPolicyDecision {\n\tconst { request, tools, pnpPolicy, customSources, contextId } = inputs;\n\tconst builder = new ToolPolicyProvenanceBuilder(contextId);\n\n\tbuilder.addSource(\"host\", {\n\t\tid: request.scope.scopeId,\n\t\tname: `${request.level}:${request.scope.scopeId}`,\n\t\tconfig: {\n\t\t\tplacement: tools.placement,\n\t\t\tpolicy: tools.policy,\n\t\t},\n\t});\n\n\tconst placement = normalizeToolList(tools.placement[request.level]);\n\tconst allowed = normalizeToolList(tools.policy.allowed);\n\tconst blocked = new Set(normalizeToolList(tools.policy.blocked));\n\n\t// Step 1 — Membership filter.\n\t//\n\t// Logged with `action: \"skip\"` rather than `\"enable\"` because a\n\t// placement-membership entry is the pipeline's starting point, not\n\t// a winning decision. Subsequent steps may block the tool at the\n\t// same precedence (0); the builder's `decision.precedence <\n\t// winning.precedence` rule would otherwise let the placement entry\n\t// win equality and mask later blocks. Surviving tools are flipped\n\t// to `enabled` by `builder.reconcileFinalStates(...)` at the end of\n\t// the pipeline once the final candidate set is known.\n\tlet candidates: string[] = [];\n\tfor (const toolId of placement) {\n\t\tcandidates.push(toolId);\n\t\tbuilder.addDecision({\n\t\t\tprecedence: 0,\n\t\t\trule: \"placement-membership\",\n\t\t\tfeatureId: toolId,\n\t\t\taction: \"skip\",\n\t\t\tsourceType: \"host\",\n\t\t\treason: `Listed in tools.placement.${request.level}`,\n\t\t});\n\t}\n\n\t// Step 2 — Provider veto.\n\tcandidates = candidates.filter((toolId) => {\n\t\tconst providerEnabled = tools.providers?.[toolId]?.enabled;\n\t\tif (providerEnabled === false) {\n\t\t\tbuilder.addDecision({\n\t\t\t\tprecedence: 0,\n\t\t\t\trule: \"provider-disabled\",\n\t\t\t\tfeatureId: toolId,\n\t\t\t\taction: \"block\",\n\t\t\t\tsourceType: \"host\",\n\t\t\t\treason: `tools.providers.${toolId}.enabled === false`,\n\t\t\t\tvalue: false,\n\t\t\t});\n\t\t\treturn false;\n\t\t}\n\t\treturn true;\n\t});\n\n\t// Step 3 — Host whitelist (only when non-empty).\n\tif (allowed.length > 0) {\n\t\tconst allowedSet = new Set(allowed);\n\t\tcandidates = candidates.filter((toolId) => {\n\t\t\tif (!allowedSet.has(toolId)) {\n\t\t\t\tbuilder.addDecision({\n\t\t\t\t\tprecedence: 0,\n\t\t\t\t\trule: \"host-allowlist\",\n\t\t\t\t\tfeatureId: toolId,\n\t\t\t\t\taction: \"block\",\n\t\t\t\t\tsourceType: \"host\",\n\t\t\t\t\treason: \"Not present in tools.policy.allowed\",\n\t\t\t\t\tvalue: allowed,\n\t\t\t\t});\n\t\t\t\treturn false;\n\t\t\t}\n\t\t\treturn true;\n\t\t});\n\t}\n\n\t// Step 4 — Host blocklist (absolute).\n\tcandidates = candidates.filter((toolId) => {\n\t\tif (blocked.has(toolId)) {\n\t\t\tbuilder.addDecision({\n\t\t\t\tprecedence: 0,\n\t\t\t\trule: \"host-blocked\",\n\t\t\t\tfeatureId: toolId,\n\t\t\t\taction: \"block\",\n\t\t\t\tsourceType: \"host\",\n\t\t\t\treason: \"Listed in tools.policy.blocked\",\n\t\t\t\tvalue: tools.policy.blocked,\n\t\t\t});\n\t\t\treturn false;\n\t\t}\n\t\treturn true;\n\t});\n\n\t// Step 5 — PNP/profile policy gates.\n\tconst diagnostics: ToolPolicyDiagnostic[] = [];\n\tconst sourcesByTool = new Map<string, PolicySourceTag[]>();\n\tfor (const toolId of candidates) {\n\t\tsourcesByTool.set(toolId, [\"placement\"]);\n\t}\n\n\t// Snapshot the post-host candidate set so step 5b can distinguish\n\t// \"host removed a required tool\" (requiredToolBlocked fires)\n\t// from \"profile policy's own precedence removed a required tool\" (fix\n\t// per M8 PR 1 R1 S1 — multi-rule conflict on the same tool must\n\t// not blame the host).\n\tconst postHostCandidates = new Set(candidates);\n\n\tlet pnpPolicyResult: ReturnType<PnpPolicySource[\"apply\"]> | null = null;\n\tif (\n\t\tpnpPolicy.enforcement === \"on\" &&\n\t\tpnpPolicy.source &&\n\t\t(pnpPolicy.assessment || pnpPolicy.currentItemRef)\n\t) {\n\t\tpnpPolicyResult = pnpPolicy.source.apply({\n\t\t\tassessment: pnpPolicy.assessment,\n\t\t\tcurrentItemRef: pnpPolicy.currentItemRef,\n\t\t});\n\n\t\tif (pnpPolicyResult.sources.assessment) {\n\t\t\tbuilder.addSource(\"assessment\", pnpPolicyResult.sources.assessment);\n\t\t}\n\t\tif (pnpPolicyResult.sources.student) {\n\t\t\tbuilder.addSource(\"student\", pnpPolicyResult.sources.student);\n\t\t}\n\t\tif (pnpPolicyResult.sources.item) {\n\t\t\tbuilder.addSource(\"item\", pnpPolicyResult.sources.item);\n\t\t}\n\n\t\tfor (const decision of pnpPolicyResult.decisions) {\n\t\t\tbuilder.addDecision({\n\t\t\t\tprecedence: decision.precedence,\n\t\t\t\trule: decision.rule,\n\t\t\t\tfeatureId: decision.featureId,\n\t\t\t\taction: decision.action,\n\t\t\t\tsourceType: decision.sourceType,\n\t\t\t\treason: decision.reason,\n\t\t\t\tvalue: decision.value,\n\t\t\t});\n\t\t}\n\n\t\t// 5a — remove PNP/profile-blocked tools from the candidate set.\n\t\tcandidates = candidates.filter((toolId) => {\n\t\t\treturn !pnpPolicyResult!.blockedToolIds.has(toolId);\n\t\t});\n\t\tfor (const toolId of Array.from(sourcesByTool.keys())) {\n\t\t\tif (pnpPolicyResult.blockedToolIds.has(toolId)) {\n\t\t\t\tsourcesByTool.delete(toolId);\n\t\t\t}\n\t\t}\n\n\t\t// 5b — surface requiredToolBlocked diagnostics ONLY for\n\t\t// PNP/profile-mandated tools that the host removed (i.e., the tool was\n\t\t// NOT in `postHostCandidates`). Mandated tools removed by\n\t\t// profile policy's own higher-precedence rule (e.g. `restrictedTools`\n\t\t// blocking a `requiredTools` mandate) are an internal policy\n\t\t// resolution and must not be reported as a host conflict — the\n\t\t// loser's `block` decision is already in the trail with full\n\t\t// provenance.\n\t\t//\n\t\t// `details` carries `{ rule, hostRule, hostValue }` so consumers\n\t\t// can render the conflict as a single sentence without\n\t\t// re-deriving the host gate from `provenance.features`. See\n\t\t// `RequiredToolBlockedDetails` for the typed shape.\n\t\tfor (const mandatedToolId of pnpPolicyResult.mandatedToolIds) {\n\t\t\tconst removedByHost = !postHostCandidates.has(mandatedToolId);\n\t\t\tif (!removedByHost) continue;\n\t\t\tconst flag = pnpPolicyResult.perToolFlags.get(mandatedToolId);\n\t\t\tconst ruleName = flag?.rule ?? \"required-tool\";\n\t\t\tconst hostGate = detectHostRemovalGate(mandatedToolId, {\n\t\t\t\tplacement,\n\t\t\t\tallowed,\n\t\t\t\tblocked,\n\t\t\t\tproviders: tools.providers,\n\t\t\t});\n\t\t\tconst details: RequiredToolBlockedDetails = {\n\t\t\t\trule: ruleName,\n\t\t\t\thostRule: hostGate.hostRule,\n\t\t\t\thostValue: hostGate.hostValue,\n\t\t\t};\n\t\t\tdiagnostics.push({\n\t\t\t\tcode: \"tool-policy.requiredToolBlocked\",\n\t\t\t\tlevel: request.level,\n\t\t\t\ttoolId: mandatedToolId,\n\t\t\t\tmessage: `Profile policy mandates \"${mandatedToolId}\" (${ruleName}) but host policy removed it from level \"${request.level}\" via ${hostGate.hostRule}.`,\n\t\t\t\tdetails,\n\t\t\t});\n\t\t\tbuilder.addDecision({\n\t\t\t\tprecedence: 0,\n\t\t\t\trule: \"required-tool-blocked\",\n\t\t\t\tfeatureId: mandatedToolId,\n\t\t\t\taction: \"advisory\",\n\t\t\t\tsourceType: \"host\",\n\t\t\t\treason: `Host removed required tool \"${mandatedToolId}\" via ${hostGate.hostRule}`,\n\t\t\t\tvalue: details,\n\t\t\t});\n\t\t}\n\n\t\t// 5c — attach PNP policy source tags to surviving entries.\n\t\tfor (const toolId of candidates) {\n\t\t\tconst flag = pnpPolicyResult.perToolFlags.get(toolId);\n\t\t\tif (flag) {\n\t\t\t\tconst tags = sourcesByTool.get(toolId) ?? [];\n\t\t\t\ttags.push(`pnp.${flag.rule}` satisfies PolicySourceTag);\n\t\t\t\tsourcesByTool.set(toolId, tags);\n\t\t\t}\n\t\t}\n\t}\n\n\t// Step 6 — Custom PolicySources.\n\tfor (let i = 0; i < customSources.length; i++) {\n\t\tconst source = customSources[i];\n\t\tconst before = candidates.slice();\n\t\tconst result = source.refine({\n\t\t\trequest,\n\t\t\tcandidates: before,\n\t\t});\n\t\tconst refinedSet = new Set(result.refinedCandidates);\n\t\t// Reject any superset additions (custom sources can only narrow).\n\t\tfor (const toolId of result.refinedCandidates) {\n\t\t\tif (!before.includes(toolId)) {\n\t\t\t\tdiagnostics.push({\n\t\t\t\t\tcode: \"tool-policy.placementMissing\",\n\t\t\t\t\tlevel: request.level,\n\t\t\t\t\ttoolId,\n\t\t\t\t\tmessage: `Custom source \"${source.id}\" tried to add tool \"${toolId}\" that was not in candidates; ignored.`,\n\t\t\t\t\tsource: `custom.${source.id}` satisfies PolicySourceTag,\n\t\t\t\t});\n\t\t\t\trefinedSet.delete(toolId);\n\t\t\t}\n\t\t}\n\t\tcandidates = before.filter((id) => refinedSet.has(id));\n\n\t\t// Index the source's emitted block decisions by featureId so we\n\t\t// can detect \"silent removals\" — tools the source dropped from\n\t\t// the candidate set without logging an explicit block. Without\n\t\t// this auto-log, the provenance trail for a silently-removed\n\t\t// tool would show only the prior `enable` decisions and the\n\t\t// final-state reconciliation would have no evidence to mark it\n\t\t// `blocked` (M8 PR 1 R2 S1 / M1 case B).\n\t\tconst explicitBlocks = new Set<string>();\n\t\tif (result.decisions) {\n\t\t\tfor (const event of result.decisions) {\n\t\t\t\tbuilder.addDecision({\n\t\t\t\t\tprecedence: event.precedence ?? 100 + i,\n\t\t\t\t\trule: event.rule,\n\t\t\t\t\tfeatureId: event.featureId,\n\t\t\t\t\taction: event.action,\n\t\t\t\t\tsourceType: event.sourceType,\n\t\t\t\t\treason: event.reason,\n\t\t\t\t\tvalue: event.value,\n\t\t\t\t});\n\t\t\t\tif (event.action === \"block\") {\n\t\t\t\t\texplicitBlocks.add(event.featureId);\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\t// Auto-log a `custom-source / block` decision for silent removals.\n\t\tfor (const toolId of before) {\n\t\t\tif (refinedSet.has(toolId)) continue;\n\t\t\tif (explicitBlocks.has(toolId)) continue;\n\t\t\tbuilder.addDecision({\n\t\t\t\tprecedence: 100 + i,\n\t\t\t\trule: \"custom-source\",\n\t\t\t\tfeatureId: toolId,\n\t\t\t\taction: \"block\",\n\t\t\t\tsourceType: \"custom\",\n\t\t\t\treason: `Custom policy source \"${source.id}\" removed tool \"${toolId}\" from candidates without emitting a decision; auto-logged for trail completeness.`,\n\t\t\t\tvalue: { customSourceId: source.id },\n\t\t\t});\n\t\t}\n\n\t\t// Annotate surviving entries with `custom.<id>` so hosts can see\n\t\t// which custom source kept them in.\n\t\tfor (const toolId of candidates) {\n\t\t\tconst tags = sourcesByTool.get(toolId) ?? [\"placement\"];\n\t\t\ttags.push(`custom.${source.id}` satisfies PolicySourceTag);\n\t\t\tsourcesByTool.set(toolId, tags);\n\t\t}\n\t\t// And drop attribution for IDs the source removed.\n\t\tfor (const toolId of before) {\n\t\t\tif (!refinedSet.has(toolId)) {\n\t\t\t\tsourcesByTool.delete(toolId);\n\t\t\t}\n\t\t}\n\t}\n\n\tconst survivingIds = new Set(candidates);\n\tconst visibleTools: ToolPolicyEntry[] = candidates.map((toolId) => {\n\t\tconst flag = pnpPolicyResult?.perToolFlags.get(toolId);\n\t\treturn {\n\t\t\ttoolId,\n\t\t\trequired: flag?.required ?? false,\n\t\t\talwaysAvailable: flag?.alwaysAvailable ?? false,\n\t\t\tsettings: flag?.settings,\n\t\t\tsources: sourcesByTool.get(toolId) ?? [\"placement\"],\n\t\t};\n\t});\n\n\tbuilder.reconcileFinalStates(survivingIds);\n\n\treturn {\n\t\tvisibleTools,\n\t\tdiagnostics,\n\t\tprovenance: builder.build(),\n\t};\n}\n\n/**\n * Identify which step-1-through-4 host gate removed a tool. Used by\n * step 5b to enrich `tool-policy.requiredToolBlocked` diagnostics. The\n * checks mirror the pipeline order — step 1 (placement) first, step 4\n * (blocklist) last — so the FIRST gate that would have matched wins,\n * which is the gate the pipeline actually invoked. Subsequent gates\n * never get to evaluate a tool that an earlier step already removed.\n */\nfunction detectHostRemovalGate(\n\ttoolId: string,\n\targs: {\n\t\tplacement: string[];\n\t\tallowed: string[];\n\t\tblocked: Set<string>;\n\t\tproviders: CanonicalToolsConfig[\"providers\"];\n\t},\n): { hostRule: ToolPolicyHostGate; hostValue: unknown } {\n\tif (!args.placement.includes(toolId)) {\n\t\treturn { hostRule: \"placement-missing\", hostValue: args.placement };\n\t}\n\tif (args.providers?.[toolId]?.enabled === false) {\n\t\treturn { hostRule: \"provider-disabled\", hostValue: false };\n\t}\n\tif (args.allowed.length > 0 && !args.allowed.includes(toolId)) {\n\t\treturn { hostRule: \"host-allowlist\", hostValue: args.allowed };\n\t}\n\tif (args.blocked.has(toolId)) {\n\t\treturn {\n\t\t\thostRule: \"host-blocked\",\n\t\t\thostValue: Array.from(args.blocked),\n\t\t};\n\t}\n\t// Defensive: `removedByHost` is true at the call site (the tool is\n\t// in `mandatedToolIds` but not in `postHostCandidates`), so one of\n\t// the four gates above MUST have fired. If none did, the host\n\t// pipeline has a bug; surface a best-effort rather than throwing.\n\treturn { hostRule: \"placement-missing\", hostValue: args.placement };\n}\n"]}

package/dist/policy/core/decision-types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"decision-types.js","sourceRoot":"","sources":["../../../src/policy/core/decision-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG","sourcesContent":["/**\n * Tool Policy Engine — decision input/output types.\n *\n * These types describe the *request/response* contract for\n * `ToolPolicyEngine.decide(...)`. The engine itself, plus the\n * composition pipeline that produces the response, lives in sibling\n * modules.\n *\n * See `.cursor/plans/m8-design.md` § 2 for the engine shape, § 3 for\n * the composition rule, and § 4 for the provenance contract.\n */\n\nimport type { ToolPlacementLevel } from \"../../services/tools-config-normalizer.js\";\nimport type { ToolContext, ToolLevel } from \"../../services/tool-context.js\";\nimport type { PolicySourceTag } from \"./policy-source-tag.js\";\nimport type { ToolPolicyProvenance } from \"./provenance.js\";\n\n/**\n * Scope identifier for a `decide(...)` request. The engine uses\n * `level` to pick which placement bucket to read; `scopeId` is opaque\n * to the engine (it is round-tripped into provenance for human-readable\n * trails) and is typically the section-id, item-id, or passage-id of\n * the surface asking the question. `contentKind` mirrors the\n * `ToolbarContext.scope.contentKind` field already in use by\n * `<pie-item-toolbar>` Pass-2 visibility.\n */\nexport interface ToolScope {\n\tlevel: ToolLevel;\n\tscopeId: string;\n\tassessmentId?: string;\n\tsectionId?: string;\n\titemId?: string;\n\tcanonicalItemId?: string;\n\tcontentKind?: string;\n}\n\nexport interface ToolPolicyDecisionRequest {\n\t/**\n\t * Placement bucket the engine reads from\n\t * (`tools.placement[level]`). Stays narrow (`section | item |\n\t * passage`) — broader `ToolLevel` values from `tool-context.ts`\n\t * are surfaced through `scope.level` only.\n\t */\n\tlevel: ToolPlacementLevel;\n\tscope: ToolScope;\n\t/**\n\t * Optional Pass-2 context. The engine itself does NOT call\n\t * `isVisibleInContext(...)`; that gate is intentionally applied\n\t * at the toolbar boundary (Pass-2 = relevance, Pass-1 = the\n\t * engine's job). The context is forwarded to custom\n\t * `PolicySource` instances so they can refine the candidate set\n\t * if they need to.\n\t */\n\tcontext?: ToolContext;\n}\n\n/**\n * Diagnostic codes the engine may emit alongside a decision. The\n * canonical case in M8 is `tool-policy.requiredToolBlocked` — fired\n * when a host policy gate (`policy.blocked`, missing-from-`placement`,\n * provider veto) removed a tool that profile policy `requiredTools` /\n * `district.requiredTools` mandates.\n *\n * `tool-policy.placementMissing` fires when a custom `PolicySource`\n * references a tool ID that is not present in `tools.placement[level]`\n * for the resolved level. The host-side `ToolConfigDiagnostic` channel\n * (already used by `tool-config-validation.ts`) covers config-time\n * misconfiguration; this channel covers per-decision conflicts.\n */\nexport type ToolPolicyDiagnosticCode =\n\t| \"tool-policy.requiredToolBlocked\"\n\t| \"tool-policy.placementMissing\";\n\n/**\n * Which host gate removed a profile-mandated tool. Surfaced inside\n * `ToolPolicyDiagnostic.details` for `tool-policy.requiredToolBlocked`\n * so consumers can render a single human-readable explanation\n * (\"the proctor blocked the calculator that this student's IEP\n * requires\") without re-deriving the host gate from\n * `provenance.features[toolId].allDecisions`.\n *\n * The four values mirror steps 1–4 of `composeDecision`:\n *   - `placement-missing` — tool is not in `tools.placement[level]`\n *   - `provider-disabled` — `tools.providers[id].enabled === false`\n *   - `host-allowlist`    — non-empty `tools.policy.allowed` excludes the id\n *   - `host-blocked`      — `tools.policy.blocked` lists the id\n */\nexport type ToolPolicyHostGate =\n\t| \"placement-missing\"\n\t| \"provider-disabled\"\n\t| \"host-allowlist\"\n\t| \"host-blocked\";\n\n/**\n * Strongly-typed payload for `tool-policy.requiredToolBlocked`\n * diagnostics. The diagnostic's `details` field still types as\n * `Record<string, unknown>` for forward compatibility, but engines\n * always populate this exact shape today and consumers can safely\n * cast.\n */\nexport interface RequiredToolBlockedDetails extends Record<string, unknown> {\n\t/** The profile policy rule that mandated the tool (e.g. `district-requirement`). */\n\trule: string;\n\t/** Which host gate removed the tool. */\n\thostRule: ToolPolicyHostGate;\n\t/** The host configuration value that triggered the gate (best-effort, may be omitted). */\n\thostValue?: unknown;\n}\n\nexport interface ToolPolicyDiagnostic {\n\tcode: ToolPolicyDiagnosticCode;\n\tlevel: ToolPlacementLevel;\n\ttoolId: string;\n\tmessage: string;\n\tsource?: PolicySourceTag;\n\tdetails?: Record<string, unknown>;\n}\n\nexport interface ToolPolicyEntry {\n\ttoolId: string;\n\t/**\n\t * `true` when PNP/profile policy mandates this tool (item or district\n\t * `requiredTools`, or PNP support without prohibition). Advisory\n\t * mandates that the host blocked do *not* surface here — they\n\t * appear in `diagnostics` instead. Hosts that need to know about\n\t * those should listen on the diagnostic channel.\n\t */\n\trequired: boolean;\n\t/**\n\t * `true` for PNP `supports` — UI-level signal that the host\n\t * cannot toggle this tool off in user preferences. Does NOT\n\t * override host blocks (they would have removed the entry\n\t * before this flag is read).\n\t */\n\talwaysAvailable: boolean;\n\t/**\n\t * Tool-specific settings resolved from the assessment / item\n\t * settings via the PNP policy source. Hosts that want to read these\n\t * directly should use `entry.settings` rather than peeking into\n\t * the assessment entity from above the engine.\n\t */\n\tsettings?: unknown;\n\t/**\n\t * Every contributor that helped this entry survive the\n\t * composition pipeline. Always non-empty — at minimum\n\t * `[\"placement\"]` for any entry that came from\n\t * `tools.placement[level]`.\n\t */\n\tsources: PolicySourceTag[];\n}\n\nexport interface ToolPolicyDecision {\n\tvisibleTools: ToolPolicyEntry[];\n\tdiagnostics: ToolPolicyDiagnostic[];\n\tprovenance: ToolPolicyProvenance;\n}\n"]}

package/dist/policy/core/engine-context.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"engine-context.js","sourceRoot":"","sources":["../../../src/policy/core/engine-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAIH,MAAM,CAAC,MAAM,sBAAsB,GAAkB,MAAM,CAC1D,iCAAiC,CACjC,CAAC","sourcesContent":["/**\n * Svelte context key for the tool policy engine (M8 PR 1).\n *\n * Components inside an assessment toolkit subtree consume the engine\n * through Svelte's native `getContext(TOOL_POLICY_ENGINE_KEY)`. The\n * canonical provider is the `ToolkitCoordinator` wiring (M8 PR 2):\n * the toolkit CE constructs a `ToolPolicyEngine`, attaches it to the\n * coordinator, and exposes it to descendants via\n * `setContext(TOOL_POLICY_ENGINE_KEY, engine)`.\n *\n * Mirrors the M7 `SECTION_RUNTIME_ENGINE_KEY` pattern. As with the\n * runtime engine, the key is a `Symbol` so it cannot collide with\n * userland context keys and so descendants are forced to import this\n * module rather than guess a string id.\n *\n * **No cross-CE bridge.** Unlike the runtime engine, there is no\n * `connectToolPolicyEngineHostContext` helper — see M8 design Q8.\n * Every CE in the tree gets its engine from its own coordinator\n * (the toolkit element). This avoids subscription-bridge overhead\n * for a function-style engine that hosts can simply re-call after\n * an input swap.\n *\n * **Stability.** This export is part of the stable `policy/engine`\n * surface; renaming or replacing the symbol is a major breaking\n * change.\n */\n\nimport type { ToolPolicyEngine } from \"./ToolPolicyEngine.js\";\n\nexport const TOOL_POLICY_ENGINE_KEY: unique symbol = Symbol(\n\t\"@pie-players/tool-policy-engine\",\n);\n\nexport type ToolPolicyEngineContext = ToolPolicyEngine;\n"]}