@memberjunction/core-actions 2.107.0 → 2.109.0

package/dist/custom/visualization/shared/svg-utils.js

@@ -0,0 +1,555 @@
+"use strict";
+/**
+ * @fileoverview Utility functions for SVG creation, manipulation, and sanitization.
+ * These utilities provide security, consistency, and convenience for all visualization actions.
+ *
+ * @module @memberjunction/actions-core/visualization
+ * @since 2.107.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SVGUtils = void 0;
+const jsdom_1 = require("jsdom");
+/**
+ * Utility class for SVG operations
+ */
+class SVGUtils {
+    /**
+     * Creates a base SVG element with proper namespace and dimensions
+     *
+     * @param width - SVG width in pixels
+     * @param height - SVG height in pixels
+     * @param idPrefix - Optional ID prefix for the root SVG element
+     * @returns JSDOM Document containing the SVG
+     */
+    static createSVG(width, height, idPrefix) {
+        const svgId = idPrefix ? ` id="${idPrefix}-root"` : '';
+        const dom = new jsdom_1.JSDOM(`<svg xmlns="http://www.w3.org/2000/svg"
+                                     width="${width}"
+                                     height="${height}"
+                                     viewBox="0 0 ${width} ${height}"${svgId}
+                                ></svg>`);
+        return dom.window.document;
+    }
+    /**
+     * Sanitizes text content to prevent XSS attacks
+     *
+     * @param text - Raw text content
+     * @returns HTML-safe text
+     */
+    static sanitizeText(text) {
+        return text
+            .replace(/&/g, '&amp;')
+            .replace(/</g, '&lt;')
+            .replace(/>/g, '&gt;')
+            .replace(/"/g, '&quot;')
+            .replace(/'/g, '&#039;');
+    }
+    /**
+     * Sanitizes SVG string to remove potentially malicious content
+     * - Removes event handlers (on*)
+     * - Removes external image references
+     * - Removes external use references
+     * - Restricts href to # and mailto: only
+     *
+     * @param svgString - Raw SVG XML string
+     * @returns Sanitized SVG string
+     */
+    static sanitizeSVG(svgString) {
+        let sanitized = svgString;
+        // Remove event handlers
+        sanitized = sanitized.replace(/\son\w+="[^"]*"/gi, '');
+        sanitized = sanitized.replace(/\son\w+='[^']*'/gi, '');
+        // Remove external xlink:href (keep data URIs)
+        sanitized = sanitized.replace(/xlink:href="(?!data:)[^"]*"/gi, 'xlink:href=""');
+        // Remove external href (keep # anchors and mailto:)
+        sanitized = sanitized.replace(/href="(?!#|mailto:)[^"]*"/gi, 'href=""');
+        // Remove script tags
+        sanitized = sanitized.replace(/<script[\s\S]*?<\/script>/gi, '');
+        return sanitized;
+    }
+    /**
+     * Generates a unique ID with prefix and timestamp
+     *
+     * @param prefix - ID prefix (e.g., 'flow', 'node')
+     * @param index - Index or identifier
+     * @returns Unique ID string
+     */
+    static generateId(prefix, index) {
+        return `${prefix}-${index}-${Date.now()}`;
+    }
+    /**
+     * Adds accessibility elements to SVG root
+     *
+     * @param svg - SVG element to enhance
+     * @param a11y - Accessibility configuration
+     */
+    static addA11y(svg, a11y) {
+        if (!a11y)
+            return;
+        const doc = svg.ownerDocument;
+        const ns = svg.namespaceURI;
+        // Add title
+        if (a11y.title) {
+            const title = doc.createElementNS(ns, 'title');
+            title.textContent = a11y.title;
+            svg.insertBefore(title, svg.firstChild);
+        }
+        // Add description
+        if (a11y.desc) {
+            const desc = doc.createElementNS(ns, 'desc');
+            desc.textContent = a11y.desc;
+            // Insert after title if it exists
+            const titleEl = svg.querySelector('title');
+            if (titleEl && titleEl.nextSibling) {
+                svg.insertBefore(desc, titleEl.nextSibling);
+            }
+            else {
+                svg.insertBefore(desc, svg.firstChild);
+            }
+        }
+        // Set ARIA role
+        if (a11y.ariaRole) {
+            svg.setAttribute('role', a11y.ariaRole);
+        }
+    }
+    /**
+     * Injects inline CSS styles into SVG
+     *
+     * @param svg - SVG element
+     * @param css - CSS string to inject
+     */
+    static addStyles(svg, css) {
+        const doc = svg.ownerDocument;
+        const ns = svg.namespaceURI;
+        const style = doc.createElementNS(ns, 'style');
+        style.textContent = css;
+        // Insert style after title/desc but before content
+        const lastMetaElement = Array.from(svg.children).find((el) => el.tagName === 'desc' || el.tagName === 'title');
+        if (lastMetaElement && lastMetaElement.nextSibling) {
+            svg.insertBefore(style, lastMetaElement.nextSibling);
+        }
+        else {
+            svg.insertBefore(style, svg.firstChild);
+        }
+    }
+    /**
+     * Calculates viewBox with padding applied
+     *
+     * @param viewBox - ViewBox configuration
+     * @returns Padding-adjusted dimensions and offsets
+     */
+    static calculateViewBox(viewBox) {
+        let top = 0, right = 0, bottom = 0, left = 0;
+        if (viewBox.padding !== undefined) {
+            if (typeof viewBox.padding === 'number') {
+                top = right = bottom = left = viewBox.padding;
+            }
+            else {
+                top = viewBox.padding.top || 0;
+                right = viewBox.padding.right || 0;
+                bottom = viewBox.padding.bottom || 0;
+                left = viewBox.padding.left || 0;
+            }
+        }
+        return {
+            x: left,
+            y: top,
+            width: viewBox.width,
+            height: viewBox.height,
+            contentWidth: viewBox.width - left - right,
+            contentHeight: viewBox.height - top - bottom,
+        };
+    }
+    /**
+     * Creates a <defs> element if it doesn't exist in SVG
+     *
+     * @param svg - SVG element
+     * @returns The defs element (existing or newly created)
+     */
+    static getOrCreateDefs(svg) {
+        let defs = svg.querySelector('defs');
+        if (!defs) {
+            defs = svg.ownerDocument.createElementNS(svg.namespaceURI, 'defs');
+            svg.insertBefore(defs, svg.firstChild);
+        }
+        return defs;
+    }
+    /**
+     * Adds an arrowhead marker definition to SVG
+     *
+     * @param svg - SVG element
+     * @param id - Marker ID
+     * @param color - Arrow color
+     * @returns Marker ID for use in marker-end attribute
+     */
+    static addArrowMarker(svg, id, color = '#000') {
+        const defs = this.getOrCreateDefs(svg);
+        const doc = svg.ownerDocument;
+        const ns = svg.namespaceURI;
+        // Check if marker already exists
+        if (defs.querySelector(`#${id}`)) {
+            return `url(#${id})`;
+        }
+        const marker = doc.createElementNS(ns, 'marker');
+        marker.setAttribute('id', id);
+        marker.setAttribute('markerWidth', '10');
+        marker.setAttribute('markerHeight', '10');
+        marker.setAttribute('refX', '9');
+        marker.setAttribute('refY', '3');
+        marker.setAttribute('orient', 'auto');
+        marker.setAttribute('markerUnits', 'strokeWidth');
+        const path = doc.createElementNS(ns, 'path');
+        path.setAttribute('d', 'M0,0 L0,6 L9,3 z');
+        path.setAttribute('fill', color);
+        marker.appendChild(path);
+        defs.appendChild(marker);
+        return `url(#${id})`;
+    }
+    /**
+     * Creates a seeded pseudo-random number generator
+     * Uses simple Linear Congruential Generator for deterministic output
+     *
+     * @param seed - Random seed
+     * @returns Function that returns random numbers between 0 and 1
+     */
+    static seededRandom(seed) {
+        let s = seed;
+        return function () {
+            s = (s * 9301 + 49297) % 233280;
+            return s / 233280;
+        };
+    }
+    /**
+     * Wraps text to fit within a specified width
+     *
+     * @param text - Text to wrap
+     * @param maxWidth - Maximum width in characters (approximate)
+     * @returns Array of text lines
+     */
+    static wrapText(text, maxWidth) {
+        const words = text.split(/\s+/);
+        const lines = [];
+        let currentLine = '';
+        for (const word of words) {
+            const testLine = currentLine ? `${currentLine} ${word}` : word;
+            if (testLine.length <= maxWidth) {
+                currentLine = testLine;
+            }
+            else {
+                if (currentLine)
+                    lines.push(currentLine);
+                currentLine = word;
+            }
+        }
+        if (currentLine)
+            lines.push(currentLine);
+        return lines;
+    }
+    /**
+     * Calculates text width (approximate based on character count and font size)
+     * More accurate measurement would require actual rendering
+     *
+     * @param text - Text content
+     * @param fontSize - Font size in pixels
+     * @returns Estimated width in pixels
+     */
+    static estimateTextWidth(text, fontSize = 14) {
+        // Average character width is approximately 0.6 of font size
+        return text.length * fontSize * 0.6;
+    }
+    /**
+     * Creates a rounded rectangle path
+     *
+     * @param x - X coordinate
+     * @param y - Y coordinate
+     * @param width - Width
+     * @param height - Height
+     * @param radius - Corner radius
+     * @returns SVG path data string
+     */
+    static roundedRectPath(x, y, width, height, radius) {
+        radius = Math.min(radius, width / 2, height / 2);
+        return `
+            M ${x + radius},${y}
+            L ${x + width - radius},${y}
+            Q ${x + width},${y} ${x + width},${y + radius}
+            L ${x + width},${y + height - radius}
+            Q ${x + width},${y + height} ${x + width - radius},${y + height}
+            L ${x + radius},${y + height}
+            Q ${x},${y + height} ${x},${y + height - radius}
+            L ${x},${y + radius}
+            Q ${x},${y} ${x + radius},${y}
+            Z
+        `.replace(/\s+/g, ' ').trim();
+    }
+    /**
+     * Wraps SVG string in a scrollable HTML container
+     * Useful for large visualizations that exceed viewport size
+     *
+     * @param svgString - The SVG XML string to wrap
+     * @param maxWidth - Maximum container width in pixels (default: 1200)
+     * @param maxHeight - Maximum container height in pixels (default: 800)
+     * @param showBorder - Whether to show container border (default: true)
+     * @param borderColor - Border color (default: #ddd)
+     * @returns HTML string with SVG wrapped in scrollable div
+     */
+    static wrapWithScrollContainer(svgString, maxWidth = 1200, maxHeight = 800, showBorder = true, borderColor = '#ddd') {
+        const borderStyle = showBorder ? `border: 1px solid ${borderColor};` : '';
+        return `<div style="max-width: ${maxWidth}px; max-height: ${maxHeight}px; overflow: auto; ${borderStyle} border-radius: 4px; background: white; box-shadow: 0 2px 4px rgba(0,0,0,0.1);">${svgString}</div>`;
+    }
+    /**
+     * Generates self-contained pan/zoom script for SVG
+     * No external dependencies - fully embedded JavaScript
+     *
+     * @param containerId - ID of the SVG group to apply transform to
+     * @param minScale - Minimum zoom level (default: 0.5)
+     * @param maxScale - Maximum zoom level (default: 3)
+     * @param showControls - Show zoom in/out/reset buttons (default: false)
+     * @returns Script tag with pan/zoom implementation
+     */
+    static generatePanZoomScript(containerId = 'pan-zoom-container', minScale = 0.5, maxScale = 3, showControls = false) {
+        return `<script type="text/javascript"><![CDATA[
+(function() {
+    const svg = document.currentScript.closest('svg');
+    const container = svg.getElementById('${containerId}');
+    if (!container) return;
+
+    let scale = 1, translateX = 0, translateY = 0;
+    let isDragging = false, startX, startY;
+
+    function updateTransform() {
+        container.setAttribute('transform',
+            'translate(' + translateX + ',' + translateY + ') scale(' + scale + ')');
+    }
+
+    // Mouse wheel zoom
+    svg.addEventListener('wheel', function(e) {
+        e.preventDefault();
+        const delta = e.deltaY > 0 ? 0.9 : 1.1;
+        const newScale = Math.max(${minScale}, Math.min(${maxScale}, scale * delta));
+
+        // Zoom toward mouse position
+        const rect = svg.getBoundingClientRect();
+        const x = e.clientX - rect.left;
+        const y = e.clientY - rect.top;
+
+        translateX = x - (x - translateX) * (newScale / scale);
+        translateY = y - (y - translateY) * (newScale / scale);
+        scale = newScale;
+
+        updateTransform();
+    });
+
+    // Pan with drag
+    svg.addEventListener('mousedown', function(e) {
+        if (e.button !== 0) return; // Left button only
+        isDragging = true;
+        startX = e.clientX - translateX;
+        startY = e.clientY - translateY;
+        svg.style.cursor = 'grabbing';
+    });
+
+    svg.addEventListener('mousemove', function(e) {
+        if (!isDragging) return;
+        translateX = e.clientX - startX;
+        translateY = e.clientY - startY;
+        updateTransform();
+    });
+
+    svg.addEventListener('mouseup', function() {
+        isDragging = false;
+        svg.style.cursor = 'grab';
+    });
+
+    svg.addEventListener('mouseleave', function() {
+        isDragging = false;
+        svg.style.cursor = 'default';
+    });
+
+    // Touch gestures
+    let touchStartDist = 0;
+    let touch1StartX = 0, touch1StartY = 0;
+
+    svg.addEventListener('touchstart', function(e) {
+        if (e.touches.length === 2) {
+            touchStartDist = Math.hypot(
+                e.touches[0].clientX - e.touches[1].clientX,
+                e.touches[0].clientY - e.touches[1].clientY
+            );
+        } else if (e.touches.length === 1) {
+            touch1StartX = e.touches[0].clientX - translateX;
+            touch1StartY = e.touches[0].clientY - translateY;
+        }
+    });
+
+    svg.addEventListener('touchmove', function(e) {
+        if (e.touches.length === 2) {
+            e.preventDefault();
+            const dist = Math.hypot(
+                e.touches[0].clientX - e.touches[1].clientX,
+                e.touches[0].clientY - e.touches[1].clientY
+            );
+            const delta = dist / touchStartDist;
+            scale = Math.max(${minScale}, Math.min(${maxScale}, scale * delta));
+            touchStartDist = dist;
+            updateTransform();
+        } else if (e.touches.length === 1 && !isDragging) {
+            translateX = e.touches[0].clientX - touch1StartX;
+            translateY = e.touches[0].clientY - touch1StartY;
+            updateTransform();
+        }
+    });
+
+    svg.style.cursor = 'grab';
+    ${showControls ? this.generateZoomControlsScript() : ''}
+})();
+]]></script>`;
+    }
+    /**
+     * Generates zoom control buttons script
+     * @returns Script code for zoom controls (internal use)
+     */
+    static generateZoomControlsScript() {
+        return `
+    // Add zoom controls
+    const controlsGroup = document.createElementNS('http://www.w3.org/2000/svg', 'g');
+    controlsGroup.setAttribute('id', 'zoom-controls');
+    controlsGroup.setAttribute('transform', 'translate(10, 10)');
+
+    const minScaleVal = ${0.5};
+    const maxScaleVal = ${3};
+
+    const buttonData = [
+        { y: 0, text: '+', action: 'in' },
+        { y: 35, text: '-', action: 'out' },
+        { y: 70, text: '⟲', action: 'reset' }
+    ];
+
+    buttonData.forEach(function(btn) {
+        const g = document.createElementNS('http://www.w3.org/2000/svg', 'g');
+        g.style.cursor = 'pointer';
+
+        const rect = document.createElementNS('http://www.w3.org/2000/svg', 'rect');
+        rect.setAttribute('width', '30');
+        rect.setAttribute('height', '30');
+        rect.setAttribute('y', btn.y);
+        rect.setAttribute('fill', '#fff');
+        rect.setAttribute('stroke', '#333');
+        rect.setAttribute('stroke-width', '1');
+        rect.setAttribute('rx', '4');
+
+        const text = document.createElementNS('http://www.w3.org/2000/svg', 'text');
+        text.setAttribute('x', '15');
+        text.setAttribute('y', btn.y + 20);
+        text.setAttribute('text-anchor', 'middle');
+        text.setAttribute('font-size', '16');
+        text.setAttribute('font-weight', 'bold');
+        text.textContent = btn.text;
+
+        g.appendChild(rect);
+        g.appendChild(text);
+
+        g.addEventListener('click', function() {
+            if (btn.action === 'in') {
+                scale = Math.min(maxScaleVal, scale * 1.2);
+            } else if (btn.action === 'out') {
+                scale = Math.max(minScaleVal, scale * 0.8);
+            } else if (btn.action === 'reset') {
+                scale = 1;
+                translateX = 0;
+                translateY = 0;
+            }
+            updateTransform();
+        });
+
+        controlsGroup.appendChild(g);
+    });
+
+    svg.appendChild(controlsGroup);
+    `;
+    }
+    /**
+     * Generates interactive tooltip script for SVG elements
+     * Elements must have data-tooltip attribute
+     *
+     * @param svg - SVG element to add tooltip to
+     * @param doc - Document to create elements in
+     * @returns Script tag with tooltip implementation
+     */
+    static addTooltipSupport(svg, doc) {
+        const ns = svg.namespaceURI;
+        // Create tooltip text element
+        const tooltip = doc.createElementNS(ns, 'text');
+        tooltip.setAttribute('id', 'mj-tooltip');
+        tooltip.setAttribute('visibility', 'hidden');
+        tooltip.setAttribute('pointer-events', 'none');
+        tooltip.setAttribute('font-size', '12');
+        tooltip.setAttribute('font-family', 'sans-serif');
+        tooltip.setAttribute('fill', '#000');
+        // Add background rect for better readability
+        const tooltipBg = doc.createElementNS(ns, 'rect');
+        tooltipBg.setAttribute('id', 'mj-tooltip-bg');
+        tooltipBg.setAttribute('visibility', 'hidden');
+        tooltipBg.setAttribute('pointer-events', 'none');
+        tooltipBg.setAttribute('fill', '#fff');
+        tooltipBg.setAttribute('stroke', '#333');
+        tooltipBg.setAttribute('stroke-width', '1');
+        tooltipBg.setAttribute('rx', '3');
+        tooltipBg.setAttribute('opacity', '0.95');
+        svg.appendChild(tooltipBg);
+        svg.appendChild(tooltip);
+        // Add script for tooltip behavior
+        const script = doc.createElementNS(ns, 'script');
+        script.setAttribute('type', 'text/javascript');
+        script.textContent = `
+(function() {
+    const svg = document.currentScript.closest('svg');
+    const tooltip = svg.getElementById('mj-tooltip');
+    const tooltipBg = svg.getElementById('mj-tooltip-bg');
+
+    svg.querySelectorAll('[data-tooltip]').forEach(function(el) {
+        el.addEventListener('mouseenter', function(e) {
+            const content = this.getAttribute('data-tooltip');
+            const rect = svg.getBoundingClientRect();
+            const x = e.clientX - rect.left + 10;
+            const y = e.clientY - rect.top - 10;
+
+            tooltip.textContent = content;
+            tooltip.setAttribute('x', x);
+            tooltip.setAttribute('y', y);
+            tooltip.setAttribute('visibility', 'visible');
+
+            // Size background to text
+            const bbox = tooltip.getBBox();
+            tooltipBg.setAttribute('x', bbox.x - 4);
+            tooltipBg.setAttribute('y', bbox.y - 2);
+            tooltipBg.setAttribute('width', bbox.width + 8);
+            tooltipBg.setAttribute('height', bbox.height + 4);
+            tooltipBg.setAttribute('visibility', 'visible');
+        });
+
+        el.addEventListener('mouseleave', function() {
+            tooltip.setAttribute('visibility', 'hidden');
+            tooltipBg.setAttribute('visibility', 'hidden');
+        });
+
+        el.addEventListener('mousemove', function(e) {
+            const rect = svg.getBoundingClientRect();
+            const x = e.clientX - rect.left + 10;
+            const y = e.clientY - rect.top - 10;
+
+            tooltip.setAttribute('x', x);
+            tooltip.setAttribute('y', y);
+
+            const bbox = tooltip.getBBox();
+            tooltipBg.setAttribute('x', bbox.x - 4);
+            tooltipBg.setAttribute('y', bbox.y - 2);
+        });
+    });
+})();
+        `;
+        svg.appendChild(script);
+    }
+}
+exports.SVGUtils = SVGUtils;
+//# sourceMappingURL=svg-utils.js.map

package/dist/custom/visualization/shared/svg-utils.js.map

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

package/dist/custom/web/google-custom-search.action.d.ts

@@ -30,18 +30,23 @@ import { BaseAction } from "@memberjunction/actions";
  *   }, {
  *     Name: 'SiteSearch',
  *     Value: 'europa.eu'
+ *   }, {
+ *     Name: 'Verbosity',
+ *     Value: 'minimal'  // 'minimal' | 'standard' (default) | 'detailed'
  *   }]
  * });
  * ```
  */
 export declare class GoogleCustomSearchAction extends BaseAction {
     protected InternalRunAction(params: RunActionParams): Promise<ActionResultSimple>;
-    private transformItem;
+    private transformItemByVerbosity;
+    private buildResultData;
     private extractFirstString;
     private normalizeSafeSearch;
     private normalizeSiteSearchFilter;
     private normalizeLanguageRestriction;
     private normalizeSearchType;
+    private normalizeVerbosity;
     private clamp;
     private getStringParam;
     private getNumericParam;

package/dist/custom/web/google-custom-search.action.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"google-custom-search.action.d.ts","sourceRoot":"","sources":["../../../src/custom/web/google-custom-search.action.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACnF,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AA6BrD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,qBACa,wBAAyB,SAAQ,UAAU;cAEpC,iBAAiB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,kBAAkB,CAAC;IA6JvF,OAAO,CAAC,aAAa;IAoBrB,OAAO,CAAC,kBAAkB;IAsB1B,OAAO,CAAC,mBAAmB;IAsB3B,OAAO,CAAC,yBAAyB;IAgBjC,OAAO,CAAC,4BAA4B;IAiBpC,OAAO,CAAC,mBAAmB;IAa3B,OAAO,CAAC,KAAK;IAQb,OAAO,CAAC,cAAc;IAUtB,OAAO,CAAC,eAAe;IAUvB,OAAO,CAAC,cAAc;IAQtB,OAAO,CAAC,iBAAiB;CAO5B;AAED;;GAEG;AACH,wBAAgB,4BAA4B,SAE3C"}
+{"version":3,"file":"google-custom-search.action.d.ts","sourceRoot":"","sources":["../../../src/custom/web/google-custom-search.action.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACnF,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AA6BrD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,qBACa,wBAAyB,SAAQ,UAAU;cAEpC,iBAAiB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAyJvF,OAAO,CAAC,wBAAwB;IAyChC,OAAO,CAAC,eAAe;IAmCvB,OAAO,CAAC,kBAAkB;IAsB1B,OAAO,CAAC,mBAAmB;IAsB3B,OAAO,CAAC,yBAAyB;IAgBjC,OAAO,CAAC,4BAA4B;IAiBpC,OAAO,CAAC,mBAAmB;IAa3B,OAAO,CAAC,kBAAkB;IA0B1B,OAAO,CAAC,KAAK;IAQb,OAAO,CAAC,cAAc;IAUtB,OAAO,CAAC,eAAe;IAUvB,OAAO,CAAC,cAAc;IAQtB,OAAO,CAAC,iBAAiB;CAO5B;AAED;;GAEG;AACH,wBAAgB,4BAA4B,SAE3C"}