@kenjura/ursa 0.83.0 → 0.85.0

package/CHANGELOG.md

@@ -1,3 +1,7 @@
+# 0.84.0
+2026-05-08
+
+- Unified sticky headers are now standard
 
 # 0.83.0
 2026-05-07

package/meta/templates/default-template/default.css

@@ -50,6 +50,21 @@ h1 {
   text-overflow: ellipsis;
 }
 
+figure {
+  margin: 0.5rem 0;
+  padding: 0;
+  max-width: 300px;
+  float: left;
+  margin-right: 1.5rem;
+  margin-bottom: 0.5rem;
+
+  &:nth-of-type(even) {
+    float: right;
+    margin-left: 1.5rem;
+    margin-right: 0;
+  }
+}
+
 nav#nav-global {
   background-color: var(--nav-top-bg);
   height: var(--global-nav-height);
@@ -1264,4 +1279,40 @@ footer#site-footer {
     -webkit-text-size-adjust: 100%;
     text-size-adjust: 100%;
   }
+}
+
+
+/* sticky unified header */
+article#main-content {
+  h1, h2, h3 {
+    position: sticky;
+    z-index: 90;
+    margin: 0;
+
+    &.stuck {
+      background: var(--nav-top-bg);
+    }
+  }
+  h1 {
+    top: var(--global-nav-height);
+    height: 3rem;
+    line-height: 3rem;
+  }
+  h2 {
+    top: calc(var(--global-nav-height) + 3rem);
+    height: 2.25rem;
+    line-height: 2.25rem;
+  }
+  h3 {
+    top: calc(var(--global-nav-height) + 5.25rem);
+    height: 1.75rem;
+    line-height: 1.75rem;
+  }
+
+  /* Hide stuck h2/h3 — the breadcrumb on the stuck h1 carries their text.
+     Use visibility (not max-height/display) to preserve layout and avoid
+     the flicker loop where collapsing the heading un-sticks it. */
+  h2.stuck, h3.stuck {
+    visibility: hidden;
+  }
 }

package/package.json

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

package/src/dev.js

@@ -569,10 +569,12 @@ async function wrapInTemplate(body, title, fileMeta, urlPath, sourcePath, hydrat
   // Resolve relative URLs
   finalHtml = resolveRelativeUrls(finalHtml, docUrlPath);
   
-  // Mark inactive links (only if validPaths is ready)
-  if (validPaths) {
-    finalHtml = markInactiveLinks(finalHtml, validPaths, docUrlPath, false);
-  }
+  // Mark inactive links + rewrite .md/.mdx → .html. We always run this even
+  // before validPaths is ready, because the optimistic .md→.html conversion
+  // inside resolveHref does not require validPaths. Without this, links to
+  // markdown files served before background caches finish would not be
+  // rewritten and the browser would request the source .md file directly.
+  finalHtml = markInactiveLinks(finalHtml, validPaths || new Map(), docUrlPath, false);
   
   return finalHtml;
 }

package/src/helper/mdxRenderer.js

@@ -12,6 +12,25 @@ import remarkSupersub from "remark-supersub";
 import remarkGfm from "remark-gfm";
 import { visit } from "unist-util-visit";
 
+/**
+ * remark-definition-list only registers the `:` (charcode 58) marker, but
+ * PHP Markdown Extra (and markdown-it-deflist) also support `~` (charcode 126).
+ * This sibling plugin must run AFTER remarkDefinitionList; it locates the
+ * already-registered defList construct and re-registers it under `~` so that
+ * .mdx files have parity with .md files.
+ */
+function remarkDefinitionListTildeMarker() {
+  const data = this.data();
+  const micromarkExtensions = data.micromarkExtensions ?? (data.micromarkExtensions = []);
+  for (const ext of micromarkExtensions) {
+    const construct = ext?.document?.[58];
+    if (construct) {
+      micromarkExtensions.push({ document: { 126: construct } });
+      return;
+    }
+  }
+}
+
 /**
  * Custom remark plugin that converts container directives (:::name ... :::)
  * into <aside> HTML elements, matching the markdown-it-container behavior
@@ -122,6 +141,7 @@ export async function renderMDX({ source, filePath, sourceRoot, hydrate = false
       remarkDirective,
       remarkAsideContainers,
       remarkDefinitionList,
+      remarkDefinitionListTildeMarker,
       remarkSupersub,
     ];
     // remark-definition-list needs custom handlers for remark-rehype conversion