@jant/core 0.3.38 → 0.3.39

package/src/__tests__/site-localize-media.test.ts

@@ -0,0 +1,150 @@
+import {
+  mkdir,
+  mkdtemp,
+  readFile,
+  readdir,
+  rm,
+  writeFile,
+} from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { describe, expect, it } from "vitest";
+import {
+  collectMediaReferences,
+  getSitePathPrefix,
+  localizeSiteExportDirectory,
+  resolveExportUrl,
+  toLocalizedPublicPath,
+  updateConfigMediaUrls,
+} from "../../bin/lib/site-localize-media.js";
+
+describe("site-localize-media helpers", () => {
+  it("collects markdown, html, and attachment media references", () => {
+    const content = `
+![hero](/media/hero.webp)
+<img src="https://example.com/inline.png" alt="">
+<video poster="/media/poster.webp"><source src="/media/clip.mp4"></video>
+<audio src="/media/memo.mp3"></audio>
+<div data-jant-node="attachments">
+  <figure data-jant-node="attachment">
+    <script type="application/json" data-jant-meta>{"src":"/media/doc.pdf","poster":"/media/doc-poster.webp"}</script>
+  </figure>
+</div>
+`;
+
+    expect(collectMediaReferences(content)).toEqual([
+      "/media/hero.webp",
+      "https://example.com/inline.png",
+      "/media/poster.webp",
+      "/media/clip.mp4",
+      "/media/memo.mp3",
+      "/media/doc.pdf",
+      "/media/doc-poster.webp",
+    ]);
+  });
+
+  it("builds localized public paths with a site path prefix", () => {
+    expect(getSitePathPrefix("https://example.com/blog")).toBe("/blog");
+    expect(toLocalizedPublicPath("media/photo.webp", "/blog")).toBe(
+      "/blog/media/photo.webp",
+    );
+    expect(
+      resolveExportUrl("/media/photo.webp", "https://example.com/blog"),
+    ).toBe("https://example.com/media/photo.webp");
+  });
+
+  it("updates config media URLs when replacements exist", () => {
+    const config = {
+      extra: {
+        jant: {
+          site_avatar_url: "https://origin.example/media/avatar.webp",
+          apple_touch_icon_url: "https://origin.example/media/apple-touch.png",
+          favicon_url: "https://origin.example/media/avatar.webp",
+        },
+      },
+    };
+    const replacements = new Map([
+      [
+        "https://origin.example/media/avatar.webp",
+        "/blog/media/local-avatar.webp",
+      ],
+      [
+        "https://origin.example/media/apple-touch.png",
+        "/blog/media/local-apple-touch.png",
+      ],
+    ]);
+
+    expect(updateConfigMediaUrls(config, replacements)).toBe(true);
+    expect(config.extra.jant.site_avatar_url).toBe(
+      "/blog/media/local-avatar.webp",
+    );
+    expect(config.extra.jant.apple_touch_icon_url).toBe(
+      "/blog/media/local-apple-touch.png",
+    );
+    expect(config.extra.jant.favicon_url).toBe("/blog/media/local-avatar.webp");
+  });
+
+  it("localizes media files into static/media and rewrites content/config", async () => {
+    const rootDir = await mkdtemp(join(tmpdir(), "jant-localize-test-"));
+
+    try {
+      await mkdir(join(rootDir, "content", "hello"), { recursive: true });
+      await writeFile(
+        join(rootDir, "config.toml"),
+        `base_url = "https://example.com/blog"
+
+[extra.jant]
+site_avatar_url = "/media/avatar.webp"
+apple_touch_icon_url = "/media/apple-touch.png"
+favicon_url = "/media/avatar.webp"
+`,
+      );
+      await writeFile(
+        join(rootDir, "content", "hello", "index.md"),
+        `---
+title: "Hello"
+---
+
+![hero](/media/hero.webp)
+
+<div data-jant-node="attachments">
+  <figure data-jant-node="attachment">
+    <script type="application/json" data-jant-meta>{"src":"/media/report.pdf"}</script>
+    <a href="/media/report.pdf">report.pdf</a>
+  </figure>
+</div>
+`,
+      );
+
+      const stats = await localizeSiteExportDirectory(rootDir, {
+        assetLoader: async ({ resolvedUrl }) => ({
+          bytes: new TextEncoder().encode(resolvedUrl),
+          contentType: resolvedUrl.endsWith(".pdf")
+            ? "application/pdf"
+            : "image/webp",
+        }),
+      });
+
+      expect(stats.downloaded).toBe(4);
+      expect(stats.filesUpdated).toBe(1);
+      expect(stats.configUpdated).toBe(true);
+
+      const content = await readFile(
+        join(rootDir, "content", "hello", "index.md"),
+        "utf-8",
+      );
+      expect(content).toContain("/blog/media/");
+      expect(content).not.toContain('"/media/hero.webp"');
+      expect(content).not.toContain('"/media/report.pdf"');
+
+      const config = await readFile(join(rootDir, "config.toml"), "utf-8");
+      expect(config).toContain('site_avatar_url = "/blog/media/');
+      expect(config).toContain('apple_touch_icon_url = "/blog/media/');
+
+      const localizedFiles = await readdir(join(rootDir, "static", "media"));
+      expect(localizedFiles).toHaveLength(4);
+    } finally {
+      await rm(rootDir, { recursive: true, force: true });
+    }
+  });
+});

package/src/__tests__/site-media-parser.test.ts

@@ -0,0 +1,216 @@
+import { describe, expect, it } from "vitest";
+import {
+  collectMediaReferences,
+  extractAttachmentBlocks,
+  findImageUrls,
+  normalizeImportedBody,
+  rewriteMediaReferences,
+} from "../../bin/lib/site-media-parser.js";
+
+describe("site-media-parser", () => {
+  it("collects markdown, reference-style, html, and attachment metadata refs", () => {
+    const content = `
+![hero](/media/hero.webp)
+![ref hero][hero-ref]
+
+[hero-ref]: ./media/ref-hero.webp "Hero"
+
+<img src="/media/inline.png" alt="">
+<video poster="/media/poster.webp"><source src="/media/video.mp4"></video>
+<audio src="/media/audio.mp3"></audio>
+
+<div data-jant-node="attachments">
+  <figure data-jant-node="attachment">
+    <script type="application/json" data-jant-meta>{"src":"/media/report.pdf","poster":"/media/report-poster.webp"}</script>
+    <a href="/media/report.pdf">report.pdf</a>
+  </figure>
+</div>
+`;
+
+    expect(collectMediaReferences(content)).toEqual([
+      "/media/hero.webp",
+      "./media/ref-hero.webp",
+      "/media/inline.png",
+      "/media/audio.mp3",
+      "/media/video.mp4",
+      "/media/poster.webp",
+      "/media/report.pdf",
+      "/media/report-poster.webp",
+    ]);
+  });
+
+  it("rewrites only discovered media refs and leaves code fences alone", () => {
+    const content = `
+![hero](/media/hero.webp)
+![ref hero][hero-ref]
+
+[hero-ref]: ./media/ref-hero.webp "Hero"
+
+<div data-jant-node="attachments">
+  <figure data-jant-node="attachment">
+    <script type="application/json" data-jant-meta>{"src":"/media/report.pdf","poster":"/media/report-poster.webp"}</script>
+    <a href="/media/report.pdf">report.pdf</a>
+    <img src="/media/report-poster.webp" alt="">
+  </figure>
+</div>
+
+\`\`\`md
+![not-rewritten](/media/code.webp)
+\`\`\`
+`;
+
+    const rewritten = rewriteMediaReferences(
+      content,
+      new Map([
+        ["/media/hero.webp", "/static/media/hero.webp"],
+        ["./media/ref-hero.webp", "/static/media/ref-hero.webp"],
+        ["/media/report.pdf", "/static/media/report.pdf"],
+        ["/media/report-poster.webp", "/static/media/report-poster.webp"],
+      ]),
+    );
+
+    expect(rewritten).toContain("![hero](/static/media/hero.webp)");
+    expect(rewritten).toContain("[hero-ref]: /static/media/ref-hero.webp");
+    expect(rewritten).toContain('"src":"/static/media/report.pdf"');
+    expect(rewritten).toContain('"poster":"/static/media/report-poster.webp"');
+    expect(rewritten).toContain('<a href="/static/media/report.pdf">');
+    expect(rewritten).toContain('<img src="/static/media/report-poster.webp"');
+    expect(rewritten).toContain("![not-rewritten](/media/code.webp)");
+  });
+
+  it("finds inline images from markdown, html, and reference definitions", () => {
+    const content = `
+![hero](/media/hero.webp)
+![ref hero][hero-ref]
+
+[hero-ref]: ./media/ref-hero.webp "Hero"
+
+<img src="/media/inline.png" alt="">
+
+\`\`\`md
+![not-an-image](/media/code.webp)
+\`\`\`
+`;
+
+    expect(findImageUrls(content)).toEqual([
+      "/media/hero.webp",
+      "./media/ref-hero.webp",
+      "/media/inline.png",
+    ]);
+  });
+
+  it("extracts Jant attachment blocks and leaves surrounding markdown intact", () => {
+    const result = extractAttachmentBlocks(`
+Before
+
+<div data-jant-node="attachments">
+  <figure data-jant-node="attachment">
+    <script type="application/json" data-jant-meta>{"kind":"image","src":"/media/photo.webp","alt":"Photo"}</script>
+    <img src="/media/photo.webp" alt="Photo">
+  </figure>
+  <figure data-jant-node="attachment">
+    <script type="application/json" data-jant-meta>{"kind":"text","contentFormat":"markdown","content":"# Attached note\\n\\nHello import"}</script>
+  </figure>
+</div>
+
+After
+`);
+
+    expect(result.markdown).toBe("Before\n\nAfter");
+    expect(result.attachments).toEqual([
+      {
+        kind: "image",
+        src: "/media/photo.webp",
+        alt: "Photo",
+      },
+      {
+        kind: "text",
+        contentFormat: "markdown",
+        content: "# Attached note\n\nHello import",
+      },
+    ]);
+  });
+
+  it("normalizes standalone image html into Jant image markup", () => {
+    const result = normalizeImportedBody(`
+Before
+
+<figure>
+  <a href="https://example.com/source">
+    <img src="/media/photo.webp" alt="Photo" title="Title">
+  </a>
+  <figcaption>Caption</figcaption>
+</figure>
+
+After
+`);
+
+    expect(result).toEqual({
+      markdown:
+        'Before\n\n<figure data-jant-node="image"><a href="https://example.com/source"><img src="/media/photo.webp" alt="Photo" title="Title"></a><figcaption>Caption</figcaption></figure>\n\nAfter',
+      attachments: [],
+    });
+  });
+
+  it("normalizes inline html images into markdown images", () => {
+    const result = normalizeImportedBody(
+      'Before <img src="/media/photo.webp" alt="Photo" title="Title"> after',
+    );
+
+    expect(result).toEqual({
+      markdown: 'Before ![Photo](/media/photo.webp "Title") after',
+      attachments: [],
+    });
+  });
+
+  it("converts standalone audio and video html into imported attachments", () => {
+    const result = normalizeImportedBody(`
+Intro
+
+<figure>
+  <video controls poster="/media/video-poster.webp">
+    <source src="/media/video.mp4" type="video/mp4">
+  </video>
+  <figcaption>Video caption</figcaption>
+</figure>
+
+<audio controls src="/media/audio.mp3"></audio>
+`);
+
+    expect(result).toEqual({
+      markdown: "Intro",
+      attachments: [
+        {
+          kind: "video",
+          src: "/media/video.mp4",
+          poster: "/media/video-poster.webp",
+          summary: "Video caption",
+        },
+        {
+          kind: "audio",
+          src: "/media/audio.mp3",
+        },
+      ],
+    });
+  });
+
+  it("extracts mixed inline audio and video html into attachments while keeping text", () => {
+    const result = normalizeImportedBody(
+      'Before <video controls><source src="/media/video.mp4" type="video/mp4"></video> middle <audio controls src="/media/audio.mp3"></audio> after',
+    );
+
+    expect(result).toEqual({
+      markdown: "Before middle after",
+      attachments: [
+        {
+          kind: "video",
+          src: "/media/video.mp4",
+        },
+        {
+          kind: "audio",
+          src: "/media/audio.mp3",
+        },
+      ],
+    });
+  });
+});