@kenjura/ursa 0.88.0 → 0.89.1

package/CHANGELOG.md

@@ -1,3 +1,14 @@
+# 0.89.0
+2026-08-20
+
+Fixed `generate` dropping every static file that was not an image or an HTML page — fonts, video, audio, PDFs. A site that used any of them worked perfectly in `ursa serve` and shipped broken.
+
+`serve` reads static files straight off disk through one list of extensions, while `generate` had two narrower ideas of what to copy: images, and `.html`. Nothing else ever reached the output. Because dev and build disagreed rather than both being wrong, the gap was invisible until deploy — and then invisible again, since a static host that rewrites 404s to `index.html` answers a missing `.mp4` with a page of HTML rather than an error.
+
+- **`generate` now copies fonts, audio, video, documents and archives**: `woff`, `woff2`, `ttf`, `eot`, `otf`, `pdf`, `mp3`, `m4a`, `wav`, `flac`, `mp4`, `m4v`, `webm`, `ogv`, `ogg`, `zip`. Images keep their own path, because they also get previews.
+- **One shared list**, in `helper/staticAssets.js`, used by both `generate` and `serve`, so they cannot drift apart again. It is the drift, not either list, that caused this.
+- The static-files progress line now counts HTML and media separately.
+
 # 0.88.0
 2026-08-19
 

package/package.json

@@ -2,7 +2,7 @@
   "name": "@kenjura/ursa",
   "author": "Andrew London <andrew@kenjura.com>",
   "type": "module",
-  "version": "0.88.0",
+  "version": "0.89.1",
   "description": "static site generator from MD/wikitext/YML",
   "main": "lib/index.js",
   "bin": {

package/src/helper/__test__/staticAssets.test.js

@@ -0,0 +1,47 @@
+import {
+  isImage,
+  isMedia,
+  isStaticAsset,
+} from "../staticAssets.js";
+
+describe("staticAssets", () => {
+  it("treats the image formats as images", () => {
+    for (const f of ["a.jpg", "a.jpeg", "a.PNG", "a.gif", "a.webp", "a.svg", "a.ico"]) {
+      expect(isImage(f)).toBe(true);
+      expect(isMedia(f)).toBe(false);
+    }
+  });
+
+  // The regression this module exists for: generate() copied images and HTML
+  // and nothing else, so every one of these 404'd in a built site.
+  it("treats fonts, audio, video and documents as media", () => {
+    for (const f of ["a.woff", "a.woff2", "a.ttf", "a.eot", "a.otf", "a.pdf",
+      "a.mp3", "a.m4a", "a.wav", "a.flac", "a.mp4", "a.m4v", "a.webm", "a.ogv", "a.ogg", "a.zip"]) {
+      expect(isMedia(f)).toBe(true);
+      expect(isImage(f)).toBe(false);
+    }
+  });
+
+  it("counts both as static assets", () => {
+    expect(isStaticAsset("clip.mp4")).toBe(true);
+    expect(isStaticAsset("Herculanum Regular.ttf")).toBe(true);
+    expect(isStaticAsset("photo.jpg")).toBe(true);
+  });
+
+  it("leaves the processed formats alone", () => {
+    for (const f of ["page.md", "page.mdx", "page.html", "style.css", "script.js", "data.json"]) {
+      expect(isStaticAsset(f)).toBe(false);
+    }
+  });
+
+  it("matches on the extension, not on a name that merely contains one", () => {
+    expect(isStaticAsset("mp4")).toBe(false);
+    expect(isStaticAsset("notes-about-mp4-encoding.md")).toBe(false);
+    expect(isStaticAsset("my.mp4.md")).toBe(false);
+  });
+
+  it("is case insensitive, as filesystems are not", () => {
+    expect(isStaticAsset("CLIP.MP4")).toBe(true);
+    expect(isStaticAsset("Font.TTF")).toBe(true);
+  });
+});

package/src/helper/staticAssets.js

@@ -0,0 +1,31 @@
+/**
+ * What counts as a static asset.
+ *
+ * This list used to be written out separately in serve.js and in
+ * dependencyTracker.js and — fatally — not at all in generate.js, which knew
+ * only about *image* extensions. `ursa serve` therefore served fonts, audio and
+ * video quite happily while `ursa generate` left them out of the build
+ * entirely, so they worked all the way through development and 404'd in
+ * production. One list, in one place, used by both.
+ */
+
+/** Extensions that get preview generation and image transformation. */
+export const IMAGE_EXTENSIONS = /\.(jpg|jpeg|png|gif|webp|svg|ico)$/i;
+
+/**
+ * Everything else copied through untouched: fonts, documents, audio, video.
+ * Deliberately not images, which take a different path, and deliberately not
+ * .css, .js, .html or the document formats, all of which are processed rather
+ * than copied.
+ */
+export const MEDIA_EXTENSIONS = /\.(woff2?|ttf|eot|otf|pdf|mp3|m4a|wav|flac|mp4|m4v|webm|ogv|ogg|zip)$/i;
+
+/** Any file the build should place in the output as-is. */
+export const STATIC_ASSET_EXTENSIONS = new RegExp(
+  `(?:${IMAGE_EXTENSIONS.source})|(?:${MEDIA_EXTENSIONS.source})`,
+  'i'
+);
+
+export const isImage = (filename) => IMAGE_EXTENSIONS.test(filename);
+export const isMedia = (filename) => MEDIA_EXTENSIONS.test(filename);
+export const isStaticAsset = (filename) => STATIC_ASSET_EXTENSIONS.test(filename);

package/src/jobs/generate.js

@@ -5,6 +5,7 @@ import { filterAsync } from "../helper/filterAsync.js";
 import { isDirectory } from "../helper/isDirectory.js";
 import { isFolderHidden, clearConfigCache } from "../helper/folderConfig.js";
 import { isHiddenOrSystemPath } from "../helper/hiddenPaths.js";
+import { IMAGE_EXTENSIONS, isMedia } from "../helper/staticAssets.js";
 import {
   extractMetadata,
   extractRawMetadata,
@@ -449,7 +450,7 @@ export async function generate({
   const copiedCssFiles = new Set();
 
   // Identify all image files from the filtered source list
-  const imageExtensions = /\.(jpg|jpeg|png|gif|webp|svg|ico)/;
+  const imageExtensions = IMAGE_EXTENSIONS;
   let allSourceFilenamesThatAreImages = allSourceFilenames.filter(
     (filename) => filename.match(imageExtensions) && !isHiddenOrSystem(filename)
   );
@@ -1172,11 +1173,23 @@ export async function generate({
     (filename) => filename.match(/\.html$/) && !isHiddenOrSystem(filename)
   );
   
-  const allStaticFiles = allSourceFilenamesThatAreHtml;
+  // Fonts, audio, video, PDFs: copied through untouched. Images are handled
+  // separately above because they also get previews; everything else that is
+  // neither an article nor a stylesheet belongs here. Leaving this out is what
+  // let `ursa serve` and `ursa generate` disagree — serve reads these straight
+  // off disk, so the missing copy step only ever showed up in a built site.
+  const allSourceFilenamesThatAreMedia = allSourceFilenames.filter(
+    (filename) => isMedia(filename) && !isHiddenOrSystem(filename)
+  );
+
+  const allStaticFiles = [...allSourceFilenamesThatAreHtml, ...allSourceFilenamesThatAreMedia];
   const totalStatic = allStaticFiles.length;
   let processedStatic = 0;
   let copiedStatic = 0;
-  progress.log(`Processing ${totalStatic} static HTML files...`);
+  progress.log(
+    `Processing ${totalStatic} static files ` +
+    `(${allSourceFilenamesThatAreHtml.length} HTML, ${allSourceFilenamesThatAreMedia.length} media)...`
+  );
   await processBatched(allStaticFiles, async (file) => {
     try {
       processedStatic++;

package/src/serve.js

@@ -7,6 +7,7 @@ import fs from "fs";
 import { promises } from "fs";
 import { copy as copyDir, outputFile } from "fs-extra";
 import { processImage } from "./helper/imageProcessor.js";
+import { STATIC_ASSET_EXTENSIONS, IMAGE_EXTENSIONS } from "./helper/staticAssets.js";
 import { watchModeCache } from "./helper/build/watchCache.js";
 import { dependencyTracker } from "./helper/dependencyTracker.js";
 import { bundleMetaTemplateAssets, clearMetaBundleCache } from "./helper/assetBundler.js";
@@ -297,10 +298,9 @@ async function copyCssFile(cssPath, sourceDir, outputDir) {
   }
 }
 
-// Static file extensions that should be copied (images, fonts, etc.)
-const STATIC_FILE_EXTENSIONS = /\.(jpg|jpeg|png|gif|webp|svg|ico|woff|woff2|ttf|eot|pdf|mp3|mp4|webm|ogg)$/i;
-// Image extensions that get preview processing
-const IMAGE_EXTENSIONS = /\.(jpg|jpeg|png|gif|webp|svg|ico)$/i;
+// Shared with generate so the two cannot drift apart again — that drift is
+// exactly how fonts and video came to work in dev and 404 in production.
+const STATIC_FILE_EXTENSIONS = STATIC_ASSET_EXTENSIONS;
 
 /**
  * Copy a single static file to the output directory