@vertesia/fusion-ux 1.0.0-dev.20260128.144200

package/LICENSE

@@ -0,0 +1,13 @@
+Copyright 2024 Composable
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

package/README.md

@@ -0,0 +1,160 @@
+# @vertesia/fusion-ux
+
+Dynamic model-generated UI components for Vertesia. Models generate templates (structure), the system provides values (data).
+
+## Installation
+
+```bash
+pnpm add @vertesia/fusion-ux
+```
+
+## Quick Start
+
+### Client-side (React)
+
+```tsx
+import {
+  FusionFragmentRenderer,
+  FusionFragmentProvider,
+  FusionFragmentHandler,
+} from '@vertesia/fusion-ux';
+
+// Option 1: Direct rendering with template and data
+<FusionFragmentRenderer
+  template={{
+    title: "Fund Parameters",
+    sections: [{
+      title: "Identity",
+      layout: "grid-3",
+      fields: [
+        { label: "Firm Name", key: "firmName" },
+        { label: "Vintage", key: "vintageYear", format: "number" }
+      ]
+    }]
+  }}
+  data={{ firmName: "Acme Capital", vintageYear: 2024 }}
+  onUpdate={async (key, value) => {
+    // Handle field updates
+  }}
+/>
+
+// Option 2: Context-based rendering (for markdown code blocks)
+<FusionFragmentProvider data={fund.parameters} onUpdate={handleUpdate}>
+  <MarkdownRenderer content={agentResponse} />
+</FusionFragmentProvider>
+
+// Option 3: Code block handler for markdown renderers
+const codeBlockRenderers = {
+  'fusion-fragment': ({ code }) => <FusionFragmentHandler code={code} />
+};
+```
+
+### Server-side (Tools)
+
+```typescript
+import { fusionUxTools } from '@vertesia/fusion-ux/server';
+
+// Register tools with your server
+server.registerCollection(fusionUxTools);
+```
+
+## Template Structure
+
+```typescript
+interface FragmentTemplate {
+  title?: string;
+  entityType?: 'fund' | 'scenario' | 'portfolio' | 'transaction' | 'custom';
+  sections: SectionTemplate[];
+  footer?: string;
+}
+
+interface SectionTemplate {
+  title: string;
+  layout?: 'grid-2' | 'grid-3' | 'grid-4' | 'list';
+  collapsed?: boolean;
+  fields: FieldTemplate[];
+}
+
+interface FieldTemplate {
+  label: string;           // Display label
+  key: string;             // Data key (required)
+  format?: 'text' | 'number' | 'currency' | 'percent' | 'date' | 'boolean';
+  unit?: string;           // e.g., "years", "USD"
+  editable?: boolean;
+  highlight?: 'success' | 'warning' | 'error' | 'info';
+  tooltip?: string;
+  decimals?: number;       // For number/currency/percent
+  currency?: string;       // For currency format
+}
+```
+
+## Validation Tool
+
+The `validate_fusion_fragment` tool allows models to validate templates:
+
+```json
+{
+  "template": {
+    "sections": [{
+      "title": "Identity",
+      "fields": [{ "label": "Firm", "key": "firmName" }]
+    }]
+  },
+  "dataKeys": ["firmName", "fundName", "vintageYear"],
+  "preview": "text"
+}
+```
+
+Returns errors with suggestions or a text preview of the template.
+
+## API
+
+### Components
+
+- `FusionFragmentRenderer` - Main renderer component
+- `FusionFragmentProvider` - Context provider for data
+- `FusionFragmentHandler` - Code block handler
+- `SectionRenderer` - Section renderer
+- `FieldRenderer` - Field renderer
+
+### Validation
+
+- `validateTemplate(template, dataKeys)` - Validate a template
+- `parseAndValidateTemplate(jsonString, dataKeys)` - Parse and validate
+- `findClosestKey(input, validKeys)` - Fuzzy key matching
+- `formatValidationErrors(errors)` - Format errors for models
+
+### Server
+
+- `fusionUxTools` - Tool collection for registration
+- `ValidateFusionFragmentTool` - The validation tool
+
+### Serverless Rendering
+
+Render templates to PNG without a browser using `@napi-rs/canvas`:
+
+```typescript
+import { renderToBuffer, renderToBase64, renderToDataUrl } from '@vertesia/fusion-ux/server';
+
+// Render to PNG buffer
+const buffer = renderToBuffer(template, data);
+fs.writeFileSync('preview.png', buffer);
+
+// Render to base64 string
+const base64 = renderToBase64(template, data);
+
+// Render to data URL
+const dataUrl = renderToDataUrl(template, data);
+// Returns: "data:image/png;base64,..."
+
+// With custom options
+const buffer = renderToBuffer(template, data, {
+  width: 800,      // Canvas width (default: 600)
+  padding: 24,     // Padding around content (default: 20)
+  fieldHeight: 60, // Height per field row (default: 50)
+});
+```
+
+## License
+
+Apache-2.0

package/lib/esm/fusion-fragment/ChartRenderer.js

@@ -0,0 +1,70 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useFusionFragmentContextSafe } from './FusionFragmentContext.js';
+/**
+ * Renders a Vega-Lite chart from a chart template.
+ * If dataKey is provided, it merges data from context into the spec.
+ * Uses the ChartComponent from FusionFragmentContext if available.
+ */
+export function ChartRenderer({ chart, data, className }) {
+    const context = useFusionFragmentContextSafe();
+    const ChartComponent = context?.ChartComponent;
+    const artifactRunId = context?.artifactRunId;
+    // Debug logging
+    console.log('[ChartRenderer] Context:', {
+        hasContext: !!context,
+        hasChartComponent: !!ChartComponent,
+        artifactRunId,
+        chartTitle: chart.title,
+        dataKey: chart.dataKey,
+    });
+    // Resolve data from context if dataKey is provided
+    const resolvedSpec = { ...chart.spec };
+    if (chart.dataKey && data[chart.dataKey]) {
+        const chartData = data[chart.dataKey];
+        if (Array.isArray(chartData)) {
+            // Inject data into spec
+            resolvedSpec.data = { values: chartData };
+        }
+    }
+    // Build the VegaLiteChartSpec format expected by @vertesia/ui
+    const vegaSpec = {
+        library: 'vega-lite',
+        title: chart.title,
+        description: chart.description,
+        spec: resolvedSpec,
+        options: {
+            height: chart.height,
+        }
+    };
+    // If a ChartComponent is provided via context, use it to render the actual chart
+    if (ChartComponent) {
+        return (_jsx("div", { className: className, children: _jsx(ChartComponent, { spec: vegaSpec, artifactRunId: artifactRunId }) }));
+    }
+    // Fallback: render a placeholder with spec info when no ChartComponent is injected
+    return (_jsxs("div", { className: className, style: {
+            padding: '16px',
+            backgroundColor: 'var(--gray-2, #f9fafb)',
+            border: '1px solid var(--gray-5, #e5e7eb)',
+            borderRadius: '8px',
+            minHeight: chart.height || 280
+        }, children: [chart.title && (_jsx("div", { style: {
+                    fontSize: '14px',
+                    fontWeight: 600,
+                    marginBottom: '8px',
+                    color: 'var(--gray-12, #111827)'
+                }, children: chart.title })), chart.description && (_jsx("div", { style: {
+                    fontSize: '12px',
+                    color: 'var(--gray-11, #6b7280)',
+                    marginBottom: '12px'
+                }, children: chart.description })), _jsx("div", { style: {
+                    display: 'flex',
+                    alignItems: 'center',
+                    justifyContent: 'center',
+                    height: (chart.height || 280) - 60,
+                    backgroundColor: 'var(--gray-3, #f3f4f6)',
+                    borderRadius: '4px',
+                    color: 'var(--gray-11, #6b7280)',
+                    fontSize: '12px'
+                }, "data-vega-spec": JSON.stringify(vegaSpec), children: _jsxs("div", { style: { textAlign: 'center' }, children: [_jsxs("div", { style: { marginBottom: '4px' }, children: ["Chart: ", resolvedSpec.mark ? String(typeof resolvedSpec.mark === 'string' ? resolvedSpec.mark : resolvedSpec.mark.type) : 'composite'] }), resolvedSpec.data?.values && (_jsxs("div", { style: { fontSize: '11px', opacity: 0.8 }, children: [resolvedSpec.data.values.length, " data points"] }))] }) })] }));
+}
+//# sourceMappingURL=ChartRenderer.js.map

package/lib/esm/fusion-fragment/ChartRenderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChartRenderer.js","sourceRoot":"","sources":["../../../src/fusion-fragment/ChartRenderer.tsx"],"names":[],"mappings":"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"}

package/lib/esm/fusion-fragment/FieldRenderer.js

@@ -0,0 +1,153 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * FieldRenderer component
+ * Renders a single field with formatting and optional edit capability
+ */
+import { useMemo, useState, useCallback } from 'react';
+// Styles as constants
+const styles = {
+    container: {
+        display: 'flex',
+        flexDirection: 'column',
+        gap: '2px',
+        minWidth: 0, // Allow text truncation
+    },
+    label: {
+        fontSize: '11px',
+        fontWeight: 500,
+        color: 'var(--gray-11, #6b7280)',
+        textTransform: 'uppercase',
+        letterSpacing: '0.5px',
+    },
+    value: {
+        fontSize: '14px',
+        fontWeight: 500,
+        color: 'var(--gray-12, #1f2937)',
+        fontFamily: 'var(--font-mono, ui-monospace, monospace)',
+        fontVariantNumeric: 'tabular-nums',
+        letterSpacing: '-0.02em',
+    },
+    unit: {
+        fontSize: '12px',
+        color: 'var(--gray-10, #9ca3af)',
+        marginLeft: '4px',
+    },
+    highlight: {
+        success: { color: 'var(--green-11, #15803d)' },
+        warning: { color: 'var(--yellow-11, #ca8a04)' },
+        error: { color: 'var(--red-11, #dc2626)' },
+        info: { color: 'var(--blue-11, #2563eb)' },
+    },
+    editable: {
+        cursor: 'pointer',
+        padding: '2px 4px',
+        borderRadius: '4px',
+        transition: 'background-color 0.15s',
+    },
+    tooltip: {
+        position: 'relative',
+    },
+    nullValue: {
+        color: 'var(--gray-9, #9ca3af)',
+        fontStyle: 'italic',
+    },
+};
+/**
+ * Format a value according to the field's format specification
+ */
+function formatValue(value, field) {
+    if (value === null || value === undefined) {
+        return '\u2014'; // em-dash for null/undefined
+    }
+    switch (field.format) {
+        case 'number': {
+            const num = typeof value === 'number' ? value : parseFloat(String(value));
+            if (isNaN(num))
+                return String(value);
+            const options = {
+                minimumFractionDigits: field.decimals ?? 0,
+                maximumFractionDigits: field.decimals ?? 2,
+            };
+            return new Intl.NumberFormat('en-US', options).format(num);
+        }
+        case 'currency': {
+            const num = typeof value === 'number' ? value : parseFloat(String(value));
+            if (isNaN(num))
+                return String(value);
+            const options = {
+                style: 'currency',
+                currency: field.currency || 'USD',
+                minimumFractionDigits: field.decimals ?? 0,
+                maximumFractionDigits: field.decimals ?? 0,
+            };
+            return new Intl.NumberFormat('en-US', options).format(num);
+        }
+        case 'percent': {
+            const num = typeof value === 'number' ? value : parseFloat(String(value));
+            if (isNaN(num))
+                return String(value);
+            // Assume value is already a percentage (e.g., 25 for 25%)
+            // If it's a decimal (e.g., 0.25), multiply by 100
+            const pct = num < 1 && num > -1 && num !== 0 ? num * 100 : num;
+            const decimals = field.decimals ?? 1;
+            return `${pct.toFixed(decimals)}%`;
+        }
+        case 'date': {
+            if (!value)
+                return '\u2014';
+            const date = value instanceof Date ? value : new Date(String(value));
+            if (isNaN(date.getTime()))
+                return String(value);
+            return new Intl.DateTimeFormat('en-US', {
+                year: 'numeric',
+                month: 'short',
+                day: 'numeric',
+            }).format(date);
+        }
+        case 'boolean': {
+            const bool = typeof value === 'boolean' ? value : value === 'true' || value === '1';
+            return bool ? 'Yes' : 'No';
+        }
+        case 'text':
+        default:
+            return String(value);
+    }
+}
+/**
+ * FieldRenderer component
+ * Displays a field with label, formatted value, and optional highlighting
+ */
+export function FieldRenderer({ field, value, onUpdate, agentMode, }) {
+    const [isHovered, setIsHovered] = useState(false);
+    const formattedValue = useMemo(() => formatValue(value, field), [value, field]);
+    const isNull = value === null || value === undefined;
+    const isEditable = field.editable && (onUpdate || agentMode);
+    const handleClick = useCallback(() => {
+        if (!isEditable)
+            return;
+        if (agentMode?.enabled && agentMode.sendMessage) {
+            // Send message to agent for editing
+            agentMode.sendMessage(`Please help me update the "${field.label}" field (key: ${field.key}). Current value: ${formattedValue}`);
+        }
+        // Direct edit mode would go here (Phase 2)
+    }, [isEditable, agentMode, field, formattedValue]);
+    const valueStyle = useMemo(() => {
+        const base = { ...styles.value };
+        if (isNull) {
+            return { ...base, ...styles.nullValue };
+        }
+        if (field.highlight) {
+            return { ...base, ...styles.highlight[field.highlight] };
+        }
+        if (isEditable) {
+            return {
+                ...base,
+                ...styles.editable,
+                backgroundColor: isHovered ? 'var(--gray-3, #f3f4f6)' : 'transparent',
+            };
+        }
+        return base;
+    }, [isNull, field.highlight, isEditable, isHovered]);
+    return (_jsxs("div", { style: styles.container, title: field.tooltip, onMouseEnter: () => setIsHovered(true), onMouseLeave: () => setIsHovered(false), onClick: handleClick, role: isEditable ? 'button' : undefined, tabIndex: isEditable ? 0 : undefined, children: [_jsx("span", { style: styles.label, children: field.label }), _jsxs("span", { style: valueStyle, children: [formattedValue, field.unit && !isNull && (_jsx("span", { style: styles.unit, children: field.unit }))] })] }));
+}
+//# sourceMappingURL=FieldRenderer.js.map

package/lib/esm/fusion-fragment/FieldRenderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FieldRenderer.js","sourceRoot":"","sources":["../../../src/fusion-fragment/FieldRenderer.tsx"],"names":[],"mappings":";AAAA;;;GAGG;AAEH,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAqB,MAAM,OAAO,CAAC;AAG1E,sBAAsB;AACtB,MAAM,MAAM,GAAG;IACb,SAAS,EAAE;QACT,OAAO,EAAE,MAAM;QACf,aAAa,EAAE,QAAiB;QAChC,GAAG,EAAE,KAAK;QACV,QAAQ,EAAE,CAAC,EAAE,wBAAwB;KACtC;IACD,KAAK,EAAE;QACL,QAAQ,EAAE,MAAM;QAChB,UAAU,EAAE,GAAG;QACf,KAAK,EAAE,yBAAyB;QAChC,aAAa,EAAE,WAAoB;QACnC,aAAa,EAAE,OAAO;KACvB;IACD,KAAK,EAAE;QACL,QAAQ,EAAE,MAAM;QAChB,UAAU,EAAE,GAAG;QACf,KAAK,EAAE,yBAAyB;QAChC,UAAU,EAAE,2CAA2C;QACvD,kBAAkB,EAAE,cAAuB;QAC3C,aAAa,EAAE,SAAS;KACzB;IACD,IAAI,EAAE;QACJ,QAAQ,EAAE,MAAM;QAChB,KAAK,EAAE,yBAAyB;QAChC,UAAU,EAAE,KAAK;KAClB;IACD,SAAS,EAAE;QACT,OAAO,EAAE,EAAE,KAAK,EAAE,0BAA0B,EAAE;QAC9C,OAAO,EAAE,EAAE,KAAK,EAAE,2BAA2B,EAAE;QAC/C,KAAK,EAAE,EAAE,KAAK,EAAE,wBAAwB,EAAE;QAC1C,IAAI,EAAE,EAAE,KAAK,EAAE,yBAAyB,EAAE;KAC3C;IACD,QAAQ,EAAE;QACR,MAAM,EAAE,SAAS;QACjB,OAAO,EAAE,SAAS;QAClB,YAAY,EAAE,KAAK;QACnB,UAAU,EAAE,wBAAwB;KACrC;IACD,OAAO,EAAE;QACP,QAAQ,EAAE,UAAmB;KAC9B;IACD,SAAS,EAAE;QACT,KAAK,EAAE,wBAAwB;QAC/B,SAAS,EAAE,QAAiB;KAC7B;CACF,CAAC;AAEF;;GAEG;AACH,SAAS,WAAW,CAAC,KAAc,EAAE,KAAoB;IACvD,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QAC1C,OAAO,QAAQ,CAAC,CAAC,6BAA6B;IAChD,CAAC;IAED,QAAQ,KAAK,CAAC,MAAM,EAAE,CAAC;QACrB,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,MAAM,GAAG,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YAC1E,IAAI,KAAK,CAAC,GAAG,CAAC;gBAAE,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;YAErC,MAAM,OAAO,GAA6B;gBACxC,qBAAqB,EAAE,KAAK,CAAC,QAAQ,IAAI,CAAC;gBAC1C,qBAAqB,EAAE,KAAK,CAAC,QAAQ,IAAI,CAAC;aAC3C,CAAC;YACF,OAAO,IAAI,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC7D,CAAC;QAED,KAAK,UAAU,CAAC,CAAC,CAAC;YAChB,MAAM,GAAG,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YAC1E,IAAI,KAAK,CAAC,GAAG,CAAC;gBAAE,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;YAErC,MAAM,OAAO,GAA6B;gBACxC,KAAK,EAAE,UAAU;gBACjB,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,KAAK;gBACjC,qBAAqB,EAAE,KAAK,CAAC,QAAQ,IAAI,CAAC;gBAC1C,qBAAqB,EAAE,KAAK,CAAC,QAAQ,IAAI,CAAC;aAC3C,CAAC;YACF,OAAO,IAAI,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC7D,CAAC;QAED,KAAK,SAAS,CAAC,CAAC,CAAC;YACf,MAAM,GAAG,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YAC1E,IAAI,KAAK,CAAC,GAAG,CAAC;gBAAE,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;YAErC,0DAA0D;YAC1D,kDAAkD;YAClD,MAAM,GAAG,GAAG,GAAG,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;YAC/D,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,IAAI,CAAC,CAAC;YACrC,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC;QACrC,CAAC;QAED,KAAK,MAAM,CAAC,CAAC,CAAC;YACZ,IAAI,CAAC,KAAK;gBAAE,OAAO,QAAQ,CAAC;YAE5B,MAAM,IAAI,GAAG,KAAK,YAAY,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YACrE,IAAI,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;gBAAE,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;YAEhD,OAAO,IAAI,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE;gBACtC,IAAI,EAAE,SAAS;gBACf,KAAK,EAAE,OAAO;gBACd,GAAG,EAAE,SAAS;aACf,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAClB,CAAC;QAED,KAAK,SAAS,CAAC,CAAC,CAAC;YACf,MAAM,IAAI,GAAG,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,KAAK,MAAM,IAAI,KAAK,KAAK,GAAG,CAAC;YACpF,OAAO,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;QAC7B,CAAC;QAED,KAAK,MAAM,CAAC;QACZ;YACE,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IACzB,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,EAC5B,KAAK,EACL,KAAK,EACL,QAAQ,EACR,SAAS,GACU;IACnB,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAElD,MAAM,cAAc,GAAG,OAAO,CAC5B,GAAG,EAAE,CAAC,WAAW,CAAC,KAAK,EAAE,KAAK,CAAC,EAC/B,CAAC,KAAK,EAAE,KAAK,CAAC,CACf,CAAC;IAEF,MAAM,MAAM,GAAG,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,CAAC;IACrD,MAAM,UAAU,GAAG,KAAK,CAAC,QAAQ,IAAI,CAAC,QAAQ,IAAI,SAAS,CAAC,CAAC;IAE7D,MAAM,WAAW,GAAG,WAAW,CAAC,GAAG,EAAE;QACnC,IAAI,CAAC,UAAU;YAAE,OAAO;QAExB,IAAI,SAAS,EAAE,OAAO,IAAI,SAAS,CAAC,WAAW,EAAE,CAAC;YAChD,oCAAoC;YACpC,SAAS,CAAC,WAAW,CACnB,8BAA8B,KAAK,CAAC,KAAK,iBAAiB,KAAK,CAAC,GAAG,qBAAqB,cAAc,EAAE,CACzG,CAAC;QACJ,CAAC;QACD,2CAA2C;IAC7C,CAAC,EAAE,CAAC,UAAU,EAAE,SAAS,EAAE,KAAK,EAAE,cAAc,CAAC,CAAC,CAAC;IAEnD,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,EAAE;QAC9B,MAAM,IAAI,GAAG,EAAE,GAAG,MAAM,CAAC,KAAK,EAAE,CAAC;QAEjC,IAAI,MAAM,EAAE,CAAC;YACX,OAAO,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC,SAAS,EAAE,CAAC;QAC1C,CAAC;QAED,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;YACpB,OAAO,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC;QAC3D,CAAC;QAED,IAAI,UAAU,EAAE,CAAC;YACf,OAAO;gBACL,GAAG,IAAI;gBACP,GAAG,MAAM,CAAC,QAAQ;gBAClB,eAAe,EAAE,SAAS,CAAC,CAAC,CAAC,wBAAwB,CAAC,CAAC,CAAC,aAAa;aACtE,CAAC;QACJ,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC,EAAE,CAAC,MAAM,EAAE,KAAK,CAAC,SAAS,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC,CAAC;IAErD,OAAO,CACL,eACE,KAAK,EAAE,MAAM,CAAC,SAAS,EACvB,KAAK,EAAE,KAAK,CAAC,OAAO,EACpB,YAAY,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,EACtC,YAAY,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC,EACvC,OAAO,EAAE,WAAW,EACpB,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,EACvC,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,aAEpC,eAAM,KAAK,EAAE,MAAM,CAAC,KAAK,YAAG,KAAK,CAAC,KAAK,GAAQ,EAC/C,gBAAM,KAAK,EAAE,UAAU,aACpB,cAAc,EACd,KAAK,CAAC,IAAI,IAAI,CAAC,MAAM,IAAI,CACxB,eAAM,KAAK,EAAE,MAAM,CAAC,IAAI,YAAG,KAAK,CAAC,IAAI,GAAQ,CAC9C,IACI,IACH,CACP,CAAC;AACJ,CAAC"}

package/lib/esm/fusion-fragment/FusionFragmentContext.js

@@ -0,0 +1,53 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * Context provider for FusionFragment components
+ * Provides data and update handlers to nested components
+ */
+import { createContext, useContext, useMemo } from 'react';
+const FusionFragmentContext = createContext(null);
+/**
+ * Provider component that supplies data and update handlers
+ * to FusionFragment components via context
+ *
+ * @example
+ * ```tsx
+ * <FusionFragmentProvider
+ *   data={fund.parameters}
+ *   onUpdate={async (key, value) => {
+ *     await api.funds.updateParameters(fundId, { [key]: value });
+ *   }}
+ * >
+ *   <MarkdownRenderer content={agentResponse} />
+ * </FusionFragmentProvider>
+ * ```
+ */
+export function FusionFragmentProvider({ data, onUpdate, sendMessage, ChartComponent, artifactRunId, children }) {
+    const value = useMemo(() => ({ data, onUpdate, sendMessage, ChartComponent, artifactRunId }), [data, onUpdate, sendMessage, ChartComponent, artifactRunId]);
+    // Debug logging
+    console.log('[FusionFragmentProvider] Created with:', {
+        hasData: !!data,
+        dataKeys: data ? Object.keys(data) : [],
+        hasChartComponent: !!ChartComponent,
+        artifactRunId,
+    });
+    return (_jsx(FusionFragmentContext.Provider, { value: value, children: children }));
+}
+/**
+ * Hook to access FusionFragment context
+ * @throws Error if used outside of FusionFragmentProvider
+ */
+export function useFusionFragmentContext() {
+    const context = useContext(FusionFragmentContext);
+    if (!context) {
+        throw new Error('useFusionFragmentContext must be used within a FusionFragmentProvider');
+    }
+    return context;
+}
+/**
+ * Hook to safely access FusionFragment context
+ * Returns null if not within a provider (useful for optional context)
+ */
+export function useFusionFragmentContextSafe() {
+    return useContext(FusionFragmentContext);
+}
+//# sourceMappingURL=FusionFragmentContext.js.map

package/lib/esm/fusion-fragment/FusionFragmentContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FusionFragmentContext.js","sourceRoot":"","sources":["../../../src/fusion-fragment/FusionFragmentContext.tsx"],"names":[],"mappings":";AAAA;;;GAGG;AAEH,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,OAAO,EAAqC,MAAM,OAAO,CAAC;AAG9F,MAAM,qBAAqB,GAAG,aAAa,CAAoC,IAAI,CAAC,CAAC;AAiBrF;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,sBAAsB,CAAC,EACrC,IAAI,EACJ,QAAQ,EACR,WAAW,EACX,cAAc,EACd,aAAa,EACb,QAAQ,EACoB;IAC5B,MAAM,KAAK,GAAG,OAAO,CACnB,GAAG,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,cAAc,EAAE,aAAa,EAAE,CAAC,EACtE,CAAC,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,cAAc,EAAE,aAAa,CAAC,CAC7D,CAAC;IAEF,gBAAgB;IAChB,OAAO,CAAC,GAAG,CAAC,wCAAwC,EAAE;QACpD,OAAO,EAAE,CAAC,CAAC,IAAI;QACf,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE;QACvC,iBAAiB,EAAE,CAAC,CAAC,cAAc;QACnC,aAAa;KACd,CAAC,CAAC;IAEH,OAAO,CACL,KAAC,qBAAqB,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,YACzC,QAAQ,GACsB,CAClC,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,wBAAwB;IACtC,MAAM,OAAO,GAAG,UAAU,CAAC,qBAAqB,CAAC,CAAC;IAElD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,uEAAuE,CACxE,CAAC;IACJ,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,4BAA4B;IAC1C,OAAO,UAAU,CAAC,qBAAqB,CAAC,CAAC;AAC3C,CAAC"}