@pie-players/pie-assessment-toolkit 0.2.0

package/dist/services/AccessibilityCatalogResolver.js

@@ -0,0 +1,249 @@
+/**
+ * Accessibility Catalog Resolver Service
+ *
+ * Manages QTI 3.0 accessibility catalogs at both assessment and item levels.
+ * Provides lookup and resolution services for alternative content representations.
+ *
+ * @example
+ * ```typescript
+ * // Initialize with assessment-level catalogs
+ * const resolver = new AccessibilityCatalogResolver(assessment.accessibilityCatalogs);
+ *
+ * // Add item-level catalogs when rendering item
+ * resolver.addItemCatalogs(item.accessibilityCatalogs);
+ *
+ * // Resolve catalog by identifier
+ * const spokenContent = resolver.getAlternative('intro-passage', {
+ *   type: 'spoken',
+ *   language: 'en-US'
+ * });
+ *
+ * // Check if catalog exists
+ * if (resolver.hasCatalog('math-problem-1')) {
+ *   const braille = resolver.getAlternative('math-problem-1', { type: 'braille' });
+ * }
+ * ```
+ */
+export class AccessibilityCatalogResolver {
+    assessmentCatalogs = new Map();
+    itemCatalogs = new Map();
+    defaultLanguage = "en";
+    constructor(assessmentCatalogs, defaultLanguage = "en") {
+        this.defaultLanguage = defaultLanguage;
+        this.indexCatalogs(assessmentCatalogs ?? [], "assessment");
+    }
+    /**
+     * Set the default language for fallback resolution
+     */
+    setDefaultLanguage(language) {
+        this.defaultLanguage = language;
+    }
+    /**
+     * Get the default language
+     */
+    getDefaultLanguage() {
+        return this.defaultLanguage;
+    }
+    /**
+     * Index catalogs into the appropriate map
+     */
+    indexCatalogs(catalogs, source) {
+        const targetMap = source === "assessment" ? this.assessmentCatalogs : this.itemCatalogs;
+        for (const catalog of catalogs) {
+            targetMap.set(catalog.identifier, catalog);
+        }
+    }
+    /**
+     * Add item-level catalogs (called when rendering a new item)
+     */
+    addItemCatalogs(catalogs) {
+        if (!catalogs || catalogs.length === 0)
+            return;
+        this.indexCatalogs(catalogs, "item");
+    }
+    /**
+     * Clear item-level catalogs (called when leaving an item)
+     */
+    clearItemCatalogs() {
+        this.itemCatalogs.clear();
+    }
+    /**
+     * Check if a catalog exists (checks both assessment and item levels)
+     */
+    hasCatalog(catalogId) {
+        return (this.itemCatalogs.has(catalogId) || this.assessmentCatalogs.has(catalogId));
+    }
+    /**
+     * Get alternative content for a catalog identifier
+     *
+     * Priority: Item-level catalogs take precedence over assessment-level
+     */
+    getAlternative(catalogId, options) {
+        // Check item-level first (higher precedence)
+        const itemCatalog = this.itemCatalogs.get(catalogId);
+        if (itemCatalog) {
+            const card = this.findMatchingCard(itemCatalog, options);
+            if (card) {
+                return {
+                    catalogId,
+                    type: card.catalog,
+                    language: card.language,
+                    content: card.content,
+                    source: "item",
+                };
+            }
+        }
+        // Fallback to assessment-level
+        const assessmentCatalog = this.assessmentCatalogs.get(catalogId);
+        if (assessmentCatalog) {
+            const card = this.findMatchingCard(assessmentCatalog, options);
+            if (card) {
+                return {
+                    catalogId,
+                    type: card.catalog,
+                    language: card.language,
+                    content: card.content,
+                    source: "assessment",
+                };
+            }
+        }
+        return null;
+    }
+    /**
+     * Find a matching catalog card based on lookup options
+     */
+    findMatchingCard(catalog, options) {
+        const { type, language, useFallback = true } = options;
+        // Try exact match (type + language)
+        if (language) {
+            const exactMatch = catalog.cards.find((card) => card.catalog === type && card.language === language);
+            if (exactMatch)
+                return exactMatch;
+        }
+        // Try type match with default language (if fallback enabled)
+        if (useFallback) {
+            const defaultMatch = catalog.cards.find((card) => card.catalog === type && card.language === this.defaultLanguage);
+            if (defaultMatch)
+                return defaultMatch;
+            // Try type match without language constraint
+            const typeMatch = catalog.cards.find((card) => card.catalog === type);
+            if (typeMatch)
+                return typeMatch;
+        }
+        return null;
+    }
+    /**
+     * Get all available alternatives for a catalog identifier
+     */
+    getAllAlternatives(catalogId) {
+        const results = [];
+        // Add item-level alternatives
+        const itemCatalog = this.itemCatalogs.get(catalogId);
+        if (itemCatalog) {
+            for (const card of itemCatalog.cards) {
+                results.push({
+                    catalogId,
+                    type: card.catalog,
+                    language: card.language,
+                    content: card.content,
+                    source: "item",
+                });
+            }
+        }
+        // Add assessment-level alternatives (if not already provided by item)
+        const assessmentCatalog = this.assessmentCatalogs.get(catalogId);
+        if (assessmentCatalog) {
+            for (const card of assessmentCatalog.cards) {
+                // Only add if not already provided by item catalog
+                const exists = results.some((r) => r.type === card.catalog && r.language === card.language);
+                if (!exists) {
+                    results.push({
+                        catalogId,
+                        type: card.catalog,
+                        language: card.language,
+                        content: card.content,
+                        source: "assessment",
+                    });
+                }
+            }
+        }
+        return results;
+    }
+    /**
+     * Get all catalog identifiers available (both assessment and item)
+     */
+    getAllCatalogIds() {
+        const itemIds = Array.from(this.itemCatalogs.keys());
+        const assessmentIds = Array.from(this.assessmentCatalogs.keys());
+        // Combine and deduplicate
+        return Array.from(new Set([...itemIds, ...assessmentIds]));
+    }
+    /**
+     * Get statistics about available catalogs
+     */
+    getStatistics() {
+        const allTypes = new Set();
+        const allLanguages = new Set();
+        // Collect from assessment catalogs
+        for (const catalog of this.assessmentCatalogs.values()) {
+            for (const card of catalog.cards) {
+                allTypes.add(card.catalog);
+                if (card.language)
+                    allLanguages.add(card.language);
+            }
+        }
+        // Collect from item catalogs
+        for (const catalog of this.itemCatalogs.values()) {
+            for (const card of catalog.cards) {
+                allTypes.add(card.catalog);
+                if (card.language)
+                    allLanguages.add(card.language);
+            }
+        }
+        return {
+            totalCatalogs: this.assessmentCatalogs.size + this.itemCatalogs.size,
+            assessmentCatalogs: this.assessmentCatalogs.size,
+            itemCatalogs: this.itemCatalogs.size,
+            availableTypes: allTypes,
+            availableLanguages: allLanguages,
+        };
+    }
+    /**
+     * Check if a specific catalog type is available for a given catalog ID
+     */
+    hasAlternativeType(catalogId, type) {
+        const alternatives = this.getAllAlternatives(catalogId);
+        return alternatives.some((alt) => alt.type === type);
+    }
+    /**
+     * Get all catalog IDs that have a specific type of alternative
+     */
+    getCatalogsByType(type) {
+        const catalogIds = new Set();
+        for (const [id, catalog] of this.assessmentCatalogs.entries()) {
+            if (catalog.cards.some((card) => card.catalog === type)) {
+                catalogIds.add(id);
+            }
+        }
+        for (const [id, catalog] of this.itemCatalogs.entries()) {
+            if (catalog.cards.some((card) => card.catalog === type)) {
+                catalogIds.add(id);
+            }
+        }
+        return Array.from(catalogIds);
+    }
+    /**
+     * Reset all catalogs (both assessment and item)
+     */
+    reset() {
+        this.assessmentCatalogs.clear();
+        this.itemCatalogs.clear();
+    }
+    /**
+     * Destroy and cleanup
+     */
+    destroy() {
+        this.reset();
+    }
+}
+//# sourceMappingURL=AccessibilityCatalogResolver.js.map

package/dist/services/AccessibilityCatalogResolver.js.map

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

package/dist/services/AssessmentAuthoringService.d.ts

@@ -0,0 +1,60 @@
+import type { AssessmentAuthoringCallbacks, AssessmentEntity, AssessmentSection, QuestionEntity } from "@pie-players/pie-players-shared";
+export declare class AssessmentAuthoringService {
+    private assessment;
+    private eventBus;
+    private callbacks;
+    constructor(assessment: AssessmentEntity, callbacks?: AssessmentAuthoringCallbacks);
+    /**
+     * Get the current assessment structure
+     */
+    getAssessment(): AssessmentEntity;
+    /**
+     * Subscribe to assessment updates
+     */
+    subscribe(listener: (assessment: AssessmentEntity) => void): () => void;
+    /**
+     * Add a question/item to the assessment
+     */
+    addItem(item: QuestionEntity, index?: number): void;
+    /**
+     * Remove an item from the assessment
+     */
+    removeItem(itemId: string): void;
+    /**
+     * Move an item from one position to another
+     */
+    moveItem(fromIndex: number, toIndex: number): void;
+    /**
+     * Update an item's properties
+     */
+    updateItem(itemId: string, updates: Partial<QuestionEntity>): void;
+    /**
+     * Reorder items to match the provided question IDs
+     */
+    reorderItems(newOrder: string[]): void;
+    /**
+     * Add a section to the assessment
+     */
+    addSection(section: AssessmentSection, index?: number): void;
+    /**
+     * Remove a section from the assessment
+     */
+    removeSection(sectionId: string): void;
+    /**
+     * Update a section's properties
+     */
+    updateSection(sectionId: string, updates: Partial<AssessmentSection>): void;
+    /**
+     * Add a question to a section
+     */
+    addQuestionToSection(sectionId: string, questionId: string, sort?: string): void;
+    /**
+     * Remove a question from a section
+     */
+    removeQuestionFromSection(sectionId: string, questionId: string): void;
+    /**
+     * Emit assessment update event
+     */
+    private emitUpdate;
+}
+//# sourceMappingURL=AssessmentAuthoringService.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AssessmentAuthoringService.d.ts","sourceRoot":"","sources":["../../src/services/AssessmentAuthoringService.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,4BAA4B,EAC5B,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,EAEd,MAAM,iCAAiC,CAAC;AAWzC,qBAAa,0BAA0B;IACtC,OAAO,CAAC,UAAU,CAAmB;IACrC,OAAO,CAAC,QAAQ,CAA2C;IAC3D,OAAO,CAAC,SAAS,CAA+B;gBAG/C,UAAU,EAAE,gBAAgB,EAC5B,SAAS,GAAE,4BAAiC;IAe7C;;OAEG;IACH,aAAa,IAAI,gBAAgB;IAIjC;;OAEG;IACH,SAAS,CAAC,QAAQ,EAAE,CAAC,UAAU,EAAE,gBAAgB,KAAK,IAAI,GAAG,MAAM,IAAI;IAUvE;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,cAAc,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI;IAWnD;;OAEG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAuBhC;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAoBlD;;OAEG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,IAAI;IAelE;;OAEG;IACH,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI;IAYtC;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,iBAAiB,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI;IAW5D;;OAEG;IACH,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAetC;;OAEG;IACH,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,iBAAiB,CAAC,GAAG,IAAI;IAe3E;;OAEG;IACH,oBAAoB,CACnB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,IAAI,CAAC,EAAE,MAAM,GACX,IAAI;IAcP;;OAEG;IACH,yBAAyB,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;IAetE;;OAEG;IACH,OAAO,CAAC,UAAU;CAIlB"}

package/dist/services/AssessmentAuthoringService.js

@@ -0,0 +1,183 @@
+import { TypedEventBus } from "../core/TypedEventBus";
+export class AssessmentAuthoringService {
+    assessment;
+    eventBus;
+    callbacks;
+    constructor(assessment, callbacks = {}) {
+        this.assessment = { ...assessment };
+        this.callbacks = callbacks;
+        this.eventBus = new TypedEventBus();
+        // Initialize structure if missing
+        if (!this.assessment.questions) {
+            this.assessment.questions = [];
+        }
+        if (!this.assessment.sections) {
+            this.assessment.sections = [];
+        }
+    }
+    /**
+     * Get the current assessment structure
+     */
+    getAssessment() {
+        return { ...this.assessment };
+    }
+    /**
+     * Subscribe to assessment updates
+     */
+    subscribe(listener) {
+        const wrappedListener = (event) => {
+            listener(event.detail);
+        };
+        this.eventBus.on("assessment-updated", wrappedListener);
+        return () => {
+            this.eventBus.off("assessment-updated", wrappedListener);
+        };
+    }
+    /**
+     * Add a question/item to the assessment
+     */
+    addItem(item, index) {
+        const questions = this.assessment.questions || [];
+        const targetIndex = index !== undefined ? index : questions.length;
+        questions.splice(targetIndex, 0, item);
+        this.assessment.questions = questions;
+        this.callbacks.onItemAdded?.(item, targetIndex);
+        this.emitUpdate();
+    }
+    /**
+     * Remove an item from the assessment
+     */
+    removeItem(itemId) {
+        const questions = this.assessment.questions || [];
+        const index = questions.findIndex((q) => q.id === itemId);
+        if (index === -1) {
+            return;
+        }
+        questions.splice(index, 1);
+        this.assessment.questions = questions;
+        // Also remove from sections
+        if (this.assessment.sections) {
+            this.assessment.sections = this.assessment.sections.map((section) => ({
+                ...section,
+                questions: section.questions.filter((ref) => ref.questionId !== itemId),
+            }));
+        }
+        this.callbacks.onItemRemoved?.(itemId, index);
+        this.emitUpdate();
+    }
+    /**
+     * Move an item from one position to another
+     */
+    moveItem(fromIndex, toIndex) {
+        const questions = this.assessment.questions || [];
+        if (fromIndex < 0 ||
+            fromIndex >= questions.length ||
+            toIndex < 0 ||
+            toIndex >= questions.length) {
+            return;
+        }
+        const [item] = questions.splice(fromIndex, 1);
+        questions.splice(toIndex, 0, item);
+        this.assessment.questions = questions;
+        this.callbacks.onItemMoved?.(fromIndex, toIndex);
+        this.emitUpdate();
+    }
+    /**
+     * Update an item's properties
+     */
+    updateItem(itemId, updates) {
+        const questions = this.assessment.questions || [];
+        const index = questions.findIndex((q) => q.id === itemId);
+        if (index === -1) {
+            return;
+        }
+        questions[index] = { ...questions[index], ...updates };
+        this.assessment.questions = questions;
+        this.callbacks.onItemUpdated?.(itemId, updates);
+        this.emitUpdate();
+    }
+    /**
+     * Reorder items to match the provided question IDs
+     */
+    reorderItems(newOrder) {
+        const questions = this.assessment.questions || [];
+        const questionMap = new Map(questions.map((q) => [q.id, q]));
+        const reordered = newOrder
+            .map((id) => questionMap.get(id))
+            .filter((q) => q !== undefined);
+        this.assessment.questions = reordered;
+        this.emitUpdate();
+    }
+    /**
+     * Add a section to the assessment
+     */
+    addSection(section, index) {
+        const sections = this.assessment.sections || [];
+        const targetIndex = index !== undefined ? index : sections.length;
+        sections.splice(targetIndex, 0, section);
+        this.assessment.sections = sections;
+        this.callbacks.onSectionAdded?.(section, targetIndex);
+        this.emitUpdate();
+    }
+    /**
+     * Remove a section from the assessment
+     */
+    removeSection(sectionId) {
+        const sections = this.assessment.sections || [];
+        const index = sections.findIndex((s) => s.id === sectionId);
+        if (index === -1) {
+            return;
+        }
+        sections.splice(index, 1);
+        this.assessment.sections = sections;
+        this.callbacks.onSectionRemoved?.(sectionId, index);
+        this.emitUpdate();
+    }
+    /**
+     * Update a section's properties
+     */
+    updateSection(sectionId, updates) {
+        const sections = this.assessment.sections || [];
+        const index = sections.findIndex((s) => s.id === sectionId);
+        if (index === -1) {
+            return;
+        }
+        sections[index] = { ...sections[index], ...updates };
+        this.assessment.sections = sections;
+        this.callbacks.onSectionUpdated?.(sectionId, updates);
+        this.emitUpdate();
+    }
+    /**
+     * Add a question to a section
+     */
+    addQuestionToSection(sectionId, questionId, sort) {
+        const sections = this.assessment.sections || [];
+        const section = sections.find((s) => s.id === sectionId);
+        if (!section) {
+            return;
+        }
+        const ref = { questionId, sort };
+        section.questions = [...(section.questions || []), ref];
+        this.emitUpdate();
+    }
+    /**
+     * Remove a question from a section
+     */
+    removeQuestionFromSection(sectionId, questionId) {
+        const sections = this.assessment.sections || [];
+        const section = sections.find((s) => s.id === sectionId);
+        if (!section) {
+            return;
+        }
+        section.questions = section.questions.filter((ref) => ref.questionId !== questionId);
+        this.emitUpdate();
+    }
+    /**
+     * Emit assessment update event
+     */
+    emitUpdate() {
+        this.callbacks.onAssessmentUpdated?.(this.assessment);
+        this.eventBus.emit("assessment-updated", this.assessment);
+    }
+}
+//# sourceMappingURL=AssessmentAuthoringService.js.map

package/dist/services/AssessmentAuthoringService.js.map

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

package/dist/services/ContextVariableStore.d.ts

@@ -0,0 +1,114 @@
+/**
+ * Context Variable Store
+ *
+ * Standalone service for managing QTI 3.0 context variables.
+ * Context variables are global assessment-level variables that can be
+ * shared across items.
+ *
+ * Can be used independently by any assessment player without requiring
+ * the full AssessmentPlayer.
+ *
+ * Part of PIE Assessment Toolkit.
+ */
+import type { ContextDeclaration } from "@pie-players/pie-players-shared/types";
+/**
+ * Standalone service for managing QTI 3.0 context variables.
+ *
+ * Context variables are global assessment-level variables that can be
+ * shared across items. Can be used independently by any assessment player.
+ *
+ * @example
+ * ```typescript
+ * // Initialize with declarations
+ * const store = new ContextVariableStore(declarations);
+ *
+ * // Get/set variables
+ * const seed = store.get('RANDOM_SEED');
+ * store.set('DIFFICULTY_LEVEL', 'hard');
+ *
+ * // Pass to items
+ * const context = store.toObject();
+ * await renderItem(item, session, context);
+ *
+ * // Persist in session
+ * session.contextVariables = store.toObject();
+ * ```
+ */
+export declare class ContextVariableStore {
+    private variables;
+    private declarations;
+    /**
+     * Initialize store with context declarations from assessment
+     *
+     * @param declarations QTI 3.0 context declarations
+     */
+    constructor(declarations?: ContextDeclaration[]);
+    /**
+     * Initialize context variables from declarations
+     *
+     * Sets each variable to its defaultValue or type-appropriate default.
+     */
+    initialize(declarations: ContextDeclaration[]): void;
+    /**
+     * Get context variable value
+     *
+     * @param identifier Variable identifier
+     * @returns Variable value or undefined if not found
+     */
+    get(identifier: string): any;
+    /**
+     * Set context variable value
+     *
+     * @param identifier Variable identifier
+     * @param value New value
+     */
+    set(identifier: string, value: any): void;
+    /**
+     * Check if variable exists
+     */
+    has(identifier: string): boolean;
+    /**
+     * Get all variable names
+     */
+    getIdentifiers(): string[];
+    /**
+     * Get all variables as object (for passing to PIE elements)
+     *
+     * @returns Plain object with all context variables
+     */
+    toObject(): Record<string, any>;
+    /**
+     * Load state from serialized object (for session restore)
+     *
+     * @param state Object containing context variable values
+     */
+    fromObject(state: Record<string, any>): void;
+    /**
+     * Clear all variables (reset to defaults)
+     */
+    reset(): void;
+    /**
+     * Get declaration for variable
+     *
+     * @param identifier Variable identifier
+     * @returns Declaration or undefined if not found
+     */
+    getDeclaration(identifier: string): ContextDeclaration | undefined;
+    /**
+     * Get all declarations
+     */
+    getDeclarations(): ContextDeclaration[];
+    /**
+     * Get default value for QTI base type
+     *
+     * @private
+     */
+    private getDefaultValueForType;
+    /**
+     * Validate value matches declared type (basic validation)
+     *
+     * @private
+     */
+    private validateValue;
+}
+//# sourceMappingURL=ContextVariableStore.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ContextVariableStore.d.ts","sourceRoot":"","sources":["../../src/services/ContextVariableStore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAEhF;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,oBAAoB;IAChC,OAAO,CAAC,SAAS,CAA+B;IAChD,OAAO,CAAC,YAAY,CAA8C;IAElE;;;;OAIG;gBACS,YAAY,CAAC,EAAE,kBAAkB,EAAE;IAM/C;;;;OAIG;IACH,UAAU,CAAC,YAAY,EAAE,kBAAkB,EAAE,GAAG,IAAI;IAoBpD;;;;;OAKG;IACH,GAAG,CAAC,UAAU,EAAE,MAAM,GAAG,GAAG;IAI5B;;;;;OAKG;IACH,GAAG,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,IAAI;IAiBzC;;OAEG;IACH,GAAG,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAIhC;;OAEG;IACH,cAAc,IAAI,MAAM,EAAE;IAI1B;;;;OAIG;IACH,QAAQ,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAI/B;;;;OAIG;IACH,UAAU,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;IAM5C;;OAEG;IACH,KAAK,IAAI,IAAI;IAWb;;;;;OAKG;IACH,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS;IAIlE;;OAEG;IACH,eAAe,IAAI,kBAAkB,EAAE;IAIvC;;;;OAIG;IACH,OAAO,CAAC,sBAAsB;IAoC9B;;;;OAIG;IACH,OAAO,CAAC,aAAa;CAiCrB"}