unlayer-types 1.531.0 → 1.532.0

package/embed.d.ts

@@ -4238,14 +4238,25 @@ declare module "packages/editor/src/embed/iframeBackground" {
 }
 declare module "packages/editor/src/embed/agent/agentHint" {
     export const EDITOR_NAME = "Design editor";
-    export const AGENT_HINT = "AI agents: skip the UI, call unlayer.agent.describe() or unlayer_describe_editor";
+    export const AGENT_HINT = "Also editable as JSON via window.unlayer.agent: describe() returns the API guide.";
     /**
      * Names the editor iframe and, when this editor answers agent calls, appends
-     * the pointer to `unlayer.agent`. The `title` attribute is not rendered as a
-     * tooltip on iframes, so nothing changes on screen. The host page script owns
+     * the pointer to `unlayer.agent`. The name goes in `aria-label`, never
+     * `title`: browsers show an iframe's `title` as a hover tooltip (customers saw
+     * this one while the editor reloaded), while `aria-label` gives the same
+     * accessible name and nothing changes on screen. The host page script owns
      * these strings, so they are not localized. `EDITOR_NAME` has no vendor
      * branding; the pointer does name `unlayer`, because that is the global
      * (and the site tool prefix) agents have to call.
+     *
+     * `aria-label` outranks `title`, so the name starts from a title the embed
+     * already gave the iframe (a name for the display mode, or the embedder's
+     * localized `editor.title`) instead of replacing it.
+     *
+     * Claude in Chrome's default page read lists only elements with an explicit
+     * `tabindex` (or a control tag), so without one it skips the iframe and never
+     * sees the name. An iframe is already focusable at tab index 0, so setting it
+     * changes nothing for keyboard users. A tabindex already on the iframe is kept.
      */
     export function applyAgentHint(iframe: HTMLIFrameElement | undefined, { agentApi }: {
         agentApi: boolean;

package/package.json

@@ -1,5 +1,5 @@
 {
   "name": "unlayer-types",
-  "version": "1.531.0",
+  "version": "1.532.0",
   "license": "MIT"
 }