@c4a/context-cli 0.7.62 → 0.7.64

package/cli.js

@@ -32174,6 +32174,7 @@ var init_packageSite = __esm(() => {
   packageSiteNavLinkSchema = exports_external.object({
     text: exports_external.string().trim().min(1),
     link: siteHrefSchema,
+    position: exports_external.enum(["start", "end"]).optional(),
     locales: localizedTextSchema.optional()
   }).strict();
   packageSiteMoreItemSchema = exports_external.object({
@@ -87601,6 +87602,17 @@ var init_packageSiteTheme = __esm(() => {
       return true;
     }, { alt: ['paragraph'] });
     md.renderer.rules.context_anchor = (tokens, index) => '<a id="' + md.utils.escapeHtml(tokens[index].content) + '"></a>\n';
+    // Only the compiler writes section landing pages; accept exactly its card wrappers there.
+    const sectionWrappers = new Set(['<div class="context-section-grid">', '<div class="context-section-card">', '</div>']);
+    md.block.ruler.before('paragraph', 'context_section_card', (state, line, end, silent) => {
+      if (!/(?:^|\/)sections\/[0-9a-f]+\.md$/.test(state.env.relativePath || '')) return false;
+      const raw = state.src.slice(state.bMarks[line] + state.tShift[line], state.eMarks[line]);
+      if (!sectionWrappers.has(raw)) return false;
+      if (!silent) { const token = state.push('context_section_card', '', 0); token.content = raw; }
+      state.line = line + 1;
+      return true;
+    }, { alt: ['paragraph'] });
+    md.renderer.rules.context_section_card = (tokens, index) => tokens[index].content + '\n';
     // The generated website config declares contextLocaleMarker; null when the site has no translations.
     const contextLocale = typeof contextLocaleMarker === 'string' ? contextLocaleMarker : null;
     md.block.ruler.before('paragraph', 'context_locale', (state, line, end, silent) => {
@@ -87738,8 +87750,11 @@ export default {
             tags.map(tag => h('span', { 'data-context-locales': tag, lang: next(tag) }, shortLabel(next(tag))))),
         ]);
       };
+      // Origin links become absolute URLs, which VitePress never marks active.
       const navLink = item => ({ text: item.text,
-        ...(item.origin ? { link: mounted.value ? window.location.origin + item.link : item.link, target: '_self', noIcon: true } : { link: item.link }) });
+        ...(item.origin ? { link: mounted.value ? window.location.origin + item.link : item.link, target: '_self', noIcon: true,
+          activeMatch: [item.link, item.link + 'index.html'].includes(route.path) ||
+            (inHome.value && item.link === data.site.value.base) ? '^' : '(?!)' } : { link: item.link }) });
       const href = value => value.startsWith('/') ? data.site.value.base + value.slice(1) : value;
       const external = value => /^https?:\/\//.test(value) || value.startsWith('mailto:');
       const copyCommand = async value => {
@@ -87827,10 +87842,13 @@ export default {
         return part('year') + '-' + part('month') + '-' + part('day') + ' ' +
           part('hour') + ':' + part('minute') + ':' + part('second') + ' ' + part('timeZoneName');
       });
+      const sitePath = () => {
+        const base = data.site.value.base;
+        return route.path.startsWith(base) ? '/' + route.path.slice(base.length) : route.path;
+      };
       watch(() => route.path, () => {
         allSources.value = false;
-        const base = data.site.value.base;
-        const path = route.path.startsWith(base) ? '/' + route.path.slice(base.length) : route.path;
+        const path = sitePath();
         const direct = sections.value.find(section => section.href === path);
         const current = sections.value.find(section => section.key === selected.value);
         selected.value = (direct || (current?.pages.includes(path) ? current :
@@ -87840,6 +87858,12 @@ export default {
       const inLlms = computed(() => route.path.startsWith(data.site.value.base + 'llms/'));
       const inHistory = computed(() => route.path === data.site.value.base + 'changelog.html');
       const inHome = computed(() => data.frontmatter.value.layout === 'home');
+      // Articles outside the knowledge map, such as More menu targets, belong to no section.
+      const inMore = computed(() => (data.theme.value.contextMore || []).some(item => !item.origin && item.link === sitePath()));
+      const outsideSections = computed(() => inLlms.value || inHistory.value || inMore.value || (!inHome.value &&
+        !sections.value.some(section => section.href === sitePath() || section.pages.includes(sitePath()))));
+      const userNav = position => (data.theme.value.contextNav || [])
+        .filter(item => (item.position === 'start') === (position === 'start')).map(navLink);
       // Descendants, including site extensions, read the reader language as lang.
       // The frontmatter carries it too so the content refreshes its outline on a switch.
       provide(dataSymbol, { ...data, lang: computed(() => locale.value), frontmatter: computed(() => {
@@ -87848,15 +87872,15 @@ export default {
         return { ...value, contextLocale: locale.value, ...(actions ? { hero: { ...value.hero, actions } } : {}) };
       }), theme: computed(() => ({ ...data.theme.value,
         ...data.theme.value.contextUiLabels?.[chinese.value ? 'zh' : 'en'],
-        sidebar: inLlms.value || inHistory.value ? [] : active.value?.items || [],
-        nav: [...sections.value.map(section => ({ text: section.label, link: section.href,
-          activeMatch: !inLlms.value && !inHistory.value && section.key === selected.value ? '^' : '(?!)' })),
-          ...(data.theme.value.contextNav || []).map(navLink),
+        sidebar: outsideSections.value ? [] : active.value?.items || [],
+        nav: [...userNav('start'), ...sections.value.map(section => ({ text: section.label, link: section.href,
+          activeMatch: !inHome.value && !outsideSections.value && section.key === selected.value ? '^' : '(?!)' })),
+          ...userNav('end'),
           { text: bothHtml('更多', 'More'), items: [
             ...(data.theme.value.contextMore || []).map(navLink),
             { text: 'LLM Docs', link: '/llms/index.html' },
             { text: 'Changelog', link: '/changelog.html' }],
-            activeMatch: inLlms.value || inHistory.value ? '^' : '(?!)' }],
+            activeMatch: inLlms.value || inHistory.value || inMore.value ? '^' : '(?!)' }],
       })) });
       const slots = {
         'nav-bar-title-before': () => extensions.brand ? h('span', { class: 'context-brand' }, custom('brand')) : null,
@@ -87924,7 +87948,7 @@ export default {
       };
       // History belongs between the page heading and footer metadata.
       return () => h(DefaultTheme.Layout, { class: inHome.value ? 'context-home' : data.page.value.isNotFound ? 'context-missing' :
-        inLlms.value || inHistory.value ? 'context-empty-sidebar' : undefined }, { ...slots, 'doc-after': undefined,
+        outsideSections.value ? 'context-empty-sidebar' : undefined }, { ...slots, 'doc-after': undefined,
         'doc-footer-before': () => [slots['doc-after'](), slots['doc-footer-before']()] });
     }
   },
@@ -87948,14 +87972,20 @@ export default {
 `;
   siteThemeCss = `
 .context-business-floating { position: fixed; right: max(20px, env(safe-area-inset-right)); bottom: max(20px, env(safe-area-inset-bottom)); z-index: 30; max-width: calc(100vw - 40px); }
-.context-history-cards { display: grid; gap: 16px; margin: 24px 0; }
-.context-history-card { border: 1px solid var(--vp-c-divider); border-radius: 12px; background: var(--vp-c-bg-soft); }
-.context-history-card summary { display: flex; align-items: baseline; flex-wrap: wrap; gap: 12px; padding: 20px; cursor: pointer; }
+.context-history-cards { display: grid; grid-template-columns: minmax(0, 1fr); gap: 16px; margin: 24px 0; }
+.context-history-card { min-width: 0; border: 1px solid var(--vp-c-divider); border-radius: 12px; background: var(--vp-c-bg-soft); }
+.context-history-card summary { display: flex; align-items: baseline; gap: 12px; padding: 20px; cursor: pointer; }
 .context-history-card summary::before { content: '▸'; }
 .context-history-card[open] summary::before { content: '▾'; }
 .context-history-card summary strong { color: var(--vp-c-brand-1); font-size: 13px; }
-.context-history-title { font-size: 16px; font-weight: 600; overflow-wrap: anywhere; }
-.context-history-attribution { margin-left: auto; font-size: 13px; color: var(--vp-c-text-2); }
+.context-history-card summary strong, .context-history-card summary::before { flex-shrink: 0; }
+.context-history-title { flex: 1; min-width: 0; font-size: 16px; font-weight: 600; white-space: nowrap; overflow: hidden; text-overflow: ellipsis; }
+.context-history-card[open] .context-history-title { white-space: normal; overflow-wrap: anywhere; }
+.context-history-attribution { flex-shrink: 0; margin-left: auto; font-size: 13px; color: var(--vp-c-text-2); white-space: nowrap; }
+@media (max-width: 639px) {
+  .context-history-card summary { flex-wrap: wrap; }
+  .context-history-attribution { flex-basis: 100%; text-align: right; }
+}
 .context-history-body { padding: 0 24px 20px; font-size: 13px; line-height: 1.8; overflow-wrap: anywhere; }
 .context-history-body ul { list-style: disc; padding-left: 20px; }
 .context-history-meta { margin-top: 16px; padding-top: 12px; border-top: 1px solid var(--vp-c-divider); color: var(--vp-c-text-2); }
@@ -88203,6 +88233,19 @@ ${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; }
+/* 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;
+  background: color-mix(in srgb, var(--vp-c-bg) 88%, var(--vp-c-bg-soft)); }
+.vp-doc .context-section-card:hover { border-color: color-mix(in srgb, var(--vp-c-brand-1) 42%, var(--vp-c-divider)); }
+.vp-doc .context-section-card h2 { margin: 0 0 10px; padding: 0 0 10px; border-top: 0; border-bottom: 1px solid var(--vp-c-divider); font-size: 17px; line-height: 1.45; letter-spacing: 0; }
+.vp-doc .context-section-card h2 a { color: var(--vp-c-text-1); text-decoration: none; }
+.vp-doc .context-section-card > ul { margin: 0; padding: 0; list-style: none; }
+.vp-doc .context-section-card li { margin: 6px 0; font-size: 14px; line-height: 1.55; }
+.vp-doc .context-section-card li a { color: var(--vp-c-text-2); text-decoration: none; }
+.vp-doc .context-section-card li a:hover { color: var(--vp-c-brand-1); }
+.vp-doc .context-section-card ul ul { margin: 4px 0 8px; padding-left: 14px; border-left: 1px solid var(--vp-c-divider); list-style: none; }
+@media (max-width: 719px) { .context-section-grid { grid-template-columns: 1fr; } }
 ${DIAGRAM_STYLES}
 `;
 });
@@ -89647,6 +89690,7 @@ function siteNavigationConfig(site, pages) {
     text: item.text,
     link: item.link,
     ...item.link.startsWith("/") ? { origin: true } : {},
+    ...item.position === "start" ? { position: "start" } : {},
     ...item.locales ? { locales: item.locales } : {}
   }));
   return { nav, more };
@@ -89662,7 +89706,7 @@ function restoreOriginNavLinks(html, base, links) {
     const link = href === undefined ? undefined : prefixedHref.get(href);
     if (link === undefined)
       return tag;
-    return tag.replace(` href="${href}"`, ` href="${link}"`).replace(/\sclass="([^"]*)"/u, (_, classes) => ` class="${classes.split(/\s+/u).filter((name3) => name3 !== "active").join(" ")}"`);
+    return tag.replace(` href="${href}"`, ` href="${link}"`);
   });
 }
 function translatedMarkdown(content3, from, pages, resources) {
@@ -90117,11 +90161,28 @@ ${localized.body}`);
       lines.push(`${"  ".repeat(level)}- ${entry.href ? `[${title}](${entry.href})` : title}`);
       menu(lines, entry.children, level + 1, tag);
     });
+    const card = (lines, heading, entries2, tag) => {
+      lines.push('<div class="context-section-card">', "");
+      if (heading !== undefined)
+        lines.push(`## ${heading}`, "");
+      menu(lines, entries2, 0, tag);
+      lines.push("", "</div>", "");
+    };
     await mkdir28(join75(temporary, "sections"), { recursive: true });
     for (const section of sections) {
       await writeFile23(join75(temporary, section.href.slice(1).replace(/\.html$/u, ".md")), localizer.variants((tag) => {
-        const lines = [`# ${mdLabel(localizer.entryTitle(tag, section.entry))}`, ""];
-        menu(lines, section.entries, 0, tag);
+        const lines = [`# ${mdLabel(localizer.entryTitle(tag, section.entry))}`, "", '<div class="context-section-grid">', ""];
+        const groups = section.entries.filter((entry) => entry.children.length > 0);
+        const articles = section.entries.filter((entry) => entry.children.length === 0);
+        for (const group of groups) {
+          card(lines, group.href ? `[${mdLabel(localizer.entryTitle(tag, group))}](${group.href})` : mdLabel(localizer.entryTitle(tag, group)), group.children, tag);
+        }
+        if (groups.length === 0)
+          for (const article of articles)
+            card(lines, undefined, [article], tag);
+        else if (articles.length)
+          card(lines, undefined, articles, tag);
+        lines.push("</div>");
         return lines.join(`
 `) + `
 `;