@c4a/context-cli 0.7.64 → 0.7.66

package/cli.js

@@ -87071,6 +87071,50 @@ function siteArticleSources(article, registry2, repositoryRemote) {
   }
   return [...new Map(sources.map((source2) => [JSON.stringify(source2), source2])).values()];
 }
+function siteSourceLinks(article, registry2, repositoryRemote) {
+  const candidates = new Map;
+  const names = new Map;
+  const add = (map2, key, url) => map2.set(key, (map2.get(key) ?? new Set).add(url));
+  for (const reference2 of article?.sections.flatMap((section) => section.references) ?? []) {
+    const ref2 = reference2.source_ref;
+    const local = parseRepoContentRef(ref2);
+    const repo = local ? undefined : registry2.repos.find((entry) => ref2 === `repo:${entry.id}` || ref2 === `repo:${entry.name}`);
+    const prefix = repo?.subpath?.replace(/^\/+|\/+$/gu, "") ?? "";
+    const base = repo && repoUrl(repo.remote);
+    const target = (path3, directory) => local ? local.worktree ? undefined : repoContentWebUrl(repositoryRemote, local.commit, path3, directory) : base ? `${base}/${directory ? "tree" : "blob"}/${encodeURIComponent(repo.ref)}/${encodedPath(path3)}` : undefined;
+    const path2 = reference2.locator.path;
+    const parts = path2.split("/");
+    if (!local && !repo || path2.startsWith("/") || parts.some((part) => !part || part === "." || part === ".."))
+      continue;
+    for (const written of new Set([path2, prefix ? `${prefix}/${path2}` : path2])) {
+      const segments = written.split("/");
+      for (let depth = segments.length;depth >= 1; depth--) {
+        const spelled = segments.slice(0, depth).join("/");
+        const full = prefix && !written.startsWith(`${prefix}/`) ? `${prefix}/${spelled}` : spelled;
+        const directory = depth < segments.length;
+        const url = target(local ? spelled : full, directory);
+        if (!url)
+          break;
+        if (!directory)
+          add(candidates, spelled, url);
+        else if (depth >= 2) {
+          add(candidates, spelled, url);
+          add(candidates, `${spelled}/`, url);
+        }
+        const name3 = segments[depth - 1];
+        if (directory && /[._-]/u.test(name3))
+          add(names, name3, url);
+      }
+    }
+  }
+  const links = {};
+  for (const map2 of [names, candidates]) {
+    for (const [key, urls] of map2)
+      if (urls.size === 1)
+        links[key] = [...urls][0];
+  }
+  return links;
+}
 var encodedPath = (value) => value.split("/").map(encodeURIComponent).join("/");
 var init_packageSiteSources = __esm(() => {
   init_src2();
@@ -87593,6 +87637,29 @@ var init_packageSiteTheme = __esm(() => {
       const render = md.renderer.rules[name];
       if (render) md.renderer.rules[name] = (...args) => render(...args).replace(/\{/g, '&#123;');
     }
+    // The compiler lists contextSourceLinks only from the page's recorded references.
+    // Headings stay unlinked because their text also feeds the outline links.
+    md.core.ruler.push('context_source_links', state => {
+      const links = state.env.frontmatter && state.env.frontmatter.contextSourceLinks;
+      if (!links || typeof links !== 'object') return;
+      state.tokens.forEach((block, position) => {
+        if (block.type !== 'inline' || !block.children || state.tokens[position - 1]?.type === 'heading_open') return;
+        const children = [];
+        let depth = 0;
+        for (const token of block.children) {
+          if (token.type === 'link_open') depth++;
+          if (token.type === 'link_close') depth--;
+          const href = token.type === 'code_inline' && depth === 0 && Object.hasOwn(links, token.content) ? links[token.content] : null;
+          if (typeof href !== 'string' || !/^https?:\/\//.test(href)) { children.push(token); continue; }
+          const open = new state.Token('html_inline', '', 0);
+          open.content = '<a class="context-source-link" href="' + md.utils.escapeHtml(href) + '" target="_blank" rel="noopener noreferrer">';
+          const close = new state.Token('html_inline', '', 0);
+          close.content = '</a>';
+          children.push(open, token, close);
+        }
+        block.children = children;
+      });
+    });
     md.block.ruler.before('paragraph', 'context_anchor', (state, line, end, silent) => {
       const raw = state.src.slice(state.bMarks[line] + state.tShift[line], state.eMarks[line]);
       const match = /^<a id="(section-[a-zA-Z0-9_%.-]+)"><\/a>$/.exec(raw);
@@ -87642,7 +87709,7 @@ import DefaultTheme from 'vitepress/theme-without-fonts';
 import { useData, useRoute, dataSymbol, onContentUpdated, getScrollOffset } from 'vitepress';
 import { onMounted, onUnmounted, nextTick, watch, computed, ref, provide, h } from 'vue';
 import './style.css';
-import extensions from './extensions.js';
+import extensions, { preloadExtensions } from './extensions.js';
 export default {
   extends: DefaultTheme,
   Layout: {
@@ -87829,7 +87896,10 @@ export default {
       // components that read isDark are mounted again for readers starting dark.
       const startedDark = ref(false);
       const custom = name => extensions[name]({ key: startedDark.value ? 'client' : 'prerender' });
-      onMounted(() => { mounted.value = true; startedDark.value = data.isDark.value; });
+      onMounted(() => {
+        mounted.value = true;
+        if (data.isDark.value) preloadExtensions().catch(() => {}).then(() => { startedDark.value = true; });
+      });
       const updatedLabel = computed(() => {
         const value = data.frontmatter.value.contextUpdated || data.theme.value.contextUpdated;
         if (!value) return '';
@@ -88233,6 +88303,12 @@ ${readerContentStyles(".vp-doc")}
 .context-sources li + li { margin-top: 6px; }
 .context-sources a { color: inherit; text-decoration: none; border-bottom: 1px solid transparent; }
 .context-sources a:hover { color: var(--vp-c-brand-1); border-color: currentColor; }
+.vp-doc a.context-source-link { font-weight: inherit; border-bottom: 0; }
+.vp-doc a.context-source-link::before { content: ""; display: inline-block; width: .85em; height: .85em; margin-right: .25em; vertical-align: -.1em; background: currentColor; opacity: .55; -webkit-mask: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24' fill='none' stroke='black' stroke-width='2' stroke-linecap='round' stroke-linejoin='round'%3E%3Cpath d='M10 13a5 5 0 0 0 7.54.54l3-3a5 5 0 0 0-7.07-7.07l-1.72 1.71'/%3E%3Cpath d='M14 11a5 5 0 0 0-7.54-.54l-3 3a5 5 0 0 0 7.07 7.07l1.71-1.71'/%3E%3C/svg%3E") center / contain no-repeat; mask: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24' fill='none' stroke='black' stroke-width='2' stroke-linecap='round' stroke-linejoin='round'%3E%3Cpath d='M10 13a5 5 0 0 0 7.54.54l3-3a5 5 0 0 0-7.07-7.07l-1.72 1.71'/%3E%3Cpath d='M14 11a5 5 0 0 0-7.54-.54l-3 3a5 5 0 0 0 7.07 7.07l1.71-1.71'/%3E%3C/svg%3E") center / contain no-repeat; transition: opacity .15s; }
+.vp-doc a.context-source-link > code { border-bottom: 1px dotted color-mix(in srgb, var(--vp-c-text-1) 55%, transparent); transition: color .15s, border-color .15s; }
+.vp-doc td a.context-source-link { white-space: nowrap; }
+.vp-doc a.context-source-link:hover::before { opacity: 1; }
+.vp-doc a.context-source-link:hover > code { color: var(--vp-c-brand-1); border-bottom-style: solid; border-bottom-color: currentColor; }
 /* Section landing pages: two cards per row, one on narrow screens. */
 .context-section-grid { display: grid; grid-template-columns: repeat(2, minmax(0, 1fr)); gap: 14px; margin-top: 24px; }
 .vp-doc .context-section-card { min-width: 0; padding: 18px 20px; border: 1px solid var(--vp-c-divider); border-radius: 12px;
@@ -88357,6 +88433,7 @@ async function writeSiteExtensions(projectRoot, temporary, extensions) {
   }
   const imports = ["import { h, defineAsyncComponent, resolveComponent } from 'vue';"];
   const slots = [];
+  const remounted = [];
   for (const [name3, path2] of Object.entries(extensions?.slots ?? {})) {
     if (path2 === undefined)
       continue;
@@ -88365,11 +88442,15 @@ async function writeSiteExtensions(projectRoot, temporary, extensions) {
       continue;
     }
     imports.push(`const ${name3} = defineAsyncComponent(() => import(${JSON.stringify(`../../_site/${path2}`)}));`);
+    if (name3 !== "floating")
+      remounted.push(name3);
     slots.push(`${JSON.stringify(name3)}: ${name3 === "floating" ? `() => h(resolveComponent('ClientOnly'), null, { default: () => h(${name3}) })` : `props => h(${name3}, props)`}`);
   }
+  const preload = `export const preloadExtensions = () => Promise.all([${remounted.map((name3) => `${name3}.__asyncLoader()`).join(",")}]);`;
   await writeFile20(join70(temporary, ".vitepress/theme/extensions.js"), imports.join(`
 `) + `
 export default {${slots.join(",")}};
+${preload}
 `);
   for (const [key, path2] of Object.entries(extensions?.pages ?? {})) {
     await mkdir25(join70(temporary, "custom"), { recursive: true });
@@ -90080,13 +90161,15 @@ async function writePackageSite(input) {
     const pageFrontmatter = (page, content3, titles) => {
       const original = sourceContent.get(page.package_path);
       const sources = siteArticleSources(original?.article, registry2, repositoryRemote);
+      const sourceLinks = siteSourceLinks(original?.article, registry2, repositoryRemote);
       const timestamp = parseKnowledgeFrontmatter(original?.content ?? content3).timestamp;
       const updated = typeof timestamp === "string" && Number.isFinite(Date.parse(timestamp)) ? new Date(timestamp).toISOString() : null;
       return `---
 title: ${JSON.stringify(page.title)}
 ${titles ? `contextTitles: ${JSON.stringify(titles)}
 ` : ""}` + `contextSources: ${JSON.stringify(sources)}
-contextUpdated: ${JSON.stringify(updated)}
+` + `${Object.keys(sourceLinks).length ? `contextSourceLinks: ${JSON.stringify(sourceLinks)}
+` : ""}contextUpdated: ${JSON.stringify(updated)}
 ---
 `;
     };