@wildo-ai/saas-frontend-lib 1.0.1

package/dist/esm/components/views/chart-view/ChartView.js

@@ -0,0 +1,115 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/** ──────────────────────────────────────────────────────────────
+ * ChartView — ECharts-based chart component
+ *
+ * Fetches data from backend via POST /api/charts/:chartRef/data,
+ * combines with the visual encoding from the chart definition,
+ * and renders via ECharts.
+ *
+ * This file is lazy-loaded via React.lazy() in AppRouter.
+ * ────────────────────────────────────────────────────────────── */
+import React, { useRef, useState, useEffect, useCallback, useMemo, Suspense } from 'react';
+import { FrontendComponentType } from '@wildo-ai/presets-components-models';
+import { useUI } from '../../../core/ui/useUI.js';
+import { useI18n } from '../../../core/i18n/useI18n.js';
+import { ViewNotFound } from '../../../components/views/ViewNotFound.js';
+import { useChartData } from './chart-view.utils.js';
+import { useResolvedChartRuntimeDescriptor } from './chart-runtime.utils.js';
+import { useChartTheme, getWildoThemeName } from './chart-theme-bridge.js';
+import { buildEChartsOption } from './option-builder/echarts-option-builder.js';
+import { ChartLoadingSkeleton } from './ChartLoadingSkeleton.js';
+import { ChartErrorState } from './ChartErrorState.js';
+import { ChartEmptyState } from './ChartEmptyState.js';
+import { buildResolvedInsertedChartDescriptor, resolveInsertedChartView, } from '../../../core/config/chart-view.frontend.schemas.js';
+import { useResourceRegistry } from '../../../core/resources/useResourceRegistry.js';
+// Import the modular echarts instance (tree-shaken, ~300-400KB instead of ~1MB)
+import { echarts } from './echarts-setup.js';
+// Lazy-load echarts-for-react — keeps ECharts out of the main bundle
+const ReactECharts = React.lazy(() => import('echarts-for-react'));
+/**
+ * ChartView — renders an ECharts chart from a ChartDefinition.
+ *
+ * Data flow:
+ *   1. Resolve definition from UIContext or props
+ *   2. Fetch aggregated data from backend
+ *   3. Build ECharts option from definition + data
+ *   4. Render with echarts-for-react
+ */
+export const ChartView = ({ viewRef, document: documentProp, viewDefinition: viewDefinitionProp, runtimeDescriptor, contextResourceIdentifiers, urlParamValues, inputs, className = '', width = '100%', height = 400, }) => {
+    const { registry } = useResourceRegistry();
+    const { getChartStylePreset, isDark } = useUI();
+    const chartStylePreset = getChartStylePreset();
+    const { t } = useI18n({ component: FrontendComponentType.HIGH_LEVEL_VIEWS_CHART });
+    const containerRef = useRef(null);
+    const echartsRef = useRef(null);
+    // Register/update chart theme with current style preset
+    useChartTheme(chartStylePreset);
+    const resolvedInsertedChart = useMemo(() => (viewDefinitionProp ? undefined : resolveInsertedChartView({ viewRef, registry })), [viewDefinitionProp, viewRef, registry]);
+    const viewDefinition = viewDefinitionProp ?? resolvedInsertedChart?.chartView;
+    const effectiveRuntimeDescriptor = useMemo(() => runtimeDescriptor ?? (resolvedInsertedChart
+        ? buildResolvedInsertedChartDescriptor({
+            identity: resolvedInsertedChart.identity,
+            chartView: resolvedInsertedChart.chartView,
+            contextResourceIdentifiers: contextResourceIdentifiers ?? {},
+        })
+        : undefined), [runtimeDescriptor, resolvedInsertedChart, contextResourceIdentifiers]);
+    const runtime = useResolvedChartRuntimeDescriptor({
+        surfaceDefinition: viewDefinition,
+        chartDefinition: documentProp,
+        runtimeDescriptor: effectiveRuntimeDescriptor,
+        explicitContextResourceIdentifiers: contextResourceIdentifiers,
+        explicitInputs: inputs,
+        urlParamValues,
+    });
+    const definition = runtime?.chartDefinition;
+    // Fetch chart data
+    const { data, loading, error, refetch } = useChartData(definition, runtime?.executionChartRef, runtime?.resolvedInputs, runtime?.contextResourceIdentifiers, urlParamValues);
+    // Track container size in state so option rebuilds on resize
+    const [containerSize, setContainerSize] = useState({ width: 800, height: 400 });
+    // ResizeObserver for container
+    useEffect(() => {
+        const el = containerRef.current;
+        if (!el)
+            return;
+        const observer = new ResizeObserver((entries) => {
+            const entry = entries[0];
+            if (entry) {
+                setContainerSize({
+                    width: entry.contentRect.width,
+                    height: entry.contentRect.height,
+                });
+                // Tell ECharts to resize
+                echartsRef.current?.getEchartsInstance?.()?.resize?.();
+            }
+        });
+        observer.observe(el);
+        return () => observer.disconnect();
+    }, []);
+    // Save echarts instance ref
+    const onChartReady = useCallback((instance) => {
+        echartsRef.current = { getEchartsInstance: () => instance };
+    }, []);
+    // Build ECharts option — memoized, placed before early returns to respect Rules of Hooks
+    const option = useMemo(() => (definition && data && data.data.length > 0)
+        ? buildEChartsOption(definition, data, containerSize, chartStylePreset, t)
+        : null, [definition, data, containerSize, chartStylePreset, t]);
+    // Not found
+    if (!definition) {
+        return _jsx(ViewNotFound, { viewType: "Chart view", viewRef: viewRef });
+    }
+    // Loading
+    if (loading && !data) {
+        return _jsx(ChartLoadingSkeleton, { height: height });
+    }
+    // Error
+    if (error) {
+        return _jsx(ChartErrorState, { error: error, onRetry: refetch });
+    }
+    // Empty
+    if (!option) {
+        return _jsx(ChartEmptyState, {});
+    }
+    return (_jsx("div", { ref: containerRef, className: `chart-view ${className}`, style: { width, height, position: 'relative' }, children: _jsx(Suspense, { fallback: _jsx(ChartLoadingSkeleton, { height: height }), children: _jsx(ReactECharts, { echarts: echarts, option: option, theme: getWildoThemeName(), style: { width: '100%', height: '100%' }, notMerge: true, lazyUpdate: true, onChartReady: onChartReady }, isDark ? 'dark' : 'light') }) }));
+};
+export default ChartView;
+//# sourceMappingURL=ChartView.js.map

package/dist/esm/components/views/chart-view/ChartView.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChartView.js","sourceRoot":"","sources":["../../../../../src/components/views/chart-view/ChartView.tsx"],"names":[],"mappings":"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"}

package/dist/esm/components/views/chart-view/ChartView.lazy.d.ts

@@ -0,0 +1,13 @@
+import React from 'react';
+import type { ChartViewProps } from './ChartView.js';
+/**
+ * Lazy barrel-safe ChartView export.
+ *
+ * This wrapper keeps the ECharts runtime behind a dynamic import boundary so
+ * package-root consumers can still render charts without pulling the heavy
+ * chart bundle into the main application chunk.
+ */
+export declare const ChartView: React.FC<ChartViewProps>;
+export type { ChartViewProps } from './ChartView.js';
+export default ChartView;
+//# sourceMappingURL=ChartView.lazy.d.ts.map

package/dist/esm/components/views/chart-view/ChartView.lazy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChartView.lazy.d.ts","sourceRoot":"","sources":["../../../../../src/components/views/chart-view/ChartView.lazy.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAmB,MAAM,OAAO,CAAC;AAExC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAIlD;;;;;;GAMG;AACH,eAAO,MAAM,SAAS,EAAE,KAAK,CAAC,EAAE,CAAC,cAAc,CAI9C,CAAC;AAEF,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,eAAe,SAAS,CAAC"}

package/dist/esm/components/views/chart-view/ChartView.lazy.js

@@ -0,0 +1,14 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import React, { Suspense } from 'react';
+import { ChartLoadingSkeleton } from './ChartLoadingSkeleton.js';
+const LazyChartViewInner = React.lazy(() => import('./ChartView.js'));
+/**
+ * Lazy barrel-safe ChartView export.
+ *
+ * This wrapper keeps the ECharts runtime behind a dynamic import boundary so
+ * package-root consumers can still render charts without pulling the heavy
+ * chart bundle into the main application chunk.
+ */
+export const ChartView = (props) => (_jsx(Suspense, { fallback: _jsx(ChartLoadingSkeleton, { height: props.height ?? 400 }), children: _jsx(LazyChartViewInner, { ...props }) }));
+export default ChartView;
+//# sourceMappingURL=ChartView.lazy.js.map

package/dist/esm/components/views/chart-view/ChartView.lazy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChartView.lazy.js","sourceRoot":"","sources":["../../../../../src/components/views/chart-view/ChartView.lazy.tsx"],"names":[],"mappings":";AAAA,OAAO,KAAK,EAAE,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACxC,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAG9D,MAAM,kBAAkB,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC;AAEnE;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,SAAS,GAA6B,CAAC,KAAK,EAAE,EAAE,CAAC,CAC5D,KAAC,QAAQ,IAAC,QAAQ,EAAE,KAAC,oBAAoB,IAAC,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,GAAG,GAAI,YACvE,KAAC,kBAAkB,OAAK,KAAK,GAAI,GACxB,CACZ,CAAC;AAIF,eAAe,SAAS,CAAC"}

package/dist/esm/components/views/chart-view/ChartWidget.d.ts

@@ -0,0 +1,29 @@
+/** ──────────────────────────────────────────────────────────────
+ * ChartWidget — Lazy-loaded chart for CompositeView grids
+ *
+ * Wraps ChartView in:
+ *   - React.lazy (code-split)
+ *   - Error boundary (chart failure doesn't crash the dashboard)
+ *   - Suspense (loading skeleton)
+ *
+ * Usage in CompositeView grid config:
+ *   { type: 'chart', chartRef: 'orders-per-month', x: 0, y: 0, w: 6, h: 4 }
+ * ────────────────────────────────────────────────────────────── */
+import React from 'react';
+export interface ChartWidgetProps {
+    /** Chart reference — resolved by `ChartView` from the resource registry. */
+    chartRef: string;
+    /** Width (default: 100% — fills grid cell) */
+    width?: string | number;
+    /** Height (default: 100% — fills grid cell) */
+    height?: string | number;
+    /** Additional CSS class */
+    className?: string;
+}
+/**
+ * ChartWidget — drop-in chart component for dashboard grids.
+ * Includes lazy loading, error boundary, and suspense fallback.
+ */
+export declare const ChartWidget: React.FC<ChartWidgetProps>;
+export default ChartWidget;
+//# sourceMappingURL=ChartWidget.d.ts.map

package/dist/esm/components/views/chart-view/ChartWidget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChartWidget.d.ts","sourceRoot":"","sources":["../../../../../src/components/views/chart-view/ChartWidget.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;oEAUoE;AAEpE,OAAO,KAA8B,MAAM,OAAO,CAAC;AAwEnD,MAAM,WAAW,gBAAgB;IAC/B,4EAA4E;IAC5E,QAAQ,EAAE,MAAM,CAAC;IACjB,8CAA8C;IAC9C,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,+CAA+C;IAC/C,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,2BAA2B;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,eAAO,MAAM,WAAW,EAAE,KAAK,CAAC,EAAE,CAAC,gBAAgB,CA0BlD,CAAC;AAEF,eAAe,WAAW,CAAC"}

package/dist/esm/components/views/chart-view/ChartWidget.js

@@ -0,0 +1,60 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/** ──────────────────────────────────────────────────────────────
+ * ChartWidget — Lazy-loaded chart for CompositeView grids
+ *
+ * Wraps ChartView in:
+ *   - React.lazy (code-split)
+ *   - Error boundary (chart failure doesn't crash the dashboard)
+ *   - Suspense (loading skeleton)
+ *
+ * Usage in CompositeView grid config:
+ *   { type: 'chart', chartRef: 'orders-per-month', x: 0, y: 0, w: 6, h: 4 }
+ * ────────────────────────────────────────────────────────────── */
+import React, { Component, Suspense } from 'react';
+import { EmptyState } from '../../../components/feedback/empty-state.js';
+import { StandardIconReference } from '../../../core/icons/icon-registry.frontend.schemas.js';
+import { FrontendComponentType } from '@wildo-ai/presets-components-models';
+import { useI18n } from '../../../core/i18n/useI18n.js';
+import { FeatureRouteGuard } from '../../../core/features/FeatureRouteGuard.js';
+import { useResourceRegistry } from '../../../core/resources/useResourceRegistry.js';
+import { resolveInsertedChartView } from '../../../core/config/chart-view.frontend.schemas.js';
+import { ChartLoadingSkeleton } from './ChartLoadingSkeleton.js';
+// Lazy-load ChartView — keeps ECharts completely out of the main bundle
+const LazyChartView = React.lazy(() => import('./ChartView.js'));
+// ── Error Fallback (functional — can use hooks) ─────────────
+const ChartWidgetErrorFallback = ({ onRetry }) => {
+    const { tComponent } = useI18n({ component: FrontendComponentType.HIGH_LEVEL_VIEWS_CHART_WIDGET });
+    return (_jsx(EmptyState, { variant: "compact", iconRef: StandardIconReference.ERROR_APPLICATION, title: tComponent(FrontendComponentType.HIGH_LEVEL_VIEWS_CHART_WIDGET, 'chartFailed'), primaryActionLabel: tComponent(FrontendComponentType.HIGH_LEVEL_VIEWS_CHART_WIDGET, 'retry'), onPrimaryAction: onRetry, className: "h-full min-h-[120px] border-0" }));
+};
+class ChartWidgetErrorBoundary extends Component {
+    constructor(props) {
+        super(props);
+        this.state = { hasError: false };
+    }
+    static getDerivedStateFromError(error) {
+        return { hasError: true, error };
+    }
+    componentDidCatch(error, errorInfo) {
+        console.error(`ChartWidget error (ref: ${this.props.chartRef}):`, error, errorInfo);
+    }
+    render() {
+        if (this.state.hasError) {
+            return (_jsx(ChartWidgetErrorFallback, { onRetry: () => this.setState({ hasError: false, error: undefined }) }));
+        }
+        return this.props.children;
+    }
+}
+/**
+ * ChartWidget — drop-in chart component for dashboard grids.
+ * Includes lazy loading, error boundary, and suspense fallback.
+ */
+export const ChartWidget = ({ chartRef, width = '100%', height = '100%', className, }) => {
+    const { registry } = useResourceRegistry();
+    const requiredFeatures = resolveInsertedChartView({
+        viewRef: chartRef,
+        registry,
+    })?.chartView.chartDefinition.requiredFeatures;
+    return (_jsx(ChartWidgetErrorBoundary, { chartRef: chartRef, children: _jsx(FeatureRouteGuard, { requiredFeatures: requiredFeatures, children: _jsx(Suspense, { fallback: _jsx(ChartLoadingSkeleton, { height: height }), children: _jsx(LazyChartView, { viewRef: chartRef, width: width, height: height, className: className }) }) }) }));
+};
+export default ChartWidget;
+//# sourceMappingURL=ChartWidget.js.map

package/dist/esm/components/views/chart-view/ChartWidget.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChartWidget.js","sourceRoot":"","sources":["../../../../../src/components/views/chart-view/ChartWidget.tsx"],"names":[],"mappings":"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"}

package/dist/esm/components/views/chart-view/chart-export.utils.d.ts

@@ -0,0 +1,34 @@
+/** ──────────────────────────────────────────────────────────────
+ * Chart Export Utilities
+ *
+ * - PNG export via ECharts `getDataURL()`
+ * - CSV export from aggregation response data
+ * ────────────────────────────────────────────────────────────── */
+import type { AggregationQueryResponse } from '@wildo-ai/saas-models';
+import type { ChartDefinition } from '@wildo-ai/saas-models';
+/**
+ * Export the chart as a PNG image.
+ *
+ * @param echartsInstance - The ECharts instance (from `onChartReady`)
+ * @param filename - The file name for the download (default: 'chart.png')
+ * @param pixelRatio - Resolution multiplier (default: 2 for retina)
+ */
+/** Minimal interface for the ECharts getDataURL method */
+interface EChartsExportable {
+    getDataURL: (opts: {
+        type: string;
+        pixelRatio: number;
+        backgroundColor: string;
+    }) => string;
+}
+export declare function exportChartAsPNG(echartsInstance: EChartsExportable | null | undefined, filename?: string, pixelRatio?: number): void;
+/**
+ * Export the chart data as a CSV file.
+ *
+ * @param response - The aggregation query response
+ * @param definition - The chart definition (for column headers)
+ * @param filename - The file name for the download (default: 'chart-data.csv')
+ */
+export declare function exportChartAsCSV(response: AggregationQueryResponse, definition: ChartDefinition, filename?: string): void;
+export {};
+//# sourceMappingURL=chart-export.utils.d.ts.map

package/dist/esm/components/views/chart-view/chart-export.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chart-export.utils.d.ts","sourceRoot":"","sources":["../../../../../src/components/views/chart-view/chart-export.utils.ts"],"names":[],"mappings":"AAAA;;;;;oEAKoE;AAEpE,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AACtE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D;;;;;;GAMG;AACH,0DAA0D;AAC1D,UAAU,iBAAiB;IACzB,UAAU,EAAE,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,MAAM,CAAA;KAAE,KAAK,MAAM,CAAC;CAC7F;AAED,wBAAgB,gBAAgB,CAC9B,eAAe,EAAE,iBAAiB,GAAG,IAAI,GAAG,SAAS,EACrD,QAAQ,SAAc,EACtB,UAAU,SAAI,GACb,IAAI,CAkBN;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,wBAAwB,EAClC,UAAU,EAAE,eAAe,EAC3B,QAAQ,SAAmB,GAC1B,IAAI,CAkDN"}

package/dist/esm/components/views/chart-view/chart-export.utils.js

@@ -0,0 +1,85 @@
+/** ──────────────────────────────────────────────────────────────
+ * Chart Export Utilities
+ *
+ * - PNG export via ECharts `getDataURL()`
+ * - CSV export from aggregation response data
+ * ────────────────────────────────────────────────────────────── */
+export function exportChartAsPNG(echartsInstance, filename = 'chart.png', pixelRatio = 2) {
+    if (!echartsInstance?.getDataURL) {
+        console.warn('Chart export: no ECharts instance available');
+        return;
+    }
+    const dataURL = echartsInstance.getDataURL({
+        type: 'png',
+        pixelRatio,
+        backgroundColor: '#fff',
+    });
+    const link = document.createElement('a');
+    link.download = filename;
+    link.href = dataURL;
+    document.body.appendChild(link);
+    link.click();
+    document.body.removeChild(link);
+}
+/**
+ * Export the chart data as a CSV file.
+ *
+ * @param response - The aggregation query response
+ * @param definition - The chart definition (for column headers)
+ * @param filename - The file name for the download (default: 'chart-data.csv')
+ */
+export function exportChartAsCSV(response, definition, filename = 'chart-data.csv') {
+    if (!response.data || response.data.length === 0) {
+        console.warn('Chart export: no data to export');
+        return;
+    }
+    // Determine column order: dimensions first, then measures
+    const dimensionRefs = definition.dataQuery.dimensions.map(d => d.ref);
+    const measureRefs = definition.dataQuery.measures.map(m => m.ref);
+    const computedRefs = (definition.dataQuery.computedMeasures || []).map(cm => cm.ref);
+    const windowRefs = (definition.dataQuery.windowFunctions || []).map(wf => wf.ref);
+    const allRefs = [...dimensionRefs, ...measureRefs, ...computedRefs, ...windowRefs];
+    // Build headers — use labels when available
+    const dimensionLabels = definition.dataQuery.dimensions.map(d => d.label || d.ref);
+    const measureLabels = definition.dataQuery.measures.map(m => m.label || m.ref);
+    const computedLabels = (definition.dataQuery.computedMeasures || []).map(cm => cm.label || cm.ref);
+    const windowLabels = (definition.dataQuery.windowFunctions || []).map(wf => wf.label || wf.ref);
+    const headers = [...dimensionLabels, ...measureLabels, ...computedLabels, ...windowLabels];
+    // Build rows (headers are also escaped to handle labels with commas/quotes/newlines)
+    const rows = [];
+    rows.push(headers.map(h => escapeCSV(h)));
+    for (const row of response.data) {
+        const csvRow = allRefs.map(ref => {
+            const value = row[ref];
+            if (value == null)
+                return '';
+            if (typeof value === 'string')
+                return escapeCSV(value);
+            if (value instanceof Date)
+                return value.toISOString();
+            return String(value);
+        });
+        rows.push(csvRow);
+    }
+    // Build CSV string
+    const csvContent = rows.map(row => row.join(',')).join('\n');
+    const blob = new Blob([csvContent], { type: 'text/csv;charset=utf-8;' });
+    const url = URL.createObjectURL(blob);
+    const link = document.createElement('a');
+    link.download = filename;
+    link.href = url;
+    document.body.appendChild(link);
+    link.click();
+    document.body.removeChild(link);
+    URL.revokeObjectURL(url);
+}
+/**
+ * Escape a value for CSV: wrap in quotes if it contains commas, quotes, or newlines.
+ */
+function escapeCSV(value) {
+    if (value.includes(',') || value.includes('"') || value.includes('\n')) {
+        return `"${value.replace(/"/g, '""')}"`;
+    }
+    return value;
+}
+//# sourceMappingURL=chart-export.utils.js.map

package/dist/esm/components/views/chart-view/chart-export.utils.js.map

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

package/dist/esm/components/views/chart-view/chart-runtime.utils.d.ts

@@ -0,0 +1,35 @@
+import { type ChartDefinition, type ChartInputValues } from '@wildo-ai/saas-models';
+import type { ChartViewDefinition, InsertedChartDeclaration, ResolvedInsertedChartDescriptor } from '../../../core/config/chart-view.frontend.schemas.js';
+export interface ResolvedChartRuntimeDescriptor {
+    chartDefinition: ChartDefinition;
+    executionChartRef: string;
+    contextResourceIdentifiers?: Record<string, string>;
+    resolvedInputs?: ChartInputValues;
+}
+type ChartSurfaceDefinition = ChartViewDefinition | InsertedChartDeclaration;
+export interface ChartRuntimeAppScopeSnapshot {
+    currentUserId?: string | null;
+    currentOrganizationId?: string | null;
+    currentApplicationId?: string | null;
+    currentAnonymousUserId?: string | null;
+    buildContextResourceIdentifiers?: () => Record<string, string>;
+}
+export declare function resolveChartRuntimeDescriptor(params: {
+    surfaceDefinition?: ChartSurfaceDefinition;
+    chartDefinition?: ChartDefinition;
+    runtimeDescriptor?: ResolvedInsertedChartDescriptor;
+    explicitContextResourceIdentifiers?: Record<string, string>;
+    explicitInputs?: ChartInputValues;
+    urlParamValues?: Record<string, string>;
+    appScope?: ChartRuntimeAppScopeSnapshot;
+}): ResolvedChartRuntimeDescriptor | undefined;
+export declare function useResolvedChartRuntimeDescriptor(params: {
+    surfaceDefinition?: ChartSurfaceDefinition;
+    chartDefinition?: ChartDefinition;
+    runtimeDescriptor?: ResolvedInsertedChartDescriptor;
+    explicitContextResourceIdentifiers?: Record<string, string>;
+    explicitInputs?: ChartInputValues;
+    urlParamValues?: Record<string, string>;
+}): ResolvedChartRuntimeDescriptor | undefined;
+export {};
+//# sourceMappingURL=chart-runtime.utils.d.ts.map

package/dist/esm/components/views/chart-view/chart-runtime.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chart-runtime.utils.d.ts","sourceRoot":"","sources":["../../../../../src/components/views/chart-view/chart-runtime.utils.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,eAAe,EAGpB,KAAK,gBAAgB,EACtB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,KAAK,EACV,mBAAmB,EACnB,wBAAwB,EACxB,+BAA+B,EAChC,MAAM,6DAA6D,CAAC;AAMrE,MAAM,WAAW,8BAA8B;IAC7C,eAAe,EAAE,eAAe,CAAC;IACjC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,0BAA0B,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpD,cAAc,CAAC,EAAE,gBAAgB,CAAC;CACnC;AAED,KAAK,sBAAsB,GAAG,mBAAmB,GAAG,wBAAwB,CAAC;AAgI7E,MAAM,WAAW,4BAA4B;IAC3C,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,qBAAqB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,oBAAoB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,sBAAsB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,+BAA+B,CAAC,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChE;AAED,wBAAgB,6BAA6B,CAAC,MAAM,EAAE;IACpD,iBAAiB,CAAC,EAAE,sBAAsB,CAAC;IAC3C,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,iBAAiB,CAAC,EAAE,+BAA+B,CAAC;IACpD,kCAAkC,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5D,cAAc,CAAC,EAAE,gBAAgB,CAAC;IAClC,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,QAAQ,CAAC,EAAE,4BAA4B,CAAC;CACzC,GAAG,8BAA8B,GAAG,SAAS,CAyF7C;AAED,wBAAgB,iCAAiC,CAAC,MAAM,EAAE;IACxD,iBAAiB,CAAC,EAAE,sBAAsB,CAAC;IAC3C,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,iBAAiB,CAAC,EAAE,+BAA+B,CAAC;IACpD,kCAAkC,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5D,cAAc,CAAC,EAAE,gBAAgB,CAAC;IAClC,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACzC,GAAG,8BAA8B,GAAG,SAAS,CAmB7C"}

package/dist/esm/components/views/chart-view/chart-runtime.utils.js

@@ -0,0 +1,188 @@
+import { useMemo } from 'react';
+import { getChartInputValueTypeSchema, } from '@wildo-ai/saas-models';
+import { ScopeUtilsService } from '../../../core/scope/scope.utils.frontend.service.js';
+import { useAppScopeSafe } from '../../../core/scope/useAppScope.js';
+import { InsertedViewInputBindingSource, } from '../../../core/config/inserted-view.frontend.schemas.js';
+function isInsertedChartDeclaration(definition) {
+    return 'chartDefinition' in definition;
+}
+function getSurfaceChartDefinition(definition) {
+    return isInsertedChartDeclaration(definition) ? definition.chartDefinition : definition;
+}
+function validateChartInputValue(inputDefinition, value) {
+    const parsed = getChartInputValueTypeSchema(inputDefinition.valueType).safeParse(value);
+    return parsed.success ? parsed.data : undefined;
+}
+function resolveBindingValue(params) {
+    const { binding, liveAppScopeContext, explicitContextResourceIdentifiers, urlParamValues } = params;
+    switch (binding.source) {
+        case InsertedViewInputBindingSource.APP_SCOPE:
+            return binding.contextKey ? liveAppScopeContext?.[binding.contextKey] : undefined;
+        case InsertedViewInputBindingSource.PARENT_CONTEXT:
+            return binding.contextKey ? explicitContextResourceIdentifiers?.[binding.contextKey] : undefined;
+        case InsertedViewInputBindingSource.URL_PARAM:
+            return binding.contextKey ? urlParamValues?.[binding.contextKey] : undefined;
+        case InsertedViewInputBindingSource.FIXED_VALUE:
+            return binding.value;
+    }
+}
+function resolveChartInputValues(params) {
+    const resolvedInputs = {};
+    const inputDefinitionsByRef = new Map((params.chartDefinition.inputs ?? []).map((inputDefinition) => [inputDefinition.ref, inputDefinition]));
+    for (const inputDefinition of params.chartDefinition.inputs ?? []) {
+        if (inputDefinition.defaultValue !== undefined) {
+            resolvedInputs[inputDefinition.ref] = inputDefinition.defaultValue;
+        }
+    }
+    for (const binding of params.inputBindings ?? []) {
+        const inputDefinition = inputDefinitionsByRef.get(binding.inputRef);
+        if (!inputDefinition) {
+            if (process.env.NODE_ENV !== 'production') {
+                console.warn('[ChartRuntime] Ignoring input binding for unknown chart input.', {
+                    inputRef: binding.inputRef,
+                    availableInputs: Array.from(inputDefinitionsByRef.keys()).sort(),
+                });
+            }
+            continue;
+        }
+        const candidateValue = resolveBindingValue({
+            binding,
+            liveAppScopeContext: params.liveAppScopeContext,
+            explicitContextResourceIdentifiers: params.explicitContextResourceIdentifiers,
+            urlParamValues: params.urlParamValues,
+        });
+        if (candidateValue === undefined) {
+            continue;
+        }
+        const validatedValue = validateChartInputValue(inputDefinition, candidateValue);
+        if (validatedValue === undefined) {
+            if (process.env.NODE_ENV !== 'production') {
+                console.warn('[ChartRuntime] Ignoring chart input binding value that does not match the authored input type.', {
+                    inputRef: inputDefinition.ref,
+                    valueType: inputDefinition.valueType,
+                    candidateValue,
+                    binding,
+                });
+            }
+            continue;
+        }
+        resolvedInputs[inputDefinition.ref] = validatedValue;
+    }
+    for (const [inputRef, candidateValue] of Object.entries(params.explicitInputs ?? {})) {
+        const inputDefinition = inputDefinitionsByRef.get(inputRef);
+        if (!inputDefinition) {
+            if (process.env.NODE_ENV !== 'production') {
+                console.warn('[ChartRuntime] Ignoring explicit chart input that is not declared by the chart definition.', {
+                    inputRef,
+                    availableInputs: Array.from(inputDefinitionsByRef.keys()).sort(),
+                });
+            }
+            continue;
+        }
+        const validatedValue = validateChartInputValue(inputDefinition, candidateValue);
+        if (validatedValue === undefined) {
+            if (process.env.NODE_ENV !== 'production') {
+                console.warn('[ChartRuntime] Ignoring explicit chart input value that does not match the authored input type.', {
+                    inputRef,
+                    valueType: inputDefinition.valueType,
+                    candidateValue,
+                });
+            }
+            continue;
+        }
+        resolvedInputs[inputRef] = validatedValue;
+    }
+    return Object.keys(resolvedInputs).length > 0 ? resolvedInputs : undefined;
+}
+export function resolveChartRuntimeDescriptor(params) {
+    const primaryScopeInitiatorIds = ScopeUtilsService.buildInitiatorIds({
+        userId: params.appScope?.currentUserId,
+        organizationId: params.appScope?.currentOrganizationId,
+        applicationId: params.appScope?.currentApplicationId,
+        anonymousUserId: params.appScope?.currentAnonymousUserId,
+    });
+    const liveAppScopeContext = params.appScope?.buildContextResourceIdentifiers?.() ?? {};
+    const customScopeContext = ScopeUtilsService.filterCustomScopeContextResourceIdentifiers(liveAppScopeContext);
+    if (params.runtimeDescriptor) {
+        const runtimeContextResourceIdentifiers = params.surfaceDefinition
+            ? ScopeUtilsService.resolveViewContextResourceIdentifiers({
+                surfaceName: 'ChartView',
+                surfaceRef: params.runtimeDescriptor.identity.insertedViewRef,
+                primaryScope: params.surfaceDefinition.primaryScope,
+                parentResourcesRequirements: params.surfaceDefinition.parentResourcesRequirements,
+                additionalResourceRequirements: params.surfaceDefinition.additionalResourceRequirements,
+                primaryScopeContext: ScopeUtilsService.primaryScopeToContextIdentifiers(primaryScopeInitiatorIds, params.surfaceDefinition.primaryScope),
+                customScopeContext,
+                explicitContextResourceIdentifiers: params.runtimeDescriptor.contextResourceIdentifiers,
+            })
+            : ScopeUtilsService.mergeContextResourceIdentifiers(customScopeContext, params.runtimeDescriptor.contextResourceIdentifiers);
+        const mergedRuntimeInputs = resolveChartInputValues({
+            chartDefinition: params.runtimeDescriptor.chartDefinition,
+            inputBindings: params.surfaceDefinition?.inputBindings,
+            liveAppScopeContext,
+            explicitContextResourceIdentifiers: runtimeContextResourceIdentifiers,
+            explicitInputs: {
+                ...(params.runtimeDescriptor.resolvedInputs ?? {}),
+                ...(params.explicitInputs ?? {}),
+            },
+            urlParamValues: params.urlParamValues,
+        });
+        return {
+            chartDefinition: params.runtimeDescriptor.chartDefinition,
+            executionChartRef: params.runtimeDescriptor.executionChartRef,
+            contextResourceIdentifiers: runtimeContextResourceIdentifiers,
+            resolvedInputs: mergedRuntimeInputs,
+        };
+    }
+    const surfaceDefinition = params.surfaceDefinition;
+    const chartDefinition = params.chartDefinition
+        ?? (surfaceDefinition ? getSurfaceChartDefinition(surfaceDefinition) : undefined);
+    if (!chartDefinition) {
+        return undefined;
+    }
+    const contextResourceIdentifiers = surfaceDefinition
+        ? ScopeUtilsService.resolveViewContextResourceIdentifiers({
+            surfaceName: 'ChartView',
+            surfaceRef: surfaceDefinition.ref,
+            primaryScope: surfaceDefinition.primaryScope,
+            parentResourcesRequirements: surfaceDefinition.parentResourcesRequirements,
+            additionalResourceRequirements: surfaceDefinition.additionalResourceRequirements,
+            primaryScopeContext: ScopeUtilsService.primaryScopeToContextIdentifiers(primaryScopeInitiatorIds, surfaceDefinition.primaryScope),
+            customScopeContext,
+            explicitContextResourceIdentifiers: params.explicitContextResourceIdentifiers,
+        })
+        : ScopeUtilsService.mergeContextResourceIdentifiers(customScopeContext, params.explicitContextResourceIdentifiers);
+    return {
+        chartDefinition,
+        executionChartRef: chartDefinition.ref,
+        contextResourceIdentifiers,
+        resolvedInputs: resolveChartInputValues({
+            chartDefinition,
+            inputBindings: surfaceDefinition?.inputBindings,
+            liveAppScopeContext,
+            explicitContextResourceIdentifiers: contextResourceIdentifiers,
+            explicitInputs: params.explicitInputs,
+            urlParamValues: params.urlParamValues,
+        }),
+    };
+}
+export function useResolvedChartRuntimeDescriptor(params) {
+    const appScope = useAppScopeSafe();
+    return useMemo(() => resolveChartRuntimeDescriptor({
+        ...params,
+        appScope,
+    }), [
+        params.runtimeDescriptor,
+        params.surfaceDefinition,
+        params.chartDefinition,
+        params.explicitContextResourceIdentifiers,
+        params.explicitInputs,
+        params.urlParamValues,
+        appScope,
+        appScope?.currentUserId,
+        appScope?.currentOrganizationId,
+        appScope?.currentApplicationId,
+        appScope?.currentAnonymousUserId,
+    ]);
+}
+//# sourceMappingURL=chart-runtime.utils.js.map