@sybilion/uilib 1.3.41 → 1.3.43

package/dist/esm/components/ui/RegionCoords/RegionSelector.js

@@ -6,7 +6,7 @@ import { DropdownMenu, DropdownMenuTrigger, DropdownMenuContent, DropdownMenuIte
 import { CaretDownIcon } from '@phosphor-icons/react';
 import S from './RegionSelector.styl.js';
 
-function RegionSelector({ children, onSelect, className, regions: regionCoordinates, }) {
+function RegionSelector({ children, onSelect, className, regions: regionCoordinates = {}, }) {
     const [open, setOpen] = useState(false);
     const handleRegionSelect = (regionName) => {
         const coords = regionCoordinates[regionName];
@@ -16,7 +16,7 @@ function RegionSelector({ children, onSelect, className, regions: regionCoordina
         }
     };
     const regions = Object.keys(regionCoordinates).sort();
-    return (jsxs("div", { className: cn(S.root, className), children: [children, jsxs(DropdownMenu, { open: open, onOpenChange: setOpen, children: [jsx(DropdownMenuTrigger, { asChild: true, children: jsx(Button, { variant: "outline", size: "sm", className: S.button, children: jsx(CaretDownIcon, { size: 16 }) }) }), jsx(DropdownMenuContent, { align: "end", children: regions.map(region => (jsx(DropdownMenuItem, { onSelect: () => handleRegionSelect(region), children: region }, region))) })] })] }));
+    return (jsxs("div", { className: cn(S.root, className), children: [children, regions.length > 0 && (jsxs(DropdownMenu, { open: open, onOpenChange: setOpen, children: [jsx(DropdownMenuTrigger, { asChild: true, children: jsx(Button, { variant: "outline", size: "sm", className: S.button, children: jsx(CaretDownIcon, { size: 16 }) }) }), jsx(DropdownMenuContent, { align: "end", children: regions.map(region => (jsx(DropdownMenuItem, { onSelect: () => handleRegionSelect(region), children: region }, region))) })] }))] }));
 }
 
 export { RegionSelector };

package/dist/esm/types/src/components/ui/RegionCoords/RegionSelector.types.d.ts

@@ -6,7 +6,7 @@ export interface RegionSelectorProps {
     }) => void;
     className?: string;
     /** Region name → coordinates (app-defined; replaces app-only drivers catalog). */
-    regions: Record<string, {
+    regions?: Record<string, {
         longitude: number;
         latitude: number;
     }>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sybilion/uilib",
-  "version": "1.3.41",
+  "version": "1.3.43",
   "description": "Sybilion Design System — React UI components (Webpack + Stylus)",
   "publishConfig": {
     "access": "public",

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

@@ -0,0 +1,19 @@
+# ChartAreaInteractive
+
+Renders: time-series chart with historical line, forecast lines, optional pin / quantile-band / threshold overlays.
+
+Use when: custom forecast UI with overlays or full chart control.
+Not when: packaged performance or drivers-comparison views (use PerformanceChart or DriversComparisonChart).
+
+Host provides:
+
+- `chartData`, `forecastData` built from API
+- `timeRange` / `onTimeRangeChange` or brush-only range
+- Optional `mode`: pin | intervals | thresholds + overlay state
+- Analysis selector and fetch outside widget
+
+Report tile: `dataset_card` — host loads dataset + analysis; chart inside dashboard card.
+
+Requires: `chartData`; `forecastData`; `loading`; `toggleLegendSeries` / `ensureAnalysisSeriesVisible` when legend is external.
+
+Empty/loading: `loading`, `error`; empty data shows chart empty state via host message props.

package/src/components/ui/RegionCoords/RegionSelector.tsx

@@ -17,7 +17,7 @@ export function RegionSelector({
   children,
   onSelect,
   className,
-  regions: regionCoordinates,
+  regions: regionCoordinates = {},
 }: RegionSelectorProps) {
   const [open, setOpen] = useState(false);
 
@@ -34,23 +34,25 @@ export function RegionSelector({
   return (
     <div className={cn(S.root, className)}>
       {children}
-      <DropdownMenu open={open} onOpenChange={setOpen}>
-        <DropdownMenuTrigger asChild>
-          <Button variant="outline" size="sm" className={S.button}>
-            <CaretDownIcon size={16} />
-          </Button>
-        </DropdownMenuTrigger>
-        <DropdownMenuContent align="end">
-          {regions.map(region => (
-            <DropdownMenuItem
-              key={region}
-              onSelect={() => handleRegionSelect(region)}
-            >
-              {region}
-            </DropdownMenuItem>
-          ))}
-        </DropdownMenuContent>
-      </DropdownMenu>
+      {regions.length > 0 && (
+        <DropdownMenu open={open} onOpenChange={setOpen}>
+          <DropdownMenuTrigger asChild>
+            <Button variant="outline" size="sm" className={S.button}>
+              <CaretDownIcon size={16} />
+            </Button>
+          </DropdownMenuTrigger>
+          <DropdownMenuContent align="end">
+            {regions.map(region => (
+              <DropdownMenuItem
+                key={region}
+                onSelect={() => handleRegionSelect(region)}
+              >
+                {region}
+              </DropdownMenuItem>
+            ))}
+          </DropdownMenuContent>
+        </DropdownMenu>
+      )}
     </div>
   );
 }

package/src/components/ui/RegionCoords/RegionSelector.types.ts

@@ -6,5 +6,5 @@ export interface RegionSelectorProps {
   ) => void;
   className?: string;
   /** Region name → coordinates (app-defined; replaces app-only drivers catalog). */
-  regions: Record<string, { longitude: number; latitude: number }>;
+  regions?: Record<string, { longitude: number; latitude: number }>;
 }

package/src/components/widgets/AGENT.md

@@ -0,0 +1,21 @@
+<!-- not a component — authoring guide only -->
+
+# Widget `AGENT.md` authoring
+
+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.
+
+```markdown
+# Name
+
+Renders: …
+Use when: …
+Not when: …
+Host provides: …
+Report tile: …
+Requires: …
+Empty/loading: …
+```

package/src/components/widgets/DriverMap/AGENT.md

@@ -0,0 +1,18 @@
+# DriverMap
+
+Renders: world map with regional driver badges, bottom strip for world-level drivers, selection highlight.
+
+Use when: geographic driver exploration for one analysis.
+Not when: driver detail metrics card alone (pair with DriverCard) or normalized series chart (use DriversComparisonChart).
+
+Host provides:
+
+- `drivers` as `DriverData[]` from analysis API
+- Controlled `selectedDriver` + `setSelectedDriver`
+- `isLoading` while fetching drivers
+
+Report tile: `drivers_map` — tile resolves analysis id, fetches drivers, passes list + selection (see EmbeddedAnalysisSelector pattern).
+
+Requires: `drivers`; `isLoading`; `selectedDriver`; `setSelectedDriver`.
+
+Empty/loading: `isLoading` shows overlay; empty `drivers` leaves map without badges.

package/src/components/widgets/DriversComparisonChart/AGENT.md

@@ -0,0 +1,18 @@
+# DriversComparisonChart
+
+Renders: target vs drivers backtests chart with ChartAreaInteractive plus table; row click toggles series visibility.
+
+Use when: drivers comparison tab with normalized target and driver series from backtests payload.
+Not when: geographic map or performance horizons — use DriverMap or PerformanceChart.
+
+Host provides:
+
+- `payload`: BacktestsComponentPayload from platform SDK (host fetch per analysis)
+- Optional `datasetHistorical` overlay
+- `seriesInitKey` when selected analysis changes
+
+Report tile: Not used in report tiles.
+
+Requires: `payload` — target + driver normalized_series; `loading` / `chartLoading` — spinners; `seriesInitKey` — reset visible series on analysis change; `runAnalysisHint` / `statusHint` — empty/error text.
+
+Empty/loading: loading props shimmer chart; null `payload` with `runAnalysisHint` prompts to run analysis.

package/src/components/widgets/PerformanceChart/AGENT.md

@@ -0,0 +1,18 @@
+# PerformanceChart
+
+Renders: forecast performance on ChartAreaInteractive — per-horizon tab (24m window, MAE/MAPE table) and spaghetti tab (all horizons overlaid).
+
+Use when: dataset performance tab with horizon selector and error metrics.
+Not when: simple forecast card or driver backtests — use ChartAreaInteractive or DriversComparisonChart.
+
+Host provides:
+
+- `performanceData` (PerformanceChartPayload) and `historicalData` from performance API
+- Analysis selection and fetch outside widget
+- Optional `forecastData`, `customPerformanceMatrix`, `userSeries` for spaghetti
+
+Report tile: Not used in report tiles.
+
+Requires: `performanceData` — model/drift forecasts and metrics; `historicalData` — baseline series; `loading` / `chartLoading` / `performanceDataLoading` — spinners; `runAnalysisHint` / `statusHint` — empty states.
+
+Empty/loading: loading props show shimmer/spinner; null `performanceData` with `runAnalysisHint` prompts to run analysis.

package/src/components/widgets/SidebarDatasetsItemsGrouped/AGENT.md

@@ -0,0 +1,18 @@
+# SidebarDatasetsItemsGrouped
+
+Renders: expandable sidebar groups of datasets (by target type, regions, or categories).
+
+Use when: app shell needs grouped dataset navigation.
+Not when: in-page or report content (no sidebar slot).
+
+Host provides:
+
+- `datasets` list (`SidebarDatasetsItemsGroupedDataset`)
+- `groupBy`, `selectedDatasetId`, `onDatasetClick`
+- Optional `preItems` / `postItems`, `defaultExpandedGroupNames`
+
+Report tile: Not used in report tiles.
+
+Requires: `datasets`; `groupBy`; `onDatasetClick` for navigation.
+
+Empty/loading: empty `datasets` renders no groups; loading handled by host before pass-in.