euparliamentmonitor 0.8.4

package/scripts/types/visualization.d.ts

@@ -0,0 +1,708 @@
+/**
+ * @module Types/Visualization
+ * @description Type definitions for SWOT analysis and dashboard visualization
+ * components. These types enable agentic workflows to extend any article type
+ * with structured SWOT diagrams and data dashboards using data from MCP
+ * servers or other data sources.
+ */
+/**
+ * A single item within a SWOT quadrant.
+ * Represents one strength, weakness, opportunity, or threat.
+ */
+export interface SwotItem {
+    /** Description of the SWOT item */
+    readonly text: string;
+    /** Optional severity/importance level */
+    readonly severity?: 'low' | 'medium' | 'high' | undefined;
+}
+/**
+ * Complete SWOT analysis data structure.
+ * Used by agentic workflows to generate strategic analysis visualizations
+ * for any article type using data from European Parliament MCP or other sources.
+ *
+ * @example
+ * ```typescript
+ * const swot: SwotAnalysis = {
+ *   title: 'Digital Markets Act — Strategic Assessment',
+ *   strengths: [{ text: 'Broad political support', severity: 'high' }],
+ *   weaknesses: [{ text: 'Complex enforcement mechanisms', severity: 'medium' }],
+ *   opportunities: [{ text: 'Global regulatory leadership', severity: 'high' }],
+ *   threats: [{ text: 'Industry lobbying resistance', severity: 'medium' }],
+ * };
+ * ```
+ */
+export interface SwotAnalysis {
+    /** Optional title for the SWOT analysis */
+    readonly title?: string | undefined;
+    /** Internal strengths — positive factors within EU Parliament control */
+    readonly strengths: readonly SwotItem[];
+    /** Internal weaknesses — negative factors within EU Parliament control */
+    readonly weaknesses: readonly SwotItem[];
+    /** External opportunities — positive external factors */
+    readonly opportunities: readonly SwotItem[];
+    /** External threats — negative external factors */
+    readonly threats: readonly SwotItem[];
+}
+/**
+ * Localized strings for SWOT analysis section headings, quadrant labels,
+ * and accessible descriptions. Used by SWOT visualization generators
+ * (including `buildSwotSection()`) for multi-language article rendering.
+ */
+export interface SwotStrings {
+    /** Section heading (e.g. "SWOT Analysis") */
+    readonly sectionHeading: string;
+    /** Quadrant labels */
+    readonly strengthsLabel: string;
+    readonly weaknessesLabel: string;
+    readonly opportunitiesLabel: string;
+    readonly threatsLabel: string;
+    /** Accessible quadrant descriptions */
+    readonly strengthsDesc: string;
+    readonly weaknessesDesc: string;
+    readonly opportunitiesDesc: string;
+    readonly threatsDesc: string;
+    /** Axis labels */
+    readonly internalLabel: string;
+    readonly externalLabel: string;
+}
+/**
+ * A single key metric displayed as a card in a dashboard.
+ */
+export interface DashboardMetric {
+    /** Human-readable label for the metric */
+    readonly label: string;
+    /** Formatted display value (e.g. "85%", "1,234", "€2.5M") */
+    readonly value: string;
+    /** Optional percentage change from previous period */
+    readonly change?: number | undefined;
+    /** Optional trend direction */
+    readonly trend?: 'up' | 'down' | 'stable' | undefined;
+    /** Optional unit suffix (e.g. "%", "MEPs", "votes") */
+    readonly unit?: string | undefined;
+}
+/**
+ * A single point in a scatter dataset.
+ */
+export interface ScatterPoint {
+    /** X-axis value */
+    readonly x: number;
+    /** Y-axis value */
+    readonly y: number;
+}
+/**
+ * A single point in a bubble dataset.
+ */
+export interface BubblePoint {
+    /** X-axis value */
+    readonly x: number;
+    /** Y-axis value */
+    readonly y: number;
+    /** Bubble radius in pixels */
+    readonly r: number;
+}
+/**
+ * A single dataset within a chart.
+ * For bar/line/pie/doughnut/radar/polarArea charts, `data` is `number[]`.
+ * For scatter charts, `data` is `ScatterPoint[]`.
+ * For bubble charts, `data` is `BubblePoint[]`.
+ * Maps to Chart.js dataset configuration.
+ */
+export interface ChartDataset {
+    /** Dataset label (shown in legend) */
+    readonly label: string;
+    /** Data points — numbers for most chart types, point objects for scatter/bubble */
+    readonly data: readonly number[] | readonly ScatterPoint[] | readonly BubblePoint[];
+    /** Background color(s) — single color or array for per-point colors */
+    readonly backgroundColor?: string | readonly string[] | undefined;
+    /** Border color(s) — single color or array for per-point colors */
+    readonly borderColor?: string | readonly string[] | undefined;
+}
+/**
+ * Chart data configuration.
+ * Maps to Chart.js data structure.
+ */
+export interface ChartData {
+    /** Category labels for the x-axis or pie segments */
+    readonly labels: readonly string[];
+    /** One or more datasets to plot */
+    readonly datasets: readonly ChartDataset[];
+}
+/**
+ * Chart configuration for dashboard visualizations.
+ * Generates a `<canvas>` element with embedded JSON configuration
+ * that can be hydrated by Chart.js on the client side.
+ */
+export interface ChartConfig {
+    /** Chart type — matches Chart.js chart types */
+    readonly type: 'bar' | 'line' | 'pie' | 'doughnut' | 'radar' | 'polarArea' | 'scatter' | 'bubble';
+    /** Chart title displayed above the chart */
+    readonly title?: string | undefined;
+    /** Chart data (labels + datasets) */
+    readonly data: ChartData;
+    /** Optional Chart.js options override (scales, plugins, annotation, etc.) */
+    readonly options?: Record<string, unknown> | undefined;
+}
+/**
+ * A single panel within a dashboard.
+ * Can contain metrics, a chart, or both.
+ */
+export interface DashboardPanel {
+    /** Panel heading */
+    readonly title: string;
+    /** Optional key metrics displayed as cards */
+    readonly metrics?: readonly DashboardMetric[] | undefined;
+    /** Optional chart configuration */
+    readonly chart?: ChartConfig | undefined;
+}
+/**
+ * Complete dashboard configuration.
+ * Used by agentic workflows to generate data dashboards for any article type
+ * using data from European Parliament MCP, World Bank API, or other sources.
+ *
+ * @example
+ * ```typescript
+ * const dashboard: DashboardConfig = {
+ *   title: 'Legislative Activity Overview',
+ *   panels: [
+ *     {
+ *       title: 'Voting Statistics',
+ *       metrics: [
+ *         { label: 'Total Votes', value: '1,234', trend: 'up', change: 5.2 },
+ *         { label: 'Participation Rate', value: '87%', trend: 'stable' },
+ *       ],
+ *       chart: {
+ *         type: 'bar',
+ *         data: {
+ *           labels: ['EPP', 'S&D', 'Renew', 'Greens/EFA'],
+ *           datasets: [{ label: 'Votes Cast', data: [400, 350, 200, 150] }],
+ *         },
+ *       },
+ *     },
+ *   ],
+ * };
+ * ```
+ */
+export interface DashboardConfig {
+    /** Dashboard heading */
+    readonly title?: string | undefined;
+    /** Dashboard panels — each contains metrics and/or a chart */
+    readonly panels: readonly DashboardPanel[];
+}
+/**
+ * Localized strings for dashboard section UI text.
+ * Used for multi-language dashboard and article rendering.
+ */
+export interface DashboardStrings {
+    /** Default section heading (e.g. "Dashboard") */
+    readonly sectionHeading: string;
+    /** Trend aria-label prefix (e.g. "Trend:") */
+    readonly trendPrefix: string;
+    /** Localized direction label for upward trend (e.g. "increasing") */
+    readonly trendUp: string;
+    /** Localized direction label for downward trend (e.g. "decreasing") */
+    readonly trendDown: string;
+    /** Localized direction label for stable trend (e.g. "stable") */
+    readonly trendStable: string;
+    /** Fallback text when chart has no data */
+    readonly noChartData: string;
+    /** Default chart aria-label */
+    readonly chartLabel: string;
+    /** Column header for category column in chart fallback tables (e.g. "Category") */
+    readonly categoryLabel: string;
+}
+/**
+ * Dimension name for multi-dimensional SWOT analysis.
+ * Covers political, economic, social, legal, and geopolitical perspectives.
+ */
+export type SwotDimensionName = 'political' | 'economic' | 'social' | 'legal' | 'geopolitical';
+/**
+ * Stakeholder type for perspective-based SWOT views.
+ */
+export type StakeholderType = 'citizen' | 'industry' | 'ngo' | 'mep' | 'government' | 'media';
+/**
+ * A single analytical dimension within a multi-dimensional SWOT assessment.
+ * Each dimension contains its own complete SWOT quadrant data, allowing
+ * drill-down analysis from political, economic, social, legal, or geopolitical angles.
+ */
+export interface SwotDimension {
+    /** Dimension identifier */
+    readonly name: SwotDimensionName;
+    /** Internal strengths relevant to this dimension */
+    readonly strengths: readonly SwotItem[];
+    /** Internal weaknesses relevant to this dimension */
+    readonly weaknesses: readonly SwotItem[];
+    /** External opportunities relevant to this dimension */
+    readonly opportunities: readonly SwotItem[];
+    /** External threats relevant to this dimension */
+    readonly threats: readonly SwotItem[];
+}
+/**
+ * Cross-reference linking a SWOT item to a specific EP document or vote.
+ * Provides evidence anchoring for AI-generated SWOT assessments.
+ */
+export interface SwotCrossReference {
+    /** Excerpt or key text of the SWOT item being referenced */
+    readonly itemText: string;
+    /** EP document or vote identifier (e.g. "TA-10-2024-0001") */
+    readonly documentId: string;
+    /** Human-readable document or vote title */
+    readonly documentTitle: string;
+    /** Optional URL to the EP document */
+    readonly url?: string | undefined;
+}
+/**
+ * Temporal SWOT assessment showing evolution of the analysis
+ * across short, medium, and long time horizons.
+ */
+export interface TemporalSwotAssessment {
+    /** Short-term view — covers the current week's agenda and immediate impacts */
+    readonly shortTerm: SwotAnalysis;
+    /** Medium-term view — covers the current quarter's legislative activity */
+    readonly mediumTerm: SwotAnalysis;
+    /** Long-term view — covers the current parliamentary term (optional) */
+    readonly longTerm?: SwotAnalysis | undefined;
+}
+/**
+ * Multi-dimensional SWOT analysis with political context depth.
+ * Extends the basic SWOT framework with dimension-specific drill-downs,
+ * stakeholder perspectives, temporal tracking, and evidence cross-references.
+ *
+ * @example
+ * ```typescript
+ * const mdSwot: MultiDimensionalSwot = {
+ *   title: 'AI Act — Multi-Dimensional Assessment',
+ *   dimensions: [
+ *     {
+ *       name: 'political',
+ *       strengths: [{ text: 'Broad cross-party consensus', severity: 'high' }],
+ *       weaknesses: [], opportunities: [], threats: [],
+ *     },
+ *   ],
+ *   temporal: {
+ *     shortTerm: { strengths: [], weaknesses: [], opportunities: [], threats: [] },
+ *     mediumTerm: { strengths: [], weaknesses: [], opportunities: [], threats: [] },
+ *   },
+ * };
+ * ```
+ */
+export interface MultiDimensionalSwot {
+    /** Optional title for the full analysis */
+    readonly title?: string | undefined;
+    /** Per-dimension SWOT quadrant data */
+    readonly dimensions: readonly SwotDimension[];
+    /** Temporal assessment (short / medium / long term) */
+    readonly temporal?: TemporalSwotAssessment | undefined;
+    /** Stakeholder-specific perspectives */
+    readonly stakeholderViews?: Readonly<Partial<Record<StakeholderType, SwotAnalysis>>> | undefined;
+    /** Links from SWOT items to specific EP documents or votes */
+    readonly crossReferences?: readonly SwotCrossReference[] | undefined;
+}
+/**
+ * Localized UI strings for the multi-dimensional SWOT visualization.
+ * Covers dimension labels, stakeholder names, temporal headings, and evidence labels.
+ */
+export interface MultiDimensionalSwotStrings {
+    /** Heading for the dimensions drill-down section */
+    readonly dimensionsLabel: string;
+    /** Heading for the stakeholder perspectives section */
+    readonly stakeholderPerspectivesLabel: string;
+    /** Heading for the temporal analysis section */
+    readonly temporalAnalysisLabel: string;
+    /** Label for the short-term temporal period */
+    readonly shortTermLabel: string;
+    /** Label for the medium-term temporal period */
+    readonly mediumTermLabel: string;
+    /** Label for the long-term temporal period */
+    readonly longTermLabel: string;
+    /** Localized name for the political dimension */
+    readonly dimensionPolitical: string;
+    /** Localized name for the economic dimension */
+    readonly dimensionEconomic: string;
+    /** Localized name for the social dimension */
+    readonly dimensionSocial: string;
+    /** Localized name for the legal dimension */
+    readonly dimensionLegal: string;
+    /** Localized name for the geopolitical dimension */
+    readonly dimensionGeopolitical: string;
+    /** Localized label for citizen stakeholder */
+    readonly stakeholderCitizen: string;
+    /** Localized label for industry stakeholder */
+    readonly stakeholderIndustry: string;
+    /** Localized label for NGO / civil society stakeholder */
+    readonly stakeholderNgo: string;
+    /** Localized label for MEP stakeholder */
+    readonly stakeholderMep: string;
+    /** Localized label for government stakeholder */
+    readonly stakeholderGovernment: string;
+    /** Localized label for media stakeholder */
+    readonly stakeholderMedia: string;
+    /** Label for evidence items */
+    readonly evidenceLabel: string;
+    /** Heading for the cross-references section */
+    readonly crossReferencesLabel: string;
+}
+/**
+ * Localized strings for SWOT builder item text across all 5 analysis types.
+ * Template functions accept dynamic counts; plain strings are static prose.
+ */
+export interface SwotBuilderStrings {
+    readonly votingHighCohesion: (count: number) => string;
+    readonly votingAdopted: (count: number) => string;
+    readonly votingActiveVotes: (count: number) => string;
+    readonly votingLowCohesion: (count: number) => string;
+    readonly votingAnomalies: (count: number) => string;
+    readonly votingCrossParty: string;
+    readonly votingDiverseGroups: (count: number) => string;
+    readonly votingHighSeverity: (count: number) => string;
+    readonly votingShiftingAlliances: string;
+    readonly prospectiveEvents: (count: number) => string;
+    readonly prospectiveCommittees: (count: number) => string;
+    readonly prospectiveBottlenecks: (count: number) => string;
+    readonly prospectiveHighDensity: (count: number) => string;
+    readonly prospectiveDocuments: (count: number) => string;
+    readonly prospectiveQuestions: (count: number) => string;
+    readonly prospectiveBottleneckRisk: string;
+    readonly prospectiveSchedulingRisk: string;
+    readonly breakingAdopted: (count: number) => string;
+    readonly breakingEvents: (count: number) => string;
+    readonly breakingAnomalyWeakness: string;
+    readonly breakingNoProcedures: string;
+    readonly breakingProceduresActive: (count: number) => string;
+    readonly breakingCoalitionOpportunity: string;
+    readonly breakingAnomalyThreat: string;
+    readonly breakingRapidEvents: string;
+    readonly propositionsHealthStrong: (pct: string) => string;
+    readonly propositionsThroughputGood: (rate: number) => string;
+    readonly propositionsHealthWeak: (pct: string) => string;
+    readonly propositionsThroughputLow: (rate: number) => string;
+    readonly propositionsPrioritisation: string;
+    readonly propositionsTrilogueAcceleration: string;
+    readonly propositionsCriticalCongestion: string;
+    readonly propositionsOverlapping: string;
+    readonly committeeActive: (active: number, total: number) => string;
+    readonly committeeDocuments: (count: number) => string;
+    readonly committeeInactive: (count: number) => string;
+    readonly committeeCrossCollaboration: string;
+    readonly committeeHearings: string;
+    readonly committeeLowActivity: string;
+    readonly committeeCompetingPriorities: string;
+}
+/**
+ * Category of a node within an intelligence mindmap.
+ * - `policy_domain` — top-level EU policy area (e.g. ENVI, ECON, AFET)
+ * - `sub_topic` — sub-issue within a policy domain
+ * - `actor` — MEP, political group, committee, or external stakeholder
+ * - `action` — a specific legislative act or parliamentary action
+ * - `outcome` — the result or consequence of an action
+ */
+export type MindmapNodeCategory = 'policy_domain' | 'sub_topic' | 'actor' | 'action' | 'outcome';
+/**
+ * Type of connection between two nodes in an intelligence mindmap.
+ * - `legislative` — formal procedural/legal link between nodes
+ * - `political` — alliance, coalition, or adversarial political relationship
+ * - `procedural` — committee-stage or plenary procedural link
+ * - `thematic` — shared policy theme or topic overlap
+ */
+export type PolicyConnectionType = 'legislative' | 'political' | 'procedural' | 'thematic';
+/**
+ * Strength of a policy connection.
+ * - `strong` — clearly evidenced, high-confidence link
+ * - `moderate` — supported by indirect evidence
+ * - `weak` — emerging or low-confidence relationship
+ */
+export type PolicyConnectionStrength = 'strong' | 'moderate' | 'weak';
+/**
+ * Type of actor in the actor-network.
+ * - `mep` — individual Member of European Parliament
+ * - `group` — political group (EPP, S&D, Renew, etc.)
+ * - `committee` — EP standing committee (ENVI, ECON, etc.)
+ * - `external` — non-EP stakeholder (Commission, Council, NGO, etc.)
+ */
+export type ActorType = 'mep' | 'group' | 'committee' | 'external';
+/**
+ * Pre-defined semantic color roles for mindmap branch nodes.
+ * When assigned to `MindmapNode.color`, selects the corresponding branch
+ * palette entry (overriding the default category-based colors).
+ */
+export type MindmapBranchColor = 'cyan' | 'magenta' | 'yellow' | 'green' | 'purple' | 'orange' | 'blue' | 'red';
+/**
+ * A single node in the intelligence mindmap.
+ * Nodes are arranged in depth layers: domain → sub-topic → actor → action → outcome.
+ */
+export interface MindmapNode {
+    /** Unique node identifier (used for connection references). */
+    readonly id: string;
+    /** Human-readable label rendered inside the node. */
+    readonly label: string;
+    /** Node category determining visual styling. */
+    readonly category: MindmapNodeCategory;
+    /** Normalized influence weight 0–1 (drives `--node-influence` CSS var). */
+    readonly influence: number;
+    /**
+     * Optional semantic color key from the 8-color branch palette.
+     * When set to a valid `MindmapBranchColor` key (cyan, green, red, etc.),
+     * overrides the default category-based palette for this node.
+     * When omitted, the renderer falls back to the category palette.
+     */
+    readonly color?: MindmapBranchColor | undefined;
+    /** Child nodes one layer deeper in the hierarchy. */
+    readonly children: readonly MindmapNode[];
+    /** Optional EP-specific metadata for hover/detail rendering. */
+    readonly metadata?: {
+        readonly committee?: string | undefined;
+        readonly politicalGroup?: string | undefined;
+        readonly documentRef?: string | undefined;
+    } | undefined;
+}
+/**
+ * A single depth layer in the intelligence mindmap hierarchy.
+ * Layer 0 is the central topic; higher depths are progressively detailed.
+ */
+export interface MindmapLayer {
+    /** Layer depth (0 = center, 1 = domains, 2 = sub-topics, 3 = actors, 4 = actions/outcomes). */
+    readonly depth: number;
+    /** Nodes belonging to this layer. */
+    readonly nodes: readonly MindmapNode[];
+}
+/**
+ * A directed connection between two endpoints in the intelligence mindmap.
+ * Endpoints may reference either layer node IDs or actorNetwork IDs,
+ * allowing connections between rendered domain nodes and actor-network
+ * entities (e.g., anomaly or pipeline procedure nodes).
+ */
+export interface PolicyConnection {
+    /** ID of the source endpoint (layer node or actorNetwork node). */
+    readonly from: string;
+    /** ID of the target endpoint (layer node or actorNetwork node). */
+    readonly to: string;
+    /** Confidence level of the relationship. */
+    readonly strength: PolicyConnectionStrength;
+    /** Nature of the relationship. */
+    readonly type: PolicyConnectionType;
+    /** EP document reference or description serving as evidence. */
+    readonly evidence: string;
+}
+/**
+ * A parliamentary or external actor node in the network.
+ * Used to represent MEPs, political groups, committees, or external stakeholders.
+ */
+export interface ActorNode {
+    /** Unique actor identifier. */
+    readonly id: string;
+    /** Display name of the actor. */
+    readonly name: string;
+    /** Category of actor. */
+    readonly type: ActorType;
+    /** Normalized influence score 0–1. */
+    readonly influence: number;
+    /** IDs of connected nodes in the network. */
+    readonly connections: readonly string[];
+}
+/**
+ * Influence weight entry for a mindmap node.
+ * Provides justification for a node's computed influence score.
+ */
+export interface InfluenceWeight {
+    /** Node being scored. */
+    readonly nodeId: string;
+    /** Normalized weight 0–1. */
+    readonly weight: number;
+    /** Human-readable factors explaining the score. */
+    readonly factors: readonly string[];
+}
+/**
+ * Complete intelligence mindmap data structure.
+ * Combines layered policy domain nodes, actor-network relationships,
+ * policy connections, and optional stakeholder perspective overlays.
+ *
+ * @example
+ * ```typescript
+ * const imap: IntelligenceMindmap = {
+ *   centralTopic: 'EU Climate Policy Intelligence',
+ *   layers: [{ depth: 1, nodes: [{ id: 'envi', label: 'Environment', category: 'policy_domain', ... }] }],
+ *   connections: [{ from: 'envi', to: 'econ', strength: 'strong', type: 'legislative', evidence: 'Green Deal' }],
+ *   actorNetwork: [{ id: 'envi-cmt', name: 'ENVI Committee', type: 'committee', influence: 0.9, connections: [] }],
+ *   stakeholderGroups: ['Industry', 'Civil Society', 'Member States'],
+ * };
+ * ```
+ */
+export interface IntelligenceMindmap {
+    /** Central topic label for the root node. */
+    readonly centralTopic: string;
+    /** Ordered depth layers from domains (1) to outcomes (4). */
+    readonly layers: readonly MindmapLayer[];
+    /** Cross-cutting connections between nodes in different branches. */
+    readonly connections: readonly PolicyConnection[];
+    /** Actor-network nodes (MEPs, groups, committees, external). */
+    readonly actorNetwork: readonly ActorNode[];
+    /** Optional stakeholder group labels for `<details>` overlay sections. */
+    readonly stakeholderGroups?: readonly string[] | undefined;
+    /** Optional summary rendered above the mindmap. */
+    readonly summary?: string | undefined;
+}
+/**
+ * A single voting bloc within a coalition.
+ */
+export interface VotingBloc {
+    /** Name of the political group */
+    readonly group: string;
+    /** Alignment score with the coalition (0–100) */
+    readonly alignmentScore: number;
+    /** Optional seat count */
+    readonly seats?: number | undefined;
+}
+/**
+ * A defining vote that shaped coalition dynamics.
+ */
+export interface VoteHighlight {
+    /** Vote title or description */
+    readonly title: string;
+    /** Outcome of the vote */
+    readonly outcome: 'adopted' | 'rejected' | 'split';
+    /** Votes in favour */
+    readonly votesFor: number;
+    /** Votes against */
+    readonly votesAgainst: number;
+}
+/**
+ * Coalition dynamics metrics for a parliamentary period.
+ * Used to build coalition radar charts and alignment visualizations.
+ */
+export interface CoalitionMetrics {
+    /** Overall alignment score (0–100) */
+    readonly alignmentScore: number;
+    /** Identified voting blocs and their cohesion */
+    readonly votingBlocs: readonly VotingBloc[];
+    /** Overall trend direction */
+    readonly shiftIndicator: 'strengthening' | 'weakening' | 'stable';
+    /** Defining votes that illustrate coalition dynamics */
+    readonly keyVotes?: readonly VoteHighlight[] | undefined;
+}
+/**
+ * Legislative pipeline status with color-coded health indicators.
+ * Used to build pipeline bar charts and status visualizations.
+ */
+export interface LegislativePipeline {
+    /** Overall pipeline health (0–100) */
+    readonly healthScore: number;
+    /** Number of on-track procedures */
+    readonly onTrack: number;
+    /** Number of delayed procedures */
+    readonly delayed: number;
+    /** Number of blocked procedures */
+    readonly blocked: number;
+    /** Number of fast-tracked procedures */
+    readonly fastTracked: number;
+    /** Total procedures in pipeline */
+    readonly total: number;
+}
+/**
+ * A single trend metric data point for sparkline charts.
+ */
+export interface TrendMetric {
+    /** Period label (e.g., "Week 1", "Jan") */
+    readonly period: string;
+    /** Numeric value for this period */
+    readonly value: number;
+}
+/**
+ * Trend analytics for cross-article activity patterns.
+ * Used to build sparkline charts and comparison tables.
+ */
+export interface TrendAnalytics {
+    /** Trend period granularity */
+    readonly period: 'weekly' | 'monthly' | 'quarterly';
+    /** Trend metrics over time */
+    readonly metrics: readonly TrendMetric[];
+    /** Overall direction of the trend */
+    readonly direction: 'improving' | 'declining' | 'stable';
+    /** Week-over-week change percentage */
+    readonly weekOverWeekChange?: number | undefined;
+    /** Month-over-month change percentage */
+    readonly monthOverMonthChange?: number | undefined;
+}
+/**
+ * Stakeholder impact metric for scorecards.
+ */
+export interface StakeholderMetric {
+    /** Stakeholder group name */
+    readonly stakeholder: string;
+    /** Impact intensity (0–100) */
+    readonly impactScore: number;
+    /** Impact direction */
+    readonly impactDirection: 'positive' | 'negative' | 'neutral';
+    /** Brief description of impact */
+    readonly description?: string | undefined;
+}
+/**
+ * Localized strings for Dashboard builder panel titles and metric labels
+ * across all 5 analysis types.
+ */
+export interface DashboardBuilderStrings {
+    readonly votingOverview: string;
+    readonly totalVotes: string;
+    readonly adopted: string;
+    readonly rejected: string;
+    readonly anomalies: string;
+    readonly politicalGroupCohesion: string;
+    readonly groupCohesionRates: string;
+    readonly cohesionPct: string;
+    readonly scheduledActivity: string;
+    readonly plenaryEvents: string;
+    readonly committeeMeetings: string;
+    readonly documents: string;
+    readonly pipelineProcedures: string;
+    readonly parliamentaryQuestions: string;
+    readonly questionsFiled: string;
+    readonly bottleneckProcedures: string;
+    readonly feedActivity: string;
+    readonly adoptedTexts: string;
+    readonly events: string;
+    readonly procedures: string;
+    readonly mepUpdates: string;
+    readonly activitySummary: string;
+    readonly totalItems: string;
+    readonly feedBreakdown: string;
+    readonly items: string;
+    readonly pipelineHealth: string;
+    readonly healthScore: string;
+    readonly throughput: string;
+    readonly status: string;
+    readonly pipelineStrong: string;
+    readonly pipelineModerate: string;
+    readonly pipelineWeak: string;
+    readonly committeeOverview: string;
+    readonly totalCommittees: string;
+    readonly activeCommittees: string;
+    readonly activityRate: string;
+    readonly documentsProduced: string;
+    readonly documentOutputByCommittee: string;
+    readonly documentsPerCommittee: string;
+    readonly coalitionAlignment: string;
+    readonly alignmentScore: string;
+    readonly votingBlocs: string;
+    readonly coalitionShift: string;
+    readonly coalitionStrengthening: string;
+    readonly coalitionWeakening: string;
+    readonly coalitionStable: string;
+    readonly coalitionRadarChart: string;
+    readonly pipelineStatus: string;
+    readonly onTrack: string;
+    readonly delayed: string;
+    readonly blocked: string;
+    readonly fastTracked: string;
+    readonly pipelineStatusChart: string;
+    readonly trendAnalysis: string;
+    readonly weekOverWeek: string;
+    readonly monthOverMonth: string;
+    readonly trendImproving: string;
+    readonly trendDeclining: string;
+    readonly trendStableLabel: string;
+    readonly activityTrendChart: string;
+    readonly stakeholderImpact: string;
+    readonly impactScore: string;
+    readonly impactPositive: string;
+    readonly impactNegative: string;
+    readonly impactNeutral: string;
+}
+//# sourceMappingURL=visualization.d.ts.map