@apteva/apteva-kit 0.1.24 → 0.1.26

package/dist/index.mjs

@@ -594,14 +594,16 @@ function parseWidgetsFromText(text) {
     }
     try {
       const trimmedJson = jsonContent.trim();
-      const props = JSON.parse(trimmedJson);
+      const parsed = JSON.parse(trimmedJson);
       const widgetId = `widget-${widgetType}-${simpleHash(trimmedJson)}`;
+      const { meta, ...props } = parsed;
       segments.push({
         type: "widget",
         widget: {
           type: widgetType,
           id: widgetId,
-          props
+          props,
+          ...meta && { meta }
         }
       });
       hasWidgets = true;
@@ -709,6 +711,18 @@ function generateWidgetContext(enabledWidgets) {
 
 `;
   }
+  context += `### Meta field for extended data:
+
+`;
+  context += `Any widget can include a "meta" field with extended data that isn't displayed but is captured by the UI:
+`;
+  context += `- The widget displays from regular props (compact view)
+`;
+  context += `- The "meta" field contains full/detailed data for external UI components
+`;
+  context += `- Example: \`@ui:list[{"items": [{"id": "1", "title": "Task"}], "meta": {"items": [{"id": "1", "title": "Task", "description": "Full details...", "assignees": ["Alice"]}], "totalCount": 50}}]\`
+
+`;
   context += `### Important notes:
 `;
   context += `- JSON must be valid (use double quotes for strings)
@@ -718,6 +732,8 @@ function generateWidgetContext(enabledWidgets) {
   context += `- You can include multiple widgets in a single response
 `;
   context += `- Combine widgets with regular text for context
+`;
+  context += `- Use "meta" field when the UI needs more data than what's displayed
 `;
   return context;
 }
@@ -727,6 +743,8 @@ function generateCompactWidgetContext(enabledWidgets) {
 UI Widgets: Use @ui:type[{props}] syntax.
 `;
   context += `Available: ${widgets.join(", ")}
+`;
+  context += `Add "meta" field for extended data not shown in widget but captured by UI.
 `;
   context += `Examples:
 `;