euparliamentmonitor 0.8.4

package/scripts/generators/swot-content.js

@@ -0,0 +1,366 @@
+// SPDX-FileCopyrightText: 2024-2026 Hack23 AB
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * @module Generators/SwotContent
+ * @description Pure functions for building SWOT analysis HTML sections.
+ * Generates accessible, CSS-only SWOT matrix visualizations that can be
+ * embedded in any article type. Designed for agentic workflows to extend
+ * articles with strategic analysis using data from MCP servers or other sources.
+ *
+ * The SWOT framework covers:
+ * - **Strengths**: Internal positive factors
+ * - **Weaknesses**: Internal negative factors
+ * - **Opportunities**: External positive factors
+ * - **Threats**: External negative factors
+ *
+ * Multi-dimensional extension adds:
+ * - **Political, Economic, Social, Legal, Geopolitical** dimension drill-downs
+ * - **Stakeholder perspectives** (Citizens, Industry, NGOs, MEPs, Governments, Media)
+ * - **Temporal analysis** (short-term, medium-term, long-term)
+ * - **Cross-references** linking items to EP documents/votes
+ */
+import { escapeHTML, isSafeURL } from '../utils/file-utils.js';
+import { getLocalizedString, SWOT_STRINGS, MULTI_DIMENSIONAL_SWOT_STRINGS, } from '../constants/languages.js';
+// ─── Sub-section builders ────────────────────────────────────────────────────
+/**
+ * Build a single SWOT item HTML.
+ *
+ * @param item - SWOT item with text and optional severity
+ * @returns HTML list item string
+ */
+function buildSwotItem(item) {
+    const severityClass = item.severity ? ` swot-severity-${escapeHTML(item.severity)}` : '';
+    const severityBadge = item.severity
+        ? ` <span class="swot-severity-badge" role="img" aria-label="${escapeHTML(item.severity)}"></span>`
+        : '';
+    return `<li class="swot-item${severityClass}">${escapeHTML(item.text)}${severityBadge}</li>`;
+}
+/**
+ * Build a single SWOT quadrant HTML.
+ *
+ * @param quadrantKey - Quadrant identifier (strengths/weaknesses/opportunities/threats)
+ * @param items - Items in this quadrant
+ * @param label - Localized quadrant heading
+ * @param description - Accessible description
+ * @returns HTML string for one quadrant
+ */
+function buildSwotQuadrant(quadrantKey, items, label, description) {
+    const itemsHtml = items.length > 0
+        ? items.map((item) => buildSwotItem(item)).join('\n                ')
+        : '<li class="swot-item swot-empty">—</li>';
+    return `<div class="swot-quadrant swot-${escapeHTML(quadrantKey)}" role="region" aria-label="${escapeHTML(label)}">
+              <h4 class="swot-quadrant-heading">${escapeHTML(label)}</h4>
+              <p class="swot-quadrant-desc">${escapeHTML(description)}</p>
+              <ul class="swot-list">
+                ${itemsHtml}
+              </ul>
+            </div>`;
+}
+// ─── Main builder ────────────────────────────────────────────────────────────
+/**
+ * Build a complete SWOT analysis section HTML.
+ *
+ * Generates an accessible CSS Grid-based SWOT matrix that can be embedded
+ * in any article type. The visualization is pure HTML/CSS with no JavaScript
+ * required, ensuring compatibility with strict CSP policies.
+ *
+ * Returns an empty string if the analysis is null/undefined or contains
+ * no items in any quadrant.
+ *
+ * @param analysis - SWOT analysis data (null/undefined returns empty string)
+ * @param lang - BCP 47 language code for localized headings (defaults to "en")
+ * @param heading - Optional custom section heading override
+ * @returns HTML section string or empty string
+ */
+export function buildSwotSection(analysis, lang = 'en', heading) {
+    if (!analysis)
+        return '';
+    const totalItems = analysis.strengths.length +
+        analysis.weaknesses.length +
+        analysis.opportunities.length +
+        analysis.threats.length;
+    if (totalItems === 0)
+        return '';
+    const strings = getLocalizedString(SWOT_STRINGS, lang);
+    const sectionHeading = heading ?? analysis.title ?? strings.sectionHeading;
+    const strengthsHtml = buildSwotQuadrant('strengths', analysis.strengths, strings.strengthsLabel, strings.strengthsDesc);
+    const weaknessesHtml = buildSwotQuadrant('weaknesses', analysis.weaknesses, strings.weaknessesLabel, strings.weaknessesDesc);
+    const opportunitiesHtml = buildSwotQuadrant('opportunities', analysis.opportunities, strings.opportunitiesLabel, strings.opportunitiesDesc);
+    const threatsHtml = buildSwotQuadrant('threats', analysis.threats, strings.threatsLabel, strings.threatsDesc);
+    return `
+          <section class="swot-analysis" role="region" aria-label="${escapeHTML(sectionHeading)}">
+            <h2>${escapeHTML(sectionHeading)}</h2>
+            <div class="swot-matrix">
+              <div class="swot-axis-labels">
+                <span class="swot-axis-internal">${escapeHTML(strings.internalLabel)}</span>
+                <span class="swot-axis-external">${escapeHTML(strings.externalLabel)}</span>
+              </div>
+              <div class="swot-grid">
+                <div class="swot-row swot-row-positive">
+                  ${strengthsHtml}
+                  ${opportunitiesHtml}
+                </div>
+                <div class="swot-row swot-row-negative">
+                  ${weaknessesHtml}
+                  ${threatsHtml}
+                </div>
+              </div>
+            </div>
+          </section>`;
+}
+// ─── Multi-dimensional SWOT helpers ─────────────────────────────────────────
+/**
+ * Build a compact SWOT matrix grid (without outer section wrapper).
+ * Used for embedding inside dimension or temporal detail sections.
+ *
+ * @param analysis - SWOT analysis data
+ * @param strings - Localized SWOT strings
+ * @returns HTML string for a compact quadrant grid
+ */
+function buildSwotMiniGrid(analysis, strings) {
+    const sHtml = buildSwotQuadrant('strengths', analysis.strengths, strings.strengthsLabel, strings.strengthsDesc);
+    const wHtml = buildSwotQuadrant('weaknesses', analysis.weaknesses, strings.weaknessesLabel, strings.weaknessesDesc);
+    const oHtml = buildSwotQuadrant('opportunities', analysis.opportunities, strings.opportunitiesLabel, strings.opportunitiesDesc);
+    const tHtml = buildSwotQuadrant('threats', analysis.threats, strings.threatsLabel, strings.threatsDesc);
+    return `<div class="swot-grid swot-mini-grid">
+              <div class="swot-row swot-row-positive">${sHtml}${oHtml}</div>
+              <div class="swot-row swot-row-negative">${wHtml}${tHtml}</div>
+            </div>`;
+}
+/**
+ * Map a dimension name to its localized label.
+ *
+ * @param name - Dimension identifier
+ * @param mdStrings - Localized multi-dimensional SWOT strings
+ * @returns Localized dimension label
+ */
+function getDimensionLabel(name, mdStrings) {
+    const map = {
+        political: mdStrings.dimensionPolitical,
+        economic: mdStrings.dimensionEconomic,
+        social: mdStrings.dimensionSocial,
+        legal: mdStrings.dimensionLegal,
+        geopolitical: mdStrings.dimensionGeopolitical,
+    };
+    return map[name];
+}
+/**
+ * Build the expandable dimension drill-down sections.
+ * Each dimension is rendered as an accessible `<details>` disclosure widget.
+ *
+ * @param dimensions - Array of dimension data
+ * @param swotStrings - Localized SWOT strings for quadrant labels
+ * @param mdStrings - Localized multi-dimensional SWOT strings
+ * @returns HTML string for all dimension sections
+ */
+function buildDimensionsDrillDown(dimensions, swotStrings, mdStrings) {
+    if (dimensions.length === 0)
+        return '';
+    const sectionsHtml = dimensions
+        .map((dim) => {
+        const label = getDimensionLabel(dim.name, mdStrings);
+        const miniGrid = buildSwotMiniGrid(dim, swotStrings);
+        return `<details class="swot-dimension swot-dimension-${escapeHTML(dim.name)}">
+                <summary class="swot-dimension-summary">${escapeHTML(label)}</summary>
+                <div class="swot-dimension-content">${miniGrid}</div>
+              </details>`;
+    })
+        .join('\n              ');
+    return `<div class="swot-dimensions" role="region" aria-label="${escapeHTML(mdStrings.dimensionsLabel)}">
+            <h3 class="swot-section-subheading">${escapeHTML(mdStrings.dimensionsLabel)}</h3>
+            ${sectionsHtml}
+          </div>`;
+}
+/**
+ * Map a stakeholder type to its localized label.
+ *
+ * @param type - Stakeholder type identifier
+ * @param mdStrings - Localized multi-dimensional SWOT strings
+ * @returns Localized stakeholder label
+ */
+function getStakeholderLabel(type, mdStrings) {
+    const map = {
+        citizen: mdStrings.stakeholderCitizen,
+        industry: mdStrings.stakeholderIndustry,
+        ngo: mdStrings.stakeholderNgo,
+        mep: mdStrings.stakeholderMep,
+        government: mdStrings.stakeholderGovernment,
+        media: mdStrings.stakeholderMedia,
+    };
+    return map[type];
+}
+/**
+ * Build the stakeholder perspectives section.
+ * Each stakeholder view is a collapsible `<details>` widget.
+ *
+ * @param stakeholderViews - Map of stakeholder type to SWOT analysis
+ * @param swotStrings - Localized SWOT strings for quadrant labels
+ * @param mdStrings - Localized multi-dimensional SWOT strings
+ * @returns HTML string for the stakeholder section, or empty string if none
+ */
+function buildStakeholderSection(stakeholderViews, swotStrings, mdStrings) {
+    if (!stakeholderViews)
+        return '';
+    const entries = Object.entries(stakeholderViews);
+    const validEntries = entries.filter(([, view]) => {
+        const total = view.strengths.length +
+            view.weaknesses.length +
+            view.opportunities.length +
+            view.threats.length;
+        return total > 0;
+    });
+    if (validEntries.length === 0)
+        return '';
+    const viewsHtml = validEntries
+        .map(([type, view]) => {
+        const label = getStakeholderLabel(type, mdStrings);
+        const miniGrid = buildSwotMiniGrid(view, swotStrings);
+        return `<details class="swot-stakeholder swot-stakeholder-${escapeHTML(type)}">
+                <summary class="swot-stakeholder-summary">${escapeHTML(label)}</summary>
+                <div class="swot-stakeholder-content">${miniGrid}</div>
+              </details>`;
+    })
+        .join('\n              ');
+    return `<div class="swot-stakeholders" role="region" aria-label="${escapeHTML(mdStrings.stakeholderPerspectivesLabel)}">
+            <h3 class="swot-section-subheading">${escapeHTML(mdStrings.stakeholderPerspectivesLabel)}</h3>
+            ${viewsHtml}
+          </div>`;
+}
+/**
+ * Build the temporal analysis section.
+ * Short-term and medium-term (and optionally long-term) periods are
+ * each rendered as a collapsible `<details>` widget.
+ *
+ * @param temporal - Temporal SWOT assessment data
+ * @param swotStrings - Localized SWOT strings for quadrant labels
+ * @param mdStrings - Localized multi-dimensional SWOT strings
+ * @returns HTML string for the temporal section, or empty string if not provided
+ */
+function buildTemporalSection(temporal, swotStrings, mdStrings) {
+    if (!temporal)
+        return '';
+    const renderPeriod = (analysis, label) => {
+        if (!analysis)
+            return '';
+        const total = analysis.strengths.length +
+            analysis.weaknesses.length +
+            analysis.opportunities.length +
+            analysis.threats.length;
+        if (total === 0)
+            return '';
+        const miniGrid = buildSwotMiniGrid(analysis, swotStrings);
+        return `<details class="swot-temporal-period">
+              <summary class="swot-temporal-summary">${escapeHTML(label)}</summary>
+              <div class="swot-temporal-content">${miniGrid}</div>
+            </details>`;
+    };
+    const shortHtml = renderPeriod(temporal.shortTerm, mdStrings.shortTermLabel);
+    const mediumHtml = renderPeriod(temporal.mediumTerm, mdStrings.mediumTermLabel);
+    const longHtml = renderPeriod(temporal.longTerm, mdStrings.longTermLabel);
+    const combinedHtml = shortHtml + mediumHtml + longHtml;
+    if (!combinedHtml)
+        return '';
+    return `<div class="swot-temporal" role="region" aria-label="${escapeHTML(mdStrings.temporalAnalysisLabel)}">
+            <h3 class="swot-section-subheading">${escapeHTML(mdStrings.temporalAnalysisLabel)}</h3>
+            ${combinedHtml}
+          </div>`;
+}
+/**
+ * Build the cross-references section linking SWOT items to EP documents.
+ *
+ * @param crossReferences - Array of cross-reference data
+ * @param mdStrings - Localized multi-dimensional SWOT strings
+ * @returns HTML string for the cross-references section, or empty string if empty
+ */
+function buildCrossReferencesSection(crossReferences, mdStrings) {
+    if (!crossReferences || crossReferences.length === 0)
+        return '';
+    const refsHtml = crossReferences
+        .map((ref) => {
+        const urlPart = ref.url && isSafeURL(ref.url)
+            ? `<a href="${escapeHTML(ref.url)}" class="swot-ref-link" rel="noopener noreferrer">${escapeHTML(ref.documentId)}</a>`
+            : `<span class="swot-ref-id">${escapeHTML(ref.documentId)}</span>`;
+        return `<li class="swot-ref-item">
+                <span class="swot-ref-evidence">${escapeHTML(mdStrings.evidenceLabel)}: ${escapeHTML(ref.itemText)}</span>
+                — ${urlPart}: <cite class="swot-ref-title">${escapeHTML(ref.documentTitle)}</cite>
+              </li>`;
+    })
+        .join('\n              ');
+    return `<div class="swot-cross-references" role="region" aria-label="${escapeHTML(mdStrings.crossReferencesLabel)}">
+            <h3 class="swot-section-subheading">${escapeHTML(mdStrings.crossReferencesLabel)}</h3>
+            <ul class="swot-ref-list">${refsHtml}</ul>
+          </div>`;
+}
+/**
+ * Aggregate all dimension items into a single SwotAnalysis for the primary view.
+ *
+ * @param dimensions - Array of dimension data
+ * @returns Aggregated SwotAnalysis or null if all dimensions are empty
+ */
+function aggregateDimensions(dimensions) {
+    const strengths = dimensions.flatMap((d) => d.strengths);
+    const weaknesses = dimensions.flatMap((d) => d.weaknesses);
+    const opportunities = dimensions.flatMap((d) => d.opportunities);
+    const threats = dimensions.flatMap((d) => d.threats);
+    const total = strengths.length + weaknesses.length + opportunities.length + threats.length;
+    if (total === 0)
+        return null;
+    return { strengths, weaknesses, opportunities, threats };
+}
+// ─── Multi-dimensional SWOT main builder ─────────────────────────────────────
+/**
+ * Build a complete multi-dimensional SWOT analysis section HTML.
+ *
+ * Renders a primary aggregated 4-quadrant SWOT matrix followed by optional:
+ * - **Dimension drill-downs** (Political, Economic, Social, Legal, Geopolitical)
+ *   as CSS-only `<details>` disclosure widgets
+ * - **Stakeholder perspectives** (Citizens, Industry, NGOs, MEPs, etc.)
+ *   as collapsible `<details>` widgets
+ * - **Temporal analysis** (short-term, medium-term, long-term)
+ *   as collapsible `<details>` widgets
+ * - **Cross-references** linking SWOT items to specific EP documents/votes
+ *
+ * All interactivity is CSS-only (no JavaScript), ensuring compatibility
+ * with strict CSP policies and WCAG 2.1 AA accessibility requirements.
+ *
+ * Returns an empty string if the analysis has no dimensions or all
+ * dimensions are empty.
+ *
+ * @param analysis - Multi-dimensional SWOT data (null/undefined returns empty string)
+ * @param lang - BCP 47 language code for localized headings (defaults to "en")
+ * @param heading - Optional custom section heading override
+ * @returns HTML section string or empty string
+ */
+export function buildMultiDimensionalSwotSection(analysis, lang = 'en', heading) {
+    if (!analysis)
+        return '';
+    if (analysis.dimensions.length === 0)
+        return '';
+    const swotStrings = getLocalizedString(SWOT_STRINGS, lang);
+    const mdStrings = getLocalizedString(MULTI_DIMENSIONAL_SWOT_STRINGS, lang);
+    const sectionHeading = heading ?? analysis.title ?? swotStrings.sectionHeading;
+    const aggregated = aggregateDimensions(analysis.dimensions);
+    if (!aggregated)
+        return '';
+    const primaryMatrix = buildSwotMiniGrid(aggregated, swotStrings);
+    const dimensionsHtml = buildDimensionsDrillDown(analysis.dimensions, swotStrings, mdStrings);
+    const stakeholderHtml = buildStakeholderSection(analysis.stakeholderViews, swotStrings, mdStrings);
+    const temporalHtml = buildTemporalSection(analysis.temporal, swotStrings, mdStrings);
+    const refsHtml = buildCrossReferencesSection(analysis.crossReferences, mdStrings);
+    return `
+          <section class="swot-analysis swot-multidimensional" role="region" aria-label="${escapeHTML(sectionHeading)}">
+            <h2>${escapeHTML(sectionHeading)}</h2>
+            <div class="swot-matrix">
+              <div class="swot-axis-labels">
+                <span class="swot-axis-internal">${escapeHTML(swotStrings.internalLabel)}</span>
+                <span class="swot-axis-external">${escapeHTML(swotStrings.externalLabel)}</span>
+              </div>
+              ${primaryMatrix}
+            </div>
+            ${dimensionsHtml}
+            ${stakeholderHtml}
+            ${temporalHtml}
+            ${refsHtml}
+          </section>`;
+}
+//# sourceMappingURL=swot-content.js.map

package/scripts/generators/swot-content.js.map

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

package/scripts/generators/week-ahead-content.d.ts

@@ -0,0 +1,103 @@
+import type { ParliamentEvent, CommitteeMeeting, LegislativeDocument, LegislativeProcedure, ParliamentaryQuestion, WeekAheadData, DateRange, MCPToolResult, LegislativeVelocity, StakeholderImpactSection, PoliticalTemperature } from '../types/index.js';
+/** Placeholder events used when MCP is unavailable or returns no sessions */
+export declare const PLACEHOLDER_EVENTS: ParliamentEvent[];
+/**
+ * Parse plenary sessions from a settled MCP result
+ *
+ * @param settled - Promise.allSettled result
+ * @param fallbackDate - Fallback date when session has none
+ * @returns Array of parliament events
+ */
+export declare function parsePlenarySessions(settled: PromiseSettledResult<MCPToolResult>, fallbackDate: string): ParliamentEvent[];
+/**
+ * Parse EP events (hearings, conferences, seminars) from a settled MCP result
+ *
+ * @param settled - Promise.allSettled result
+ * @param fallbackDate - Fallback date when event has none
+ * @returns Array of parliament events
+ */
+export declare function parseEPEvents(settled: PromiseSettledResult<MCPToolResult>, fallbackDate: string): ParliamentEvent[];
+/**
+ * Parse committee meetings from a settled MCP result
+ *
+ * @param settled - Promise.allSettled result
+ * @param fallbackDate - Fallback date when meeting has no date
+ * @returns Array of committee meetings
+ */
+export declare function parseCommitteeMeetings(settled: PromiseSettledResult<MCPToolResult>, fallbackDate?: string): CommitteeMeeting[];
+/**
+ * Parse legislative documents from a settled MCP result
+ *
+ * @param settled - Promise.allSettled result
+ * @returns Array of legislative documents
+ */
+export declare function parseLegislativeDocuments(settled: PromiseSettledResult<MCPToolResult>): LegislativeDocument[];
+/**
+ * Parse legislative pipeline from a settled MCP result
+ *
+ * @param settled - Promise.allSettled result
+ * @returns Array of legislative procedures
+ */
+export declare function parseLegislativePipeline(settled: PromiseSettledResult<MCPToolResult>): LegislativeProcedure[];
+/**
+ * Parse parliamentary questions from a settled MCP result
+ *
+ * @param settled - Promise.allSettled result
+ * @returns Array of parliamentary questions
+ */
+export declare function parseParliamentaryQuestions(settled: PromiseSettledResult<MCPToolResult>): ParliamentaryQuestion[];
+/**
+ * Compute a composite political temperature score (0–100) indicating how
+ * contentious or urgent the upcoming parliamentary week is likely to be.
+ *
+ * The score is derived from the volume and diversity of scheduled events
+ * and questions — a pure scoring function with no side effects.
+ *
+ * @param events - Plenary / parliamentary events for the week
+ * @param questions - Parliamentary questions tabled for the week
+ * @returns Political temperature score and band
+ */
+export declare function computeWeekPoliticalTemperature(events: readonly ParliamentEvent[], questions: readonly ParliamentaryQuestion[]): PoliticalTemperature;
+/**
+ * Build a stakeholder impact matrix from scheduled events and legislative
+ * documents, assessing which groups are most affected by the agenda.
+ *
+ * Returns an empty section when no events or documents are available
+ * (graceful fallback). This function only constructs raw data; HTML
+ * escaping (for example via `escapeHTML()`) must be applied at render
+ * time by the caller (e.g. in `renderStakeholderSection()`).
+ *
+ * @param events - Parliament events for the upcoming week
+ * @param docs - Legislative documents expected in the period
+ * @param lang - Language code for localized labels (defaults to 'en')
+ * @returns Stakeholder impact section with rows
+ */
+export declare function buildStakeholderImpactMatrix(events: readonly ParliamentEvent[], docs: readonly LegislativeDocument[], lang?: string): StakeholderImpactSection;
+/**
+ * Build article content HTML from week-ahead data
+ *
+ * @param weekData - Aggregated week-ahead data
+ * @param dateRange - Date range for the article
+ * @param lang - Language code for editorial strings (default: 'en')
+ * @returns HTML content string
+ */
+export declare function buildWeekAheadContent(weekData: WeekAheadData, dateRange: DateRange, lang?: string): string;
+/**
+ * Build article keywords from week-ahead data
+ *
+ * @param weekData - Aggregated week-ahead data
+ * @returns Array of keyword strings
+ */
+export declare function buildKeywords(weekData: WeekAheadData): string[];
+/**
+ * Build predictive "What to Watch" analysis section showing legislative
+ * procedures and velocity data ordered by bottleneck risk.
+ * Returns an empty string when both input arrays are empty or yield no items.
+ *
+ * @param procedures - Legislative procedures to analyse
+ * @param velocities - Legislative velocity data (for example from a separate velocity analysis feed)
+ * @param language - BCP 47 language code used as the section lang attribute
+ * @returns HTML string for the "What to Watch" section
+ */
+export declare function buildWhatToWatchSection(procedures: LegislativeProcedure[], velocities: LegislativeVelocity[], language: string): string;
+//# sourceMappingURL=week-ahead-content.d.ts.map

package/scripts/generators/week-ahead-content.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"week-ahead-content.d.ts","sourceRoot":"","sources":["../../src/generators/week-ahead-content.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EACV,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,oBAAoB,EACpB,qBAAqB,EACrB,aAAa,EACb,SAAS,EACT,aAAa,EACb,mBAAmB,EACnB,wBAAwB,EAExB,oBAAoB,EAGrB,MAAM,mBAAmB,CAAC;AAK3B,6EAA6E;AAC7E,eAAO,MAAM,kBAAkB,EAAE,eAAe,EAa/C,CAAC;AA6BF;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,oBAAoB,CAAC,aAAa,CAAC,EAC5C,YAAY,EAAE,MAAM,GACnB,eAAe,EAAE,CAOnB;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,oBAAoB,CAAC,aAAa,CAAC,EAC5C,YAAY,EAAE,MAAM,GACnB,eAAe,EAAE,CAOnB;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,oBAAoB,CAAC,aAAa,CAAC,EAC5C,YAAY,CAAC,EAAE,MAAM,GACpB,gBAAgB,EAAE,CAsBpB;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,oBAAoB,CAAC,aAAa,CAAC,GAC3C,mBAAmB,EAAE,CAUvB;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,oBAAoB,CAAC,aAAa,CAAC,GAC3C,oBAAoB,EAAE,CASxB;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,oBAAoB,CAAC,aAAa,CAAC,GAC3C,qBAAqB,EAAE,CASzB;AAuJD;;;;;;;;;;GAUG;AACH,wBAAgB,+BAA+B,CAC7C,MAAM,EAAE,SAAS,eAAe,EAAE,EAClC,SAAS,EAAE,SAAS,qBAAqB,EAAE,GAC1C,oBAAoB,CAYtB;AAcD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,SAAS,eAAe,EAAE,EAClC,IAAI,EAAE,SAAS,mBAAmB,EAAE,EACpC,IAAI,GAAE,MAAa,GAClB,wBAAwB,CAsD1B;AA6ED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,aAAa,EACvB,SAAS,EAAE,SAAS,EACpB,IAAI,SAAO,GACV,MAAM,CAuER;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,aAAa,GAAG,MAAM,EAAE,CAU/D;AAoED;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CACrC,UAAU,EAAE,oBAAoB,EAAE,EAClC,UAAU,EAAE,mBAAmB,EAAE,EACjC,QAAQ,EAAE,MAAM,GACf,MAAM,CAeR"}