jsmdcui 0.11.2 → 0.12.0

package/tests/assets-helper.test.js

@@ -0,0 +1,116 @@
+import { expect, test } from "bun:test";
+import { mkdtemp, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import { tmpdir } from "node:os";
+import {
+  buildHtmlBundleImageMap,
+  canonicalHtmlBundleImageHref,
+  decodeHtmlAttribute,
+  findHtmlBundleAsset,
+  findHtmlBundleImageAsset,
+  htmlBundleImageAssetPath,
+} from "../single-exe/assetsHelper.js";
+
+const homepage = {
+  files: [
+    {
+      input: "../../images/pixel.png",
+      path: "/$bunfs/root/pixel-abc123.png",
+      loader: "file",
+      headers: { "content-type": "image/png" },
+    },
+    {
+      input: "scripts/app.js",
+      path: "/$bunfs/root/app-test.js",
+      loader: "file",
+      headers: { "content-type": "text/javascript" },
+    },
+  ],
+};
+
+test("HTML bundle asset lookup matches the compiled public asset path", () => {
+  expect(findHtmlBundleAsset(homepage, "/pixel-abc123.png"))
+    .toBe(homepage.files[0]);
+  expect(htmlBundleImageAssetPath(homepage, "/pixel-abc123.png?version=2"))
+    .toBe("/$bunfs/root/pixel-abc123.png");
+});
+
+test("HTML bundle image lookup rejects non-images and unavailable development bundles", () => {
+  expect(findHtmlBundleImageAsset(homepage, "/app-test.js")).toBeNull();
+  expect(findHtmlBundleAsset({}, "/pixel-abc123.png")).toBeNull();
+  expect(findHtmlBundleAsset(null, "/pixel-abc123.png")).toBeNull();
+});
+
+test("HTML bundle image map joins preserved Markdown hrefs to compiled bunfs assets", async () => {
+  const directory = await mkdtemp(join(tmpdir(), "jsmdcui-html-assets-"));
+  const htmlPath = join(directory, "app.html");
+  await writeFile(htmlPath, [
+    '<img src="/dms-ajghf5bd.jpg" data-mdcui-src="jsmdcui/single-exe/dms.jpg">',
+    '<img src="/unicode-xyz.png" data-mdcui-src="%E5%9C%96%E7%89%87/%E6%B8%AC%E8%A9%A6%20%E5%9C%96.png">',
+    '<img src="/query-qwe.png" data-mdcui-src="./query.png?x=1&amp;y=2#preview">',
+  ].join("\n"));
+  const compiledHomepage = {
+    index: htmlPath,
+    files: [
+      {
+        input: "dms.jpg",
+        path: "/$bunfs/root/dms-ajghf5bd.jpg",
+        loader: "file",
+        headers: { "content-type": "image/jpeg" },
+      },
+      {
+        input: "../../unicode.png",
+        path: "/$bunfs/root/unicode-xyz.png",
+        loader: "file",
+        headers: { "content-type": "image/png" },
+      },
+      {
+        input: "../query.png",
+        path: "/$bunfs/root/query-qwe.png",
+        loader: "file",
+        headers: { "content-type": "image/png" },
+      },
+    ],
+  };
+
+  const images = await buildHtmlBundleImageMap(compiledHomepage);
+  expect(images.get("jsmdcui/single-exe/dms.jpg"))
+    .toBe("/$bunfs/root/dms-ajghf5bd.jpg");
+  expect(images.get("圖片/測試 圖.png"))
+    .toBe("/$bunfs/root/unicode-xyz.png");
+  expect(images.get("./query.png?x=1&y=2#preview"))
+    .toBe("/$bunfs/root/query-qwe.png");
+});
+
+test("HTML bundle href canonicalization decodes serialization without resolving paths", () => {
+  expect(decodeHtmlAttribute("./a.png?x=1&amp;y=2")).toBe("./a.png?x=1&y=2");
+  expect(canonicalHtmlBundleImageHref("%E5%9C%96%E7%89%87/a%20b.png"))
+    .toBe("圖片/a b.png");
+  expect(canonicalHtmlBundleImageHref("./a.png?x=1&amp;y=2", { htmlAttribute: true }))
+    .toBe("./a.png?x=1&y=2");
+});
+
+test("HTML bundle image map accepts a custom source attribute", async () => {
+  const directory = await mkdtemp(join(tmpdir(), "jsmdcui-html-assets-custom-"));
+  const htmlPath = join(directory, "custom.html");
+  await writeFile(
+    htmlPath,
+    '<img src="/photo-custom123.jpg" data-original-image="./photos/a.jpg">',
+  );
+  const customHomepage = {
+    index: htmlPath,
+    files: [{
+      input: "../../photos/a.jpg",
+      path: "/$bunfs/root/photo-custom123.jpg",
+      loader: "file",
+      headers: { "content-type": "image/jpeg" },
+    }],
+  };
+
+  const images = await buildHtmlBundleImageMap(
+    customHomepage,
+    "data-original-image",
+  );
+  expect(images.get("./photos/a.jpg"))
+    .toBe("/$bunfs/root/photo-custom123.jpg");
+});

package/tests/kitty-images.test.js

@@ -26,6 +26,28 @@ test("Bun-rendered Markdown image links reserve rows and retain Kitty data", asy
   expect(Bun.stripANSI(result.rendered)).toContain("📷 pixel");
 });
 
+test("Kitty images prefer lazily supplied compiled HTML bundle assets", async () => {
+  const dir = await mkdtemp(join(tmpdir(), "jsmdcui-kitty-bundled-"));
+  const bundledPath = join(dir, "pixel-bundled.png");
+  await writeFile(bundledPath, ONE_PIXEL_PNG);
+  const ansi = Bun.markdown.ansi("![pixel](./images/pixel.png?version=2#preview)", {
+    hyperlinks: true,
+    columns: 40,
+  });
+  let imageMapRequests = 0;
+  const result = await prepareKittyImages(ansi, join(dir, "missing-app.md"), 40, {
+    getBundledImageMap: async () => {
+      imageMapRequests++;
+      return new Map([["./images/pixel.png?version=2#preview", bundledPath]]);
+    },
+  });
+
+  expect(imageMapRequests).toBe(1);
+  expect(result.images).toHaveLength(1);
+  expect(result.images[0].path).toBe(bundledPath);
+  expect(result.images[0].data.equals(ONE_PIXEL_PNG)).toBe(true);
+});
+
 test("Kitty compat converts compressed images to standard PNG payloads", async () => {
   const dir = await mkdtemp(join(tmpdir(), "jsmdcui-kitty-compat-"));
   const markdownPath = join(dir, "app.md");

package/tests/kitty-mode.test.js

@@ -0,0 +1,14 @@
+import { expect, test } from "bun:test";
+import { kittyModeFromEnvironment } from "../src/cui/kitty-mode.mjs";
+
+test("Kitty mode accepts supported environment values case-insensitively", () => {
+  expect(kittyModeFromEnvironment("compat")).toBe("compat");
+  expect(kittyModeFromEnvironment(" EXTENDED ")).toBe("extended");
+  expect(kittyModeFromEnvironment("off")).toBe("off");
+});
+
+test("Kitty mode defaults invalid or missing environment values to off", () => {
+  expect(kittyModeFromEnvironment()).toBe("off");
+  expect(kittyModeFromEnvironment("yes")).toBe("off");
+  expect(kittyModeFromEnvironment("")).toBe("off");
+});

package/tests/wui-responsive-images.test.js

@@ -19,6 +19,7 @@ test("createWui constrains images to their content width", async () => {
   const html = await createWui("![wide](wide.png)", markdownPath);
 
   expect(html).toContain("img {\n  max-width: 100%;\n  height: auto;\n}");
+  expect(html).toContain('src="wide.png" alt="wide" data-mdcui-src="wide.png"');
   expect(html.match(/max-width: 100%/g)).toHaveLength(1);
   expect(html.match(/image\.md\.front\.js/g)).toHaveLength(1);
 });
@@ -31,6 +32,7 @@ test("createWui injects the image rule into an existing document head", async ()
   const html = await createWui(source, markdownPath);
 
   expect(html.indexOf("max-width: 100%")).toBeLessThan(html.indexOf("</head>"));
+  expect(html).toContain('src="wide.png" data-mdcui-src="wide.png"');
   expect(html.match(/document\.md\.front\.js/g)).toHaveLength(1);
 });