@wix/app-extensions 1.0.164 → 1.0.165

package/build/trusted/es/index.d.mts

@@ -28189,17 +28189,22 @@ interface McpConfig {
     allowedTools?: string[];
 }
 /**
- * One translatable permission line. Repeated-message shape, keyed by id, per the
- * components-translations docs' condition for a translatable repeated field.
+ * One translatable permission line. Repeated-message shape, keyed by id. Dev Center's
+ * components-translations scanner keys a translatable repeated field on a field named id whenever
+ * the message has one, in preference to a (.wix.api.unique) annotation, so id is the key here and
+ * declaring unique on another field would not change that.
  */
 /** @internal */
 interface DisplayedPermission {
     /**
      * Identifies this line within its connector's list, so editing or reordering the list does not
-     * orphan an existing translation. The caller mints the id for a new line and it is echoed back
-     * unchanged on update. To preserve an existing line's translation history, echo back the id you
-     * last read for it; sending it empty (even for a line that already had one) is read as "this is
-     * new" and mints a fresh id, starting a fresh translation history.
+     * orphan an existing translation. The caller must supply a non-empty id, unique within the list,
+     * and echo back unchanged the id it last read for a line it is keeping. Both are caller
+     * obligations and this schema enforces neither. The write path does fill an empty id with a fresh
+     * UUID, on create and on update, but that is a backstop rather than a substitute: it can only
+     * mint for a line it sees as new, so it cannot carry a line's identity across an edit or a
+     * reorder, and only the caller knows which line is which. Nothing rejects a duplicate id. A line
+     * whose id changes starts its translation history over and shows English until retranslated.
      * @maxLength 80
      */
     id?: string;