@pie-players/pie-assessment-toolkit 0.2.2 → 0.2.4

package/dist/services/PNPToolResolver.js

@@ -2,41 +2,142 @@
  * PNP Tool Resolver
  *
  * Resolves tool availability from QTI 3.0 Personal Needs Profile (PNP) and
- * assessment settings. Implements precedence hierarchy for tool configuration.
+ * assessment settings. Implements a precedence hierarchy for tool configuration
+ * based on common assessment platform governance patterns.
  *
- * Precedence (highest to lowest):
- * 1. District block (absolute veto)
- * 2. Test administration override
- * 3. Item restriction (per-item block)
- * 4. Item requirement (forces enable)
- * 5. District requirement
- * 6. PNP supports (student needs)
+ * PRECEDENCE HIERARCHY (highest to lowest):
+ * ==========================================
+ *
+ * Standards-Based (QTI 3.0):
+ * - PNP supports (#6): Student's documented accessibility needs (accessibilityInfo.accessFeature)
+ * - Item-level settings (#3, #4): Per-item accessibility requirements/restrictions
+ *
+ * Implementation-Specific (Common Practice):
+ * - District policy (#1, #5): Institutional governance and legal compliance
+ * - Test administration (#2): Session-level operational control
+ *
+ * The hierarchy itself is NOT defined by QTI 3.0 standards but follows common
+ * patterns in K-12 assessment platforms, aligning with US IEP/504 accommodation
+ * hierarchies where legal requirements and institutional policies take precedence.
+ *
+ * Precedence Order:
+ * 1. District block (absolute veto) - Legal/policy requirements
+ * 2. Test administration override - Proctor/administrator operational control
+ * 3. Item restriction (per-item block) - Content author can disable for specific items
+ * 4. Item requirement (forces enable) - Required by IEP/504 or content needs
+ * 5. District requirement - Institutional accessibility requirements
+ * 6. PNP supports (student needs) - QTI 3.0 standard student preferences
+ *
+ * Governance Context:
+ * - Institutional veto (district) trumps individual preferences (legal compliance)
+ * - Session control (test admin) enables operational flexibility
+ * - Content restrictions (item) prevent tools that invalidate assessment
+ * - Required accommodations (IEP/504) ensure legal compliance
+ * - Student preferences (PNP) are honored when not overridden
+ *
+ * References:
+ * - QTI 3.0: https://www.imsglobal.org/spec/qti/v3p0
+ * - IMS AfA 3.0: https://www.imsglobal.org/spec/afa/v3p0
+ * - Common assessment platform governance patterns (not standardized)
  *
  * Part of PIE Assessment Toolkit.
  */
-import { mapPNPSupportToToolId } from "./PNPMapper";
+import { PNPProvenanceBuilder, } from "./pnp-provenance";
 /**
  * Resolves tool availability from QTI 3.0 assessment structure
  */
 export class PNPToolResolver {
+    toolRegistry;
+    enableProvenance;
+    /**
+     * Create a PNPToolResolver
+     *
+     * @param toolRegistry Tool registry for PNP support mapping
+     * @param enableProvenance Enable detailed provenance tracking (default: true)
+     */
+    constructor(toolRegistry, enableProvenance = true) {
+        this.toolRegistry = toolRegistry;
+        this.enableProvenance = enableProvenance;
+    }
     /**
      * Resolve all tools from QTI 3.0 assessment + optional item context
      *
      * @param assessment QTI 3.0 assessment with personalNeedsProfile
      * @param currentItemRef Current item for item-specific requirements (optional)
-     * @returns Array of resolved tool configurations
+     * @returns Array of resolved tool configurations (for backward compatibility)
+     *
+     * @deprecated Use resolveToolsWithProvenance() to get provenance tracking
      *
      * @example
-     * const resolver = new PNPToolResolver();
+     * const resolver = new PNPToolResolver(registry);
      * const tools = resolver.resolveTools(assessment, itemRef);
      * tools.forEach(tool => {
      *   console.log(`${tool.id}: ${tool.enabled ? 'enabled' : 'disabled'}`);
      * });
      */
     resolveTools(assessment, currentItemRef) {
+        const result = this.resolveToolsWithProvenance(assessment, currentItemRef);
+        return result.tools;
+    }
+    /**
+     * Resolve all tools with full provenance tracking
+     *
+     * Returns both resolved tools and complete provenance trail showing:
+     * - All configuration sources consulted
+     * - Decision steps at each precedence level
+     * - Reasons for enabling/blocking each feature
+     * - Human-readable explanations
+     *
+     * @param assessment QTI 3.0 assessment with personalNeedsProfile
+     * @param currentItemRef Current item for item-specific requirements (optional)
+     * @returns Resolution result with tools and provenance
+     *
+     * @example
+     * const resolver = new PNPToolResolver(registry);
+     * const result = resolver.resolveToolsWithProvenance(assessment, itemRef);
+     *
+     * // Use resolved tools
+     * result.tools.forEach(tool => console.log(tool.id, tool.enabled));
+     *
+     * // Display provenance to user
+     * console.log(result.provenance.summary);
+     * result.provenance.features.forEach((trail, featureId) => {
+     *   console.log(`${featureId}: ${trail.explanation}`);
+     * });
+     */
+    resolveToolsWithProvenance(assessment, currentItemRef) {
         const pnp = assessment.personalNeedsProfile;
         const settings = assessment.settings;
         const itemSettings = currentItemRef?.settings;
+        // Initialize provenance builder
+        const contextId = `assessment-${assessment.id || "unknown"}${currentItemRef ? `-item-${currentItemRef.identifier}` : ""}`;
+        const provenanceBuilder = this.enableProvenance
+            ? new PNPProvenanceBuilder(contextId)
+            : null;
+        // Record configuration sources
+        if (provenanceBuilder) {
+            if (settings?.districtPolicy || settings?.testAdministration) {
+                provenanceBuilder.addSource("assessment", {
+                    id: assessment.id || "unknown",
+                    name: assessment.name || assessment.id || "Assessment",
+                    config: settings,
+                });
+            }
+            if (pnp) {
+                provenanceBuilder.addSource("student", {
+                    id: "student", // Would come from session context
+                    name: "Student PNP Profile",
+                    config: pnp,
+                });
+            }
+            if (currentItemRef && itemSettings) {
+                provenanceBuilder.addSource("item", {
+                    id: currentItemRef.identifier,
+                    name: currentItemRef.identifier,
+                    config: itemSettings,
+                });
+            }
+        }
         // Collect all PNP support IDs mentioned anywhere
         const allSupports = new Set();
         pnp?.supports?.forEach((s) => allSupports.add(s));
@@ -45,19 +146,25 @@ export class PNPToolResolver {
         itemSettings?.requiredTools?.forEach((s) => allSupports.add(s));
         itemSettings?.restrictedTools?.forEach((s) => allSupports.add(s));
         const resolved = [];
+        const context = {
+            pnp,
+            districtPolicy: settings?.districtPolicy,
+            testAdmin: settings?.testAdministration,
+            itemSettings,
+            toolConfigs: settings?.toolConfigs,
+        };
         for (const supportId of allSupports) {
-            const config = this.resolveSupport(supportId, {
-                pnp,
-                districtPolicy: settings?.districtPolicy,
-                testAdmin: settings?.testAdministration,
-                itemSettings,
-                toolConfigs: settings?.toolConfigs,
-            });
+            const config = this.resolveSupport(supportId, context, provenanceBuilder);
             if (config) {
                 resolved.push(config);
             }
         }
-        return resolved;
+        return {
+            tools: resolved,
+            provenance: provenanceBuilder
+                ? provenanceBuilder.build()
+                : this.createEmptyProvenance(contextId),
+        };
     }
     /**
      * Resolve availability of a single PNP support
@@ -66,24 +173,61 @@ export class PNPToolResolver {
      *
      * @param supportId PNP support identifier
      * @param context Resolution context with all configuration sources
+     * @param provenanceBuilder Provenance tracking (optional)
      * @returns Resolved config or null if blocked/disabled
      */
-    resolveSupport(supportId, context) {
+    resolveSupport(supportId, context, provenanceBuilder) {
         // Precedence (highest to lowest):
         // 1. District block (absolute veto)
         if (context.districtPolicy?.blockedTools?.includes(supportId)) {
+            provenanceBuilder?.addDecision({
+                precedence: 1,
+                rule: "district-block",
+                featureId: supportId,
+                action: "block",
+                sourceType: "assessment",
+                reason: `District policy blocks "${supportId}" for all assessments`,
+                value: context.districtPolicy.blockedTools,
+            });
             return null; // Blocked
         }
         // 2. Test administration override
         if (context.testAdmin?.toolOverrides?.[supportId] === false) {
+            provenanceBuilder?.addDecision({
+                precedence: 2,
+                rule: "test-admin-override",
+                featureId: supportId,
+                action: "block",
+                sourceType: "assessment",
+                reason: `Test administrator disabled "${supportId}" for this session`,
+                value: context.testAdmin.toolOverrides,
+            });
             return null; // Blocked
         }
         // 3. Item restriction
         if (context.itemSettings?.restrictedTools?.includes(supportId)) {
+            provenanceBuilder?.addDecision({
+                precedence: 3,
+                rule: "item-restriction",
+                featureId: supportId,
+                action: "block",
+                sourceType: "item",
+                reason: `Item restricts "${supportId}" (e.g., mental math question blocks calculator)`,
+                value: context.itemSettings.restrictedTools,
+            });
             return null; // Blocked for this item
         }
         // 4. Item requirement (forces enable)
         if (context.itemSettings?.requiredTools?.includes(supportId)) {
+            provenanceBuilder?.addDecision({
+                precedence: 4,
+                rule: "item-requirement",
+                featureId: supportId,
+                action: "enable",
+                sourceType: "item",
+                reason: `Item requires "${supportId}" for this question`,
+                value: context.itemSettings.requiredTools,
+            });
             return this.buildToolConfig(supportId, context, {
                 required: true,
                 source: "item",
@@ -91,6 +235,15 @@ export class PNPToolResolver {
         }
         // 5. District requirement
         if (context.districtPolicy?.requiredTools?.includes(supportId)) {
+            provenanceBuilder?.addDecision({
+                precedence: 5,
+                rule: "district-requirement",
+                featureId: supportId,
+                action: "enable",
+                sourceType: "assessment",
+                reason: `District policy requires "${supportId}" for all assessments`,
+                value: context.districtPolicy.requiredTools,
+            });
             return this.buildToolConfig(supportId, context, {
                 required: true,
                 source: "district",
@@ -100,16 +253,63 @@ export class PNPToolResolver {
         if (context.pnp?.supports?.includes(supportId)) {
             // Check if prohibited
             const isProhibited = context.pnp.prohibitedSupports?.includes(supportId);
-            if (!isProhibited) {
-                return this.buildToolConfig(supportId, context, {
-                    alwaysAvailable: true,
-                    source: "pnp",
+            if (isProhibited) {
+                provenanceBuilder?.addDecision({
+                    precedence: 6,
+                    rule: "pnp-support",
+                    featureId: supportId,
+                    action: "block",
+                    sourceType: "student",
+                    reason: `Student PNP profile prohibits "${supportId}"`,
+                    value: context.pnp.prohibitedSupports,
                 });
+                return null;
             }
+            provenanceBuilder?.addDecision({
+                precedence: 6,
+                rule: "pnp-support",
+                featureId: supportId,
+                action: "enable",
+                sourceType: "student",
+                reason: `Student PNP profile requests "${supportId}"`,
+                value: context.pnp.supports,
+            });
+            return this.buildToolConfig(supportId, context, {
+                alwaysAvailable: true,
+                source: "pnp",
+            });
         }
-        // Not enabled
+        // Not enabled - log as skipped
+        provenanceBuilder?.addDecision({
+            precedence: 6,
+            rule: "pnp-support",
+            featureId: supportId,
+            action: "skip",
+            sourceType: "system",
+            reason: `Feature "${supportId}" not configured at any level`,
+        });
         return null;
     }
+    /**
+     * Create empty provenance when tracking is disabled
+     */
+    createEmptyProvenance(contextId) {
+        return {
+            contextId,
+            resolvedAt: new Date(),
+            sources: {},
+            features: new Map(),
+            decisionLog: [],
+            summary: {
+                totalFeatures: 0,
+                enabled: 0,
+                blocked: 0,
+                notConfigured: 0,
+                bySource: {},
+                byRule: {},
+            },
+        };
+    }
     /**
      * Build resolved tool configuration
      *
@@ -121,8 +321,11 @@ export class PNPToolResolver {
      * @returns Complete resolved tool configuration
      */
     buildToolConfig(supportId, context, flags) {
-        // Map PNP support ID to PIE tool ID
-        const pieToolId = mapPNPSupportToToolId(supportId) || supportId;
+        // Map PNP support ID to PIE tool ID via registry
+        const toolIds = this.toolRegistry.getToolsByPNPSupport(supportId);
+        // Use first matching tool (usually only one per PNP support)
+        // If no mapping exists, use the support ID directly as tool ID
+        const pieToolId = toolIds.size > 0 ? Array.from(toolIds)[0] : supportId;
         // Get tool-specific config from settings (item takes precedence)
         const toolConfig = context.itemSettings?.toolParameters?.[supportId] ||
             context.toolConfigs?.[supportId];
@@ -138,7 +341,7 @@ export class PNPToolResolver {
     /**
      * Check if a specific tool is enabled
      *
-     * @param toolId PIE tool identifier (e.g., 'pie-tool-calculator')
+     * @param toolId Toolkit tool identifier (e.g., 'calculator')
      * @param assessment Assessment with PNP
      * @param itemRef Optional item context
      * @returns true if tool is enabled
@@ -150,7 +353,7 @@ export class PNPToolResolver {
     /**
      * Check if a tool is required (cannot be disabled)
      *
-     * @param toolId PIE tool identifier
+     * @param toolId Toolkit tool identifier
      * @param assessment Assessment with PNP
      * @param itemRef Optional item context
      * @returns true if tool is required or always available
@@ -171,14 +374,17 @@ export class PNPToolResolver {
      *
      * @example
      * const autoActivate = resolver.getAutoActivateTools(assessment);
-     * // Returns: ['pie-tool-text-to-speech', 'pie-tool-line-reader']
+     * // Returns: ['textToSpeech', 'lineReader']
      */
     getAutoActivateTools(assessment) {
         const pnp = assessment.personalNeedsProfile;
         if (!pnp?.activateAtInit)
             return [];
         return pnp.activateAtInit
-            .map((supportId) => mapPNPSupportToToolId(supportId))
+            .map((supportId) => {
+            const toolIds = this.toolRegistry.getToolsByPNPSupport(supportId);
+            return toolIds.size > 0 ? Array.from(toolIds)[0] : null;
+        })
             .filter(Boolean);
     }
     /**
@@ -192,6 +398,92 @@ export class PNPToolResolver {
         const resolved = this.resolveTools(assessment, itemRef);
         return resolved.filter((t) => t.enabled).map((t) => t.id);
     }
+    /**
+     * Get allowed tool IDs (Pass 1 of two-pass visibility model)
+     *
+     * Returns tool IDs that pass orchestrator-level checks (PNP + policies + settings).
+     * This is the first gate - tools still need to pass Pass 2 (relevance check).
+     *
+     * This is the primary method to use with ToolRegistry.filterVisibleInContext()
+     *
+     * @param assessment Assessment with PNP
+     * @param itemRef Optional item context
+     * @returns Array of allowed tool IDs (Pass 1)
+     *
+     * @example
+     * // Two-pass visibility model
+     * const allowedToolIds = resolver.getAllowedToolIds(assessment, itemRef);
+     * const visibleTools = toolRegistry.filterVisibleInContext(allowedToolIds, context);
+     */
+    getAllowedToolIds(assessment, itemRef) {
+        return this.getEnabledTools(assessment, itemRef);
+    }
+    /**
+     * Resolve tools with a test/override PNP profile
+     *
+     * FOR TESTING/DEVELOPMENT ONLY
+     *
+     * Allows direct injection of a PNP profile for testing accessibility configurations
+     * without modifying the assessment entity. The override profile replaces the
+     * assessment's personalNeedsProfile entirely.
+     *
+     * Use cases:
+     * - Development/testing UI for trying different profiles
+     * - Automated testing with various accessibility configurations
+     * - Preview tools with profile simulation
+     * - Accessibility team testing and validation
+     *
+     * @param assessment Base assessment (settings, policies, etc.)
+     * @param overrideProfile PNP profile to inject (replaces assessment.personalNeedsProfile)
+     * @param itemRef Optional item context
+     * @returns Resolution result with tools and provenance
+     *
+     * @example
+     * // Test with low vision profile
+     * const testProfile = {
+     *   supports: ['magnification', 'textToSpeech', 'highContrastDisplay']
+     * };
+     * const result = resolver.resolveWithOverride(assessment, testProfile);
+     *
+     * @example
+     * // Test with null profile (no accessibility features)
+     * const result = resolver.resolveWithOverride(assessment, null);
+     */
+    resolveWithOverride(assessment, overrideProfile, itemRef) {
+        // Create assessment clone with overridden PNP
+        const testAssessment = {
+            ...assessment,
+            personalNeedsProfile: overrideProfile || undefined,
+        };
+        return this.resolveToolsWithProvenance(testAssessment, itemRef);
+    }
+    /**
+     * Get allowed tool IDs with full provenance tracking
+     *
+     * Returns both tool IDs and complete resolution provenance for debugging,
+     * auditing, and displaying to users.
+     *
+     * @param assessment Assessment with PNP
+     * @param itemRef Optional item context
+     * @returns Object with tool IDs and provenance
+     *
+     * @example
+     * const result = resolver.getAllowedToolIdsWithProvenance(assessment, itemRef);
+     *
+     * // Use tool IDs
+     * const visibleTools = toolRegistry.filterVisibleInContext(result.toolIds, context);
+     *
+     * // Display provenance to user
+     * console.log('Resolution Summary:', result.provenance.summary);
+     * console.log('Explanation for calculator:', result.provenance.features.get('calculator')?.explanation);
+     */
+    getAllowedToolIdsWithProvenance(assessment, itemRef) {
+        const result = this.resolveToolsWithProvenance(assessment, itemRef);
+        return {
+            toolIds: result.tools.map((t) => t.id),
+            provenance: result.provenance,
+        };
+    }
     /**
      * Get all required tools
      *
@@ -208,7 +500,7 @@ export class PNPToolResolver {
     /**
      * Get tool configuration settings
      *
-     * @param toolId PIE tool identifier
+     * @param toolId Toolkit tool identifier
      * @param assessment Assessment with PNP
      * @param itemRef Optional item context
      * @returns Tool-specific settings or null if not found

package/dist/services/PNPToolResolver.js.map

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

package/dist/services/RangeSerializer.d.ts

@@ -0,0 +1,119 @@
+/**
+ * RangeSerializer - Serialize and deserialize DOM Range objects
+ *
+ * Provides utilities for storing and restoring text ranges across sessions.
+ * Used by both TTS (for timing data) and annotations (for persistence).
+ *
+ * Uses CSS selector paths and node indices for robust serialization that
+ * survives content changes when possible.
+ */
+/**
+ * Serialized form of a Range suitable for storage.
+ */
+export interface SerializedRange {
+    /** CSS selector path to start container */
+    startContainer: string;
+    /** Character offset in start container */
+    startOffset: number;
+    /** CSS selector path to end container */
+    endContainer: string;
+    /** Character offset in end container */
+    endOffset: number;
+    /** Original text for validation */
+    text: string;
+    /** Optional metadata */
+    metadata?: {
+        /** When this range was created */
+        timestamp?: number;
+        /** User-provided label */
+        label?: string;
+        /** Custom data */
+        custom?: Record<string, unknown>;
+    };
+}
+/**
+ * RangeSerializer - Serialize and deserialize Range objects.
+ */
+export declare class RangeSerializer {
+    /**
+     * Serialize a Range to storable format.
+     *
+     * @param range - Range to serialize
+     * @param root - Root element (typically document.body or content container)
+     * @returns Serialized range data
+     *
+     * @example
+     * ```typescript
+     * const serializer = new RangeSerializer();
+     * const range = window.getSelection()!.getRangeAt(0);
+     * const serialized = serializer.serialize(range, document.body);
+     * localStorage.setItem('savedRange', JSON.stringify(serialized));
+     * ```
+     */
+    serialize(range: Range, root: Element): SerializedRange;
+    /**
+     * Deserialize range from storage.
+     *
+     * @param data - Serialized range data
+     * @param root - Root element (same as used in serialize)
+     * @returns Range object, or null if content changed
+     *
+     * @example
+     * ```typescript
+     * const serializer = new RangeSerializer();
+     * const data = JSON.parse(localStorage.getItem('savedRange')!);
+     * const range = serializer.deserialize(data, document.body);
+     * if (range) {
+     *   // Range successfully restored
+     * } else {
+     *   // Content changed, range invalid
+     * }
+     * ```
+     */
+    deserialize(data: SerializedRange, root: Element): Range | null;
+    /**
+     * Get a unique path to a node from root.
+     *
+     * Uses a hybrid approach:
+     * - For element nodes: CSS selector path
+     * - For text nodes: parent selector + text node index
+     *
+     * @param node - Node to get path for
+     * @param root - Root element
+     * @returns Path string
+     */
+    private getNodePath;
+    /**
+     * Get CSS selector path to an element.
+     *
+     * @param element - Element to get path for
+     * @param root - Root element
+     * @returns CSS selector path
+     */
+    private getElementPath;
+    /**
+     * Find a node by its path from root.
+     *
+     * @param path - Path string from getNodePath
+     * @param root - Root element
+     * @returns Node, or null if not found
+     */
+    private findNodeByPath;
+    /**
+     * Batch serialize multiple ranges.
+     *
+     * @param ranges - Ranges to serialize
+     * @param root - Root element
+     * @returns Array of serialized ranges
+     */
+    serializeMany(ranges: Range[], root: Element): SerializedRange[];
+    /**
+     * Batch deserialize multiple ranges.
+     *
+     * @param data - Array of serialized ranges
+     * @param root - Root element
+     * @returns Array of ranges (nulls for invalid ranges)
+     */
+    deserializeMany(data: SerializedRange[], root: Element): (Range | null)[];
+}
+//# sourceMappingURL=RangeSerializer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RangeSerializer.d.ts","sourceRoot":"","sources":["../../src/services/RangeSerializer.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;GAEG;AACH,MAAM,WAAW,eAAe;IAC/B,2CAA2C;IAC3C,cAAc,EAAE,MAAM,CAAC;IAEvB,0CAA0C;IAC1C,WAAW,EAAE,MAAM,CAAC;IAEpB,yCAAyC;IACzC,YAAY,EAAE,MAAM,CAAC;IAErB,wCAAwC;IACxC,SAAS,EAAE,MAAM,CAAC;IAElB,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;IAEb,wBAAwB;IACxB,QAAQ,CAAC,EAAE;QACV,kCAAkC;QAClC,SAAS,CAAC,EAAE,MAAM,CAAC;QAEnB,0BAA0B;QAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;QAEf,kBAAkB;QAClB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACjC,CAAC;CACF;AAED;;GAEG;AACH,qBAAa,eAAe;IAC3B;;;;;;;;;;;;;;OAcG;IACH,SAAS,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,GAAG,eAAe;IAUvD;;;;;;;;;;;;;;;;;;OAkBG;IACH,WAAW,CAAC,IAAI,EAAE,eAAe,EAAE,IAAI,EAAE,OAAO,GAAG,KAAK,GAAG,IAAI;IA2B/D;;;;;;;;;;OAUG;IACH,OAAO,CAAC,WAAW;IA8BnB;;;;;;OAMG;IACH,OAAO,CAAC,cAAc;IAmCtB;;;;;;OAMG;IACH,OAAO,CAAC,cAAc;IA+BtB;;;;;;OAMG;IACH,aAAa,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,GAAG,eAAe,EAAE;IAIhE;;;;;;OAMG;IACH,eAAe,CAAC,IAAI,EAAE,eAAe,EAAE,EAAE,IAAI,EAAE,OAAO,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC,EAAE;CAGzE"}