@plebeiantech/lat.md 0.12.3-fork.1 → 0.12.3-fork.10

package/dist/src/view/client/assets/logo-CNF8zs47.svg

@@ -0,0 +1,182 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 73224 16688" fill="#ddd">
+  <defs>
+    <path id="g2588" d="M-20 -512V1576H1253V-512Z"/>
+    <path id="g2591" d="M934 -512V-251H1094V-512ZM298 -512V-251H457V-512ZM616 -147V114H775V-147ZM-20 -147V114H138V-147ZM934 219V480H1094V219ZM298 219V480H457V219ZM616 584V845H775V584ZM-20 584V845H138V584ZM934 950V1211H1094V950ZM298 950V1211H457V950ZM616 1315V1576H775V1315ZM-20 1315V1576H138V1315Z"/>
+  </defs>
+  <use href="#g2591" transform="translate(0,0) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(1356,0) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(2712,0) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(21696,0) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(23052,0) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(24408,0) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(69156,0) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(70512,0) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(71868,0) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(0,2384) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(1356,2384) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(2712,2384) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(21696,2384) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(23052,2384) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(24408,2384) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(69156,2384) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(70512,2384) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(71868,2384) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(0,4768) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(1356,4768) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(2712,4768) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(6780,4768) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(8136,4768) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(9492,4768) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(10848,4768) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(12204,4768) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(13560,4768) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(14916,4768) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(18984,4768) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(20340,4768) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(21696,4768) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(23052,4768) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(24408,4768) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(25764,4768) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(27120,4768) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(37968,4768) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(39324,4768) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(40680,4768) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(42036,4768) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(43392,4768) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(44748,4768) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(46104,4768) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(47460,4768) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(48816,4768) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(50172,4768) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(51528,4768) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(52884,4768) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(54240,4768) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(55596,4768) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(61020,4768) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(62376,4768) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(63732,4768) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(65088,4768) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(66444,4768) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(67800,4768) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(69156,4768) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(70512,4768) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(71868,4768) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(0,7152) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(1356,7152) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(2712,7152) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(13560,7152) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(14916,7152) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(16272,7152) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(21696,7152) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(23052,7152) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(24408,7152) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(37968,7152) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(39324,7152) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(40680,7152) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(46104,7152) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(47460,7152) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(48816,7152) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(54240,7152) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(55596,7152) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(56952,7152) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(59664,7152) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(61020,7152) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(62376,7152) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(69156,7152) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(70512,7152) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(71868,7152) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(0,9536) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(1356,9536) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(2712,9536) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(6780,9536) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(8136,9536) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(9492,9536) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(10848,9536) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(12204,9536) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(13560,9536) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(14916,9536) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(16272,9536) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(21696,9536) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(23052,9536) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(24408,9536) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(37968,9536) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(39324,9536) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(40680,9536) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(46104,9536) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(47460,9536) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(48816,9536) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(54240,9536) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(55596,9536) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(56952,9536) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(59664,9536) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(61020,9536) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(62376,9536) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(69156,9536) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(70512,9536) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(71868,9536) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(0,11920) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(1356,11920) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(2712,11920) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(5424,11920) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(6780,11920) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(8136,11920) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(13560,11920) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(14916,11920) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(16272,11920) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(21696,11920) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(23052,11920) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(24408,11920) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(37968,11920) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(39324,11920) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(40680,11920) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(46104,11920) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(47460,11920) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(48816,11920) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(54240,11920) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(55596,11920) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(56952,11920) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(59664,11920) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(61020,11920) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(62376,11920) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(67800,11920) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(69156,11920) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(70512,11920) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(71868,11920) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(0,14304) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(1356,14304) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(2712,14304) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(6780,14304) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(8136,14304) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(9492,14304) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(10848,14304) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(12204,14304) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(13560,14304) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(14916,14304) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(16272,14304) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(17628,14304) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(23052,14304) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(24408,14304) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(25764,14304) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(27120,14304) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(31188,14304) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(32544,14304) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(33900,14304) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(37968,14304) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(39324,14304) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(40680,14304) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(46104,14304) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(47460,14304) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(48816,14304) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(54240,14304) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(55596,14304) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(56952,14304) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(61020,14304) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(62376,14304) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(63732,14304) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(65088,14304) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(66444,14304) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(67800,14304) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(69156,14304) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(70512,14304) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(71868,14304) scale(1,-1) translate(0,-1901)"/>
+</svg>

package/dist/src/view/client/index.html

@@ -5,8 +5,8 @@
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
     <meta name="color-scheme" content="light dark" />
     <title>lat.md</title>
-    <script type="module" crossorigin src="/assets/index-xm2_px4q.js"></script>
-    <link rel="stylesheet" crossorigin href="/assets/index-B0n0u03y.css">
+    <script type="module" crossorigin src="/assets/index-KWi67IMz.js"></script>
+    <link rel="stylesheet" crossorigin href="/assets/index-C3iaZyYT.css">
   </head>
   <body>
     <div id="root"></div>

package/dist/src/view/git-diff.js

@@ -1,6 +1,8 @@
 import { parse } from '../parser.js';
 const MAX_DIFF_CELLS = 1_000_000;
+const MIN_INLINE_WORD_OVERLAP = 0.6;
 const WORDS = /\s+|[\p{L}\p{N}_]+|[^\s\p{L}\p{N}_]+/gu;
+const WORD_TOKENS = /[\p{L}\p{N}_]+/gu;
 function sequenceDiff(oldValues, newValues, key) {
     const oldKeys = oldValues.map(key);
     const newKeys = newValues.map(key);
@@ -83,6 +85,15 @@ function nodeText(node) {
         return node.value;
     return withChildren(node) ? node.children.map(nodeText).join('') : '';
 }
+function inlineWordOverlap(oldNode, newNode) {
+    const oldWords = nodeText(oldNode).toLowerCase().match(WORD_TOKENS) ?? [];
+    const newWords = nodeText(newNode).toLowerCase().match(WORD_TOKENS) ?? [];
+    if (oldWords.length === 0 || newWords.length === 0) {
+        return oldWords.length === newWords.length ? 1 : 0;
+    }
+    const shared = sequenceDiff(oldWords, newWords, (word) => word).filter((change) => change.kind === 'same').length;
+    return shared / (oldWords.length + newWords.length - shared);
+}
 function wrapperSignature(node) {
     switch (node.type) {
         case 'link':
@@ -166,6 +177,9 @@ function addClass(node, kind) {
         : current
             ? [String(current)]
             : [];
+    if (result.type === 'code' && result.lang) {
+        classes.push(`language-${result.lang}`);
+    }
     classes.push(`git-${kind}`);
     result.data = {
         ...result.data,
@@ -189,6 +203,9 @@ function pairedNode(oldNode, newNode, oldMarkdown, newMarkdown) {
     if ((newNode.type === 'heading' || newNode.type === 'paragraph') &&
         withChildren(oldNode) &&
         withChildren(newNode)) {
+        if (inlineWordOverlap(oldNode, newNode) < MIN_INLINE_WORD_OVERLAP) {
+            return null;
+        }
         return {
             ...structuredClone(newNode),
             children: diffInline(oldNode.children, newNode.children),

package/dist/src/view/graph.d.ts

@@ -0,0 +1,6 @@
+import { type Section } from '../lattice.js';
+import type { ViewDocumentError, ViewGraph } from './protocol.js';
+import type { ViewCodeReferenceFile, ViewParsedMarkdownFile } from './references.js';
+import type { ViewGitSnapshot } from './git.js';
+/** Project the cached view state into stable nodes and weighted relationships. */
+export declare function buildViewGraph(markdownFiles: Iterable<ViewParsedMarkdownFile>, codeFiles: Iterable<ViewCodeReferenceFile>, allSections: Section[], diagnostics: ReadonlyMap<string, readonly ViewDocumentError[]>, git: ViewGitSnapshot, generation: number): ViewGraph;

package/dist/src/view/graph.js

@@ -0,0 +1,176 @@
+import { posix } from 'node:path';
+import { buildFileIndex, buildSectionSlugIndex, flattenSections, resolveRef, } from '../lattice.js';
+import { linkedSection } from './references.js';
+import { viewSourceTarget } from './source-target.js';
+function encodedPath(path) {
+    return path.split('/').map(encodeURIComponent).join('/');
+}
+function documentUrl(path, fragment = '') {
+    return `/docs/${encodedPath(path)}${fragment ? `#${encodeURIComponent(fragment)}` : ''}`;
+}
+function sourceUrl(path, symbol = '', line = 0) {
+    const search = line > 0 ? `?at=${line}` : '';
+    const fragment = symbol ? `#${encodeURIComponent(symbol)}` : '';
+    return `/code/${encodedPath(path)}${search}${fragment}`;
+}
+function pathBreadcrumbs(path) {
+    return path.replace(/\.md$/i, '').split('/');
+}
+function nodeLabelFromPath(path) {
+    return posix.basename(path).replace(/\.md$/i, '');
+}
+/** Project the cached view state into stable nodes and weighted relationships. */
+export function buildViewGraph(markdownFiles, codeFiles, allSections, diagnostics, git, generation) {
+    const files = [...markdownFiles].sort((left, right) => left.path.localeCompare(right.path));
+    const sections = flattenSections(allSections);
+    const sectionIds = new Set(sections.map((section) => section.id.toLowerCase()));
+    const fileIndex = buildFileIndex(allSections);
+    const slugIndex = buildSectionSlugIndex(allSections);
+    const sectionById = new Map(sections.map((section) => [section.id.toLowerCase(), section]));
+    const sectionsByPath = new Map();
+    const documentNodeBySection = new Map();
+    const nodes = new Map();
+    const edges = new Map();
+    const invalidWikiTargets = new Set();
+    for (const [path, errors] of diagnostics) {
+        for (const error of errors) {
+            invalidWikiTargets.add(`${path}\0${error.line}\0${error.target}`);
+        }
+    }
+    const addNode = (node) => {
+        if (!nodes.has(node.id))
+            nodes.set(node.id, node);
+        return node.id;
+    };
+    const addEdge = (from, to, kind) => {
+        if (from === to)
+            return;
+        const key = `${kind}\0${from}\0${to}`;
+        const existing = edges.get(key);
+        if (existing) {
+            existing.weight++;
+            return;
+        }
+        edges.set(key, {
+            id: `edge:${kind}:${from}->${to}`,
+            from,
+            to,
+            kind,
+            weight: 1,
+        });
+    };
+    for (const file of files) {
+        const flat = flattenSections(file.sections);
+        sectionsByPath.set(file.path.toLowerCase(), flat);
+        const root = file.sections[0];
+        const id = `document:${file.path}`;
+        for (const section of flat) {
+            documentNodeBySection.set(section.id.toLowerCase(), id);
+        }
+        const errorCount = diagnostics.get(file.path)?.length ?? 0;
+        addNode({
+            id,
+            kind: 'document',
+            label: root?.heading ?? nodeLabelFromPath(file.path),
+            url: documentUrl(file.path),
+            breadcrumbs: pathBreadcrumbs(file.path),
+            documentPath: file.path,
+            sectionId: root?.id,
+            inDegree: 0,
+            outDegree: 0,
+            ...(git.files.get(file.path)?.status
+                ? { gitStatus: git.files.get(file.path)?.status }
+                : {}),
+            ...(errorCount > 0 ? { errorCount } : {}),
+        });
+    }
+    const documentNodeForSection = (section) => documentNodeBySection.get(section.id.toLowerCase()) ?? null;
+    for (const file of files) {
+        const fileSections = flattenSections(file.sections).sort((left, right) => left.startLine - right.startLine);
+        const containingSection = (line) => fileSections.filter((section) => section.startLine <= line).at(-1) ??
+            file.sections[0];
+        for (const ref of file.wikiRefs) {
+            const sourceSection = sectionById.get(ref.fromSection.toLowerCase());
+            const from = sourceSection ? documentNodeForSection(sourceSection) : null;
+            if (!from)
+                continue;
+            const source = viewSourceTarget(ref.target);
+            if (source) {
+                if (invalidWikiTargets.has(`${file.path}\0${ref.line}\0${ref.target}`)) {
+                    continue;
+                }
+                const sourceId = addNode({
+                    id: `source:${source.path}${source.symbol ? `#${source.symbol}` : ''}`,
+                    kind: 'source',
+                    label: source.symbol || posix.basename(source.path),
+                    url: sourceUrl(source.path, source.symbol),
+                    breadcrumbs: [
+                        ...source.path.split('/'),
+                        ...(source.symbol ? [source.symbol] : []),
+                    ],
+                    sourcePath: source.path,
+                    symbol: source.symbol || undefined,
+                    inDegree: 0,
+                    outDegree: 0,
+                });
+                addEdge(from, sourceId, 'source');
+                continue;
+            }
+            const resolved = resolveRef(ref.target, sectionIds, fileIndex, slugIndex);
+            if (resolved.ambiguous)
+                continue;
+            const target = sectionById.get(resolved.resolved.toLowerCase());
+            const to = target ? documentNodeForSection(target) : null;
+            if (to)
+                addEdge(from, to, 'wiki');
+        }
+        for (const link of file.markdownLinks) {
+            if (link.kind !== 'link')
+                continue;
+            const target = linkedSection(link.url, file.path, sectionsByPath);
+            const source = containingSection(link.line);
+            const from = source ? documentNodeForSection(source) : null;
+            const to = target ? documentNodeForSection(target) : null;
+            if (from && to)
+                addEdge(from, to, 'markdown');
+        }
+    }
+    for (const file of [...codeFiles].sort((left, right) => left.path.localeCompare(right.path))) {
+        for (const ref of [...file.refs].sort((left, right) => left.line - right.line)) {
+            const resolved = resolveRef(ref.target, sectionIds, fileIndex, slugIndex);
+            if (resolved.ambiguous)
+                continue;
+            const target = sectionById.get(resolved.resolved.toLowerCase());
+            const to = target ? documentNodeForSection(target) : null;
+            if (!to)
+                continue;
+            const snippet = file.lines[ref.line - 1]?.trim() ?? '';
+            const from = addNode({
+                id: `code-ref:${file.path}:${ref.line}`,
+                kind: 'code-reference',
+                label: `${posix.basename(file.path)}:${ref.line}`,
+                url: sourceUrl(file.path, '', ref.line),
+                breadcrumbs: [...file.path.split('/'), `line ${ref.line}`],
+                sourcePath: file.path,
+                line: ref.line,
+                snippet,
+                inDegree: 0,
+                outDegree: 0,
+            });
+            addEdge(from, to, 'code-mention');
+        }
+    }
+    for (const edge of edges.values()) {
+        const source = nodes.get(edge.from);
+        const target = nodes.get(edge.to);
+        if (source)
+            source.outDegree += edge.weight;
+        if (target)
+            target.inDegree += edge.weight;
+    }
+    return {
+        generation,
+        nodes: [...nodes.values()].sort((left, right) => left.id.localeCompare(right.id)),
+        edges: [...edges.values()].sort((left, right) => left.id.localeCompare(right.id)),
+    };
+}

package/dist/src/view/markdown.d.ts

@@ -2,7 +2,11 @@ import type { Root } from 'mdast';
 export type WikiLinkContext = {
     line: number;
 };
-export type WikiLinkResolver = (target: string, context: WikiLinkContext) => string | null | Promise<string | null>;
+export type WikiLinkResolution = {
+    href: string;
+    referenceCount: number;
+};
+export type WikiLinkResolver = (target: string, context: WikiLinkContext) => WikiLinkResolution | null | Promise<WikiLinkResolution | null>;
 export type MarkdownRenderOptions = {
     activeMarkdownLink?: string;
     activeWikiLink?: string;

package/dist/src/view/markdown.js

@@ -10,6 +10,7 @@ const CODE_LINK_CLASSES = [
     'wiki-link-code',
     'wiki-link-active',
     'code-link-language',
+    'code-link-leading',
     'code-language-ts',
     'code-language-js',
     'code-language-py',
@@ -18,11 +19,17 @@ const CODE_LINK_CLASSES = [
     'code-language-c',
 ];
 const ERROR_CLASS = 'markdown-error';
+const EXTERNAL_LINK_CLASS = 'external-link';
+const EXTERNAL_LINK_ICON_CLASS = 'external-link-icon';
 const GIT_CLASSES = ['git-added', 'git-removed'];
 function classAttributes(tag) {
+    const attributes = defaultSchema.attributes?.[tag] ?? [];
+    const allowedClasses = attributes.flatMap((attribute) => Array.isArray(attribute) && attribute[0] === 'className'
+        ? attribute.slice(1)
+        : []);
     return [
-        ...(defaultSchema.attributes?.[tag] ?? []),
-        ['className', ERROR_CLASS, ...GIT_CLASSES],
+        ...attributes.filter((attribute) => !(Array.isArray(attribute) && attribute[0] === 'className')),
+        ['className', ...allowedClasses, ERROR_CLASS, ...GIT_CLASSES],
     ];
 }
 const sanitizeSchema = {
@@ -38,6 +45,7 @@ const sanitizeSchema = {
                 'wiki-link-segmented',
                 'wiki-link-code',
                 'wiki-link-active',
+                EXTERNAL_LINK_CLASS,
                 ERROR_CLASS,
                 ...GIT_CLASSES,
             ],
@@ -55,20 +63,25 @@ const sanitizeSchema = {
         img: classAttributes('img'),
         ins: classAttributes('ins'),
         li: classAttributes('li'),
+        ol: classAttributes('ol'),
         p: classAttributes('p'),
         pre: classAttributes('pre'),
         span: [
             ...(defaultSchema.attributes?.span ?? []),
             'ariaHidden',
+            'ariaLabel',
             [
                 'className',
                 'wiki-link-context',
                 'wiki-link-leaf',
+                'wiki-link-ref-count',
+                EXTERNAL_LINK_ICON_CLASS,
                 ...CODE_LINK_CLASSES.slice(2),
                 ERROR_CLASS,
                 ...GIT_CLASSES,
             ],
         ],
+        ul: classAttributes('ul'),
     },
 };
 const htmlProcessor = unified()
@@ -155,6 +168,61 @@ function languageIcon(language) {
         children: [{ type: 'text', value: language.label }],
     };
 }
+function codeLinkContent(language, children) {
+    const [first, ...rest] = children;
+    if (!first)
+        return [languageIcon(language)];
+    let leading = first;
+    let remainder = null;
+    if (first.type === 'text') {
+        const breakAt = first.value.search(/\s/);
+        if (breakAt > 0) {
+            leading = { ...first, value: first.value.slice(0, breakAt) };
+            remainder = { ...first, value: first.value.slice(breakAt) };
+        }
+    }
+    return [
+        {
+            type: 'emphasis',
+            data: {
+                hName: 'span',
+                hProperties: { className: ['code-link-leading'] },
+            },
+            children: [languageIcon(language), leading],
+        },
+        ...(remainder ? [remainder] : []),
+        ...rest,
+    ];
+}
+function externalLinkIcon() {
+    return {
+        type: 'emphasis',
+        data: {
+            hName: 'span',
+            hProperties: {
+                ariaHidden: 'true',
+                className: [EXTERNAL_LINK_ICON_CLASS],
+            },
+        },
+        children: [],
+    };
+}
+function isExternalSiteUrl(url) {
+    return /^(?:https?:)?\/\//i.test(url);
+}
+function referenceCountBadge(count) {
+    return {
+        type: 'emphasis',
+        data: {
+            hName: 'span',
+            hProperties: {
+                className: ['wiki-link-ref-count'],
+                ariaLabel: `${count} ${count === 1 ? 'reference' : 'references'}`,
+            },
+        },
+        children: [{ type: 'text', value: String(count) }],
+    };
+}
 function targetMatches(node, target) {
     if (node.type === 'wikiLink') {
         return node.value.toLowerCase() === target.toLowerCase();
@@ -229,24 +297,39 @@ export async function renderMarkdown(markdown, filePath, resolveWikiLink, option
     tree.children = tree.children.filter((node) => node.type !== 'yaml');
     if (options.errors)
         markMarkdownErrors(tree, options.errors);
-    if (options.rewriteMarkdownLink || options.activeMarkdownLink) {
-        visit(tree, 'link', (node) => {
-            const authoredUrl = node.url;
-            if (options.activeMarkdownLink &&
-                authoredUrl === options.activeMarkdownLink) {
-                node.data = {
-                    ...node.data,
-                    hProperties: {
-                        ...(node.data?.hProperties ?? {}),
-                        className: ['wiki-link-active'],
-                    },
-                };
-            }
-            if (options.rewriteMarkdownLink) {
-                node.url = options.rewriteMarkdownLink(authoredUrl);
-            }
-        });
-    }
+    visit(tree, 'link', (node) => {
+        const authoredUrl = node.url;
+        if (options.activeMarkdownLink &&
+            authoredUrl === options.activeMarkdownLink) {
+            node.data = {
+                ...node.data,
+                hProperties: {
+                    ...(node.data?.hProperties ?? {}),
+                    className: ['wiki-link-active'],
+                },
+            };
+        }
+        if (options.rewriteMarkdownLink) {
+            node.url = options.rewriteMarkdownLink(authoredUrl);
+        }
+        if (!isExternalSiteUrl(node.url))
+            return;
+        const properties = node.data?.hProperties ?? {};
+        const currentClasses = properties.className;
+        const classes = Array.isArray(currentClasses)
+            ? currentClasses.map(String)
+            : currentClasses
+                ? [String(currentClasses)]
+                : [];
+        node.data = {
+            ...node.data,
+            hProperties: {
+                ...properties,
+                className: [...classes, EXTERNAL_LINK_CLASS],
+            },
+        };
+        node.children.push(externalLinkIcon());
+    });
     const firstHeading = tree.children.find((node) => node.type === 'heading');
     const title = firstHeading
         ? nodeText(firstHeading)
@@ -266,9 +349,10 @@ export async function renderMarkdown(markdown, filePath, resolveWikiLink, option
     visit(tree, 'wikiLink', (node, index, parent) => {
         if (index === undefined || !parent || !('children' in parent))
             return;
-        const href = resolvedLinks.get(node);
+        const resolution = resolvedLinks.get(node);
         const markedProperties = node.data?.hProperties;
-        if (href) {
+        if (resolution) {
+            const { href, referenceCount } = resolution;
             const content = wikiLinkContent(node);
             const language = href.startsWith('/code/')
                 ? codeLanguage(node.value)
@@ -296,9 +380,12 @@ export async function renderMarkdown(markdown, filePath, resolveWikiLink, option
                         },
                     }
                     : undefined,
-                children: language
-                    ? [languageIcon(language), ...content.children]
-                    : content.children,
+                children: [
+                    ...(language
+                        ? codeLinkContent(language, content.children)
+                        : content.children),
+                    ...(referenceCount > 1 ? [referenceCountBadge(referenceCount)] : []),
+                ],
             };
             return;
         }