@apteva/apteva-kit 0.1.80 → 0.1.82

package/dist/index.d.mts

@@ -22,7 +22,7 @@ interface Widget {
     props: Record<string, any>;
     actions?: Action[];
     /** Additional data not displayed but captured via onWidgetRender */
-    meta?: Record<string, any>;
+    metadata?: Record<string, any>;
     /** Whether the widget is still receiving streaming data */
     isStreaming?: boolean;
 }
@@ -192,8 +192,8 @@ declare const WIDGET_DEFINITIONS: {
         readonly example: "@ui:card[{\"title\": \"Summary\", \"description\": \"Details here\"}]";
     };
     readonly list: {
-        readonly schema: "items: [{id, title, subtitle?, description?}], actions?: [{type, label}]";
-        readonly example: "@ui:list[{\"items\": [{\"id\": \"1\", \"title\": \"Item\", \"subtitle\": \"Info\"}]}]";
+        readonly schema: "items: [{id, title, subtitle?, description?, image?, metadata?: {any extra data}}], actions?: [{type, label}] - metadata is sent as action payload when clicked";
+        readonly example: "@ui:list[{\"items\": [{\"id\": \"1\", \"title\": \"Item\", \"subtitle\": \"Info\", \"metadata\": {\"key\": \"value\"}}]}]";
     };
     readonly button_group: {
         readonly schema: "buttons: [{id, label, variant?}] - Use for standalone buttons only, NOT for form submits";

package/dist/index.d.ts

@@ -22,7 +22,7 @@ interface Widget {
     props: Record<string, any>;
     actions?: Action[];
     /** Additional data not displayed but captured via onWidgetRender */
-    meta?: Record<string, any>;
+    metadata?: Record<string, any>;
     /** Whether the widget is still receiving streaming data */
     isStreaming?: boolean;
 }
@@ -192,8 +192,8 @@ declare const WIDGET_DEFINITIONS: {
         readonly example: "@ui:card[{\"title\": \"Summary\", \"description\": \"Details here\"}]";
     };
     readonly list: {
-        readonly schema: "items: [{id, title, subtitle?, description?}], actions?: [{type, label}]";
-        readonly example: "@ui:list[{\"items\": [{\"id\": \"1\", \"title\": \"Item\", \"subtitle\": \"Info\"}]}]";
+        readonly schema: "items: [{id, title, subtitle?, description?, image?, metadata?: {any extra data}}], actions?: [{type, label}] - metadata is sent as action payload when clicked";
+        readonly example: "@ui:list[{\"items\": [{\"id\": \"1\", \"title\": \"Item\", \"subtitle\": \"Info\", \"metadata\": {\"key\": \"value\"}}]}]";
     };
     readonly button_group: {
         readonly schema: "buttons: [{id, label, variant?}] - Use for standalone buttons only, NOT for form submits";

package/dist/index.js

@@ -691,7 +691,7 @@ function parseWidgetsFromText(text) {
       const trimmedJson = jsonContent.trim();
       const parsed = JSON.parse(trimmedJson);
       const widgetId = `widget-${widgetType}-${simpleHash(trimmedJson)}`;
-      const { meta, actions, ...props } = parsed;
+      const { metadata, actions, ...props } = parsed;
       segments.push({
         type: "widget",
         widget: {
@@ -699,7 +699,7 @@ function parseWidgetsFromText(text) {
           id: widgetId,
           props,
           ...actions && { actions },
-          ...meta && { meta }
+          ...metadata && { metadata }
         }
       });
       hasWidgets = true;
@@ -739,8 +739,8 @@ var WIDGET_DEFINITIONS = {
     example: '@ui:card[{"title": "Summary", "description": "Details here"}]'
   },
   list: {
-    schema: "items: [{id, title, subtitle?, description?}], actions?: [{type, label}]",
-    example: '@ui:list[{"items": [{"id": "1", "title": "Item", "subtitle": "Info"}]}]'
+    schema: "items: [{id, title, subtitle?, description?, image?, metadata?: {any extra data}}], actions?: [{type, label}] - metadata is sent as action payload when clicked",
+    example: '@ui:list[{"items": [{"id": "1", "title": "Item", "subtitle": "Info", "metadata": {"key": "value"}}]}]'
   },
   button_group: {
     schema: "buttons: [{id, label, variant?}] - Use for standalone buttons only, NOT for form submits",
@@ -772,8 +772,6 @@ SYNTAX: @ui:type[{json}] - MUST use SQUARE BRACKETS [] around the JSON object.
 CORRECT: @ui:list[{"items": [...]}]
 WRONG: @ui:list{"items": [...]} (missing square brackets)
 
-"meta" field (at root level, NOT inside items) holds extended data captured by UI.
-
 `;
   for (const type of widgets) {
     const def = WIDGET_DEFINITIONS[type];
@@ -782,14 +780,14 @@ WRONG: @ui:list{"items": [...]} (missing square brackets)
 `;
   }
   context += `
-Meta example: @ui:list[{"items": [{"id": "1", "title": "X"}], "meta": {"items": [{"id": "1", "title": "X", "extra": "..."}]}}]
+Per-item "metadata" is sent as payload on action click.
 `;
   return context;
 }
 function generateCompactWidgetContext(enabledWidgets) {
   const widgets = enabledWidgets || ALL_WIDGET_TYPES;
   return `
-Widgets: @ui:type[{json}] - MUST use square brackets []. Example: @ui:list[{"items": [...]}]. Types: ${widgets.join(", ")}. Add "meta" at root for extended data.
+Widgets: @ui:type[{json}] - MUST use square brackets []. Example: @ui:list[{"items": [...]}]. Types: ${widgets.join(", ")}. Per-item "metadata" is sent as action payload.
 `;
 }