@adecore/agents-react 0.40.4 → 0.40.5

package/dist/chat/attachments.js

@@ -80,13 +80,26 @@ function readAsBase64(file) {
 function nameFor(file, index) {
   return file.name || `pasted-${Date.now()}-${index + 1}.${file.type.split('/')[1] ?? 'bin'}`;
 }
+function fileMime(file) {
+  const image = attachmentImageMime({
+    name: file.name,
+    mime: file.type
+  });
+  if (image !== null) {
+    return image;
+  }
+  if (file.type === '' || file.type === 'application/octet-stream' || file.type === 'binary/octet-stream') {
+    const extension = /\.(heic|heif)$/i.exec(file.name)?.[1]?.toLowerCase();
+    if (extension !== undefined) {
+      return `image/${extension}`;
+    }
+  }
+  return file.type || 'application/octet-stream';
+}
 export async function readAttachments(files) {
   return Promise.all(files.map(async (file, index) => ({
     name: nameFor(file, index),
-    mime: attachmentImageMime({
-      name: file.name,
-      mime: file.type
-    }) ?? (file.type || 'application/octet-stream'),
+    mime: fileMime(file),
     data: await readAsBase64(file)
   })));
 }

package/dist/chat/image-display.d.ts

@@ -0,0 +1,4 @@
+/** Converts HEIC and HEIF to a browser-readable PNG for display, preserving other formats and the source bytes. */
+export declare function imageForDisplay(blob: Blob): Promise<Blob>;
+/** Makes embedded HEIC/HEIF data URLs readable in a sandboxed HTML preview without changing the saved document. */
+export declare function imageDocumentForDisplay(html: string): Promise<string>;

package/dist/chat/image-display.js

@@ -0,0 +1,39 @@
+/** Converts HEIC and HEIF to a browser-readable PNG for display, preserving other formats and the source bytes. */
+export async function imageForDisplay(blob) {
+  if (!/^image\/(?:heic|heif)(?:-sequence)?$/i.test(blob.type)) {
+    return blob;
+  }
+  // The CSP build decodes in a worker without requiring unsafe-eval on the host page.
+  const {
+    heicTo
+  } = await import('heic-to/csp');
+  return heicTo({
+    blob,
+    type: 'image/png'
+  });
+}
+/** Makes embedded HEIC/HEIF data URLs readable in a sandboxed HTML preview without changing the saved document. */
+export async function imageDocumentForDisplay(html) {
+  const sources = [...new Set(html.match(/data:image\/(?:heic|heif)(?:-sequence)?;base64,[A-Za-z0-9+/=]+/gi) ?? [])];
+  let result = html;
+  for (const source of sources) {
+    try {
+      const comma = source.indexOf(',');
+      const mime = source.slice(5, source.indexOf(';')).toLowerCase();
+      const bytes = Uint8Array.from(atob(source.slice(comma + 1)), character => character.charCodeAt(0));
+      const blob = await imageForDisplay(new Blob([bytes], {
+        type: mime
+      }));
+      const converted = await new Promise((resolve, reject) => {
+        const reader = new FileReader();
+        reader.onload = () => resolve(String(reader.result));
+        reader.onerror = () => reject(reader.error);
+        reader.readAsDataURL(blob);
+      });
+      result = result.replaceAll(source, converted);
+    } catch {
+      // A broken picture must not prevent the rest of the document from opening.
+    }
+  }
+  return result;
+}

package/dist/chat/thumbnails.js

@@ -2,6 +2,7 @@ import { c as _c } from "react/compiler-runtime";
 import i18next from 'i18next';
 import { useEffect, useState } from 'react';
 import { uploadPreviewUrl } from './attachments.js';
+import { imageForDisplay } from './image-display.js';
 /* The edge of a composer thumbnail: a few times the 56 px it is drawn at, so a sharp screen still gets a sharp one. */
 export const THUMBNAIL_PX = 256;
 /* The square in the middle of an image that a thumbnail shows, the same part `object-cover` would. */
@@ -36,16 +37,18 @@ function dataUrlOf(blob) {
  * cannot be decoded this way (an SVG, a browser without `OffscreenCanvas`) falls back to the image.
  */
 async function makeThumbnail(upload) {
+  let image = null;
   try {
-    const bitmap = await createImageBitmap(new Blob([bytesOf(upload.data)], {
+    image = await imageForDisplay(new Blob([bytesOf(upload.data)], {
       type: upload.mime
     }));
+    const bitmap = await createImageBitmap(image);
     const crop = thumbnailCrop(bitmap.width, bitmap.height);
     const canvas = new OffscreenCanvas(crop.out, crop.out);
     const context = canvas.getContext('2d');
     if (!context) {
       bitmap.close();
-      return uploadPreviewUrl(upload);
+      return await dataUrlOf(image);
     }
     context.drawImage(bitmap, crop.sx, crop.sy, crop.size, crop.size, 0, 0, crop.out, crop.out);
     bitmap.close();
@@ -53,7 +56,7 @@ async function makeThumbnail(upload) {
       type: 'image/png'
     }));
   } catch {
-    return uploadPreviewUrl(upload);
+    return image === null ? uploadPreviewUrl(upload) : dataUrlOf(image);
   }
 }
 // Keyed by the upload itself, so a composer that mounts again finds it and a removed file lets it go.

package/dist/chat/ui/DisplayImage.d.ts

@@ -0,0 +1,5 @@
+import { type ComponentProps } from 'react';
+type ImageProps = ComponentProps<'img'>;
+/** An image with a HEIC/HEIF fallback for browsers without a native decoder. Remote sources must allow cross-origin reads. */
+export declare function DisplayImage({ src, onError, ...props }: ImageProps): import("react").JSX.Element;
+export {};

package/dist/chat/ui/DisplayImage.js

@@ -0,0 +1,109 @@
+import { c as _c } from "react/compiler-runtime";
+import { useEffect, useState } from 'react';
+import { imageDocumentForDisplay, imageForDisplay } from '../image-display.js';
+/** An image with a HEIC/HEIF fallback for browsers without a native decoder. Remote sources must allow cross-origin reads. */
+import { jsx as _jsx } from "react/jsx-runtime";
+export function DisplayImage(t0) {
+  const $ = _c(9);
+  let onError;
+  let props;
+  let src;
+  if ($[0] !== t0) {
+    ({
+      src,
+      onError,
+      ...props
+    } = t0);
+    $[0] = t0;
+    $[1] = onError;
+    $[2] = props;
+    $[3] = src;
+  } else {
+    onError = $[1];
+    props = $[2];
+    src = $[3];
+  }
+  const t1 = typeof src === "string" ? src : undefined;
+  let t2;
+  if ($[4] !== onError || $[5] !== props || $[6] !== src || $[7] !== t1) {
+    t2 = /*#__PURE__*/_jsx(ImageSource, {
+      ...props,
+      src: src,
+      onError: onError
+    }, t1);
+    $[4] = onError;
+    $[5] = props;
+    $[6] = src;
+    $[7] = t1;
+    $[8] = t2;
+  } else {
+    t2 = $[8];
+  }
+  return t2;
+}
+function ImageSource({
+  src,
+  onError,
+  ...props
+}) {
+  const [retry, setRetry] = useState(null);
+  const [decoded, setDecoded] = useState(null);
+  const converted = decoded !== null && decoded.source === src ? decoded.url : null;
+  useEffect(() => {
+    if (typeof src !== 'string' || retry !== src) {
+      return;
+    }
+    let cancelled = false;
+    let url = null;
+    const convert = async () => {
+      try {
+        const embedded = await imageDocumentForDisplay(src);
+        if (cancelled) {
+          return;
+        }
+        if (embedded !== src) {
+          setDecoded({
+            source: src,
+            url: embedded
+          });
+          return;
+        }
+        const response = await fetch(src, {
+          referrerPolicy: 'no-referrer'
+        });
+        if (!response.ok) {
+          return;
+        }
+        const blob = await response.blob();
+        const image = await imageForDisplay(blob);
+        if (cancelled || image === blob) {
+          return;
+        }
+        url = URL.createObjectURL(image);
+        setDecoded({
+          source: src,
+          url
+        });
+      } catch {
+        // The failed image keeps the browser's alt text when it cannot be read or decoded.
+      }
+    };
+    void convert();
+    return () => {
+      cancelled = true;
+      if (url !== null) {
+        URL.revokeObjectURL(url);
+      }
+    };
+  }, [src, retry]);
+  return /*#__PURE__*/_jsx("img", {
+    src: converted ?? src,
+    ...props,
+    onError: event => {
+      if (typeof src === 'string' && retry !== src) {
+        setRetry(src);
+      }
+      onError?.(event);
+    }
+  });
+}

package/dist/chat/ui/ImageView.js

@@ -4,6 +4,7 @@ import { useTranslation } from 'react-i18next';
 import clsx from 'clsx';
 import { ImageOff, Minus, Plus, RotateCcw } from 'lucide-react';
 import { ButtonGroup, CloseButton, Dialog, Icon, IconButton, Tooltip } from '@adecore/ui';
+import { DisplayImage } from './DisplayImage.js';
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
 const MIN_SCALE = 1;
 const MAX_SCALE = 8;
@@ -404,7 +405,7 @@ function Lightbox(t0) {
   }
   let t39;
   if ($[67] !== alt || $[68] !== src || $[69] !== t38) {
-    t39 = /*#__PURE__*/_jsx("img", {
+    t39 = /*#__PURE__*/_jsx(DisplayImage, {
       src: src,
       alt: alt,
       draggable: false,
@@ -581,7 +582,7 @@ export function ImageThumb(t0) {
   }
   let t8;
   if ($[19] !== alt || $[20] !== src || $[21] !== t7) {
-    t8 = /*#__PURE__*/_jsx("img", {
+    t8 = /*#__PURE__*/_jsx(DisplayImage, {
       src: src,
       alt: alt,
       className: t7

package/dist/chat/ui/Markdown.js

@@ -19,6 +19,7 @@ import { useChatHost } from '../../host.js';
 import { useFileLinkCwd, useFileLinkScopeId, useFileLinkTarget, useOpenFileLink } from './file-links.js';
 import { ErrorBoundary, FileIcon, Icon } from '@adecore/ui';
 import { useTranslation } from 'react-i18next';
+import { DisplayImage } from './DisplayImage.js';
 import { jsx as _jsx } from "react/jsx-runtime";
 const ShellCodeBlockReplyContext = createContext(null);
 const BlockCodeContext = createContext(false);
@@ -330,7 +331,7 @@ function MarkdownImage(t0) {
   if (HostImage === undefined || path === null) {
     let t2;
     if ($[3] !== alt || $[4] !== src) {
-      t2 = /*#__PURE__*/_jsx("img", {
+      t2 = /*#__PURE__*/_jsx(DisplayImage, {
         src: src,
         alt: alt
       });
@@ -366,7 +367,7 @@ function PlainImage(t0) {
   } = t0;
   let t1;
   if ($[0] !== alt || $[1] !== src) {
-    t1 = /*#__PURE__*/_jsx("img", {
+    t1 = /*#__PURE__*/_jsx(DisplayImage, {
       src: src,
       alt: alt
     });

package/dist/chat/ui/VisualFrame.js

@@ -7,6 +7,7 @@ import { Spinner, useMeasuredWidth } from '@adecore/ui';
 import { useChatHost } from '../../host.js';
 import { useChatScope } from '../../scope.js';
 import { DEFAULT_HEIGHT_PX, initialVisualContentHeight, rememberVisualHeight } from '../logic/visual-height.js';
+import { imageDocumentForDisplay } from '../image-display.js';
 import { VisualBridge } from '../visual-bridge.js';
 import { VisualViewportController } from '../visual-viewport.js';
 import { useVisualTheme } from './visual-theme.js';
@@ -223,7 +224,7 @@ function PageFrame(t0) {
         visual: {
           maxHeight
         },
-        page: page(),
+        page: page().then(imageDocumentForDisplay),
         theme: opening.theme,
         mayOpenLink: () => personActsIn(frame),
         openLink: url => visuals?.openLink(url),

package/dist/chat/ui/index.d.ts

@@ -2,6 +2,7 @@ export { AccountPill } from './AccountPill.js';
 export { AnsiOutput } from './AnsiOutput.js';
 export { BookmarkSubmenu } from './BookmarkSubmenu.js';
 export { ChatActivity, StatusIcon } from './ChatActivity.js';
+export { DisplayImage } from './DisplayImage.js';
 export { CodeBlock } from './CodeBlock.js';
 export { Composer } from './Composer.js';
 export { type ComposerInputHandle, ComposerInput, type InputSelection } from './ComposerInput.js';

package/dist/chat/ui/index.js

@@ -3,6 +3,7 @@ export { AccountPill } from './AccountPill.js';
 export { AnsiOutput } from './AnsiOutput.js';
 export { BookmarkSubmenu } from './BookmarkSubmenu.js';
 export { ChatActivity, StatusIcon } from './ChatActivity.js';
+export { DisplayImage } from './DisplayImage.js';
 export { CodeBlock } from './CodeBlock.js';
 export { Composer } from './Composer.js';
 export { ComposerInput } from './ComposerInput.js';

package/dist/chat/ui/intelligent-ui/renderers/content.js

@@ -12,6 +12,7 @@ import { ImageThumb } from '../../ImageView.js';
 import { uiChildrenOf, uiNodeLabel, uiNodeText, uiUrlDomain } from '../node-text.js';
 import { useTruncated } from '../use-truncated.js';
 import { useHostAttachmentUrl } from '../../../../host-hooks.js';
+import { DisplayImage } from '../../DisplayImage.js';
 // The number of every source by its node id, which the list counts in its own order.
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
 const SourceNumbers = createContext(new Map());
@@ -445,7 +446,7 @@ export function CompareRenderer(t0) {
       }
       let t8;
       if ($[15] !== first.url || $[16] !== t6 || $[17] !== t7) {
-        t8 = /*#__PURE__*/_jsx("img", {
+        t8 = /*#__PURE__*/_jsx(DisplayImage, {
           src: t5,
           alt: t6,
           draggable: false,
@@ -471,7 +472,7 @@ export function CompareRenderer(t0) {
       }
       let t11;
       if ($[22] !== second.url || $[23] !== t10) {
-        t11 = /*#__PURE__*/_jsx("img", {
+        t11 = /*#__PURE__*/_jsx(DisplayImage, {
           src: t9,
           alt: t10,
           draggable: false,

package/dist/images.d.ts

@@ -0,0 +1,2 @@
+export { imageDocumentForDisplay, imageForDisplay } from './chat/image-display.js';
+export { DisplayImage } from './chat/ui/DisplayImage.js';

package/dist/images.js

@@ -0,0 +1,2 @@
+export { imageDocumentForDisplay, imageForDisplay } from './chat/image-display.js';
+export { DisplayImage } from './chat/ui/DisplayImage.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adecore/agents-react",
-  "version": "0.40.4",
+  "version": "0.40.5",
   "description": "React agent chat threads, composers, approvals, provider accounts and usage views.",
   "type": "module",
   "exports": {
@@ -58,6 +58,11 @@
       "source": "./src/theme.css",
       "style": "./src/theme.css",
       "default": "./dist/theme.css"
+    },
+    "./images": {
+      "source": "./src/images.ts",
+      "types": "./dist/images.d.ts",
+      "default": "./dist/images.js"
     }
   },
   "scripts": {
@@ -67,11 +72,11 @@
     "test:visuals": "bun --config=integration.bunfig.toml --conditions=source test ./src/chat/visual-viewport.integration.test.ts"
   },
   "dependencies": {
-    "@adecore/agent-contracts": "0.40.4",
-    "@adecore/editor": "0.40.4",
-    "@adecore/editor-react": "0.40.4",
-    "@adecore/intelligent-ui": "0.40.4",
-    "@adecore/merge": "0.40.4",
+    "@adecore/agent-contracts": "0.40.5",
+    "@adecore/editor": "0.40.5",
+    "@adecore/editor-react": "0.40.5",
+    "@adecore/intelligent-ui": "0.40.5",
+    "@adecore/merge": "0.40.5",
     "@codemirror/commands": "^6.11.1",
     "@codemirror/language": "^6.13.1",
     "@codemirror/state": "^6.7.6",
@@ -82,6 +87,7 @@
     "@pierre/diffs": "^1.6.1",
     "@tanstack/react-virtual": "^3.14.23",
     "clsx": "^2.1.1",
+    "heic-to": "1.6.6",
     "lucide-react": "^1.61.0",
     "maplibre-gl": "^6.16.0",
     "pele": "1.8.0",
@@ -94,14 +100,14 @@
     "zustand": "^5.0.16"
   },
   "peerDependencies": {
-    "@adecore/ui": "^0.40.4",
+    "@adecore/ui": "^0.40.5",
     "i18next": "^26.4.2",
     "react": "^19.3.0",
     "react-dom": "^19.3.0",
     "react-i18next": "^17.0.15"
   },
   "devDependencies": {
-    "@adecore/ui": "0.40.4",
+    "@adecore/ui": "0.40.5",
     "@types/bun": "^1.4.4",
     "@types/react": "^19.3.0",
     "@types/react-dom": "^19.3.0",

package/src/chat/attachments.ts

@@ -95,11 +95,29 @@ function nameFor(file: File, index: number): string {
     return file.name || `pasted-${Date.now()}-${index + 1}.${file.type.split('/')[1] ?? 'bin'}`;
 }
 
+function fileMime(file: File): string {
+    const image = attachmentImageMime({ name: file.name, mime: file.type });
+
+    if (image !== null) {
+        return image;
+    }
+
+    if (file.type === '' || file.type === 'application/octet-stream' || file.type === 'binary/octet-stream') {
+        const extension = /\.(heic|heif)$/i.exec(file.name)?.[1]?.toLowerCase();
+
+        if (extension !== undefined) {
+            return `image/${extension}`;
+        }
+    }
+
+    return file.type || 'application/octet-stream';
+}
+
 export async function readAttachments(files: File[]): Promise<ChatAttachmentUpload[]> {
     return Promise.all(
         files.map(async (file, index) => ({
             name: nameFor(file, index),
-            mime: attachmentImageMime({ name: file.name, mime: file.type }) ?? (file.type || 'application/octet-stream'),
+            mime: fileMime(file),
             data: await readAsBase64(file)
         }))
     );

package/src/chat/image-display.ts

@@ -0,0 +1,38 @@
+/** Converts HEIC and HEIF to a browser-readable PNG for display, preserving other formats and the source bytes. */
+export async function imageForDisplay(blob: Blob): Promise<Blob> {
+    if (!/^image\/(?:heic|heif)(?:-sequence)?$/i.test(blob.type)) {
+        return blob;
+    }
+
+    // The CSP build decodes in a worker without requiring unsafe-eval on the host page.
+    const { heicTo } = await import('heic-to/csp');
+
+    return heicTo({ blob, type: 'image/png' });
+}
+
+/** Makes embedded HEIC/HEIF data URLs readable in a sandboxed HTML preview without changing the saved document. */
+export async function imageDocumentForDisplay(html: string): Promise<string> {
+    const sources = [...new Set(html.match(/data:image\/(?:heic|heif)(?:-sequence)?;base64,[A-Za-z0-9+/=]+/gi) ?? [])];
+    let result = html;
+
+    for (const source of sources) {
+        try {
+            const comma = source.indexOf(',');
+            const mime = source.slice(5, source.indexOf(';')).toLowerCase();
+            const bytes = Uint8Array.from(atob(source.slice(comma + 1)), (character) => character.charCodeAt(0));
+            const blob = await imageForDisplay(new Blob([bytes], { type: mime }));
+            const converted = await new Promise<string>((resolve, reject) => {
+                const reader = new FileReader();
+                reader.onload = () => resolve(String(reader.result));
+                reader.onerror = () => reject(reader.error);
+                reader.readAsDataURL(blob);
+            });
+
+            result = result.replaceAll(source, converted);
+        } catch {
+            // A broken picture must not prevent the rest of the document from opening.
+        }
+    }
+
+    return result;
+}

package/src/chat/thumbnails.ts

@@ -2,6 +2,7 @@ import i18next from 'i18next';
 import { useEffect, useState } from 'react';
 import type { ChatAttachmentUpload } from '@adecore/agent-contracts';
 import { uploadPreviewUrl } from './attachments';
+import { imageForDisplay } from './image-display';
 
 /* The edge of a composer thumbnail: a few times the 56 px it is drawn at, so a sharp screen still gets a sharp one. */
 export const THUMBNAIL_PX = 256;
@@ -53,8 +54,11 @@ function dataUrlOf(blob: Blob): Promise<string> {
  * cannot be decoded this way (an SVG, a browser without `OffscreenCanvas`) falls back to the image.
  */
 async function makeThumbnail(upload: ChatAttachmentUpload): Promise<string> {
+    let image: Blob | null = null;
+
     try {
-        const bitmap = await createImageBitmap(new Blob([bytesOf(upload.data)], { type: upload.mime }));
+        image = await imageForDisplay(new Blob([bytesOf(upload.data)], { type: upload.mime }));
+        const bitmap = await createImageBitmap(image);
         const crop = thumbnailCrop(bitmap.width, bitmap.height);
         const canvas = new OffscreenCanvas(crop.out, crop.out);
         const context = canvas.getContext('2d');
@@ -62,7 +66,7 @@ async function makeThumbnail(upload: ChatAttachmentUpload): Promise<string> {
         if (!context) {
             bitmap.close();
 
-            return uploadPreviewUrl(upload);
+            return await dataUrlOf(image);
         }
 
         context.drawImage(bitmap, crop.sx, crop.sy, crop.size, crop.size, 0, 0, crop.out, crop.out);
@@ -70,7 +74,7 @@ async function makeThumbnail(upload: ChatAttachmentUpload): Promise<string> {
 
         return await dataUrlOf(await canvas.convertToBlob({ type: 'image/png' }));
     } catch {
-        return uploadPreviewUrl(upload);
+        return image === null ? uploadPreviewUrl(upload) : dataUrlOf(image);
     }
 }
 

package/src/chat/ui/DisplayImage.tsx

@@ -0,0 +1,82 @@
+import { useEffect, useState, type ComponentProps } from 'react';
+import { imageDocumentForDisplay, imageForDisplay } from '../image-display';
+
+type ImageProps = ComponentProps<'img'>;
+
+/** An image with a HEIC/HEIF fallback for browsers without a native decoder. Remote sources must allow cross-origin reads. */
+export function DisplayImage({ src, onError, ...props }: ImageProps) {
+    return <ImageSource key={typeof src === 'string' ? src : undefined} {...props} src={src} onError={onError} />;
+}
+
+function ImageSource({ src, onError, ...props }: ImageProps) {
+    const [retry, setRetry] = useState<string | null>(null);
+    const [decoded, setDecoded] = useState<{ source: string; url: string } | null>(null);
+    const converted = decoded !== null && decoded.source === src ? decoded.url : null;
+
+    useEffect(() => {
+        if (typeof src !== 'string' || retry !== src) {
+            return;
+        }
+
+        let cancelled = false;
+        let url: string | null = null;
+
+        const convert = async (): Promise<void> => {
+            try {
+                const embedded = await imageDocumentForDisplay(src);
+
+                if (cancelled) {
+                    return;
+                }
+
+                if (embedded !== src) {
+                    setDecoded({ source: src, url: embedded });
+
+                    return;
+                }
+
+                const response = await fetch(src, { referrerPolicy: 'no-referrer' });
+
+                if (!response.ok) {
+                    return;
+                }
+
+                const blob = await response.blob();
+                const image = await imageForDisplay(blob);
+
+                if (cancelled || image === blob) {
+                    return;
+                }
+
+                url = URL.createObjectURL(image);
+                setDecoded({ source: src, url });
+            } catch {
+                // The failed image keeps the browser's alt text when it cannot be read or decoded.
+            }
+        };
+
+        void convert();
+
+        return () => {
+            cancelled = true;
+
+            if (url !== null) {
+                URL.revokeObjectURL(url);
+            }
+        };
+    }, [src, retry]);
+
+    return (
+        <img
+            src={converted ?? src}
+            {...props}
+            onError={(event) => {
+                if (typeof src === 'string' && retry !== src) {
+                    setRetry(src);
+                }
+
+                onError?.(event);
+            }}
+        />
+    );
+}

package/src/chat/ui/ImageView.tsx

@@ -4,6 +4,7 @@ import clsx from 'clsx';
 import { ImageOff, Minus, Plus, RotateCcw } from 'lucide-react';
 import type { ResourceUrl } from '../../host';
 import { ButtonGroup, CloseButton, Dialog, Icon, IconButton, Tooltip } from '@adecore/ui';
+import { DisplayImage } from './DisplayImage';
 
 const MIN_SCALE = 1;
 const MAX_SCALE = 8;
@@ -137,7 +138,7 @@ function Lightbox({
                         dragRef.current = null;
                     }}
                 >
-                    <img
+                    <DisplayImage
                         src={src}
                         alt={alt}
                         draggable={false}
@@ -205,7 +206,7 @@ export function ImageThumb({ source, alt, className, aspect, actions, open: open
                 style={ratio}
                 onClick={() => setOpen(true)}
             >
-                <img src={src} alt={alt} className={clsx(aspect !== undefined && 'size-full object-contain', className)} />
+                <DisplayImage src={src} alt={alt} className={clsx(aspect !== undefined && 'size-full object-contain', className)} />
             </button>
             <Lightbox src={src} alt={alt} open={open} onOpenChange={setOpen} actions={actions} />
         </>

package/src/chat/ui/Markdown.tsx

@@ -19,6 +19,7 @@ import { useChatHost, type ChatHost, type FileRef, type ShellCodeBlockContext }
 import { useFileLinkCwd, useFileLinkScopeId, useFileLinkTarget, useOpenFileLink } from './file-links';
 import { ErrorBoundary, FileIcon, Icon } from '@adecore/ui';
 import { useTranslation } from 'react-i18next';
+import { DisplayImage } from './DisplayImage';
 
 type ShellCodeBlockReply = Pick<ShellCodeBlockContext, 'scopeId' | 'chatId' | 'itemId'> & { streaming: boolean };
 
@@ -211,14 +212,14 @@ function MarkdownImage({ src, alt }: { src?: string; alt?: string }) {
     const path = typeof src === 'string' ? localImagePath(src, cwd) : null;
 
     if (HostImage === undefined || path === null) {
-        return <img src={src} alt={alt} />;
+        return <DisplayImage src={src} alt={alt} />;
     }
 
     return <HostImage path={path} alt={alt ?? ''} />;
 }
 
 function PlainImage({ src, alt }: { src?: string; alt?: string }) {
-    return <img src={src} alt={alt} />;
+    return <DisplayImage src={src} alt={alt} />;
 }
 
 /* A ```mermaid fence, which draws what it says. */

package/src/chat/ui/VisualFrame.tsx

@@ -6,6 +6,7 @@ import { Spinner, useMeasuredWidth } from '@adecore/ui';
 import { useChatHost } from '../../host';
 import { useChatScope } from '../../scope';
 import { DEFAULT_HEIGHT_PX, initialVisualContentHeight, rememberVisualHeight } from '../logic/visual-height';
+import { imageDocumentForDisplay } from '../image-display';
 import { VisualBridge } from '../visual-bridge';
 import { VisualViewportController } from '../visual-viewport';
 import { useVisualTheme } from './visual-theme';
@@ -129,7 +130,7 @@ function PageFrame({ page, title, maxHeight, fill = false, className, initialHei
         const bridge = new VisualBridge({
             frame: () => frame.contentWindow,
             visual: { maxHeight },
-            page: page(),
+            page: page().then(imageDocumentForDisplay),
             theme: opening.theme,
             mayOpenLink: () => personActsIn(frame),
             openLink: (url) => visuals?.openLink(url),

package/src/chat/ui/index.ts

@@ -3,6 +3,7 @@ export { AccountPill } from './AccountPill';
 export { AnsiOutput } from './AnsiOutput';
 export { BookmarkSubmenu } from './BookmarkSubmenu';
 export { ChatActivity, StatusIcon } from './ChatActivity';
+export { DisplayImage } from './DisplayImage';
 export { CodeBlock } from './CodeBlock';
 export { Composer } from './Composer';
 export { type ComposerInputHandle, ComposerInput, type InputSelection } from './ComposerInput';

package/src/chat/ui/intelligent-ui/renderers/content.tsx

@@ -13,6 +13,7 @@ import { uiChildrenOf, uiNodeLabel, uiNodeText, uiUrlDomain } from '../node-text
 import type { UiRendererProps } from '../render-context';
 import { useTruncated } from '../use-truncated';
 import { useHostAttachmentUrl } from '../../../../host-hooks';
+import { DisplayImage } from '../../DisplayImage';
 
 // The number of every source by its node id, which the list counts in its own order.
 const SourceNumbers = createContext<ReadonlyMap<string, number>>(new Map());
@@ -153,7 +154,7 @@ export function CompareRenderer({ node, children, context }: UiRendererProps<UiP
                     onValueChange={setSplit}
                     label={label}
                     before={
-                        <img
+                        <DisplayImage
                             src={first.url}
                             alt={describe(beforeLabel)}
                             draggable={false}
@@ -167,7 +168,7 @@ export function CompareRenderer({ node, children, context }: UiRendererProps<UiP
                             }}
                         />
                     }
-                    after={<img src={second.url} alt={describe(afterLabel)} draggable={false} className="size-full object-contain select-none" />}
+                    after={<DisplayImage src={second.url} alt={describe(afterLabel)} draggable={false} className="size-full object-contain select-none" />}
                 />
                 <CompareChip side="left" label={beforeLabel} />
                 <CompareChip side="right" label={afterLabel} />

package/src/images.ts

@@ -0,0 +1,2 @@
+export { imageDocumentForDisplay, imageForDisplay } from './chat/image-display';
+export { DisplayImage } from './chat/ui/DisplayImage';