@retailcrm/embed-ui-v1-contexts 0.9.23-alpha.3 → 0.9.24

package/dist/meta.json

@@ -1570,9 +1570,9 @@
           "name": "image.workers",
           "type": "Array<string>",
           "description": {
-            "en-GB": "A list of servers that process images.",
-            "es-ES": "Una lista de servidores que procesan imágenes.",
-            "ru-RU": "Список серверов, обрабатывающих изображения."
+            "en-GB": "List of image preview worker hosts used to build resized or cropped image URLs.",
+            "es-ES": "Lista de hosts de workers de previsualización de imágenes usados para crear URLs de imágenes redimensionadas o recortadas.",
+            "ru-RU": "Список host-ов image preview workers для построения URL уменьшенных или обрезанных изображений."
           },
           "readonly": true
         },

package/docs/contexts/customer-card-phone.yml

@@ -1,5 +1,5 @@
 "context": "customer/card:phone"
-"summary": "Context profile for customer/card:phone."
+"summary": "Readonly context for a single customer phone row target with phone value and row index."
 "language": "en-GB"
 "audience": "ai"
 "public_import":
@@ -11,6 +11,7 @@
     "type": "string"
     "readonly": true
     "description": "Customer phone"
+    "source_of_truth": "Phone number value for the phone row where the widget is mounted."
     "mutation":
       "mode": "readonly"
       "notes": "Readonly context field; use it for reading and UI calculations."
@@ -21,6 +22,7 @@
     "type": "number"
     "readonly": true
     "description": "Serial number of the phone in the list"
+    "source_of_truth": "Zero-based position of the phone row inside the customer phone list."
     "mutation":
       "mode": "readonly"
       "notes": "Readonly context field; use it for reading and UI calculations."

package/docs/contexts/customer-card.yml

@@ -1,5 +1,5 @@
 "context": "customer/card"
-"summary": "Context profile for customer/card."
+"summary": "Readonly customer card context with customer identifiers, primary email, and phone list."
 "language": "en-GB"
 "audience": "ai"
 "public_import":
@@ -11,6 +11,7 @@
     "type": "number|null"
     "readonly": true
     "description": "Customer ID"
+    "source_of_truth": "CRM customer identifier for the opened customer card."
     "mutation":
       "mode": "readonly"
       "notes": "Readonly context field; use it for reading and UI calculations."
@@ -21,6 +22,7 @@
     "type": "string"
     "readonly": true
     "description": "Customer external ID"
+    "source_of_truth": "External customer identifier from the source system."
     "mutation":
       "mode": "readonly"
       "notes": "Readonly context field; use it for reading and UI calculations."
@@ -35,7 +37,8 @@
       "mode": "readonly"
       "notes": "Readonly context field; use it for reading and UI calculations."
     "related_actions": []
-    "ai_notes": []
+    "ai_notes":
+      - "Use as the current customer email shown on the customer card; it is not a writable order-form field."
   -
     "name": "phones"
     "type": "Array<string>"
@@ -45,7 +48,8 @@
       "mode": "readonly"
       "notes": "Readonly context field; use it for reading and UI calculations."
     "related_actions": []
-    "ai_notes": []
+    "ai_notes":
+      - "Use for customer-card phone display and selection logic. For a widget attached to one phone row, prefer the customer/card:phone context."
 "field_groups": []
 "types": []
 "usage":

package/docs/contexts/settings.yml

@@ -1,5 +1,5 @@
 "context": "settings"
-"summary": "Readonly CRM settings context with locale, routing data and image processing workers."
+"summary": "Readonly CRM settings context with UI locale, Symfony router data, and image preview worker hosts."
 "language": "en-GB"
 "audience": "ai"
 "public_import":
@@ -10,18 +10,22 @@
     "name": "image.workers"
     "type": "Array<string>"
     "readonly": true
-    "description": "A list of servers that process images."
+    "description": "List of image preview worker hosts used to build resized or cropped image URLs."
+    "source_of_truth": "List of image preview worker hosts used to build resized or cropped image URLs."
     "mutation":
       "mode": "readonly"
       "notes": "Readonly context field; use it for reading and UI calculations."
     "related_actions": []
     "ai_notes":
-      - "Use these worker endpoints for image processing flows."
+      - "Pass these workers to usePreview or @retailcrm/image-preview preview()."
+      - "If the list is empty, preview helpers return the original image URL."
+      - "Workers are used for image preview resizing and cropping, not for uploading or storing images."
   -
     "name": "system.locale"
     "type": "\"en-GB\"|\"es-ES\"|\"ru-RU\""
     "readonly": true
     "description": "Current system's locale"
+    "source_of_truth": "Current CRM UI locale for the opened account session."
     "mutation":
       "mode": "readonly"
       "notes": "Readonly context field; use it for reading and UI calculations."
@@ -33,12 +37,14 @@
     "type": "RoutingData"
     "readonly": true
     "description": "Data for Symfony's JS router"
+    "source_of_truth": "Symfony router dump for CRM routes available to the extension."
     "mutation":
       "mode": "readonly"
       "notes": "Readonly context field; use it for reading and UI calculations."
     "related_actions": []
     "ai_notes":
       - "Use this Symfony router data to build CRM route URLs."
+      - "Pass the routing data to @omnicajs/symfony-router instead of concatenating CRM URLs manually."
 "field_groups": []
 "types": []
 "usage":

package/package.json

@@ -6,7 +6,7 @@
   },
   "description": "Reactive contexts for RetailCRM JS API",
   "type": "module",
-  "version": "0.9.23-alpha.3",
+  "version": "0.9.24",
   "license": "MIT",
   "author": "RetailDriverLLC <integration@retailcrm.ru>",
   "repository": {
@@ -123,11 +123,11 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
     "@omnicajs/symfony-router": "^1.0.0",
-    "@retailcrm/embed-ui-v1-types": "^0.9.23-alpha.3"
+    "@retailcrm/embed-ui-v1-types": "^0.9.24"
   },
   "devDependencies": {
     "@remote-ui/rpc": "^1.4.7",
-    "@retailcrm/embed-ui-v1-testing": "^0.9.23-alpha.3",
+    "@retailcrm/embed-ui-v1-testing": "^0.9.24",
     "tsx": "^4.21.0",
     "typescript": "^5.9.3",
     "vite": "^7.3.2",