@sybilion/uilib 1.3.64 → 1.3.66

package/dist/esm/components/widgets/PerformanceChart/performanceChart.helpers.js

@@ -1,4 +1,4 @@
-import { normalizeToMonthStart, getPreviousMonth } from '../../../utils/chartConnectionPoint.js';
+import { normalizeToMonthStart, getNextMonth, getPreviousMonth } from '../../../utils/chartConnectionPoint.js';
 
 /** Legacy: API backtest spaghetti lines used `SPAGHETTI_FORECAST_ID_BASE + i` (spaghetti view now uses drift per-horizon instead). */
 const SPAGHETTI_FORECAST_ID_BASE = 6000;
@@ -36,14 +36,10 @@ function addSpaghettiHistoricalBridgeForSeries(map, dataKey, earliestForecastDat
     row[dataKey] = hist;
     map.set(connectionDate, row);
 }
-/**
- * Converts `performance.model` / `performance.drift` per-horizon forecasts into synthetic
- * backtest-shaped entries: each line is [horizon_1[i], …, horizon_n[i]] as date→value points
- * (aligned by sorted key index per horizon).
- */
-function buildPerHorizonSpaghettiEntries(forecastRoot, horizonKeys) {
-    if (!forecastRoot?.forecasts || horizonKeys.length === 0)
-        return [];
+/** When horizons have different lengths, align on the latest `n` months (suffix), not the oldest. */
+function perHorizonSortedKeyLists(forecastRoot, horizonKeys) {
+    if (!forecastRoot.forecasts || horizonKeys.length === 0)
+        return null;
     const forecasts = forecastRoot.forecasts;
     const sortedHorizons = [...horizonKeys].sort((a, b) => {
         const na = parseInt(a.replace(/\D/g, ''), 10) || 0;
@@ -59,15 +55,45 @@ function buildPerHorizonSpaghettiEntries(forecastRoot, horizonKeys) {
     });
     const lengths = perHorizonKeyLists.map(l => l.length).filter(l => l > 0);
     if (lengths.length === 0)
+        return null;
+    return { sortedHorizons, perHorizonKeyLists };
+}
+function alignedHorizonRowCount(perHorizonKeyLists) {
+    const lengths = perHorizonKeyLists.map(l => l.length).filter(l => l > 0);
+    if (lengths.length === 0)
+        return 0;
+    return Math.min(...lengths);
+}
+function horizonDateKeyAtRow(perHorizonKeyLists, horizonIndex, rowIndex, rowCount) {
+    const keys = perHorizonKeyLists[horizonIndex];
+    if (!keys?.length)
+        return undefined;
+    const offset = keys.length - rowCount;
+    return keys[offset + rowIndex];
+}
+/**
+ * Converts `performance.model` / `performance.drift` per-horizon forecasts into synthetic
+ * backtest-shaped entries: each line is [horizon_1[i], …, horizon_n[i]] as date→value points
+ * (aligned on the latest shared months per horizon).
+ */
+function buildPerHorizonSpaghettiEntries(forecastRoot, horizonKeys) {
+    const aligned = perHorizonSortedKeyLists(forecastRoot ?? {}, horizonKeys);
+    if (!aligned)
+        return [];
+    const { sortedHorizons, perHorizonKeyLists } = aligned;
+    const forecasts = forecastRoot.forecasts;
+    const normalizeDateKey = (d) => d.split(' ')[0];
+    const n = alignedHorizonRowCount(perHorizonKeyLists);
+    if (n === 0)
         return [];
-    const n = Math.min(...lengths);
     const entries = [];
     for (let i = 0; i < n; i++) {
         const forecast_series = {};
         for (let hi = 0; hi < sortedHorizons.length; hi++) {
             const h = sortedHorizons[hi];
-            const keys = perHorizonKeyLists[hi];
-            const dateKey = keys[i];
+            const dateKey = horizonDateKeyAtRow(perHorizonKeyLists, hi, i, n);
+            if (!dateKey)
+                continue;
             const rawVal = forecasts[h]?.[dateKey];
             if (typeof rawVal !== 'number' || !Number.isFinite(rawVal))
                 continue;
@@ -87,29 +113,19 @@ function buildPerHorizonSpaghettiEntries(forecastRoot, horizonKeys) {
 }
 /**
  * Same row alignment as {@link buildPerHorizonSpaghettiEntries}: row `i` uses each horizon's
- * i-th sorted forecast month; `dates[i]` is horizon_1's month at that row (Date column).
+ * latest-aligned forecast month; `dates[i]` is horizon_1's month at that row (Date column).
  * Use this for custom dialog seed + “copy statistical baseline (drift)” prefill.
  */
 function buildDriftSpaghettiMatrixForCustomDialog(driftRoot, horizonKeys) {
-    if (!driftRoot?.forecasts || horizonKeys.length === 0)
+    const aligned = perHorizonSortedKeyLists(driftRoot ?? {}, horizonKeys);
+    if (!aligned)
         return null;
+    const { sortedHorizons, perHorizonKeyLists } = aligned;
     const forecasts = driftRoot.forecasts;
-    const sortedHorizons = [...horizonKeys].sort((a, b) => {
-        const na = parseInt(a.replace(/\D/g, ''), 10) || 0;
-        const nb = parseInt(b.replace(/\D/g, ''), 10) || 0;
-        return na - nb;
-    });
     const normalizeDateKey = (d) => d.split(' ')[0];
-    const perHorizonKeyLists = sortedHorizons.map(h => {
-        const m = forecasts[h];
-        if (!m || typeof m !== 'object')
-            return [];
-        return Object.keys(m).sort((a, b) => normalizeDateKey(a).localeCompare(normalizeDateKey(b)));
-    });
-    const lengths = perHorizonKeyLists.map(l => l.length).filter(l => l > 0);
-    if (lengths.length === 0)
+    const n = alignedHorizonRowCount(perHorizonKeyLists);
+    if (n === 0)
         return null;
-    const n = Math.min(...lengths);
     const dates = [];
     const grid = [];
     const perHorizonDates = [];
@@ -118,15 +134,19 @@ function buildDriftSpaghettiMatrixForCustomDialog(driftRoot, horizonKeys) {
         const dateRow = [];
         for (let hi = 0; hi < sortedHorizons.length; hi++) {
             const h = sortedHorizons[hi];
-            const keys = perHorizonKeyLists[hi];
-            const dateKey = keys[i];
+            const dateKey = horizonDateKeyAtRow(perHorizonKeyLists, hi, i, n);
+            if (!dateKey) {
+                row.push(0);
+                dateRow.push('');
+                continue;
+            }
             dateRow.push(normalizeToMonthStart(normalizeDateKey(dateKey)));
             const rawVal = forecasts[h]?.[dateKey];
             const v = typeof rawVal === 'number' && Number.isFinite(rawVal) ? rawVal : NaN;
             row.push(v);
         }
-        const d0 = perHorizonKeyLists[0][i];
-        dates.push(normalizeToMonthStart(normalizeDateKey(d0)));
+        const d0 = horizonDateKeyAtRow(perHorizonKeyLists, 0, i, n);
+        dates.push(d0 ? normalizeToMonthStart(normalizeDateKey(d0)) : '');
         perHorizonDates.push(dateRow);
         grid.push(row.map(c => (Number.isFinite(c) ? c : 0)));
     }
@@ -136,6 +156,85 @@ function buildDriftSpaghettiMatrixForCustomDialog(driftRoot, horizonKeys) {
         perHorizonDates,
     };
 }
+function latestHistoricalMonthKey(historicalByDate) {
+    let latest = null;
+    historicalByDate.forEach((_, d) => {
+        if (!latest || d.localeCompare(latest) > 0)
+            latest = d;
+    });
+    return latest;
+}
+/**
+ * Append monthly spaghetti rows after drift backtests so the dialog (and chart) reach the latest
+ * historical month (e.g. Apr 2026), not only the last drift origin (e.g. Nov 2025).
+ */
+function extendCustomPerformanceDriftSeedToHistoricalEnd(seed, historicalByDate) {
+    const latest = latestHistoricalMonthKey(historicalByDate);
+    if (!latest || seed.dates.length === 0)
+        return seed;
+    const norm = (d) => normalizeToMonthStart(String(d).split(' ')[0] ?? d);
+    const dates = seed.dates.map(d => norm(d));
+    const grid = seed.grid.map(r => [...r]);
+    const perHorizonDates = seed.perHorizonDates.map(row => row.map(d => norm(String(d))));
+    const horizonCount = grid[0]?.length ?? perHorizonDates[0]?.length ?? 0;
+    if (horizonCount === 0)
+        return seed;
+    let lastOrigin = dates[dates.length - 1];
+    if (!lastOrigin)
+        return seed;
+    while (lastOrigin.localeCompare(latest) < 0) {
+        const nextOrigin = norm(getNextMonth(lastOrigin));
+        const prevPh = perHorizonDates[perHorizonDates.length - 1];
+        const newPh = prevPh.length === horizonCount
+            ? prevPh.map(d => norm(getNextMonth(norm(d))))
+            : Array.from({ length: horizonCount }, () => nextOrigin);
+        perHorizonDates.push(newPh);
+        dates.push(nextOrigin);
+        const baselineRow = spaghettiGridFromHistoricalPreviousMonth([newPh], horizonCount, historicalByDate);
+        grid.push(baselineRow[0] ?? Array.from({ length: horizonCount }, () => 0));
+        lastOrigin = nextOrigin;
+    }
+    return { dates, grid, perHorizonDates };
+}
+/** Pad a saved custom matrix with drift/baseline rows so edit + chart cover latest backtest months. */
+function extendCustomPerformanceMatrixWithDriftSeed(saved, driftSeed, baselineGrid) {
+    const norm = (d) => normalizeToMonthStart(String(d).split(' ')[0] ?? d);
+    const horizonCount = saved.horizonKeys.length;
+    const savedByDate = new Map();
+    for (let r = 0; r < saved.dates.length; r++) {
+        savedByDate.set(norm(saved.dates[r]), {
+            grid: saved.grid[r],
+            perHorizon: saved.perHorizonDates?.[r],
+        });
+    }
+    const dates = [];
+    const grid = [];
+    const perHorizonDates = [];
+    for (let i = 0; i < driftSeed.dates.length; i++) {
+        const d = norm(driftSeed.dates[i]);
+        if (!d)
+            continue;
+        dates.push(d);
+        const existing = savedByDate.get(d);
+        if (existing) {
+            grid.push([...existing.grid]);
+            const ph = existing.perHorizon && existing.perHorizon.length === horizonCount
+                ? existing.perHorizon.map(c => norm(String(c)))
+                : (driftSeed.perHorizonDates[i]?.map(c => norm(String(c))) ?? []);
+            perHorizonDates.push(ph);
+            continue;
+        }
+        grid.push(baselineGrid?.[i] ? [...baselineGrid[i]] : [...driftSeed.grid[i]]);
+        perHorizonDates.push((driftSeed.perHorizonDates[i] ?? []).map(c => norm(String(c))));
+    }
+    return {
+        v: saved.v,
+        dates,
+        horizonKeys: [...saved.horizonKeys],
+        grid,
+        perHorizonDates,
+    };
+}
 /**
  * Prefill for custom performance when copying drift layout: each spaghetti row is flat at the
  * historical value for the month before the earliest forecast month in that row (same anchor as
@@ -588,4 +687,4 @@ function calculateYRangeFromChartData(chartData) {
     };
 }
 
-export { SPAGHETTI_DRIFT_PER_HORIZON_ID_BASE, SPAGHETTI_FORECAST_ID_BASE, SPAGHETTI_MODEL_PER_HORIZON_ID_BASE, averageForecastErrorsVsHistoricalForMatrixColumn, buildDriftSpaghettiMatrixForCustomDialog, buildPerHorizonSpaghettiEntries, buildSpaghettiMergedChartData, calculateAccuracy, calculateBenefit, calculateROI, calculateROIMultiple, calculateYRangeFromChartData, filterChartDataLast24Months, filterSpaghettiDataFromEarliestForecastStart, formatAccuracy, formatBenefit, formatError, formatROI, getForecastModelDisplayName, isSpaghettiDriftPerHorizonLineId, isSpaghettiModelPerHorizonLineId, mergeHistoricalIntoSpaghettiChartData, mergeSpaghettiMergedBases, mergeSpaghettiUserSeriesFromForecastData, spaghettiGridFromHistoricalPreviousMonth };
+export { SPAGHETTI_DRIFT_PER_HORIZON_ID_BASE, SPAGHETTI_FORECAST_ID_BASE, SPAGHETTI_MODEL_PER_HORIZON_ID_BASE, averageForecastErrorsVsHistoricalForMatrixColumn, buildDriftSpaghettiMatrixForCustomDialog, buildPerHorizonSpaghettiEntries, buildSpaghettiMergedChartData, calculateAccuracy, calculateBenefit, calculateROI, calculateROIMultiple, calculateYRangeFromChartData, extendCustomPerformanceDriftSeedToHistoricalEnd, extendCustomPerformanceMatrixWithDriftSeed, filterChartDataLast24Months, filterSpaghettiDataFromEarliestForecastStart, formatAccuracy, formatBenefit, formatError, formatROI, getForecastModelDisplayName, isSpaghettiDriftPerHorizonLineId, isSpaghettiModelPerHorizonLineId, latestHistoricalMonthKey, mergeHistoricalIntoSpaghettiChartData, mergeSpaghettiMergedBases, mergeSpaghettiUserSeriesFromForecastData, spaghettiGridFromHistoricalPreviousMonth };

package/dist/esm/index.js

@@ -21,6 +21,8 @@ export { Card, CardAction, CardContent, CardDescription, CardFooter, CardHeader,
 export { ChartLegend, ChartTooltip } from './components/ui/Chart/Chart.js';
 export { THEMES } from './components/ui/Chart/Chart.types.js';
 export { ChartAreaInteractive, chartConfig } from './components/ui/ChartAreaInteractive/ChartAreaInteractive.js';
+export { DRAG_TIME_RANGE_PREFIX, encodeDragTimeRange, filterDataForTimeRange, findPinPositionForDate, formatNumber, isAnalysisDone, isAnalysisFailed, isAnalysisNotFailed, isTimeRangePreset, longDateFormatter, parseDragTimeRange, shortDateFormatter } from './components/ui/ChartAreaInteractive/ChartAreaInteractive.helpers.js';
+export { ChartLines, FORECAST_COLORS_MAP, FORECAST_LINE_COLORS, getForecastColor, getForecastQuantileBandColor, resolveQuantileBandFillForForecastLine } from './components/ui/ChartAreaInteractive/ChartLines.js';
 export { Chat } from './components/ui/Chat/Chat.js';
 export { formatChatTranscript, usedPresetIdsFromMessages } from './components/ui/Chat/chat-preset-utils.js';
 export { ChatChrome } from './components/ui/Chat/ChatChrome/ChatChrome.js';
@@ -111,7 +113,7 @@ export { DriversComparisonChart } from './components/widgets/DriversComparisonCh
 export { DRIVER_COMPARISON_CHART_LEAD_MONTHS, DRIVER_FORECAST_ID_BASE, INITIAL_VISIBLE_SERIES_COUNT, applyDriversComparisonViewToPayload, buildDriversComparisonChartData, formatLagMonthsLabel, formatSeriesImportance, getLagDisplayForView, mergeBacktestsChartData, mergeDatasetHistoricalWithBacktestsChartData, parseLagMonthsFromLabel, resolveDriverLagLabel, shiftNormalizedSeriesForward } from './components/widgets/DriversComparisonChart/driversComparisonChart.helpers.js';
 export { PerformanceChart } from './components/widgets/PerformanceChart/PerformanceChart.js';
 export { PerformanceTable } from './components/widgets/PerformanceChart/PerformanceTable.js';
-export { SPAGHETTI_DRIFT_PER_HORIZON_ID_BASE, SPAGHETTI_MODEL_PER_HORIZON_ID_BASE, averageForecastErrorsVsHistoricalForMatrixColumn, buildDriftSpaghettiMatrixForCustomDialog, buildPerHorizonSpaghettiEntries, buildSpaghettiMergedChartData, calculateYRangeFromChartData, getForecastModelDisplayName, spaghettiGridFromHistoricalPreviousMonth } from './components/widgets/PerformanceChart/performanceChart.helpers.js';
+export { SPAGHETTI_DRIFT_PER_HORIZON_ID_BASE, SPAGHETTI_MODEL_PER_HORIZON_ID_BASE, averageForecastErrorsVsHistoricalForMatrixColumn, buildDriftSpaghettiMatrixForCustomDialog, buildPerHorizonSpaghettiEntries, buildSpaghettiMergedChartData, calculateYRangeFromChartData, extendCustomPerformanceDriftSeedToHistoricalEnd, extendCustomPerformanceMatrixWithDriftSeed, getForecastModelDisplayName, latestHistoricalMonthKey, spaghettiGridFromHistoricalPreviousMonth } from './components/widgets/PerformanceChart/performanceChart.helpers.js';
 export { SPAGHETTI_LOCAL_LS_USER_SERIES_ROW_ID, SPAGHETTI_TIME_SERIES_MATRIX_V, tryParseSpaghettiPerformanceMatrix } from './components/widgets/PerformanceChart/performanceChartUserSeries.js';
 export { SybilionAppHeader } from './components/widgets/SybilionAppHeader/SybilionAppHeader.js';
 export { SybilionAuthLayout } from './components/widgets/SybilionAuthLayout/SybilionAuthLayout.js';

package/dist/esm/types/src/components/ui/ChartAreaInteractive/ChartAreaInteractive.helpers.d.ts

@@ -9,8 +9,6 @@ declare const timeRangeToMonths: {
     readonly All: 12;
 };
 export type TimeRangePreset = keyof typeof timeRangeToMonths;
-/** @deprecated Use `TimeRangePreset` or `string` for brush-encoded ranges. */
-export type TimeRange = TimeRangePreset;
 export declare const DRAG_TIME_RANGE_PREFIX: "__drag:";
 export declare function encodeDragTimeRange(a: Date, b: Date): string;
 export declare function parseDragTimeRange(s: string): {
@@ -42,4 +40,7 @@ export declare const isAnalysisFailed: (analysis: Analysis | {
 export declare const isAnalysisNotFailed: (analysis: Analysis | {
     status?: string;
 }) => boolean;
+export declare const isAnalysisDone: (analysis: Analysis | {
+    status?: string;
+}) => boolean;
 export {};

package/dist/esm/types/src/components/ui/ChartAreaInteractive/index.d.ts

@@ -1,3 +1,5 @@
 export * from './ChartAreaInteractive';
+export * from './ChartAreaInteractive.helpers';
 export * from './ChartAreaInteractive.types';
+export * from './ChartLines';
 export type { OverlayMode } from './ChartAreaInteractive.types';

package/dist/esm/types/src/components/widgets/PerformanceChart/index.d.ts

@@ -1,4 +1,4 @@
 export { PerformanceChart, type PerformanceChartPayload, type PerformanceChartProps, type PerformanceViewTab, } from './PerformanceChart';
 export { type AdjustParameters, type ForecastModelData, PerformanceTable, } from './PerformanceTable';
-export { SPAGHETTI_DRIFT_PER_HORIZON_ID_BASE, SPAGHETTI_MODEL_PER_HORIZON_ID_BASE, averageForecastErrorsVsHistoricalForMatrixColumn, buildDriftSpaghettiMatrixForCustomDialog, buildPerHorizonSpaghettiEntries, buildSpaghettiMergedChartData, calculateYRangeFromChartData, getForecastModelDisplayName, spaghettiGridFromHistoricalPreviousMonth, } from './performanceChart.helpers';
+export { SPAGHETTI_DRIFT_PER_HORIZON_ID_BASE, SPAGHETTI_MODEL_PER_HORIZON_ID_BASE, averageForecastErrorsVsHistoricalForMatrixColumn, buildDriftSpaghettiMatrixForCustomDialog, buildPerHorizonSpaghettiEntries, extendCustomPerformanceDriftSeedToHistoricalEnd, extendCustomPerformanceMatrixWithDriftSeed, latestHistoricalMonthKey, buildSpaghettiMergedChartData, calculateYRangeFromChartData, getForecastModelDisplayName, spaghettiGridFromHistoricalPreviousMonth, } from './performanceChart.helpers';
 export { SPAGHETTI_LOCAL_LS_USER_SERIES_ROW_ID, SPAGHETTI_TIME_SERIES_MATRIX_V, tryParseSpaghettiPerformanceMatrix, type SpaghettiPerformanceMatrixPayload, } from './performanceChartUserSeries';

package/dist/esm/types/src/components/widgets/PerformanceChart/performanceChart.helpers.d.ts

@@ -21,14 +21,14 @@ export declare function isSpaghettiDriftPerHorizonLineId(id: number): boolean;
 /**
  * Converts `performance.model` / `performance.drift` per-horizon forecasts into synthetic
  * backtest-shaped entries: each line is [horizon_1[i], …, horizon_n[i]] as date→value points
- * (aligned by sorted key index per horizon).
+ * (aligned on the latest shared months per horizon).
  */
 export declare function buildPerHorizonSpaghettiEntries(forecastRoot: {
     forecasts?: Record<string, Record<string, number>>;
 } | null | undefined, horizonKeys: string[]): RealBacktestsEntry[];
 /**
  * Same row alignment as {@link buildPerHorizonSpaghettiEntries}: row `i` uses each horizon's
- * i-th sorted forecast month; `dates[i]` is horizon_1's month at that row (Date column).
+ * latest-aligned forecast month; `dates[i]` is horizon_1's month at that row (Date column).
  * Use this for custom dialog seed + “copy statistical baseline (drift)” prefill.
  */
 export declare function buildDriftSpaghettiMatrixForCustomDialog(driftRoot: {
@@ -38,6 +38,26 @@ export declare function buildDriftSpaghettiMatrixForCustomDialog(driftRoot: {
     grid: number[][];
     perHorizonDates: string[][];
 } | null;
+export declare function latestHistoricalMonthKey(historicalByDate: Map<string, number>): string | null;
+/**
+ * Append monthly spaghetti rows after drift backtests so the dialog (and chart) reach the latest
+ * historical month (e.g. Apr 2026), not only the last drift origin (e.g. Nov 2025).
+ */
+export declare function extendCustomPerformanceDriftSeedToHistoricalEnd(seed: {
+    dates: string[];
+    grid: number[][];
+    perHorizonDates: string[][];
+}, historicalByDate: Map<string, number>): {
+    dates: string[];
+    grid: number[][];
+    perHorizonDates: string[][];
+};
+/** Pad a saved custom matrix with drift/baseline rows so edit + chart cover latest backtest months. */
+export declare function extendCustomPerformanceMatrixWithDriftSeed(saved: SpaghettiPerformanceMatrixPayload, driftSeed: {
+    dates: string[];
+    grid: number[][];
+    perHorizonDates: string[][];
+}, baselineGrid?: number[][]): SpaghettiPerformanceMatrixPayload;
 /**
  * Prefill for custom performance when copying drift layout: each spaghetti row is flat at the
  * historical value for the month before the earliest forecast month in that row (same anchor as

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sybilion/uilib",
-  "version": "1.3.64",
+  "version": "1.3.66",
   "description": "Sybilion Design System — React UI components (Webpack + Stylus)",
   "publishConfig": {
     "access": "public",
@@ -42,6 +42,7 @@
     "docs",
     "src",
     "dist",
+    "dist/agent-glossary",
     "package.json"
   ],
   "directories": {
@@ -53,7 +54,8 @@
     "ts": "tsc --noEmit",
     "dev": "NODE_OPTIONS='--loader ts-node/esm' NODE_ENV=development webpack-dev-server --mode=development --config ./src/docs/config/webpack.config.js --progress",
     "prebuild": "cp src/components/ui/Logo/logo.svg assets/logo.svg",
-    "build": "rollup -c rollup.config.ts --configPlugin @rollup/plugin-typescript",
+    "build:agent-glossary": "node scripts/build-agent-glossary.mjs --all",
+    "build": "yarn build:agent-glossary && rollup -c rollup.config.ts --configPlugin @rollup/plugin-typescript",
     "build:watch": "yarn build --watch",
     "build:compress": "COMPRESS=true yarn build",
     "publish:npm": "yarn build && npm publish --access public",

package/src/components/ui/ChartAreaInteractive/ChartAreaInteractive.helpers.ts

@@ -67,9 +67,6 @@ const timeRangeToMonths = {
 
 export type TimeRangePreset = keyof typeof timeRangeToMonths;
 
-/** @deprecated Use `TimeRangePreset` or `string` for brush-encoded ranges. */
-export type TimeRange = TimeRangePreset;
-
 export const DRAG_TIME_RANGE_PREFIX = '__drag:' as const;
 
 export function encodeDragTimeRange(a: Date, b: Date): string {
@@ -258,3 +255,7 @@ export const isAnalysisFailed = (
 export const isAnalysisNotFailed = (
   analysis: Analysis | { status?: string },
 ): boolean => !isAnalysisFailed(analysis);
+
+export const isAnalysisDone = (
+  analysis: Analysis | { status?: string },
+): boolean => analysis.status?.toLowerCase() === 'done';

package/src/components/ui/ChartAreaInteractive/index.ts

@@ -1,3 +1,5 @@
 export * from './ChartAreaInteractive';
+export * from './ChartAreaInteractive.helpers';
 export * from './ChartAreaInteractive.types';
+export * from './ChartLines';
 export type { OverlayMode } from './ChartAreaInteractive.types';

package/src/components/ui/Page/AGENT.md

@@ -0,0 +1,165 @@
+# Page layout system
+
+Sybilion workspace and report surfaces use a small set of **Page** primitives from `@sybilion/uilib`. Agents must compose these instead of inventing layout with inline styles, Tailwind structure classes, or ad-hoc wrappers.
+
+## Two modes
+
+| Mode               | When                                             | Shell                                                                                 |
+| ------------------ | ------------------------------------------------ | ------------------------------------------------------------------------------------- |
+| **workspace-page** | Route inside `AppShell` / scrolled main column   | `PageHeader` → `PageContent` → `PageContentSection`(s). Optional `PageTabs`.          |
+| **content**        | Report tiles, json-dashboard, embedded body only | No `PageHeader` / `AppShell` chrome. Map React blocks to dashboard tiles (see below). |
+
+Do not nest workspace shell components inside **content** mode output.
+
+## Mandatory workspace-page skeleton
+
+```tsx
+<PageHeader title="…" subheader="…" breadcrumbs={[…]} actions={…} />
+<PageContent>
+  <PageContentSection>{/* section A */}</PageContentSection>
+  <PageContentSection grow={false}>{/* section B */}</PageContentSection>
+</PageContent>
+```
+
+- **PageHeader**: one per route view in the main column; title, optional subheader, breadcrumbs, actions.
+- **PageContent**: vertical stack for the body below the header; `variant="clean"` when you need a flatter body (no extra chrome).
+- **PageContentSection**: primary vertical band; applies horizontal **page-x-padding** via Stylus (`pageXPadding()`). Use multiple sections to separate logical blocks.
+
+Global tokens (host app `:root`, e.g. `standalone-global.css`): `--page-width`, `--page-x-padding`, `--page-y-padding`. `PageContent` caps width at `--page-width`.
+
+## PageTabs — rules and patterns
+
+**NEVER** place `PageTabs` inside `PageContentSection`. Tabs manage their own horizontal inset via `PageXScroll` / `tabsListProps.withPaddings`.
+
+### Unified (tabs + panels inside PageContent)
+
+```tsx
+<PageHeader … />
+<PageContent>
+  <PageTabs
+    items={[
+      { value: 'a', label: 'Tab A', content: <PageContentSection>…</PageContentSection> },
+      { value: 'b', label: 'Tab B', content: <PageContentSection>…</PageContentSection> },
+    ]}
+  />
+</PageContent>
+```
+
+Tab **panels** use `PageContentSection` so section padding stays correct.
+
+### Split (bar-only sibling)
+
+Use when the tab bar must sit between header and a custom scroll region:
+
+```tsx
+<PageHeader … />
+<PageTabs
+  items={[
+    { value: 'a', label: 'Tab A', content: null },
+    { value: 'b', label: 'Tab B', content: null },
+  ]}
+/>
+<PageContent>…</PageContent>
+```
+
+Set `content: null` (or omit) for bar-only items; render panel bodies in `PageContent` yourself.
+
+## Spacing ownership
+
+| Component              | Owns horizontal page padding?                             |
+| ---------------------- | --------------------------------------------------------- |
+| **PageContentSection** | Yes (`pageXPadding`)                                      |
+| **PageTabs**           | Via `tabsListProps.withPaddings` + internal `PageXScroll` |
+| **PageXScroll**        | Reads `--page-x-padding` for inset when used standalone   |
+| **PageHeader**         | Own header inner layout (not `PageContentSection`)        |
+
+Do not duplicate `padding-left/right` on children that already sit in `PageContentSection`.
+
+## Styling rules
+
+- **No** `style={{…}}` for layout or spacing (margins, padding, flex, width, gap).
+- **No** Tailwind (or other) utility classes for **structural** layout on page primitives.
+- Custom layout CSS only in co-located `ComponentName.styl`, using design tokens (`var(--p-*)`, `var(--page-x-padding)`, `pageXPadding()`, etc.).
+- `className` on Page components is for Stylus module classes or state hooks, not one-off pixel tweaks.
+
+## Component reference
+
+### PageHeader
+
+Sticky-style page title row: breadcrumbs (optional sidebar trigger in full app), `title`, `subheader`, `actions`. Lives **above** `PageContent`, never inside a section.
+
+### PageContent / PageContentSection
+
+`PageContent`: column flex child, `max-width: var(--page-width)`.  
+`PageContentSection`: `grow` (default `true`) lets the section absorb remaining height in flex layouts.
+
+### PageColumns
+
+Side-by-side columns with gap. **`fill`** controls which column(s) grow:
+
+| `fill`          | Behavior                                                                                        |
+| --------------- | ----------------------------------------------------------------------------------------------- |
+| `all` (default) | Every column `flex-grow: 1`, `max-width` unset — use for equal split or fluid grids of columns. |
+| `left`          | First column grows; others stay at fixed min/max column width.                                  |
+| `right`         | Last column grows.                                                                              |
+
+Pass `columns={[node1, node2, …]}`. On mobile, stacks vertically. Typical pattern: main + aside inside one `PageContentSection`.
+
+### PageXScroll
+
+Horizontal scroll strip; used inside `PageTabs` and anywhere a overflowing row needs page-aligned padding. Props: `size`, `fullWidth`, `innerClassName`, `scrollbarClassName`.
+
+### SectionHeader
+
+In-section title block (`title`, `description`, `actions`). Use **inside** `PageContentSection`, not as a replacement for `PageHeader`.
+
+### PageEmptyCanvas
+
+Centered empty state: `title`, `hint`, optional `children` (e.g. CTA button). Use when a route has no data yet.
+
+### GridLayout
+
+Responsive CSS grid (`repeat(auto-fit, minmax(colWidth, 1fr))`). Use for card/tile dashboards inside a section. Report mapping: dashboard **grid** rows / multi-column tile groups.
+
+### Card / Foldable
+
+Use inside sections for grouped content; see package `AGENT.md` on those components when present. Do not wrap the whole page in Card.
+
+## Content mode — React → json-dashboard tiles
+
+When generating **report** / dashboard specs (not workspace routes), map UI blocks to tiles:
+
+| React / intent                  | Dashboard tile / markdown                                         |
+| ------------------------------- | ----------------------------------------------------------------- |
+| `PageHeader` title text         | First `markdown` tile `# Title` or report title field             |
+| `SectionHeader` `title`         | `markdown` with `## …`                                            |
+| `SectionHeader` `description`   | markdown paragraph under that heading                             |
+| `PageContentSection` block      | group of tiles or one markdown section                            |
+| `GridLayout` children           | grid row of widget tiles                                          |
+| `ChartAreaInteractive` / charts | `dataset_card`, `performance_chart`, etc. (see widget `AGENT.md`) |
+| `PageEmptyCanvas` copy          | `markdown` explanatory tile                                       |
+
+See `AGENT.report-only-tiles.md` in the app repo for tiles without a uilib widget.
+
+## Shell components (workspace only)
+
+Not part of the per-route skeleton but part of **workspace-page** host wiring:
+
+- **AppShell** / **AppShellMainContent** — sidebar + main column + header slot + footer.
+- **PageScroll** — scroll root for the main column.
+- **SybilionAppHeader** — workspace app switcher + user menu (lives in header slot, not inside `PageContent`).
+
+## Anti-patterns
+
+- `PageTabs` inside `PageContentSection`.
+- Inline styles or Tailwind for page structure.
+- Second `PageHeader` nested in content.
+- `PageContent` without sections for multi-block pages (prefer multiple `PageContentSection`).
+- Wrapping data widgets in extra layout divs with hard-coded padding.
+
+## Future candidates (not implemented)
+
+- **PageToolbar** — dedicated action row between header and tabs.
+- **PageFullBleed** — edge-to-edge section escape hatch.
+
+Do not add these locally; extend uilib when product needs them.

package/src/components/widgets/AGENT.md

@@ -6,7 +6,7 @@ Each component file ≤18 lines. Signal for LLM prompts — no noise.
 
 **Include:** Renders (1 sentence); Use when / Not when; Host provides (3–5 bullets); Report tile (one line or "Not used"); Requires (prop names + role); Empty/loading (one line).
 
-**Do not include:** import examples; type/doc/demo/glossary links; page-shell boilerplate; related-components lists unless choosing between exports; implementation/styling/keyboard notes unless binding-relevant; secrets, env vars, API URLs.
+**Do not include:** import examples; type/doc/demo/glossary links; page-shell boilerplate; related-components lists unless choosing between exports; implementation/styling/keyboard notes unless binding-relevant; secrets, env vars, API URLs; inline style examples (`style={{…}}`).
 
 ```markdown
 # Name

package/src/components/widgets/PerformanceChart/index.ts

@@ -15,6 +15,9 @@ export {
   averageForecastErrorsVsHistoricalForMatrixColumn,
   buildDriftSpaghettiMatrixForCustomDialog,
   buildPerHorizonSpaghettiEntries,
+  extendCustomPerformanceDriftSeedToHistoricalEnd,
+  extendCustomPerformanceMatrixWithDriftSeed,
+  latestHistoricalMonthKey,
   buildSpaghettiMergedChartData,
   calculateYRangeFromChartData,
   getForecastModelDisplayName,