euparliamentmonitor 0.8.4

package/scripts/generators/pipeline/transform-stage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transform-stage.d.ts","sourceRoot":"","sources":["../../../src/generators/pipeline/transform-stage.ts"],"names":[],"mappings":"AAGA;;;;;;;GAOG;AAIH,0CAA0C;AAC1C,MAAM,WAAW,gBAAgB;IAC/B,6CAA6C;IAC7C,KAAK,EAAE,OAAO,CAAC;IACf,8EAA8E;IAC9E,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAqBD;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,gBAAgB,CAkCrF;AAID;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CASzD;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAExD;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEzD"}

package/scripts/generators/pipeline/transform-stage.js

@@ -0,0 +1,111 @@
+// SPDX-FileCopyrightText: 2024-2026 Hack23 AB
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * Validate the first item of a content array is a non-null object with a
+ * `text` string field.  Returns an error description or null when valid.
+ *
+ * @param item - First element of the content array
+ * @returns Error message or null
+ */
+function validateFirstContentItem(item) {
+    if (item === null || item === undefined || typeof item !== 'object' || Array.isArray(item)) {
+        return "First content item is missing a 'text' string field";
+    }
+    const obj = item;
+    return typeof obj['text'] === 'string'
+        ? null
+        : "First content item is missing a 'text' string field";
+}
+// ─── MCP Response validation ──────────────────────────────────────────────────
+/**
+ * Validate that an MCP tool response has the standard envelope shape:
+ * `{ content: [{ text: string }] }`.
+ *
+ * Does **not** throw — returns a {@link ValidationResult} so callers can
+ * choose their own degradation strategy.
+ *
+ * @param toolName - Tool name used in warning messages
+ * @param data - Raw response to validate
+ * @returns Validation result with any error descriptions
+ */
+export function validateMCPResponse(toolName, data) {
+    const errors = [];
+    if (data === null || data === undefined) {
+        errors.push('Response is null or undefined');
+        console.warn(`⚠️ MCP validation failed for ${toolName}: response is null/undefined`);
+        return { valid: false, errors };
+    }
+    if (typeof data !== 'object' || Array.isArray(data)) {
+        errors.push(`Expected object, got ${Array.isArray(data) ? 'array' : typeof data}`);
+        console.warn(`⚠️ MCP validation failed for ${toolName}:`, errors.join(', '));
+        return { valid: false, errors };
+    }
+    const response = data;
+    if (!Array.isArray(response['content'])) {
+        errors.push("Missing or invalid 'content' array");
+    }
+    else {
+        const content = response['content'];
+        if (content.length === 0) {
+            errors.push('Empty content array');
+        }
+        else {
+            const itemError = validateFirstContentItem(content[0]);
+            if (itemError)
+                errors.push(itemError);
+        }
+    }
+    if (errors.length > 0) {
+        console.warn(`⚠️ MCP validation failed for ${toolName}:`, errors.join(', '));
+    }
+    return { valid: errors.length === 0, errors };
+}
+// ─── Data normalisation helpers ───────────────────────────────────────────────
+/**
+ * Normalise a date string to YYYY-MM-DD ISO 8601 format.
+ * Returns the input unchanged when parsing fails.
+ *
+ * @param date - Raw date string
+ * @returns Normalised ISO 8601 date string
+ */
+export function normalizeISO8601Date(date) {
+    if (!date)
+        return date;
+    try {
+        const parsed = new Date(date);
+        if (isNaN(parsed.getTime()))
+            return date;
+        return parsed.toISOString().split('T')[0] ?? date;
+    }
+    catch {
+        return date;
+    }
+}
+/**
+ * Sanitise a text string by collapsing internal whitespace and trimming edges.
+ *
+ * @param text - Raw text string
+ * @returns Sanitised text string
+ */
+export function sanitizeText(text) {
+    return text.replace(/\s+/g, ' ').trim();
+}
+/**
+ * Validate that a country code matches the ISO 3166-1 alpha-2 pattern.
+ *
+ * @param code - Two-letter country code
+ * @returns `true` when the code matches `[A-Z]{2}`
+ */
+export function isValidCountryCode(code) {
+    return /^[A-Z]{2}$/.test(code);
+}
+/**
+ * Validate that a language code matches the ISO 639-1 alpha-2 pattern.
+ *
+ * @param code - Two-letter language code
+ * @returns `true` when the code matches `[a-z]{2}`
+ */
+export function isValidLanguageCode(code) {
+    return /^[a-z]{2}$/.test(code);
+}
+//# sourceMappingURL=transform-stage.js.map

package/scripts/generators/pipeline/transform-stage.js.map

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

package/scripts/generators/propositions-content.d.ts

@@ -0,0 +1,29 @@
+import type { PropositionsStrings } from '../types/index.js';
+/** Structured pipeline data returned from MCP before language-specific rendering */
+export interface PipelineData {
+    healthScore: number;
+    throughput: number;
+    procRowsHtml: string;
+}
+/**
+ * Build propositions article HTML content with localized strings.
+ *
+ * **Security contract**: `proposalsHtml`, `adoptedTextsHtml`, `procedureHtml`,
+ * and `pipelineData.procRowsHtml` MUST be pre-sanitized HTML — all external
+ * (MCP-sourced) values must have been passed through `escapeHTML()` before
+ * being interpolated into these strings.  The fetch helpers
+ * (`fetchProposalsFromMCP`, `fetchPipelineFromMCP`,
+ * `fetchProcedureStatusFromMCP`) fulfil this contract; callers must do the
+ * same if they construct these arguments independently.
+ *
+ * @param proposalsHtml - Pre-sanitized HTML for legislative procedures list section
+ * @param adoptedTextsHtml - Pre-sanitized HTML for recently adopted texts section (may be empty)
+ * @param pipelineData - Structured pipeline data from MCP (null when unavailable);
+ *   `pipelineData.procRowsHtml` must be pre-sanitized HTML
+ * @param procedureHtml - Pre-sanitized HTML for tracked procedure status section (may be empty)
+ * @param strings - Localized string set for the target language
+ * @param lang - Language code for editorial string headings (default: 'en')
+ * @returns Full article HTML content string
+ */
+export declare function buildPropositionsContent(proposalsHtml: string, adoptedTextsHtml: string, pipelineData: PipelineData | null, procedureHtml: string, strings: PropositionsStrings, lang?: string): string;
+//# sourceMappingURL=propositions-content.d.ts.map

package/scripts/generators/propositions-content.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"propositions-content.d.ts","sourceRoot":"","sources":["../../src/generators/propositions-content.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAE7D,oFAAoF;AACpF,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,wBAAwB,CACtC,aAAa,EAAE,MAAM,EACrB,gBAAgB,EAAE,MAAM,EACxB,YAAY,EAAE,YAAY,GAAG,IAAI,EACjC,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,mBAAmB,EAC5B,IAAI,SAAO,GACV,MAAM,CA2DR"}

package/scripts/generators/propositions-content.js

@@ -0,0 +1,90 @@
+// SPDX-FileCopyrightText: 2024-2026 Hack23 AB
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * @module Generators/PropositionsContent
+ * @description Pure function for building propositions article HTML with
+ * localized strings and pre-sanitized MCP data.
+ */
+import { escapeHTML } from '../utils/file-utils.js';
+import { getLocalizedString, EDITORIAL_STRINGS } from '../constants/languages.js';
+/**
+ * Build propositions article HTML content with localized strings.
+ *
+ * **Security contract**: `proposalsHtml`, `adoptedTextsHtml`, `procedureHtml`,
+ * and `pipelineData.procRowsHtml` MUST be pre-sanitized HTML — all external
+ * (MCP-sourced) values must have been passed through `escapeHTML()` before
+ * being interpolated into these strings.  The fetch helpers
+ * (`fetchProposalsFromMCP`, `fetchPipelineFromMCP`,
+ * `fetchProcedureStatusFromMCP`) fulfil this contract; callers must do the
+ * same if they construct these arguments independently.
+ *
+ * @param proposalsHtml - Pre-sanitized HTML for legislative procedures list section
+ * @param adoptedTextsHtml - Pre-sanitized HTML for recently adopted texts section (may be empty)
+ * @param pipelineData - Structured pipeline data from MCP (null when unavailable);
+ *   `pipelineData.procRowsHtml` must be pre-sanitized HTML
+ * @param procedureHtml - Pre-sanitized HTML for tracked procedure status section (may be empty)
+ * @param strings - Localized string set for the target language
+ * @param lang - Language code for editorial string headings (default: 'en')
+ * @returns Full article HTML content string
+ */
+export function buildPropositionsContent(proposalsHtml, adoptedTextsHtml, pipelineData, procedureHtml, strings, lang = 'en') {
+    const editorial = getLocalizedString(EDITORIAL_STRINGS, lang);
+    const pipelineHtml = pipelineData
+        ? `
+    <div class="pipeline-metrics">
+      <div class="metric" aria-label="${escapeHTML(strings.pipelineHealthLabel)}">
+        <span class="metric-label">${escapeHTML(strings.pipelineHealthLabel)}</span>
+        <span class="metric-value">${escapeHTML(String(Math.round(pipelineData.healthScore * 100)))}%</span>
+      </div>
+      <div class="metric" aria-label="${escapeHTML(strings.throughputRateLabel)}">
+        <span class="metric-label">${escapeHTML(strings.throughputRateLabel)}</span>
+        <span class="metric-value">${escapeHTML(String(pipelineData.throughput))}</span>
+      </div>
+    </div>
+    ${pipelineData.procRowsHtml}`
+        : '';
+    const procedureSection = procedureHtml
+        ? `
+          <section class="procedure-status">
+            <h2>${escapeHTML(strings.procedureHeading)}</h2>
+            ${procedureHtml}
+          </section>`
+        : '';
+    const adoptedTextsSection = adoptedTextsHtml
+        ? `
+          <section class="adopted-texts-section">
+            <h2>${escapeHTML(strings.adoptedTextsHeading)}</h2>
+            ${adoptedTextsHtml}
+          </section>`
+        : '';
+    const proposalsSection = proposalsHtml
+        ? `
+          <section class="proposals-list">
+            <h2>${escapeHTML(strings.proposalsHeading)}</h2>
+            ${proposalsHtml}
+          </section>`
+        : '';
+    return `
+        <div class="article-content">
+          <section class="lede">
+            <p>${escapeHTML(strings.lede)}</p>
+          </section>
+          ${proposalsSection}
+          ${adoptedTextsSection}
+          <section class="pipeline-status">
+            <h2>${escapeHTML(strings.pipelineHeading)}</h2>
+            ${pipelineHtml}
+          </section>
+          ${procedureSection}
+          <section class="analysis">
+            <h2>${escapeHTML(strings.analysisHeading)}</h2>
+            <p>${escapeHTML(strings.analysis)}</p>
+          </section>
+          <section class="why-this-matters">
+            <h2>${escapeHTML(editorial.whyThisMatters)}</h2>
+            <p>${escapeHTML(strings.whyThisMatters)}</p>
+          </section>
+        </div>
+      `;
+}
+//# sourceMappingURL=propositions-content.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"propositions-content.js","sourceRoot":"","sources":["../../src/generators/propositions-content.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,sCAAsC;AAEtC;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAUlF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,wBAAwB,CACtC,aAAqB,EACrB,gBAAwB,EACxB,YAAiC,EACjC,aAAqB,EACrB,OAA4B,EAC5B,IAAI,GAAG,IAAI;IAEX,MAAM,SAAS,GAAG,kBAAkB,CAAC,iBAAiB,EAAE,IAAI,CAAC,CAAC;IAC9D,MAAM,YAAY,GAAG,YAAY;QAC/B,CAAC,CAAC;;wCAEkC,UAAU,CAAC,OAAO,CAAC,mBAAmB,CAAC;qCAC1C,UAAU,CAAC,OAAO,CAAC,mBAAmB,CAAC;qCACvC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,WAAW,GAAG,GAAG,CAAC,CAAC,CAAC;;wCAE3D,UAAU,CAAC,OAAO,CAAC,mBAAmB,CAAC;qCAC1C,UAAU,CAAC,OAAO,CAAC,mBAAmB,CAAC;qCACvC,UAAU,CAAC,MAAM,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC;;;MAG1E,YAAY,CAAC,YAAY,EAAE;QAC7B,CAAC,CAAC,EAAE,CAAC;IACP,MAAM,gBAAgB,GAAG,aAAa;QACpC,CAAC,CAAC;;kBAEY,UAAU,CAAC,OAAO,CAAC,gBAAgB,CAAC;cACxC,aAAa;qBACN;QACjB,CAAC,CAAC,EAAE,CAAC;IACP,MAAM,mBAAmB,GAAG,gBAAgB;QAC1C,CAAC,CAAC;;kBAEY,UAAU,CAAC,OAAO,CAAC,mBAAmB,CAAC;cAC3C,gBAAgB;qBACT;QACjB,CAAC,CAAC,EAAE,CAAC;IACP,MAAM,gBAAgB,GAAG,aAAa;QACpC,CAAC,CAAC;;kBAEY,UAAU,CAAC,OAAO,CAAC,gBAAgB,CAAC;cACxC,aAAa;qBACN;QACjB,CAAC,CAAC,EAAE,CAAC;IACP,OAAO;;;iBAGQ,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC;;YAE7B,gBAAgB;YAChB,mBAAmB;;kBAEb,UAAU,CAAC,OAAO,CAAC,eAAe,CAAC;cACvC,YAAY;;YAEd,gBAAgB;;kBAEV,UAAU,CAAC,OAAO,CAAC,eAAe,CAAC;iBACpC,UAAU,CAAC,OAAO,CAAC,QAAQ,CAAC;;;kBAG3B,UAAU,CAAC,SAAS,CAAC,cAAc,CAAC;iBACrC,UAAU,CAAC,OAAO,CAAC,cAAc,CAAC;;;OAG5C,CAAC;AACR,CAAC"}

package/scripts/generators/sankey-content.d.ts

@@ -0,0 +1,45 @@
+/** Pre-defined semantic color categories for Sankey nodes. */
+export type SankeyNodeColor = 'cyan' | 'magenta' | 'yellow' | 'green' | 'purple' | 'orange' | 'blue' | 'red';
+/** A node in the Sankey diagram. */
+export interface SankeyNode {
+    /** Unique identifier (used in flows to reference source/target). */
+    readonly id: string;
+    /** Display label. */
+    readonly label: string;
+    /** Semantic color. */
+    readonly color: SankeyNodeColor;
+}
+/** A directed flow between two nodes. */
+export interface SankeyFlow {
+    /** Source node id. */
+    readonly source: string;
+    /** Target node id. */
+    readonly target: string;
+    /** Flow magnitude (relative — values are scaled to fit the SVG height). */
+    readonly value: number;
+    /** Optional label shown on the flow path. */
+    readonly label?: string | undefined;
+}
+/** Full Sankey diagram configuration. */
+export interface SankeyConfig {
+    /** Array of nodes (must have at least two: one source, one target). */
+    readonly nodes: readonly SankeyNode[];
+    /** Array of directed flows between nodes. */
+    readonly flows: readonly SankeyFlow[];
+    /** Optional narrative summary. */
+    readonly summary?: string | undefined;
+}
+/**
+ * Generate a Sankey flow chart section as an HTML string with inline SVG.
+ *
+ * Returns an empty string when `config` is null/undefined or has no flows,
+ * following the same convention as `buildSwotSection` and
+ * `buildDashboardSection`.
+ *
+ * @param config - Sankey data (nodes, flows, optional summary).
+ * @param lang - BCP 47 language code for the section heading.
+ * @param heading - Optional heading override.
+ * @returns HTML string for the sankey section, or empty string.
+ */
+export declare function buildSankeySection(config: SankeyConfig | null | undefined, lang?: string, heading?: string): string;
+//# sourceMappingURL=sankey-content.d.ts.map

package/scripts/generators/sankey-content.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sankey-content.d.ts","sourceRoot":"","sources":["../../src/generators/sankey-content.ts"],"names":[],"mappings":"AAyBA,8DAA8D;AAC9D,MAAM,MAAM,eAAe,GACvB,MAAM,GACN,SAAS,GACT,QAAQ,GACR,OAAO,GACP,QAAQ,GACR,QAAQ,GACR,MAAM,GACN,KAAK,CAAC;AAEV,oCAAoC;AACpC,MAAM,WAAW,UAAU;IACzB,oEAAoE;IACpE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,qBAAqB;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,sBAAsB;IACtB,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC;CACjC;AAED,yCAAyC;AACzC,MAAM,WAAW,UAAU;IACzB,sBAAsB;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,sBAAsB;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,2EAA2E;IAC3E,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,6CAA6C;IAC7C,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACrC;AAED,yCAAyC;AACzC,MAAM,WAAW,YAAY;IAC3B,uEAAuE;IACvE,QAAQ,CAAC,KAAK,EAAE,SAAS,UAAU,EAAE,CAAC;IACtC,6CAA6C;IAC7C,QAAQ,CAAC,KAAK,EAAE,SAAS,UAAU,EAAE,CAAC;IACtC,kCAAkC;IAClC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACvC;AAkOD;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,YAAY,GAAG,IAAI,GAAG,SAAS,EACvC,IAAI,GAAE,MAAa,EACnB,OAAO,CAAC,EAAE,MAAM,GACf,MAAM,CA4BR"}

package/scripts/generators/sankey-content.js

@@ -0,0 +1,227 @@
+// SPDX-FileCopyrightText: 2024-2026 Hack23 AB
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * Generates a Sankey (flow) chart as inline SVG — no JavaScript or
+ * third-party libraries required.
+ *
+ * A Sankey diagram visualises quantities flowing from source nodes to target
+ * nodes. Node heights and flow-path widths are proportional to the values,
+ * making it easy to see dominant flows at a glance.
+ *
+ * Typical usage in articles:
+ * - Parliamentary flow: political group → document type → legislative outcome
+ * - Policy flow: policy domain → committee → outcome (adopted/rejected/pending)
+ * - Budget flow: programme area → committee → spending category
+ *
+ * @module generators/sankey-content
+ */
+import { escapeHTML } from '../utils/file-utils.js';
+// ---------------------------------------------------------------------------
+// Color palette
+// ---------------------------------------------------------------------------
+const NODE_COLORS = {
+    cyan: { fill: '#e3f2fd', stroke: '#1565c0', text: '#1565c0' },
+    magenta: { fill: '#fce4ec', stroke: '#c62828', text: '#c62828' },
+    yellow: { fill: '#fff8e1', stroke: '#f57f17', text: '#f57f17' },
+    green: { fill: '#e8f5e9', stroke: '#2e7d32', text: '#2e7d32' },
+    purple: { fill: '#f3e5f5', stroke: '#7b1fa2', text: '#7b1fa2' },
+    orange: { fill: '#fff3e0', stroke: '#e65100', text: '#e65100' },
+    blue: { fill: '#e8eaf6', stroke: '#283593', text: '#283593' },
+    red: { fill: '#ffebee', stroke: '#b71c1c', text: '#b71c1c' },
+};
+// ---------------------------------------------------------------------------
+// Section heading labels (14 languages)
+// ---------------------------------------------------------------------------
+const SANKEY_HEADINGS = {
+    en: 'Policy Flow',
+    sv: 'Politikflöde',
+    da: 'Politikflow',
+    no: 'Politikkflyt',
+    fi: 'Politiikkavirta',
+    de: 'Politikfluss',
+    fr: 'Flux législatif',
+    es: 'Flujo legislativo',
+    nl: 'Beleidsflow',
+    ar: 'تدفق السياسات',
+    he: 'זרימת מדיניות',
+    ja: '政策フロー',
+    ko: '정책 흐름',
+    zh: '政策流向图',
+};
+// ---------------------------------------------------------------------------
+// SVG layout engine
+// ---------------------------------------------------------------------------
+const SVG_WIDTH = 600;
+const NODE_WIDTH = 22;
+const NODE_GAP = 14;
+const COL_LEFT = 20;
+const COL_RIGHT = SVG_WIDTH - NODE_WIDTH - 20;
+/**
+ * Build a cubic bezier SVG path between two columns.
+ *
+ * @param x1 - Start x coordinate.
+ * @param y1 - Start y coordinate.
+ * @param x2 - End x coordinate.
+ * @param y2 - End y coordinate.
+ * @param h - Height of the flow path.
+ * @returns SVG path data string.
+ */
+function buildBezierPath(x1, y1, x2, y2, h) {
+    const mx = (x1 + x2) / 2;
+    return [
+        `M${x1},${y1}`,
+        `C${mx},${y1} ${mx},${y2} ${x2},${y2}`,
+        `L${x2},${y2 + h}`,
+        `C${mx},${y2 + h} ${mx},${y1 + h} ${x1},${y1 + h}`,
+        'Z',
+    ].join(' ');
+}
+/**
+ * Compute SVG element strings for the Sankey diagram.
+ *
+ * @param nodes - Array of Sankey nodes.
+ * @param flows - Array of directed flows between nodes.
+ * @param svgHeight - Height of the SVG canvas in pixels.
+ * @returns Array of SVG element strings.
+ */
+function layoutSankey(nodes, flows, svgHeight) {
+    const sourceIds = new Set(flows.map((f) => f.source));
+    const targetIds = new Set(flows.map((f) => f.target));
+    const valuePer = {};
+    for (const f of flows) {
+        valuePer[f.source] = (valuePer[f.source] ?? 0) + f.value;
+        valuePer[f.target] = (valuePer[f.target] ?? 0) + f.value;
+    }
+    const totalValue = Object.values(valuePer).reduce((a, b) => a + b, 0) || 1;
+    const usableHeight = svgHeight - 40;
+    const scaleFactor = usableHeight / (totalValue / 2 + (nodes.length - 1) * NODE_GAP);
+    const leftNodes = nodes.filter((n) => sourceIds.has(n.id) || !targetIds.has(n.id));
+    const rightNodes = nodes.filter((n) => targetIds.has(n.id) && !sourceIds.has(n.id));
+    function placeNodes(nds) {
+        const result = [];
+        let yOffset = 20;
+        for (const n of nds) {
+            const total = valuePer[n.id] ?? 0;
+            const height = Math.max(18, Math.round(total * scaleFactor));
+            result.push({
+                id: n.id,
+                label: n.label,
+                color: n.color,
+                totalValue: total,
+                y: yOffset,
+                height,
+                srcOffset: 0,
+                tgtOffset: 0,
+            });
+            yOffset += height + NODE_GAP;
+        }
+        return result;
+    }
+    const leftLayout = placeNodes(leftNodes);
+    const rightLayout = placeNodes(rightNodes);
+    const allLayout = [...leftLayout, ...rightLayout];
+    const layoutMap = new Map(allLayout.map((n) => [n.id, n]));
+    const svgElements = [];
+    for (const ln of allLayout) {
+        const palette = NODE_COLORS[ln.color] ?? NODE_COLORS.cyan;
+        const isLeft = leftLayout.some((l) => l.id === ln.id);
+        const xPos = isLeft ? COL_LEFT : COL_RIGHT;
+        const labelX = isLeft ? xPos + NODE_WIDTH + 6 : xPos - 6;
+        const textAnchor = isLeft ? 'start' : 'end';
+        svgElements.push(`<rect x="${xPos}" y="${ln.y}" width="${NODE_WIDTH}" height="${ln.height}" fill="${palette.fill}" stroke="${palette.stroke}" stroke-width="2" rx="3"/>`, `<text x="${labelX}" y="${ln.y + ln.height / 2}" text-anchor="${textAnchor}" dominant-baseline="middle" font-size="11" fill="${palette.text}" font-family="sans-serif">${escapeHTML(ln.label)}</text>`);
+    }
+    for (const flow of flows) {
+        const srcNode = layoutMap.get(flow.source);
+        const tgtNode = layoutMap.get(flow.target);
+        if (!srcNode || !tgtNode)
+            continue;
+        const srcPalette = NODE_COLORS[srcNode.color] ?? NODE_COLORS.cyan;
+        const tgtVal = valuePer[tgtNode.id] ?? 1;
+        const scaledH = Math.max(4, Math.round(((flow.value / Math.max(tgtVal, valuePer[srcNode.id] ?? 1)) *
+            (srcNode.height + tgtNode.height)) /
+            2));
+        const srcIsLeft = leftLayout.some((l) => l.id === srcNode.id);
+        const x1 = srcIsLeft ? COL_LEFT + NODE_WIDTH : COL_RIGHT;
+        const x2 = COL_RIGHT;
+        const y1 = srcNode.y + srcNode.srcOffset;
+        const y2 = tgtNode.y + tgtNode.tgtOffset;
+        srcNode.srcOffset += scaledH + 2;
+        tgtNode.tgtOffset += scaledH + 2;
+        const pathD = buildBezierPath(x1, y1, x2, y2, scaledH);
+        svgElements.push(`<path d="${pathD}" fill="${srcPalette.stroke}33" stroke="${srcPalette.stroke}" stroke-width="0.5" opacity="0.7"/>`);
+        if (flow.label) {
+            const midX = SVG_WIDTH / 2;
+            const midY = (y1 + y2) / 2 + scaledH / 2;
+            svgElements.push(`<text x="${midX}" y="${midY}" text-anchor="middle" dominant-baseline="middle" font-size="9" fill="#495057" font-family="sans-serif">${escapeHTML(flow.label)}</text>`);
+        }
+    }
+    return svgElements;
+}
+// ---------------------------------------------------------------------------
+// Accessible table fallback
+// ---------------------------------------------------------------------------
+function renderFallbackTable(nodes, flows) {
+    const rows = flows
+        .map((f) => {
+        const srcNode = nodes.find((n) => n.id === f.source);
+        const tgtNode = nodes.find((n) => n.id === f.target);
+        return `      <tr>
+        <td>${escapeHTML(srcNode?.label ?? f.source)}</td>
+        <td>${escapeHTML(tgtNode?.label ?? f.target)}</td>
+        <td>${f.value}</td>
+        ${f.label ? `<td>${escapeHTML(f.label)}</td>` : '<td></td>'}
+      </tr>`;
+    })
+        .join('\n');
+    return `<noscript>
+  <table class="sankey-fallback-table" aria-label="Sankey data">
+    <caption>Flow data</caption>
+    <thead><tr><th>Source</th><th>Target</th><th>Value</th><th>Note</th></tr></thead>
+    <tbody>
+${rows}
+    </tbody>
+  </table>
+  </noscript>`;
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Generate a Sankey flow chart section as an HTML string with inline SVG.
+ *
+ * Returns an empty string when `config` is null/undefined or has no flows,
+ * following the same convention as `buildSwotSection` and
+ * `buildDashboardSection`.
+ *
+ * @param config - Sankey data (nodes, flows, optional summary).
+ * @param lang - BCP 47 language code for the section heading.
+ * @param heading - Optional heading override.
+ * @returns HTML string for the sankey section, or empty string.
+ */
+export function buildSankeySection(config, lang = 'en', heading) {
+    if (!config || !config.flows || config.flows.length === 0) {
+        return '';
+    }
+    const svgHeight = 340;
+    const titleText = heading?.trim() || SANKEY_HEADINGS[lang] || 'Policy Flow';
+    const summaryBlock = config.summary?.trim()
+        ? `  <p class="sankey-summary">${escapeHTML(config.summary.trim())}</p>\n`
+        : '';
+    const svgElements = layoutSankey(config.nodes, config.flows, svgHeight);
+    const svgContent = svgElements.join('\n    ');
+    const fallbackTable = renderFallbackTable(config.nodes, config.flows);
+    return `<section class="sankey-section" role="region" aria-label="${escapeHTML(titleText)}">
+  <h2>${escapeHTML(titleText)}</h2>
+${summaryBlock}  <div class="sankey-chart-wrapper">
+    <svg viewBox="0 0 ${SVG_WIDTH} ${svgHeight}" xmlns="http://www.w3.org/2000/svg"
+         role="img" aria-label="${escapeHTML(titleText)}"
+         style="width:100%;height:auto;max-width:${SVG_WIDTH}px;display:block;">
+      <title>${escapeHTML(titleText)}</title>
+      <rect width="${SVG_WIDTH}" height="${svgHeight}" fill="var(--surface, #f8f9fa)" rx="8"/>
+    ${svgContent}
+    </svg>
+  </div>
+  ${fallbackTable}
+</section>`;
+}
+//# sourceMappingURL=sankey-content.js.map

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

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

package/scripts/generators/sitemap.d.ts

@@ -0,0 +1,66 @@
+#!/usr/bin/env node
+/**
+ * Recursively collect all HTML files under a directory, returning paths
+ * relative to the project root.
+ *
+ * @param dir - Directory to scan
+ * @param rootDir - Project root for computing relative paths
+ * @returns Array of relative paths (e.g. "docs/api/index.html")
+ */
+export declare function collectDocsHtmlFiles(dir: string, rootDir?: string): string[];
+/**
+ * Generate sitemap XML including index pages, news articles, sitemap HTML pages,
+ * and documentation files from the docs/ folder.
+ *
+ * @param articles - List of article filenames
+ * @param docsFiles - Relative paths to docs HTML files (e.g. "docs/api/index.html")
+ * @returns Complete sitemap XML string
+ */
+export declare function generateSitemap(articles: string[], docsFiles?: string[]): string;
+/**
+ * Get the sitemap HTML filename for a given language code.
+ *
+ * @param lang - Language code
+ * @returns Filename string
+ */
+export declare function getSitemapFilename(lang: string): string;
+/**
+ * Article info extracted for sitemap HTML display
+ */
+interface SitemapArticleInfo {
+    filename: string;
+    date: string;
+    title: string;
+    description: string;
+}
+/**
+ * Generate a sitemap HTML page for a specific language.
+ * Lists all articles for that language with titles and descriptions,
+ * plus a high-level documentation section.
+ *
+ * @param lang - Language code
+ * @param articleInfos - Article info (title/description) for this language
+ * @param hasDocsDir - Whether the docs directory exists
+ * @returns Complete HTML document string
+ */
+export declare function generateSitemapHTML(lang: string, articleInfos: SitemapArticleInfo[], hasDocsDir?: boolean): string;
+/**
+ * RSS feed item data.
+ */
+interface RssItem {
+    title: string;
+    link: string;
+    description: string;
+    pubDate: string;
+    lang: string;
+}
+/**
+ * Generate RSS 2.0 XML feed with all news articles across all languages.
+ * Articles are sorted newest-first. Each item includes the article language.
+ *
+ * @param articleInfos - Article metadata sorted newest first
+ * @returns Complete RSS 2.0 XML string
+ */
+export declare function generateRssFeed(articleInfos: RssItem[]): string;
+export {};
+//# sourceMappingURL=sitemap.d.ts.map

package/scripts/generators/sitemap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sitemap.d.ts","sourceRoot":"","sources":["../../src/generators/sitemap.ts"],"names":[],"mappings":";AAuCA;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,MAAqB,GAAG,MAAM,EAAE,CAe1F;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,SAAS,GAAE,MAAM,EAAO,GAAG,MAAM,CA6EpF;AA+HD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEvD;AA6CD;;GAEG;AACH,UAAU,kBAAkB;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,kBAAkB,EAAE,EAClC,UAAU,GAAE,OAAe,GAC1B,MAAM,CAwJR;AAED;;GAEG;AACH,UAAU,OAAO;IACf,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd;AAiBD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,YAAY,EAAE,OAAO,EAAE,GAAG,MAAM,CA8B/D"}