+
+ )
+}
diff --git a/packages/app-bundle/overlay/packages/session-ui/src/components/markdown-local-images.test.ts b/packages/app-bundle/overlay/packages/session-ui/src/components/markdown-local-images.test.ts
new file mode 100644
index 000000000..0a346b2a7
--- /dev/null
+++ b/packages/app-bundle/overlay/packages/session-ui/src/components/markdown-local-images.test.ts
@@ -0,0 +1,141 @@
+import { beforeEach, describe, expect, test } from "bun:test"
+import {
+ cachedLocalImage,
+ clearLocalImageCache,
+ loadLocalImageCached,
+ localImageLoaderVersion,
+ localImagePath,
+ frameImages,
+ imageFileName,
+ loadLocalImages,
+ registerLocalImageLoader,
+} from "./markdown-local-images"
+
+const host = (action?: string) => {
+ const el = document.createElement("div")
+ el.setAttribute("data-slot", "markdown-copy-button")
+ if (action) el.setAttribute("data-action", action)
+ return el
+}
+const button = () => [host("download"), host()]
+const PNG = "data:image/png;base64,iVBORw0KGgo="
+
+beforeEach(() => {
+ registerLocalImageLoader(undefined)
+ clearLocalImageCache()
+})
+
+function block(html: string) {
+ const root = document.createElement("div")
+ root.innerHTML = html
+ document.body.appendChild(root)
+ return root
+}
+
+const tick = () => new Promise((resolve) => setTimeout(resolve, 0))
+
+describe("localImagePath", () => {
+ test("absolute posix image paths are local; query and hash are dropped", () => {
+ expect(localImagePath("/home/me/talk/eq 1.png")).toBe("/home/me/talk/eq 1.png")
+ expect(localImagePath("/home/me/talk/eq%201.png?v=2#x")).toBe("/home/me/talk/eq 1.png")
+ expect(localImagePath("file:///tmp/plot.svg")).toBe("/tmp/plot.svg")
+ })
+
+ test("remote, data, protocol-relative, relative and non-image sources are not", () => {
+ expect(localImagePath("https://example.com/a.png")).toBeUndefined()
+ expect(localImagePath(PNG)).toBeUndefined()
+ expect(localImagePath("//cdn.example.com/a.png")).toBeUndefined()
+ expect(localImagePath("plots/a.png")).toBeUndefined()
+ expect(localImagePath("/home/me/notes.md")).toBeUndefined()
+ })
+})
+
+describe("loader registry", () => {
+ test("no loader → null, nothing cached", async () => {
+ expect(await loadLocalImageCached("/a.png")).toBeNull()
+ expect(cachedLocalImage("/a.png")).toBeUndefined()
+ })
+
+ test("loads cache hits and dedupe in flight; misses stay uncached for retry", async () => {
+ let calls = 0
+ registerLocalImageLoader(async (path) => {
+ calls++
+ return path === "/real.png" ? PNG : null
+ })
+ const [a, b] = await Promise.all([loadLocalImageCached("/real.png"), loadLocalImageCached("/real.png")])
+ expect(a).toBe(PNG)
+ expect(b).toBe(PNG)
+ expect(await loadLocalImageCached("/real.png")).toBe(PNG)
+ expect(calls).toBe(1)
+ expect(await loadLocalImageCached("/missing.png")).toBeNull()
+ expect(cachedLocalImage("/missing.png")).toBeUndefined()
+ })
+
+ test("a stale unregister keeps the newer loader; registration bumps the version", async () => {
+ const before = localImageLoaderVersion()
+ const stale = registerLocalImageLoader(async () => null)
+ registerLocalImageLoader(async () => PNG)
+ stale()
+ expect(localImageLoaderVersion()).toBeGreaterThan(before)
+ expect(await loadLocalImageCached("/x.png")).toBe(PNG)
+ })
+})
+
+describe("chat image frames", () => {
+ test("every image is framed with download + copy buttons, once", () => {
+ const root = block('
+
+
+
+
+ void saveImage(props.src, props.filename ?? "image.png")}
+ />
+ void copy()}
+ />
+
+
+ 
+
+ 
'))).toBe(
+ "18-piccolo-mintime.png",
+ )
+ expect(imageFileName(img('
'))).toBe("plot.png")
+ expect(imageFileName(img('
'))).toBe("my-figure.v2.png")
+ })
+
+ test("otherwise the alt text names it, else 'image'", () => {
+ expect(imageFileName(img('