euparliamentmonitor 0.8.4

package/scripts/utils/validate-articles.js

@@ -0,0 +1,284 @@
+// SPDX-FileCopyrightText: 2024-2026 Hack23 AB
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * @module Utils/ValidateArticles
+ * @description CI-ready article validation tool that checks all news articles
+ * for quality, structural correctness, language consistency, and meta tag alignment.
+ *
+ * Can be run standalone or integrated into CI pipelines as a quality gate.
+ * Exits with code 1 if any article has validation errors.
+ *
+ * Usage:
+ * - Validate all articles: `npx tsx src/utils/validate-articles.ts`
+ * - Validate specific date: `npx tsx src/utils/validate-articles.ts --date=2026-03-04`
+ * - Strict mode (warnings are errors): `npx tsx src/utils/validate-articles.ts --strict`
+ * - Dry run (no exit code): `npx tsx src/utils/validate-articles.ts --dry-run`
+ * - Quality scoring: `npx tsx src/utils/validate-articles.ts --quality`
+ * - JSON output: `npx tsx src/utils/validate-articles.ts --quality --output=json`
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { NEWS_DIR, ARTICLE_FILENAME_PATTERN } from '../constants/config.js';
+import { validateArticleContent } from './content-validator.js';
+import { scoreArticleQuality } from './article-quality-scorer.js';
+// ─── CLI argument parsing ─────────────────────────────────────────────────────
+const args = process.argv.slice(2);
+/**
+ * Extract a CLI flag value: --flag=value
+ *
+ * @param name - Flag name to extract
+ * @returns Flag value or undefined if not found
+ */
+function getArg(name) {
+    const prefix = `--${name}=`;
+    const arg = args.find((a) => a.startsWith(prefix));
+    return arg?.slice(prefix.length);
+}
+const filterDate = getArg('date');
+const strictMode = args.includes('--strict');
+const dryRun = args.includes('--dry-run');
+const qualityMode = args.includes('--quality');
+const outputFormat = getArg('output');
+// ─── Slug-to-article-type mapping ─────────────────────────────────────────────
+/**
+ * Map article slug to article type for validator word-count thresholds.
+ * The slug is the middle portion of the filename: {date}-{slug}-{lang}.html
+ *
+ * @param slug - Article slug (e.g. "week-ahead", "breaking", "committee-reports")
+ * @returns Article type string matching ArticleCategory values
+ */
+function slugToArticleType(slug) {
+    const mapping = {
+        'week-ahead': 'week-ahead',
+        'month-ahead': 'month-ahead',
+        breaking: 'breaking',
+        'committee-reports': 'committee-reports',
+        propositions: 'propositions',
+        motions: 'motions',
+        'week-in-review': 'week-in-review',
+        'month-in-review': 'month-in-review',
+        'weekly-review': 'week-in-review',
+        'monthly-review': 'month-in-review',
+    };
+    return mapping[slug] ?? slug;
+}
+// ─── Main validation logic ────────────────────────────────────────────────────
+/**
+ * Validate a single article file and return a summary.
+ *
+ * @param filename - Filename of the article to validate
+ * @returns Article validation summary or null if the filename does not match
+ */
+function validateSingleFile(filename) {
+    const match = ARTICLE_FILENAME_PATTERN.exec(filename);
+    if (!match)
+        return null;
+    const date = match[1] ?? '';
+    const slug = match[2] ?? '';
+    const lang = match[3] ?? '';
+    const filePath = path.join(NEWS_DIR, filename);
+    const html = fs.readFileSync(filePath, 'utf-8');
+    const articleType = slugToArticleType(slug);
+    const result = validateArticleContent(html, lang, articleType);
+    const summary = {
+        filename,
+        lang,
+        slug,
+        date,
+        valid: strictMode ? result.valid && result.warnings.length === 0 : result.valid,
+        errors: [...result.errors],
+        warnings: [...result.warnings],
+        wordCount: result.metrics.wordCount,
+    };
+    if (strictMode && result.warnings.length > 0) {
+        summary.errors.push(...result.warnings.map((w) => `[strict] ${w}`));
+    }
+    if (qualityMode) {
+        summary.qualityReport = scoreArticleQuality(html, `${date}-${slug}`, lang, articleType);
+    }
+    return summary;
+}
+/**
+ * Validate all news articles in the news directory.
+ *
+ * @returns Validation report with per-article summaries
+ */
+function validateAllArticles() {
+    if (!fs.existsSync(NEWS_DIR)) {
+        console.error(`❌ News directory not found: ${NEWS_DIR}`);
+        return { totalArticles: 0, passed: 0, failed: 0, warnings: 0, articles: [] };
+    }
+    const files = fs
+        .readdirSync(NEWS_DIR)
+        .filter((f) => f.endsWith('.html'))
+        .filter((f) => ARTICLE_FILENAME_PATTERN.test(f))
+        .filter((f) => (filterDate ? f.startsWith(filterDate) : true))
+        .sort();
+    const articles = [];
+    let passed = 0;
+    let failed = 0;
+    let warningCount = 0;
+    for (const filename of files) {
+        const summary = validateSingleFile(filename);
+        if (!summary)
+            continue;
+        if (summary.valid) {
+            passed++;
+        }
+        else {
+            failed++;
+        }
+        if (summary.warnings.length > 0) {
+            warningCount++;
+        }
+        articles.push(summary);
+    }
+    const report = {
+        totalArticles: files.length,
+        passed,
+        failed,
+        warnings: warningCount,
+        articles,
+    };
+    if (qualityMode) {
+        report.gradeDistribution = buildGradeDistribution(articles);
+    }
+    return report;
+}
+/**
+ * Build a grade distribution map from article quality reports.
+ *
+ * @param articles - Array of article validation summaries
+ * @returns Grade distribution counts
+ */
+function buildGradeDistribution(articles) {
+    const distribution = { A: 0, B: 0, C: 0, D: 0, F: 0 };
+    for (const article of articles) {
+        if (article.qualityReport) {
+            distribution[article.qualityReport.grade]++;
+        }
+    }
+    return distribution;
+}
+/**
+ * Print a formatted validation report to the console.
+ *
+ * @param report - Validation report to print
+ */
+function printReport(report) {
+    console.log('\n════════════════════════════════════════════════════════════════');
+    console.log('  EU Parliament Monitor — Article Validation Report');
+    console.log('════════════════════════════════════════════════════════════════\n');
+    if (filterDate) {
+        console.log(`  Filter: articles from ${filterDate}`);
+    }
+    if (strictMode) {
+        console.log('  Mode: STRICT (warnings treated as errors)');
+    }
+    if (qualityMode) {
+        console.log('  Mode: QUALITY scoring enabled');
+    }
+    console.log(`  Total articles:  ${report.totalArticles}`);
+    console.log(`  ✅ Passed:       ${report.passed}`);
+    console.log(`  ❌ Failed:       ${report.failed}`);
+    console.log(`  ⚠️  With warnings: ${report.warnings}\n`);
+    printFailures(report);
+    printWarnings(report);
+    if (qualityMode) {
+        printQualityScores(report);
+        printGradeDistribution(report);
+    }
+    console.log('══════════════════════════════════════════════════════════════\n');
+}
+/**
+ * Print failure details from the validation report.
+ *
+ * @param report - Validation report
+ */
+function printFailures(report) {
+    const failures = report.articles.filter((a) => !a.valid);
+    if (failures.length === 0)
+        return;
+    console.log('── FAILURES ──────────────────────────────────────────────────\n');
+    for (const article of failures) {
+        console.log(`  ❌ ${article.filename} (${article.wordCount} words)`);
+        for (const error of article.errors) {
+            console.log(`     ERROR: ${error}`);
+        }
+        for (const warning of article.warnings) {
+            console.log(`     WARN:  ${warning}`);
+        }
+        console.log('');
+    }
+}
+/**
+ * Print warning details from the validation report.
+ *
+ * @param report - Validation report
+ */
+function printWarnings(report) {
+    const withWarnings = report.articles.filter((a) => a.valid && a.warnings.length > 0);
+    if (withWarnings.length === 0)
+        return;
+    console.log('── WARNINGS ──────────────────────────────────────────────────\n');
+    for (const article of withWarnings) {
+        console.log(`  ⚠️  ${article.filename} (${article.wordCount} words)`);
+        for (const warning of article.warnings) {
+            console.log(`     WARN:  ${warning}`);
+        }
+        console.log('');
+    }
+}
+/**
+ * Print quality scores for all articles (only in --quality mode).
+ *
+ * @param report - Validation report
+ */
+function printQualityScores(report) {
+    const articlesWithQuality = report.articles.filter((a) => a.qualityReport);
+    if (articlesWithQuality.length === 0)
+        return;
+    console.log('── QUALITY SCORES ────────────────────────────────────────────\n');
+    for (const article of articlesWithQuality) {
+        const qr = article.qualityReport;
+        if (!qr)
+            continue;
+        const gate = qr.passesQualityGate ? '✅' : '⚠️ ';
+        console.log(`  ${gate} ${article.filename} — Grade: ${qr.grade} (${qr.overallScore}/100, ${qr.wordCount} words)`);
+        if (!qr.passesQualityGate && qr.recommendations.length > 0) {
+            for (const rec of qr.recommendations.slice(0, 3)) {
+                console.log(`       💡 ${rec}`);
+            }
+        }
+    }
+    console.log('');
+}
+/**
+ * Print the grade distribution summary (only in --quality mode).
+ *
+ * @param report - Validation report
+ */
+function printGradeDistribution(report) {
+    if (!report.gradeDistribution)
+        return;
+    const dist = report.gradeDistribution;
+    console.log('── GRADE DISTRIBUTION ────────────────────────────────────────\n');
+    console.log(`  A (≥80): ${dist['A']}   B (≥65): ${dist['B']}   C (≥40): ${dist['C']}   D (≥25): ${dist['D']}   F (<25): ${dist['F']}`);
+    console.log('');
+}
+// ─── CLI execution ────────────────────────────────────────────────────────────
+const report = validateAllArticles();
+printReport(report);
+if (qualityMode && outputFormat === 'json') {
+    const outputPath = path.join(process.cwd(), 'quality-report.json');
+    fs.writeFileSync(outputPath, JSON.stringify(report, null, 2), 'utf-8');
+    console.log(`📄 Quality report written to ${outputPath}`);
+}
+if (!dryRun && report.failed > 0) {
+    console.error(`❌ Validation failed: ${report.failed} article(s) have errors`);
+    process.exit(1);
+}
+else if (report.failed === 0) {
+    console.log('✅ All articles passed validation');
+}
+//# sourceMappingURL=validate-articles.js.map

package/scripts/utils/validate-articles.js.map

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

package/scripts/utils/validate-ep-api.d.ts

@@ -0,0 +1,51 @@
+/** Result of validating a single committee endpoint */
+export interface CommitteeValidationResult {
+    /** Committee abbreviation code (e.g. `"ENVI"`) */
+    abbreviation: string;
+    /** Whether the endpoint returned usable real data */
+    success: boolean;
+    /** Whether a human-readable name was found */
+    hasName: boolean;
+    /** Whether a label/abbreviation code was found */
+    hasLabel: boolean;
+    /** Whether the classification identifies a standing committee */
+    hasClassification: boolean;
+    /** English name of the committee, or null when unavailable */
+    name: string | null;
+    /** Error message when the request failed, or null on success */
+    error: string | null;
+    /** Round-trip time in milliseconds */
+    responseTimeMs: number;
+}
+/** Overall validation summary for a batch of committee checks */
+export interface EPAPIValidationSummary {
+    /** ISO 8601 timestamp when validation was performed */
+    timestamp: string;
+    /** Base URL of the EP API that was validated */
+    apiBase: string;
+    /** Number of committees checked */
+    totalChecked: number;
+    /** Number of committees that returned valid data */
+    totalPassed: number;
+    /** Number of committees that failed validation */
+    totalFailed: number;
+    /** Per-committee validation results */
+    results: CommitteeValidationResult[];
+    /** Whether all checked committees passed validation */
+    allValid: boolean;
+}
+/**
+ * Validate a single committee endpoint on the EP v2 API.
+ *
+ * @param abbreviation - Committee code (e.g. `"ENVI"`)
+ * @returns Validation result
+ */
+export declare function validateCommitteeEndpoint(abbreviation: string): Promise<CommitteeValidationResult>;
+/**
+ * Validate all specified committee endpoints and return a summary.
+ *
+ * @param committees - Array of committee abbreviations to validate
+ * @returns Validation summary
+ */
+export declare function validateEPAPI(committees?: readonly string[]): Promise<EPAPIValidationSummary>;
+//# sourceMappingURL=validate-ep-api.d.ts.map

package/scripts/utils/validate-ep-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-ep-api.d.ts","sourceRoot":"","sources":["../../src/utils/validate-ep-api.ts"],"names":[],"mappings":"AAmCA,uDAAuD;AACvD,MAAM,WAAW,yBAAyB;IACxC,kDAAkD;IAClD,YAAY,EAAE,MAAM,CAAC;IACrB,qDAAqD;IACrD,OAAO,EAAE,OAAO,CAAC;IACjB,8CAA8C;IAC9C,OAAO,EAAE,OAAO,CAAC;IACjB,kDAAkD;IAClD,QAAQ,EAAE,OAAO,CAAC;IAClB,iEAAiE;IACjE,iBAAiB,EAAE,OAAO,CAAC;IAC3B,8DAA8D;IAC9D,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,gEAAgE;IAChE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,sCAAsC;IACtC,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,iEAAiE;AACjE,MAAM,WAAW,sBAAsB;IACrC,uDAAuD;IACvD,SAAS,EAAE,MAAM,CAAC;IAClB,gDAAgD;IAChD,OAAO,EAAE,MAAM,CAAC;IAChB,mCAAmC;IACnC,YAAY,EAAE,MAAM,CAAC;IACrB,oDAAoD;IACpD,WAAW,EAAE,MAAM,CAAC;IACpB,kDAAkD;IAClD,WAAW,EAAE,MAAM,CAAC;IACpB,uCAAuC;IACvC,OAAO,EAAE,yBAAyB,EAAE,CAAC;IACrC,uDAAuD;IACvD,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;;;;GAKG;AACH,wBAAsB,yBAAyB,CAC7C,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,yBAAyB,CAAC,CA4EpC;AAED;;;;;GAKG;AACH,wBAAsB,aAAa,CACjC,UAAU,GAAE,SAAS,MAAM,EAAuB,GACjD,OAAO,CAAC,sBAAsB,CAAC,CAYjC"}

package/scripts/utils/validate-ep-api.js

@@ -0,0 +1,160 @@
+// SPDX-FileCopyrightText: 2024-2026 Hack23 AB
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * @module Utils/ValidateEPAPI
+ * @description Validates that the European Parliament v2 API returns real data
+ * for committee endpoints.  Can be run standalone as a pre-flight check or
+ * imported as a library for integration tests.
+ *
+ * Usage:
+ *   npx tsx src/utils/validate-ep-api.ts
+ *   npx tsx src/utils/validate-ep-api.ts --committees=ENVI,ECON
+ */
+import { resolve } from 'node:path';
+import { pathToFileURL } from 'node:url';
+/** Base URL for the EP Open Data Portal v2 API */
+const EP_API_V2_BASE = 'https://data.europarl.europa.eu/api/v2';
+/** Default timeout for API requests (ms) */
+const REQUEST_TIMEOUT_MS = 20_000;
+/** Default committees to validate */
+const DEFAULT_COMMITTEES = ['ENVI', 'ECON', 'AFET', 'LIBE', 'AGRI'];
+/**
+ * Validate a single committee endpoint on the EP v2 API.
+ *
+ * @param abbreviation - Committee code (e.g. `"ENVI"`)
+ * @returns Validation result
+ */
+export async function validateCommitteeEndpoint(abbreviation) {
+    const url = `${EP_API_V2_BASE}/corporate-bodies/${encodeURIComponent(abbreviation)}?format=application%2Fld%2Bjson`;
+    const start = Date.now();
+    try {
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), REQUEST_TIMEOUT_MS);
+        let response;
+        try {
+            response = await fetch(url, {
+                signal: controller.signal,
+                headers: { Accept: 'application/ld+json' },
+            });
+        }
+        finally {
+            clearTimeout(timer);
+        }
+        const responseTimeMs = Date.now() - start;
+        if (!response.ok) {
+            return {
+                abbreviation,
+                success: false,
+                hasName: false,
+                hasLabel: false,
+                hasClassification: false,
+                name: null,
+                error: `HTTP ${String(response.status)}`,
+                responseTimeMs,
+            };
+        }
+        const body = (await response.json());
+        const items = body.data;
+        if (!Array.isArray(items) || items.length === 0) {
+            return {
+                abbreviation,
+                success: false,
+                hasName: false,
+                hasLabel: false,
+                hasClassification: false,
+                name: null,
+                error: 'No data items in response',
+                responseTimeMs,
+            };
+        }
+        const item = items[0];
+        const name = item?.prefLabel?.['en'] ?? item?.altLabel?.['en'] ?? null;
+        const label = item?.label ?? null;
+        const classification = item?.classification ?? null;
+        const hasName = name !== null && name.length > 0;
+        const hasLabel = label !== null && label.length > 0;
+        const hasClassification = classification?.includes('COMMITTEE') ?? false;
+        return {
+            abbreviation,
+            success: hasName && hasLabel && hasClassification,
+            hasName,
+            hasLabel,
+            hasClassification,
+            name,
+            error: null,
+            responseTimeMs,
+        };
+    }
+    catch (err) {
+        return {
+            abbreviation,
+            success: false,
+            hasName: false,
+            hasLabel: false,
+            hasClassification: false,
+            name: null,
+            error: err instanceof Error ? err.message : String(err),
+            responseTimeMs: Date.now() - start,
+        };
+    }
+}
+/**
+ * Validate all specified committee endpoints and return a summary.
+ *
+ * @param committees - Array of committee abbreviations to validate
+ * @returns Validation summary
+ */
+export async function validateEPAPI(committees = DEFAULT_COMMITTEES) {
+    const results = await Promise.all(committees.map((abbr) => validateCommitteeEndpoint(abbr)));
+    const totalPassed = results.filter((r) => r.success).length;
+    return {
+        timestamp: new Date().toISOString(),
+        apiBase: EP_API_V2_BASE,
+        totalChecked: results.length,
+        totalPassed,
+        totalFailed: results.length - totalPassed,
+        results,
+        allValid: totalPassed === results.length,
+    };
+}
+// ─── CLI entry point ────────────────────────────────────────────────────────
+/* c8 ignore start */
+async function main() {
+    const args = process.argv.slice(2);
+    const committeesArg = args.find((a) => a.startsWith('--committees='));
+    const parsedCommittees = committeesArg
+        ? committeesArg
+            .replace('--committees=', '')
+            .split(',')
+            .map((committee) => committee.trim())
+            .filter((committee) => committee.length > 0)
+        : [];
+    const committees = parsedCommittees.length > 0 ? parsedCommittees : [...DEFAULT_COMMITTEES];
+    console.log(`\n🔍 Validating EP v2 API for committees: ${committees.join(', ')}\n`);
+    const summary = await validateEPAPI(committees);
+    for (const r of summary.results) {
+        const icon = r.success ? '✅' : '❌';
+        const detail = r.success
+            ? `${r.name} (${String(r.responseTimeMs)}ms)`
+            : `Error: ${r.error ?? 'unknown'} (${String(r.responseTimeMs)}ms)`;
+        console.log(`  ${icon} ${r.abbreviation}: ${detail}`);
+    }
+    console.log(`\n📊 Summary: ${String(summary.totalPassed)}/${String(summary.totalChecked)} passed`);
+    if (!summary.allValid) {
+        console.error('\n❌ EP v2 API validation failed — some endpoints returned no real data');
+        process.exitCode = 1;
+    }
+    else {
+        console.log('\n✅ All EP v2 API committee endpoints returned real data');
+    }
+}
+// Only run if executed directly (not imported)
+if (process.argv[1] && import.meta.url === pathToFileURL(resolve(process.argv[1])).href) {
+    main().catch((err) => {
+        const message = err instanceof Error ? err.message : String(err);
+        console.error('Fatal error:', message);
+        process.exitCode = 1;
+    });
+}
+/* c8 ignore stop */
+//# sourceMappingURL=validate-ep-api.js.map

package/scripts/utils/validate-ep-api.js.map

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

package/scripts/utils/world-bank-data.d.ts

@@ -0,0 +1,84 @@
+/**
+ * @module Utils/WorldBankData
+ * @description Utility functions for World Bank economic data integration.
+ *
+ * Provides EU member state → World Bank country code mapping,
+ * CSV parsing for MCP responses, indicator formatting, and economic
+ * context building for EU Parliament article enrichment.
+ *
+ * Functions in this module are designed to be stateless and avoid observable
+ * side effects, with the exception of explicitly recording metadata such as
+ * data timestamps in returned objects.
+ */
+import type { EconomicContext, PolicyRelevantIndicators, WorldBankIndicator } from '../types/world-bank.js';
+/**
+ * Maps EU member state ISO 3166-1 alpha-2 codes to World Bank alpha-3 codes.
+ * Covers all 27 EU member states.
+ */
+export declare const EU_COUNTRY_CODES: Readonly<Record<string, string>>;
+/** EU aggregate code in World Bank (European Union) */
+export declare const EU_AGGREGATE_CODE = "EUU";
+/**
+ * World Bank indicator IDs relevant to EU Parliament policy analysis.
+ * These indicators map to common policy areas discussed in EP legislation.
+ */
+export declare const POLICY_INDICATORS: PolicyRelevantIndicators;
+/**
+ * Parse CSV data from World Bank MCP response into structured indicator objects.
+ * The World Bank MCP server returns indicator data as CSV text via pandas.
+ * Handles quoted fields that may contain commas (e.g., indicator names).
+ *
+ * @param csvText - Raw CSV text from the MCP tool response (accepts null/undefined for convenience)
+ * @returns Array of parsed World Bank indicator data points
+ */
+export declare function parseWorldBankCSV(csvText: string | null | undefined): WorldBankIndicator[];
+/**
+ * Format a numeric value for display based on the indicator type.
+ *
+ * @param value - The numeric value to format
+ * @param indicatorId - The World Bank indicator ID (determines formatting style)
+ * @returns Formatted display string
+ */
+export declare function formatIndicatorValue(value: number | null, indicatorId: string): string;
+/**
+ * Extract the most recent non-null data point from a series of World Bank indicators.
+ *
+ * @param indicators - Array of indicator data points
+ * @returns The most recent data point with a non-null value, or null if none found
+ */
+export declare function getMostRecentValue(indicators: readonly WorldBankIndicator[]): WorldBankIndicator | null;
+/**
+ * Build an economic context summary from raw World Bank indicator data.
+ *
+ * @param countryCode - EU member state ISO2 code
+ * @param countryName - Country display name
+ * @param indicatorData - Map of indicator ID to parsed data points
+ * @returns Structured economic context for article enrichment
+ */
+export declare function buildEconomicContext(countryCode: string, countryName: string, indicatorData: ReadonlyMap<string, readonly WorldBankIndicator[]>): EconomicContext;
+/**
+ * Get the World Bank country code for an EU member state.
+ *
+ * @param iso2Code - EU member state ISO 3166-1 alpha-2 code (e.g., 'DE', 'FR')
+ * @returns World Bank alpha-3 code or null if not an EU member state
+ */
+export declare function getWorldBankCountryCode(iso2Code: string): string | null;
+/**
+ * Check if a country code corresponds to an EU member state.
+ *
+ * @param iso2Code - ISO 3166-1 alpha-2 country code
+ * @returns True if the country is an EU member state
+ */
+export declare function isEUMemberState(iso2Code: string): boolean;
+/**
+ * Generate an HTML section with economic context data for article embedding.
+ *
+ * Note: UI strings are currently in English. A future enhancement should accept
+ * a `lang` parameter and use localized string maps (similar to `WEEK_AHEAD_STRINGS`)
+ * to support all 14 article languages.
+ *
+ * @param context - Economic context data
+ * @returns Sanitized HTML string for the economic context section
+ */
+export declare function buildEconomicContextHTML(context: EconomicContext): string;
+//# sourceMappingURL=world-bank-data.d.ts.map

package/scripts/utils/world-bank-data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"world-bank-data.d.ts","sourceRoot":"","sources":["../../src/utils/world-bank-data.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EACV,eAAe,EAEf,wBAAwB,EACxB,kBAAkB,EACnB,MAAM,wBAAwB,CAAC;AAKhC;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CA4BpD,CAAC;AAEX,uDAAuD;AACvD,eAAO,MAAM,iBAAiB,QAAQ,CAAC;AAEvC;;;GAGG;AACH,eAAO,MAAM,iBAAiB,EAAE,wBAStB,CAAC;AAsEX;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,kBAAkB,EAAE,CAqC1F;AAID;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CA+CtF;AAID;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,SAAS,kBAAkB,EAAE,GACxC,kBAAkB,GAAG,IAAI,CAO3B;AAID;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,aAAa,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,kBAAkB,EAAE,CAAC,GAChE,eAAe,CAiCjB;AAID;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGvE;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEzD;AAID;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,CAuBzE"}