@pie-players/pie-assessment-toolkit 0.2.0

package/dist/services/ThemeProvider.d.ts

@@ -0,0 +1,95 @@
+/**
+ * ThemeProvider
+ *
+ * Applies consistent accessibility theming across items and tools.
+ * Uses CSS custom properties and classes for framework-agnostic theming.
+ *
+ * Features:
+ * - High contrast mode
+ * - Font size scaling (small, normal, large, xlarge)
+ * - Color customization (background, foreground, accent)
+ * - Consistent theming across shadow DOM boundaries
+ * - No framework dependencies
+ *
+ * Part of PIE Assessment Toolkit.
+ */
+import type { IThemeProvider } from "./interfaces";
+/**
+ * Font size options
+ */
+export type FontSize = "small" | "normal" | "large" | "xlarge";
+/**
+ * Theme configuration
+ */
+export interface ThemeConfig {
+    highContrast?: boolean;
+    fontSize?: FontSize;
+    backgroundColor?: string;
+    foregroundColor?: string;
+    accentColor?: string;
+    linkColor?: string;
+    errorColor?: string;
+    successColor?: string;
+    warningColor?: string;
+}
+export declare class ThemeProvider implements IThemeProvider {
+    private currentTheme;
+    private styleElement;
+    private rootElement;
+    constructor(rootElement?: HTMLElement | null);
+    /**
+     * Initialize theme styles
+     */
+    private initializeStyles;
+    /**
+     * Apply theme configuration
+     *
+     * @param config Partial theme configuration (merged with current theme)
+     */
+    applyTheme(config: ThemeConfig): void;
+    /**
+     * Apply CSS custom properties to root element
+     */
+    private applyCSSVariables;
+    /**
+     * Apply CSS classes to root element
+     */
+    private applyCSSClasses;
+    /**
+     * Update global theme styles
+     */
+    private updateGlobalStyles;
+    /**
+     * Set high contrast mode
+     */
+    setHighContrast(enabled: boolean): void;
+    /**
+     * Set font size
+     */
+    setFontSize(size: FontSize): void;
+    /**
+     * Set color scheme
+     */
+    setColors(colors: {
+        backgroundColor?: string;
+        foregroundColor?: string;
+        accentColor?: string;
+    }): void;
+    /**
+     * Get current theme configuration
+     */
+    getCurrentTheme(): Required<ThemeConfig>;
+    /**
+     * Reset to default theme
+     */
+    reset(): void;
+    /**
+     * Adjust color opacity (helper)
+     */
+    private adjustOpacity;
+    /**
+     * Cleanup - remove theme styles
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=ThemeProvider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ThemeProvider.d.ts","sourceRoot":"","sources":["../../src/services/ThemeProvider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnD;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,CAAC;AAE/D;;GAEG;AACH,MAAM,WAAW,WAAW;IAC3B,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;CACtB;AAwCD,qBAAa,aAAc,YAAW,cAAc;IACnD,OAAO,CAAC,YAAY,CAA+C;IACnE,OAAO,CAAC,YAAY,CAAiC;IACrD,OAAO,CAAC,WAAW,CAAqB;gBAGvC,WAAW,GAAE,WAAW,GAAG,IAEpB;IAaR;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAkBxB;;;;OAIG;IACH,UAAU,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;IA0BrC;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA6CzB;;OAEG;IACH,OAAO,CAAC,eAAe;IAkBvB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAmF1B;;OAEG;IACH,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAIvC;;OAEG;IACH,WAAW,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI;IAIjC;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE;QACjB,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,WAAW,CAAC,EAAE,MAAM,CAAC;KACrB,GAAG,IAAI;IAIR;;OAEG;IACH,eAAe,IAAI,QAAQ,CAAC,WAAW,CAAC;IAIxC;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb;;OAEG;IACH,OAAO,CAAC,aAAa;IAarB;;OAEG;IACH,OAAO,IAAI,IAAI;CA+Bf"}

package/dist/services/ThemeProvider.js

@@ -0,0 +1,299 @@
+/**
+ * ThemeProvider
+ *
+ * Applies consistent accessibility theming across items and tools.
+ * Uses CSS custom properties and classes for framework-agnostic theming.
+ *
+ * Features:
+ * - High contrast mode
+ * - Font size scaling (small, normal, large, xlarge)
+ * - Color customization (background, foreground, accent)
+ * - Consistent theming across shadow DOM boundaries
+ * - No framework dependencies
+ *
+ * Part of PIE Assessment Toolkit.
+ */
+/**
+ * Font size scale (in rem units)
+ */
+const FONT_SIZE_SCALE = {
+    small: 0.875, // 14px at 16px base
+    normal: 1.0, // 16px at 16px base
+    large: 1.25, // 20px at 16px base
+    xlarge: 1.5, // 24px at 16px base
+};
+/**
+ * Default theme values
+ */
+const DEFAULT_THEME = {
+    highContrast: false,
+    fontSize: "normal",
+    backgroundColor: "#ffffff",
+    foregroundColor: "#333333",
+    accentColor: "#007bff",
+    linkColor: "#007bff",
+    errorColor: "#dc3545",
+    successColor: "#28a745",
+    warningColor: "#ffc107",
+};
+/**
+ * High contrast theme overrides
+ */
+const HIGH_CONTRAST_THEME = {
+    backgroundColor: "#000000",
+    foregroundColor: "#ffffff",
+    accentColor: "#ffff00",
+    linkColor: "#00ffff",
+    errorColor: "#ff0000",
+    successColor: "#00ff00",
+    warningColor: "#ffff00",
+};
+export class ThemeProvider {
+    currentTheme = { ...DEFAULT_THEME };
+    styleElement = null;
+    rootElement;
+    constructor(rootElement = typeof document !== "undefined"
+        ? document.documentElement
+        : null) {
+        this.rootElement = rootElement;
+        // SSR guard
+        if (typeof document === "undefined") {
+            console.warn("ThemeProvider: document not available (SSR context)");
+            return;
+        }
+        this.initializeStyles();
+    }
+    /**
+     * Initialize theme styles
+     */
+    initializeStyles() {
+        if (!this.rootElement)
+            return;
+        // Create style element if it doesn't exist
+        this.styleElement = document.getElementById("pie-theme-styles");
+        if (!this.styleElement) {
+            this.styleElement = document.createElement("style");
+            this.styleElement.id = "pie-theme-styles";
+            document.head.appendChild(this.styleElement);
+        }
+        // Apply default theme
+        this.applyTheme({});
+    }
+    /**
+     * Apply theme configuration
+     *
+     * @param config Partial theme configuration (merged with current theme)
+     */
+    applyTheme(config) {
+        if (!this.rootElement)
+            return;
+        // Merge with current theme
+        const newTheme = {
+            ...this.currentTheme,
+            ...config,
+        };
+        // Apply high contrast overrides if enabled
+        if (newTheme.highContrast) {
+            Object.assign(newTheme, HIGH_CONTRAST_THEME);
+        }
+        this.currentTheme = newTheme;
+        // Apply CSS custom properties
+        this.applyCSSVariables();
+        // Apply CSS classes
+        this.applyCSSClasses();
+        // Update global styles
+        this.updateGlobalStyles();
+    }
+    /**
+     * Apply CSS custom properties to root element
+     */
+    applyCSSVariables() {
+        if (!this.rootElement)
+            return;
+        const { fontSize, backgroundColor, foregroundColor, accentColor, linkColor, errorColor, successColor, warningColor, } = this.currentTheme;
+        // Font sizing
+        this.rootElement.style.setProperty("--pie-font-size-scale", String(FONT_SIZE_SCALE[fontSize]));
+        this.rootElement.style.setProperty("--pie-font-size-base", "1rem");
+        // Colors
+        this.rootElement.style.setProperty("--pie-bg-color", backgroundColor);
+        this.rootElement.style.setProperty("--pie-fg-color", foregroundColor);
+        this.rootElement.style.setProperty("--pie-accent-color", accentColor);
+        this.rootElement.style.setProperty("--pie-link-color", linkColor);
+        this.rootElement.style.setProperty("--pie-error-color", errorColor);
+        this.rootElement.style.setProperty("--pie-success-color", successColor);
+        this.rootElement.style.setProperty("--pie-warning-color", warningColor);
+        // Derived colors (with transparency)
+        this.rootElement.style.setProperty("--pie-bg-color-secondary", this.adjustOpacity(backgroundColor, 0.95));
+        this.rootElement.style.setProperty("--pie-border-color", this.adjustOpacity(foregroundColor, 0.2));
+        this.rootElement.style.setProperty("--pie-hover-color", this.adjustOpacity(accentColor, 0.1));
+    }
+    /**
+     * Apply CSS classes to root element
+     */
+    applyCSSClasses() {
+        if (!this.rootElement)
+            return;
+        const { highContrast, fontSize } = this.currentTheme;
+        // High contrast class
+        this.rootElement.classList.toggle("pie-high-contrast", highContrast);
+        // Font size classes
+        this.rootElement.classList.remove("pie-font-small", "pie-font-normal", "pie-font-large", "pie-font-xlarge");
+        this.rootElement.classList.add(`pie-font-${fontSize}`);
+    }
+    /**
+     * Update global theme styles
+     */
+    updateGlobalStyles() {
+        if (!this.styleElement)
+            return;
+        const { fontSize } = this.currentTheme;
+        const scale = FONT_SIZE_SCALE[fontSize];
+        this.styleElement.textContent = `
+      /* PIE Assessment Toolkit - Theme Styles */
+
+      /* Font scaling */
+      .pie-themed,
+      .pie-themed * {
+        font-size: calc(var(--pie-font-size-base) * var(--pie-font-size-scale, 1));
+      }
+
+      /* Color theming */
+      .pie-themed {
+        background-color: var(--pie-bg-color);
+        color: var(--pie-fg-color);
+      }
+
+      .pie-themed a {
+        color: var(--pie-link-color);
+      }
+
+      .pie-themed a:hover {
+        opacity: 0.8;
+      }
+
+      /* High contrast mode */
+      .pie-high-contrast .pie-themed {
+        border: 2px solid var(--pie-fg-color);
+      }
+
+      .pie-high-contrast .pie-themed a {
+        text-decoration: underline;
+        font-weight: bold;
+      }
+
+      .pie-high-contrast .pie-themed button {
+        border: 2px solid var(--pie-fg-color);
+        background-color: var(--pie-bg-color);
+        color: var(--pie-fg-color);
+      }
+
+      .pie-high-contrast .pie-themed button:hover {
+        background-color: var(--pie-fg-color);
+        color: var(--pie-bg-color);
+      }
+
+      /* Error/Success/Warning states */
+      .pie-themed .pie-error {
+        color: var(--pie-error-color);
+      }
+
+      .pie-themed .pie-success {
+        color: var(--pie-success-color);
+      }
+
+      .pie-themed .pie-warning {
+        color: var(--pie-warning-color);
+      }
+
+      /* Focus indicators (accessibility) */
+      .pie-themed *:focus-visible {
+        outline: 3px solid var(--pie-accent-color);
+        outline-offset: 2px;
+      }
+
+      .pie-high-contrast *:focus-visible {
+        outline-width: 4px;
+      }
+
+      /* Responsive font scaling */
+      @media (max-width: 768px) {
+        .pie-themed,
+        .pie-themed * {
+          font-size: calc(var(--pie-font-size-base) * var(--pie-font-size-scale, 1) * 0.9);
+        }
+      }
+    `;
+    }
+    /**
+     * Set high contrast mode
+     */
+    setHighContrast(enabled) {
+        this.applyTheme({ highContrast: enabled });
+    }
+    /**
+     * Set font size
+     */
+    setFontSize(size) {
+        this.applyTheme({ fontSize: size });
+    }
+    /**
+     * Set color scheme
+     */
+    setColors(colors) {
+        this.applyTheme(colors);
+    }
+    /**
+     * Get current theme configuration
+     */
+    getCurrentTheme() {
+        return { ...this.currentTheme };
+    }
+    /**
+     * Reset to default theme
+     */
+    reset() {
+        this.currentTheme = { ...DEFAULT_THEME };
+        this.applyTheme({});
+    }
+    /**
+     * Adjust color opacity (helper)
+     */
+    adjustOpacity(color, opacity) {
+        // Simple hex to rgba conversion
+        if (color.startsWith("#")) {
+            const r = parseInt(color.slice(1, 3), 16);
+            const g = parseInt(color.slice(3, 5), 16);
+            const b = parseInt(color.slice(5, 7), 16);
+            return `rgba(${r}, ${g}, ${b}, ${opacity})`;
+        }
+        // If already rgba/rgb, just return as-is (simplified)
+        return color;
+    }
+    /**
+     * Cleanup - remove theme styles
+     */
+    destroy() {
+        if (this.styleElement) {
+            this.styleElement.remove();
+            this.styleElement = null;
+        }
+        if (!this.rootElement)
+            return;
+        // Remove CSS classes
+        this.rootElement.classList.remove("pie-high-contrast", "pie-font-small", "pie-font-normal", "pie-font-large", "pie-font-xlarge");
+        // Remove CSS custom properties
+        this.rootElement.style.removeProperty("--pie-font-size-scale");
+        this.rootElement.style.removeProperty("--pie-font-size-base");
+        this.rootElement.style.removeProperty("--pie-bg-color");
+        this.rootElement.style.removeProperty("--pie-fg-color");
+        this.rootElement.style.removeProperty("--pie-accent-color");
+        this.rootElement.style.removeProperty("--pie-link-color");
+        this.rootElement.style.removeProperty("--pie-error-color");
+        this.rootElement.style.removeProperty("--pie-success-color");
+        this.rootElement.style.removeProperty("--pie-warning-color");
+        this.rootElement.style.removeProperty("--pie-bg-color-secondary");
+        this.rootElement.style.removeProperty("--pie-border-color");
+        this.rootElement.style.removeProperty("--pie-hover-color");
+    }
+}
+//# sourceMappingURL=ThemeProvider.js.map

package/dist/services/ThemeProvider.js.map

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

package/dist/services/ToolConfigResolver.d.ts

@@ -0,0 +1,162 @@
+/**
+ * ToolConfigResolver
+ *
+ * Implements 3-tier hierarchy for tool configuration:
+ * Item requirements > Roster allowances > Student accommodations
+ *
+ * Ensures IEP/504 compliance by properly handling accommodation requirements
+ * while respecting item-level and test-level restrictions.
+ *
+ * Features:
+ * - 3-tier configuration hierarchy
+ * - IEP/504 accommodation support
+ * - Item-specific tool requirements
+ * - Test-level tool restrictions
+ * - Type-safe configuration
+ *
+ * Part of PIE Assessment Toolkit.
+ */
+/**
+ * Tool allowance: "0" = blocked, "1" = allowed
+ */
+export type ToolAllowance = "0" | "1";
+/**
+ * Item-level tool configuration (most specific)
+ */
+export interface ItemToolConfig {
+    [toolId: string]: {
+        type?: string;
+        required?: boolean;
+        settings?: any;
+    };
+}
+/**
+ * Roster/Test-level tool allowances (assessment-wide rules)
+ */
+export interface RosterToolConfig {
+    [toolId: string]: ToolAllowance;
+}
+/**
+ * Student accommodation profile (least specific)
+ */
+export interface StudentAccommodations {
+    accommodations: string[];
+}
+/**
+ * Resolved tool configuration
+ */
+export interface ResolvedToolConfig {
+    enabled: boolean;
+    type?: string;
+    required?: boolean;
+    settings?: any;
+    source: "item" | "roster" | "student" | "default";
+}
+/**
+ * Full configuration input
+ */
+export interface ToolConfigInput {
+    itemConfig?: ItemToolConfig;
+    rosterConfig?: RosterToolConfig;
+    studentProfile?: StudentAccommodations;
+}
+export declare class ToolConfigResolver {
+    /**
+     * Resolve configuration for a specific tool
+     *
+     * Hierarchy (highest to lowest priority):
+     * 1. Item level: Item requires scientific calculator → must provide
+     * 2. Roster level: Test blocks dictionary → blocked regardless of accommodation
+     * 3. Student level: IEP requires TTS → enabled unless blocked above
+     *
+     * @param toolId Tool identifier
+     * @param itemConfig Item-level tool configuration
+     * @param rosterConfig Roster-level tool allowances
+     * @param studentProfile Student accommodation profile
+     * @returns Resolved configuration or null if tool not available
+     */
+    resolveTool(toolId: string, itemConfig?: ItemToolConfig, rosterConfig?: RosterToolConfig, studentProfile?: StudentAccommodations): ResolvedToolConfig | null;
+    /**
+     * Resolve all tools from configuration
+     *
+     * @param input Configuration input
+     * @returns Map of tool ID to resolved configuration
+     */
+    resolveAll(input: ToolConfigInput): Map<string, ResolvedToolConfig>;
+    /**
+     * Check if a tool is enabled
+     *
+     * @param toolId Tool identifier
+     * @param input Configuration input
+     * @returns true if tool is enabled
+     */
+    isToolEnabled(toolId: string, input: ToolConfigInput): boolean;
+    /**
+     * Check if a tool is required
+     *
+     * @param toolId Tool identifier
+     * @param input Configuration input
+     * @returns true if tool is required
+     */
+    isToolRequired(toolId: string, input: ToolConfigInput): boolean;
+    /**
+     * Get tool type (e.g., 'scientific' for calculator)
+     *
+     * @param toolId Tool identifier
+     * @param input Configuration input
+     * @returns Tool type or null
+     */
+    getToolType(toolId: string, input: ToolConfigInput): string | null;
+    /**
+     * Get tool settings
+     *
+     * @param toolId Tool identifier
+     * @param input Configuration input
+     * @returns Tool settings or null
+     */
+    getToolSettings(toolId: string, input: ToolConfigInput): any | null;
+    /**
+     * Get list of all enabled tools
+     *
+     * @param input Configuration input
+     * @returns Array of enabled tool IDs
+     */
+    getEnabledTools(input: ToolConfigInput): string[];
+    /**
+     * Get list of required tools
+     *
+     * @param input Configuration input
+     * @returns Array of required tool IDs
+     */
+    getRequiredTools(input: ToolConfigInput): string[];
+    /**
+     * Validate that all required tools are available
+     *
+     * @param availableTools Set of available tool IDs
+     * @param input Configuration input
+     * @returns Object with validation result
+     */
+    validate(availableTools: Set<string>, input: ToolConfigInput): {
+        valid: boolean;
+        missingTools: string[];
+    };
+    /**
+     * Merge multiple roster configurations (for complex assessments)
+     *
+     * More restrictive settings win (blocked > allowed).
+     *
+     * @param configs Array of roster configurations
+     * @returns Merged configuration
+     */
+    mergeRosterConfigs(...configs: RosterToolConfig[]): RosterToolConfig;
+    /**
+     * Merge multiple student accommodation profiles
+     *
+     * Union of all accommodations.
+     *
+     * @param profiles Array of student profiles
+     * @returns Merged profile
+     */
+    mergeStudentProfiles(...profiles: StudentAccommodations[]): StudentAccommodations;
+}
+//# sourceMappingURL=ToolConfigResolver.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ToolConfigResolver.d.ts","sourceRoot":"","sources":["../../src/services/ToolConfigResolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,GAAG,GAAG,GAAG,CAAC;AAEtC;;GAEG;AACH,MAAM,WAAW,cAAc;IAC9B,CAAC,MAAM,EAAE,MAAM,GAAG;QACjB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,QAAQ,CAAC,EAAE,GAAG,CAAC;KACf,CAAC;CACF;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAChC,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACrC,cAAc,EAAE,MAAM,EAAE,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,GAAG,CAAC;IACf,MAAM,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,CAAC;CAClD;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC/B,UAAU,CAAC,EAAE,cAAc,CAAC;IAC5B,YAAY,CAAC,EAAE,gBAAgB,CAAC;IAChC,cAAc,CAAC,EAAE,qBAAqB,CAAC;CACvC;AAED,qBAAa,kBAAkB;IAC9B;;;;;;;;;;;;;OAaG;IACH,WAAW,CACV,MAAM,EAAE,MAAM,EACd,UAAU,CAAC,EAAE,cAAc,EAC3B,YAAY,CAAC,EAAE,gBAAgB,EAC/B,cAAc,CAAC,EAAE,qBAAqB,GACpC,kBAAkB,GAAG,IAAI;IA8C5B;;;;;OAKG;IACH,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,GAAG,CAAC,MAAM,EAAE,kBAAkB,CAAC;IAsCnE;;;;;;OAMG;IACH,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,GAAG,OAAO;IAU9D;;;;;;OAMG;IACH,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,GAAG,OAAO;IAU/D;;;;;;OAMG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,GAAG,MAAM,GAAG,IAAI;IAUlE;;;;;;OAMG;IACH,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,GAAG,GAAG,GAAG,IAAI;IAUnE;;;;;OAKG;IACH,eAAe,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,EAAE;IAOjD;;;;;OAKG;IACH,gBAAgB,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,EAAE;IAOlD;;;;;;OAMG;IACH,QAAQ,CACP,cAAc,EAAE,GAAG,CAAC,MAAM,CAAC,EAC3B,KAAK,EAAE,eAAe,GACpB;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,YAAY,EAAE,MAAM,EAAE,CAAA;KAAE;IAY7C;;;;;;;OAOG;IACH,kBAAkB,CAAC,GAAG,OAAO,EAAE,gBAAgB,EAAE,GAAG,gBAAgB;IAkBpE;;;;;;;OAOG;IACH,oBAAoB,CACnB,GAAG,QAAQ,EAAE,qBAAqB,EAAE,GAClC,qBAAqB;CAWxB"}