narrarium-astro-reader 0.1.21 → 0.1.22

package/README.md

@@ -43,6 +43,7 @@ In public mode:
 - secrets stay hidden from the public atlas and nav
 - direct canon pages fall back to teaser or locked views when `known_from` or `reveal_in` say a dossier is not safe yet
 - search, canon popups, and backlinks follow the same thresholds
+- chapter and scene prose should keep canon names as plain text; the reader upgrades visible mentions into canon popups and also rewrites legacy internal canon links at runtime
 
 If you want an author-only or spoiler-friendly deployment, enable full canon mode:
 

package/cli-dist/lib/canon-mentions.d.ts

@@ -0,0 +1,8 @@
+export type CanonMentionEntry = {
+    id: string;
+    href: string;
+};
+export declare function buildCanonHrefIndex(entries: CanonMentionEntry[]): Map<string, string>;
+export declare function resolveCanonEntryIdFromHref(href: string, entries: CanonMentionEntry[]): string | null;
+export declare function normalizeCanonEntityHref(href: string): string | null;
+//# sourceMappingURL=canon-mentions.d.ts.map

package/cli-dist/lib/canon-mentions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canon-mentions.d.ts","sourceRoot":"","sources":["../../src/lib/canon-mentions.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,iBAAiB,GAAG;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,iBAAiB,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAarF;AAED,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,EAAE,GAAG,MAAM,GAAG,IAAI,CAOrG;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAyCpE"}

package/cli-dist/lib/canon-mentions.js

@@ -0,0 +1,86 @@
+export function buildCanonHrefIndex(entries) {
+    const index = new Map();
+    for (const entry of entries) {
+        const normalizedHref = normalizeCanonEntityHref(entry.href);
+        if (!normalizedHref) {
+            continue;
+        }
+        index.set(normalizedHref, entry.id);
+    }
+    return index;
+}
+export function resolveCanonEntryIdFromHref(href, entries) {
+    const normalizedHref = normalizeCanonEntityHref(href);
+    if (!normalizedHref) {
+        return null;
+    }
+    return buildCanonHrefIndex(entries).get(normalizedHref) ?? null;
+}
+export function normalizeCanonEntityHref(href) {
+    const strippedOrigin = href
+        .trim()
+        .replace(/^[a-z]+:\/\/[^/]+/i, "")
+        .split(/[?#]/, 1)[0]
+        .replace(/\\/g, "/");
+    if (!strippedOrigin) {
+        return null;
+    }
+    const segments = strippedOrigin
+        .split("/")
+        .filter(Boolean)
+        .filter((segment) => segment !== "." && segment !== "..");
+    for (let index = 0; index < segments.length; index += 1) {
+        const current = segments[index]?.toLowerCase();
+        if (!current) {
+            continue;
+        }
+        if (current === "timelines" && segments[index + 1]?.toLowerCase() === "events") {
+            const slug = normalizeSlugSegment(segments[index + 2]);
+            if (slug) {
+                return `timeline/${slug}/`;
+            }
+            continue;
+        }
+        const section = normalizeCanonSection(current);
+        if (!section) {
+            continue;
+        }
+        const slug = normalizeSlugSegment(segments[index + 1]);
+        if (slug) {
+            return `${section}/${slug}/`;
+        }
+    }
+    return null;
+}
+function normalizeCanonSection(segment) {
+    switch (segment.toLowerCase()) {
+        case "character":
+        case "characters":
+            return "characters";
+        case "location":
+        case "locations":
+            return "locations";
+        case "faction":
+        case "factions":
+            return "factions";
+        case "item":
+        case "items":
+            return "items";
+        case "secret":
+        case "secrets":
+            return "secrets";
+        case "timeline":
+        case "timeline-event":
+            return "timeline";
+        default:
+            return null;
+    }
+}
+function normalizeSlugSegment(segment) {
+    if (!segment) {
+        return null;
+    }
+    const normalized = segment.replace(/\.md$/i, "").trim().toLowerCase();
+    return /^[a-z0-9-]+$/.test(normalized) ? normalized : null;
+}
+//# sourceMappingURL=canon-mentions.js.map

package/cli-dist/lib/canon-mentions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"canon-mentions.js","sourceRoot":"","sources":["../../src/lib/canon-mentions.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "narrarium-astro-reader",
-  "version": "0.1.21",
+  "version": "0.1.22",
   "type": "module",
   "description": "Astro reader and scaffolding CLI for Narrarium book repositories.",
   "license": "MIT",
@@ -50,7 +50,7 @@
     "test": "npm run build:cli && node --test test/**/*.test.mjs"
   },
   "dependencies": {
-    "narrarium": "^0.1.21",
+    "narrarium": "^0.1.22",
     "astro": "^5.14.1",
     "chokidar": "^4.0.3",
     "marked": "^16.3.0"

package/src/components/ReaderRuntime.astro

@@ -144,7 +144,9 @@ const chaptersJson = JSON.stringify(chapters).replace(/</g, "\\u003c");
 <script type="application/json" id="canon-glossary-data" set:html={glossaryJson}></script>
 <script type="application/json" id="reader-chapter-data" set:html={chaptersJson}></script>
 
-<script is:inline>
+<script>
+  import { buildCanonHrefIndex, normalizeCanonEntityHref } from "../lib/canon-mentions.js";
+
   const themeStorageKey = "narrarium-reader-theme";
   const canonModeStorageKey = "narrarium-reader-canon";
   const progressStorageKey = "narrarium-reader-progress";
@@ -354,6 +356,7 @@ const chaptersJson = JSON.stringify(chapters).replace(/</g, "\\u003c");
     const limit = getSelectedSpoilerLimit();
     const visibleEntries = glossaryEntries.filter((entry) => isEntryVisible(entry, limit));
     const glossaryById = new Map(visibleEntries.map((entry) => [entry.id, entry]));
+    const hrefIndex = buildCanonHrefIndex(visibleEntries);
     const termMap = new Map();
 
     for (const entry of visibleEntries) {
@@ -368,15 +371,15 @@ const chaptersJson = JSON.stringify(chapters).replace(/</g, "\\u003c");
     }
 
     const terms = [...termMap.keys()].sort((left, right) => right.length - left.length);
-    if (terms.length === 0) return;
-
-    const pattern = new RegExp(`(^|[^\\p{L}\\p{N}])(${terms.map(escapeRegex).join("|")})(?=$|[^\\p{L}\\p{N}])`, "giu");
+    const pattern = terms.length > 0
+      ? new RegExp(`(^|[^\\p{L}\\p{N}])(${terms.map(escapeRegex).join("|")})(?=$|[^\\p{L}\\p{N}])`, "giu")
+      : null;
 
-    enhanceCanonRoot(document, pattern, termMap);
-    initializeCanonOverlay(pattern, termMap, glossaryById, limit);
+    enhanceCanonRoot(document, pattern, termMap, hrefIndex);
+    initializeCanonOverlay(pattern, termMap, hrefIndex, glossaryById, limit);
   }
 
-  function enhanceCanonRoot(root, pattern, termMap) {
+  function enhanceCanonRoot(root, pattern, termMap, hrefIndex) {
     const containers = root instanceof Document
       ? root.querySelectorAll(".prose p, .prose li, .prose blockquote")
       : root.matches?.(".prose")
@@ -385,7 +388,11 @@ const chaptersJson = JSON.stringify(chapters).replace(/</g, "\\u003c");
 
     containers.forEach((container) => {
       if (container.dataset.canonEnhanced === "true") return;
+      rewriteLegacyCanonLinks(container, hrefIndex);
       container.dataset.canonEnhanced = "true";
+      if (!pattern) {
+        return;
+      }
       const walker = document.createTreeWalker(container, NodeFilter.SHOW_TEXT);
       const textNodes = [];
       while (walker.nextNode()) {
@@ -430,12 +437,7 @@ const chaptersJson = JSON.stringify(chapters).replace(/</g, "\\u003c");
       }
 
       if (entryId) {
-        const button = document.createElement("button");
-        button.type = "button";
-        button.className = "canon-mention";
-        button.dataset.canonId = entryId;
-        button.textContent = term;
-        fragment.append(button);
+        fragment.append(createCanonMentionButton(entryId, term));
       } else {
         fragment.append(term);
       }
@@ -450,7 +452,33 @@ const chaptersJson = JSON.stringify(chapters).replace(/</g, "\\u003c");
     textNode.replaceWith(fragment);
   }
 
-  function initializeCanonOverlay(pattern, termMap, glossaryById, limit) {
+  function rewriteLegacyCanonLinks(container, hrefIndex) {
+    container.querySelectorAll("a[href]").forEach((anchor) => {
+      if (!(anchor instanceof HTMLAnchorElement) || anchor.closest("[data-no-canon]")) {
+        return;
+      }
+
+      const normalizedHref = normalizeCanonEntityHref(anchor.getAttribute("href") || "");
+      if (!normalizedHref) {
+        return;
+      }
+
+      const label = anchor.textContent || "";
+      const entryId = hrefIndex.get(normalizedHref);
+      anchor.replaceWith(entryId ? createCanonMentionButton(entryId, label) : document.createTextNode(label));
+    });
+  }
+
+  function createCanonMentionButton(entryId, label) {
+    const button = document.createElement("button");
+    button.type = "button";
+    button.className = "canon-mention";
+    button.dataset.canonId = entryId;
+    button.textContent = label;
+    return button;
+  }
+
+  function initializeCanonOverlay(pattern, termMap, hrefIndex, glossaryById, limit) {
     const overlay = document.querySelector("[data-canon-overlay]");
     if (!overlay || overlay.dataset.bound === "true") return;
     overlay.dataset.bound = "true";
@@ -482,7 +510,7 @@ const chaptersJson = JSON.stringify(chapters).replace(/</g, "\\u003c");
         link.href = entry.href;
         link.hidden = !revealed;
         body.innerHTML = revealed ? entry.bodyHtml || "" : "";
-        enhanceCanonRoot(body, pattern, termMap);
+        enhanceCanonRoot(body, pattern, termMap, hrefIndex);
         metadata.replaceChildren(...(entry.metadataEntries || []).map((item) => {
           const row = document.createElement("div");
           row.className = "meta-row";

package/src/lib/canon-mentions.ts

@@ -0,0 +1,105 @@
+export type CanonMentionEntry = {
+  id: string;
+  href: string;
+};
+
+export function buildCanonHrefIndex(entries: CanonMentionEntry[]): Map<string, string> {
+  const index = new Map<string, string>();
+
+  for (const entry of entries) {
+    const normalizedHref = normalizeCanonEntityHref(entry.href);
+    if (!normalizedHref) {
+      continue;
+    }
+
+    index.set(normalizedHref, entry.id);
+  }
+
+  return index;
+}
+
+export function resolveCanonEntryIdFromHref(href: string, entries: CanonMentionEntry[]): string | null {
+  const normalizedHref = normalizeCanonEntityHref(href);
+  if (!normalizedHref) {
+    return null;
+  }
+
+  return buildCanonHrefIndex(entries).get(normalizedHref) ?? null;
+}
+
+export function normalizeCanonEntityHref(href: string): string | null {
+  const strippedOrigin = href
+    .trim()
+    .replace(/^[a-z]+:\/\/[^/]+/i, "")
+    .split(/[?#]/, 1)[0]
+    .replace(/\\/g, "/");
+  if (!strippedOrigin) {
+    return null;
+  }
+
+  const segments = strippedOrigin
+    .split("/")
+    .filter(Boolean)
+    .filter((segment) => segment !== "." && segment !== "..");
+
+  for (let index = 0; index < segments.length; index += 1) {
+    const current = segments[index]?.toLowerCase();
+    if (!current) {
+      continue;
+    }
+
+    if (current === "timelines" && segments[index + 1]?.toLowerCase() === "events") {
+      const slug = normalizeSlugSegment(segments[index + 2]);
+      if (slug) {
+        return `timeline/${slug}/`;
+      }
+      continue;
+    }
+
+    const section = normalizeCanonSection(current);
+    if (!section) {
+      continue;
+    }
+
+    const slug = normalizeSlugSegment(segments[index + 1]);
+    if (slug) {
+      return `${section}/${slug}/`;
+    }
+  }
+
+  return null;
+}
+
+function normalizeCanonSection(segment: string): string | null {
+  switch (segment.toLowerCase()) {
+    case "character":
+    case "characters":
+      return "characters";
+    case "location":
+    case "locations":
+      return "locations";
+    case "faction":
+    case "factions":
+      return "factions";
+    case "item":
+    case "items":
+      return "items";
+    case "secret":
+    case "secrets":
+      return "secrets";
+    case "timeline":
+    case "timeline-event":
+      return "timeline";
+    default:
+      return null;
+  }
+}
+
+function normalizeSlugSegment(segment: string | undefined): string | null {
+  if (!segment) {
+    return null;
+  }
+
+  const normalized = segment.replace(/\.md$/i, "").trim().toLowerCase();
+  return /^[a-z0-9-]+$/.test(normalized) ? normalized : null;
+}