@lupinum/ginko-docs 0.4.0 → 0.5.0

package/dist/icons.mjs

@@ -0,0 +1,175 @@
+import { existsSync, readdirSync, statSync, readFileSync } from 'node:fs';
+import { createRequire } from 'node:module';
+import { join, relative, resolve, extname } from 'node:path';
+import { defineNuxtModule, createResolver, useLogger, addComponent, addTemplate, addTypeTemplate, updateTemplates } from '@nuxt/kit';
+import { getIconData, iconToSVG } from '@iconify/utils';
+
+const SKIP_DIRS = /* @__PURE__ */ new Set(["node_modules", ".git", ".nuxt", ".output", "dist"]);
+const walk = (dir, extensions, out = []) => {
+  if (!existsSync(dir)) return out;
+  for (const name of readdirSync(dir)) {
+    if (SKIP_DIRS.has(name) || name.startsWith(".")) continue;
+    const path = join(dir, name);
+    if (statSync(path).isDirectory()) walk(path, extensions, out);
+    else if (extensions.includes(extname(name))) out.push(path);
+  }
+  return out;
+};
+const OWN_NAME = /['"`]((?:lucide|docs):[a-z0-9]+(?:-[a-z0-9]+)*)['"`]/g;
+const NAME = "[a-z0-9]+(?:-[a-z0-9]+)*(?::[a-z0-9]+(?:-[a-z0-9]+)*)?";
+const QUOTED_NAME = new RegExp(`\\bicon\\??\\s*:\\s*['"](${NAME})['"]`, "g");
+const YAML_NAME = new RegExp(`\\bicon["']?\\s*:\\s*["']?(${NAME})["']?(?=\\s|$|,|\\}|\\))`, "gm");
+const ATTR_NAME = new RegExp(`(?<![\\w-])(?::icon=["']['"]|(?<!:)icon=["'])(${NAME})["']`, "g");
+const ICON_TAG = new RegExp(`<Icon\\b[^>]*?\\s(?::name=["']['"]|name=["'])(${NAME})["']`, "g");
+const matches = (re, source) => [...source.matchAll(re)].map((m) => m[1].includes(":") ? m[1] : `lucide:${m[1]}`);
+const without = (source, open, close) => {
+  let out = "";
+  let at = 0;
+  for (; ; ) {
+    const start = source.indexOf(open, at);
+    const end = start === -1 ? -1 : source.indexOf(close, start + open.length);
+    if (end === -1) return out + source.slice(at);
+    out += source.slice(at, start);
+    at = end + close.length;
+  }
+};
+const mapScripts = (source, fn) => {
+  let out = "";
+  let at = 0;
+  for (; ; ) {
+    const tag = source.indexOf("<script", at);
+    const open = tag === -1 ? -1 : source.indexOf(">", tag);
+    const close = open === -1 ? -1 : source.indexOf("<\/script>", open);
+    if (close === -1) return out + source.slice(at);
+    out += source.slice(at, open + 1) + fn(source.slice(open + 1, close));
+    at = close;
+  }
+};
+const cutLine = (line) => {
+  for (let i = line.indexOf("//"); i !== -1; i = line.indexOf("//", i + 2)) if (i === 0 || /\s/.test(line[i - 1])) return line.slice(0, i);
+  return line;
+};
+const stripCode = (code) => without(code, "/*", "*/").split("\n").map(cutLine).join("\n");
+const stripComments = (source, file = "") => file.endsWith(".vue") ? mapScripts(without(source, "<!--", "-->"), stripCode) : stripCode(source);
+const codeIconNames = (source, file) => {
+  const code = stripComments(source, file);
+  return file.endsWith(".vue") ? [...matches(ICON_TAG, code), ...matches(ATTR_NAME, code)] : matches(QUOTED_NAME, code);
+};
+const contentIconNames = (source, file) => {
+  if (!file.endsWith(".md")) return matches(YAML_NAME, source);
+  const front = /^---\r?\n([\s\S]*?)\r?\n---/.exec(source);
+  const body = (front ? source.slice(front[0].length) : source).replace(/^(```|~~~)[^\n]*\n[\s\S]*?^\1[^\n]*$/gm, "").replace(/`[^`\n]*`/g, "");
+  const names = front ? matches(YAML_NAME, front[1]) : [];
+  for (const m of body.matchAll(/:{1,}[a-z][\w-]*(?:\[[^\]\n]*\])?\{([^}\n]*)\}/g)) names.push(...matches(ATTR_NAME, m[1]));
+  for (const m of body.matchAll(/^:{2,}[\w-]+[^\n]*\n---\r?\n([\s\S]*?)\r?\n---/gm)) names.push(...matches(YAML_NAME, m[1]));
+  return names;
+};
+const readIcon = (name, roots, customDir, sets = /* @__PURE__ */ new Map()) => {
+  const [prefix = "", icon = ""] = name.split(":");
+  if (prefix === "docs") {
+    const file = join(customDir, `${icon}.svg`);
+    if (!existsSync(file)) return;
+    const svg2 = readFileSync(file, "utf8");
+    const body = /<svg[^>]*>([\s\S]*)<\/svg>/.exec(svg2)?.[1]?.trim();
+    const viewBox = /viewBox="([^"]+)"/.exec(svg2)?.[1];
+    return body && viewBox ? [body, viewBox] : void 0;
+  }
+  if (!sets.has(prefix)) {
+    for (const from of roots) {
+      try {
+        sets.set(prefix, JSON.parse(readFileSync(createRequire(join(from, "noop.js")).resolve(`@iconify-json/${prefix}/icons.json`), "utf8")));
+        break;
+      } catch {
+      }
+    }
+    if (!sets.has(prefix)) sets.set(prefix, void 0);
+  }
+  const set = sets.get(prefix);
+  const data = set && getIconData(set, icon);
+  if (!data) return;
+  const svg = iconToSVG(data);
+  return [svg.body, svg.attributes.viewBox];
+};
+const collectIcons = (o) => {
+  const found = /* @__PURE__ */ new Map();
+  const add = (name, file) => found.set(name, (found.get(name) ?? /* @__PURE__ */ new Set()).add(file));
+  const read = (file) => readFileSync(file, "utf8");
+  for (const file of walk(join(o.layerRoot, "app"), [".vue", ".ts"])) {
+    for (const m of stripComments(read(file), file).matchAll(OWN_NAME)) add(m[1], relative(o.layerRoot, file));
+  }
+  for (const root of o.roots) {
+    const files = [
+      ...walk(join(root, "content"), [".md", ".yml", ".yaml", ".json"]),
+      ...["app/app.config.ts", "app.config.ts"].map((f) => join(root, f)).filter(existsSync)
+    ];
+    for (const file of files) {
+      const names = file.endsWith(".ts") ? codeIconNames(read(file), file) : contentIconNames(read(file), file);
+      for (const name of names) add(name, relative(o.relativeTo, file));
+    }
+    if (resolve(root) !== resolve(o.layerRoot)) {
+      for (const file of walk(join(root, "app"), [".vue"])) {
+        for (const name of codeIconNames(read(file), file)) add(name, relative(o.relativeTo, file));
+      }
+    }
+  }
+  const sets = /* @__PURE__ */ new Map();
+  const customDir = join(o.layerRoot, "icons");
+  const icons = {};
+  const warnings = [];
+  for (const name of [...found.keys()].sort()) {
+    const entry = readIcon(name, o.resolveFrom, customDir, sets);
+    if (entry) icons[name] = entry;
+    else warnings.push(`Icon "${name}" (${[...found.get(name)][0]}) is not in an installed Iconify set; it renders nothing.`);
+  }
+  return { icons, warnings };
+};
+const docsIcons = defineNuxtModule({
+  meta: { name: "@lupinum/ginko-docs/icons" },
+  setup(_, nuxt) {
+    const { resolve: here } = createResolver(import.meta.url);
+    const logger = useLogger("@lupinum/ginko-docs");
+    const layerRoot = here("..");
+    addComponent({ name: "Icon", filePath: here("../app/components/DocsIcon.vue"), global: true, priority: -1 });
+    const warned = /* @__PURE__ */ new Set();
+    const collect = () => {
+      const { icons, warnings } = collectIcons({
+        layerRoot,
+        roots: nuxt.options._layers.map((layer) => layer.config.rootDir ?? layer.cwd),
+        resolveFrom: [nuxt.options.rootDir, layerRoot],
+        relativeTo: nuxt.options.rootDir
+      });
+      for (const warning of warnings) if (!warned.has(warning)) {
+        warned.add(warning);
+        logger.warn(warning);
+      }
+      return icons;
+    };
+    const template = addTemplate({
+      filename: "docs-icons.mjs",
+      write: true,
+      getContents: () => `export default ${JSON.stringify(collect())}
+`
+    });
+    nuxt.options.alias["#docs-icons"] = template.dst;
+    addTypeTemplate({
+      filename: "types/docs-icons.d.ts",
+      getContents: () => `declare module '#docs-icons' {
+  const icons: Record<string, [body: string, viewBox: string]>
+  export default icons
+}
+`
+    });
+    nuxt.hook("build:manifest", (manifest) => {
+      for (const [key, item] of Object.entries(manifest)) {
+        if ([key, item.file, item.name, item.src].some((s) => s && /DocsIcon|docs-icons/.test(s))) item.prefetch = false;
+      }
+    });
+    if (nuxt.options.dev) {
+      nuxt.hook("builder:watch", async (_event, path) => {
+        if (/\.(md|ya?ml|json|vue)$|app\.config\.ts$/.test(path)) await updateTemplates({ filter: (t) => t.filename === "docs-icons.mjs" });
+      });
+    }
+  }
+});
+
+export { codeIconNames, collectIcons, contentIconNames, docsIcons as default, readIcon, stripComments };

package/dist/pages.mjs

@@ -1,35 +1,67 @@
-import { defineNuxtModule, createResolver, extendPages, addServerHandler, useLogger } from '@nuxt/kit';
-import { B as BLOG_PATH, C as CHANGELOG_PATH } from './shared/ginko-docs.BwbF7JBR.mjs';
+import { defineNuxtModule, createResolver, useLogger, addServerHandler } from '@nuxt/kit';
+
+function listPath(route) {
+  if (!route) return void 0;
+  const list = route.replace(/\/\[slug\]$/, "");
+  return list.includes("[") ? void 0 : list || "/";
+}
+function addressesOf(page, main) {
+  const mapped = page.meta?.i18n && page.meta.i18n.paths?.[main];
+  return mapped ? [page.path, mapped] : [page.path];
+}
+function layerRoutes(site, pages) {
+  const bricks = site?.bricks ?? {};
+  const main = site?.locales?.[0] ?? "";
+  const taken = /* @__PURE__ */ new Set();
+  for (const page of pages) for (const path of addressesOf(page, main)) taken.add(path);
+  const docsBase = bricks.docs?.route?.[main]?.replace(/\/\[slug\]$/, "") ?? "/docs";
+  const blog = bricks.posts ? listPath(bricks.posts.route?.[main]) : void 0;
+  const changelog = bricks.changelog ? listPath(bricks.changelog.route?.[main]) ?? site?.pages?.changelog?.[main] : void 0;
+  const free = (path) => path && !taken.has(path) ? path : void 0;
+  const noAddress = [...bricks.posts && !blog ? ["posts"] : [], ...bricks.changelog && !changelog ? ["changelog"] : []];
+  const addedBlog = free(blog);
+  const addedChangelog = free(changelog);
+  const wanted = [
+    { name: "docs-slug", path: `${docsBase}/:slug()`, file: "doc.vue" },
+    { name: "docs", path: docsBase, file: "docs.vue" },
+    { name: "index", path: "/", file: "index.vue" },
+    addedBlog ? { name: "blog", path: addedBlog, file: "blog.vue" } : void 0,
+    addedBlog ? { name: "blog-slug", path: `${addedBlog}/:slug()`, file: "post.vue" } : void 0,
+    addedChangelog ? { name: "changelog", path: addedChangelog, file: "changelog.vue" } : void 0
+  ];
+  return {
+    docs: { base: docsBase },
+    addresses: { ...blog && { blog }, ...changelog && { changelog } },
+    pages: wanted.filter((page) => !!page && !taken.has(page.path)),
+    ...addedBlog && { blog: addedBlog },
+    ...addedChangelog && { changelog: addedChangelog },
+    noAddress
+  };
+}
 
 const docsPages = defineNuxtModule({
   meta: { name: "@lupinum/ginko-docs/pages" },
   setup(_, nuxt) {
     const { resolve } = createResolver(import.meta.url);
+    const logger = useLogger("ginko-docs");
     const site = nuxt.options.ginko;
-    const bricks = site?.bricks ?? {};
-    const main = site?.locales?.[0] ?? "";
-    const base = bricks.docs?.route?.[main]?.replace(/\/\[slug\]$/, "") ?? "/docs";
-    extendPages((pages) => {
-      const taken = new Set(pages.map((p) => p.path));
-      const add = (name, path, file) => {
-        if (!taken.has(path)) pages.push({ name, path, file: resolve(`../app/docs-pages/${file}`) });
-      };
-      add("docs-slug", `${base}/:slug()`, "doc.vue");
-      add("docs", base, "docs.vue");
-      add("index", "/", "index.vue");
-      if (bricks.posts) {
-        add("blog", BLOG_PATH, "blog.vue");
-        add("blog-slug", `${BLOG_PATH}/:slug()`, "post.vue");
+    const { addresses } = layerRoutes(site, []);
+    nuxt.options.runtimeConfig.public.ginkoDocs = { blog: addresses.blog ?? "", changelog: addresses.changelog ?? "" };
+    let announced = false;
+    nuxt.hook("pages:resolved", (pages) => {
+      const r = layerRoutes(site, pages);
+      for (const page of r.pages) pages.push({ ...page, file: resolve(`../app/docs-pages/${page.file}`) });
+      if (announced) return;
+      announced = true;
+      if (r.blog) {
+        addServerHandler({ route: `${r.blog}/rss.xml`, method: "get", handler: resolve("../server/feeds/blog.get") });
+        addServerHandler({ route: `/:locale${r.blog}/rss.xml`, method: "get", handler: resolve("../server/feeds/blog-locale.get") });
+        if (!site?.pages?.blog) logger.warn(`The layer adds the blog at ${r.blog} but the site has no \`blog: blogPages({ locales })\` in \`pages\`: the blog list is missing from the sitemap and the static build.`);
       }
-      if (bricks.changelog) add("changelog", CHANGELOG_PATH, "changelog.vue");
+      if (r.changelog && !site?.pages?.changelog) logger.warn(`The layer adds the changelog at ${r.changelog} but the site has no \`changelog: changelogPages({ locales })\` in \`pages\`: it is missing from the sitemap and the static build.`);
+      for (const brick of r.noAddress)
+        logger.warn(brick === "changelog" ? "The changelog brick has no address: give it a `route` or add `changelog: changelogPages({ locales })` to `pages`. No changelog page is added." : "The posts brick has no `route` for the main language, so the layer adds no blog page.");
     });
-    if (bricks.posts) {
-      addServerHandler({ route: `${BLOG_PATH}/rss.xml`, method: "get", handler: resolve("../server/feeds/blog.get") });
-      addServerHandler({ route: `/:locale${BLOG_PATH}/rss.xml`, method: "get", handler: resolve("../server/feeds/blog-locale.get") });
-    }
-    const logger = useLogger("ginko-docs");
-    if (bricks.posts && !site?.pages?.blog) logger.warn("The site has a blog but no `blog: blogPages({ locales })` in `pages`: the blog list is missing from the sitemap and the static build.");
-    if (bricks.changelog && !site?.pages?.changelog) logger.warn("The site has a changelog but no `changelog: changelogPages({ locales })` in `pages`: it is missing from the sitemap and the static build.");
   }
 });
 

package/i18n/de.json

@@ -1 +1 @@
-{"docs":{"docs":"Doku","edit":"Seite bearbeiten","issue":"Fehler melden","top":"Nach oben","updated":"Zuletzt geändert am","copyPage":"Seite kopieren","copied":"Kopiert","copyFailed":"Kopieren nicht möglich","table":"Tabelle, scrollbar","installCommand":"Installationsbefehl","searchResults":"Suchergebnisse","copyCommand":"Befehl kopieren","moreActions":"Weitere Seitenaktionen","viewMarkdown":"Als Markdown ansehen","viewMarkdownHint":"Die Seite als reiner Text","openChatGpt":"In ChatGPT öffnen","openClaude":"In Claude öffnen","askHint":"Fragen zu dieser Seite stellen","askPrompt":"Lies {url} und beantworte Fragen dazu.","pageActions":"Seitenaktionen","skip":"Zum Inhalt","nav":"Doku-Navigation","onThisPage":"Auf dieser Seite","search":"Suchen","searchPlaceholder":"Doku durchsuchen …","searchHint":"Tippe, um Seiten und Abschnitte zu finden.","noResults":"Nichts gefunden für „{query}“.","searchMove":"wählen","searchOpen":"öffnen","close":"Schließen","previous":"Zurück","next":"Weiter","pager":"Vorige und nächste Seite","language":"Sprache","sections":"Bereiche","breadcrumb":"Pfad","theme":{"label":"Darstellung","auto":"Auto","light":"Hell","dark":"Dunkel","toggle":"Zwischen hell und dunkel wechseln"},"bannerClose":"Hinweis schließen","footerNav":"Fußzeile","builtWith":"Erstellt mit Ginko","toggle":"Unterseiten von {title} ein- oder ausklappen","blog":"Blog","changelog":"Änderungen","by":"Von","rss":"RSS-Feed","siteLinks":"Hauptbereiche","siteMenu":"Hauptmenü","blogLead":"Neuigkeiten, Anleitungen und Einblicke.","changelogLead":"Was sich mit jeder Version geändert hat.","draft":"Entwurf","readMore":"Weiterlesen","example":{"preview":"Vorschau","source":"Markdown"},"notFound":{"title":"Seite nicht gefunden","text":"Diese Seite gibt es nicht oder sie ist umgezogen.","home":"Zur Startseite"},"error":{"title":"Etwas ist schiefgelaufen","text":"Die Seite konnte nicht geladen werden. Versuche es gleich noch einmal."}}}
+{"docs":{"docs":"Doku","edit":"Seite bearbeiten","issue":"Fehler melden","top":"Nach oben","updated":"Zuletzt geändert am","copyPage":"Seite kopieren","copied":"Kopiert","copyFailed":"Kopieren nicht möglich","table":"Tabelle, scrollbar","installCommand":"Installationsbefehl","searchResults":"Suchergebnisse","copyCommand":"Befehl kopieren","moreActions":"Weitere Seitenaktionen","viewMarkdown":"Als Markdown ansehen","viewMarkdownHint":"Die Seite als reiner Text","openChatGpt":"In ChatGPT öffnen","openClaude":"In Claude öffnen","askHint":"Fragen zu dieser Seite stellen","askPrompt":"Lies {url} und beantworte Fragen dazu.","pageActions":"Seitenaktionen","skip":"Zum Inhalt","nav":"Doku-Navigation","contents":"Inhalt","onThisPage":"Auf dieser Seite","search":"Suchen","searchPlaceholder":"Doku durchsuchen …","searchHint":"Tippe, um Seiten und Abschnitte zu finden.","noResults":"Nichts gefunden für „{query}“.","searchMove":"wählen","searchOpen":"öffnen","close":"Schließen","previous":"Zurück","next":"Weiter","pager":"Vorige und nächste Seite","language":"Sprache","sections":"Bereiche","breadcrumb":"Pfad","theme":{"label":"Darstellung","auto":"Auto","light":"Hell","dark":"Dunkel","toggle":"Zwischen hell und dunkel wechseln"},"bannerClose":"Hinweis schließen","footerNav":"Fußzeile","builtWith":"Erstellt mit Ginko","toggle":"Unterseiten von {title} ein- oder ausklappen","blog":"Blog","changelog":"Änderungen","by":"Von","rss":"RSS-Feed","siteLinks":"Hauptbereiche","siteMenu":"Hauptmenü","blogLead":"Neuigkeiten, Anleitungen und Einblicke.","changelogLead":"Was sich mit jeder Version geändert hat.","changelogEmpty":"Noch keine Versionen. Lege die erste als Markdown-Datei in content/changelog an.","draft":"Entwurf","readMore":"Weiterlesen","example":{"preview":"Vorschau","source":"Markdown"},"notFound":{"title":"Seite nicht gefunden","text":"Diese Seite gibt es nicht oder sie ist umgezogen.","home":"Zur Startseite","mainLanguage":"Auf {language} versuchen"},"error":{"title":"Etwas ist schiefgelaufen","text":"Die Seite konnte nicht geladen werden. Versuche es gleich noch einmal."},"untranslated":"Nicht übersetzt: öffnet die Startseite"}}

package/i18n/en.json

@@ -1 +1 @@
-{"docs":{"docs":"Docs","edit":"Edit this page","issue":"Report an issue","top":"Back to top","updated":"Last updated","copyPage":"Copy page","copied":"Copied","copyFailed":"Could not copy","table":"Table, scrollable","installCommand":"Install command","searchResults":"Search results","copyCommand":"Copy command","moreActions":"More page actions","viewMarkdown":"View as Markdown","viewMarkdownHint":"The page as plain text","openChatGpt":"Open in ChatGPT","openClaude":"Open in Claude","askHint":"Ask questions about this page","askPrompt":"Read {url} and answer questions about it.","pageActions":"Page actions","skip":"Skip to content","nav":"Docs navigation","onThisPage":"On this page","search":"Search","searchPlaceholder":"Search the docs…","searchHint":"Type to search pages and sections.","noResults":"No results for “{query}”.","searchMove":"to move","searchOpen":"to open","close":"Close","previous":"Previous","next":"Next","pager":"Previous and next page","language":"Language","sections":"Sections","breadcrumb":"Breadcrumb","theme":{"label":"Appearance","auto":"Auto","light":"Light","dark":"Dark","toggle":"Switch between light and dark"},"bannerClose":"Dismiss notice","footerNav":"Footer","builtWith":"Built with Ginko","toggle":"Show or hide subpages of {title}","blog":"Blog","changelog":"Changelog","by":"By","rss":"RSS feed","siteLinks":"Main","siteMenu":"Main menu","blogLead":"News, guides and insights.","changelogLead":"What changed with each version.","draft":"Draft","readMore":"Read more","example":{"preview":"Preview","source":"Markdown"},"notFound":{"title":"Page not found","text":"This page does not exist or has moved.","home":"Go to the home page"},"error":{"title":"Something went wrong","text":"The page could not be loaded. Please try again in a moment."}}}
+{"docs":{"docs":"Docs","edit":"Edit this page","issue":"Report an issue","top":"Back to top","updated":"Last updated","copyPage":"Copy page","copied":"Copied","copyFailed":"Could not copy","table":"Table, scrollable","installCommand":"Install command","searchResults":"Search results","copyCommand":"Copy command","moreActions":"More page actions","viewMarkdown":"View as Markdown","viewMarkdownHint":"The page as plain text","openChatGpt":"Open in ChatGPT","openClaude":"Open in Claude","askHint":"Ask questions about this page","askPrompt":"Read {url} and answer questions about it.","pageActions":"Page actions","skip":"Skip to content","nav":"Docs navigation","contents":"Contents","onThisPage":"On this page","search":"Search","searchPlaceholder":"Search the docs…","searchHint":"Type to search pages and sections.","noResults":"No results for “{query}”.","searchMove":"to move","searchOpen":"to open","close":"Close","previous":"Previous","next":"Next","pager":"Previous and next page","language":"Language","sections":"Sections","breadcrumb":"Breadcrumb","theme":{"label":"Appearance","auto":"Auto","light":"Light","dark":"Dark","toggle":"Switch between light and dark"},"bannerClose":"Dismiss notice","footerNav":"Footer","builtWith":"Built with Ginko","toggle":"Show or hide subpages of {title}","blog":"Blog","changelog":"Changelog","by":"By","rss":"RSS feed","siteLinks":"Main","siteMenu":"Main menu","blogLead":"News, guides and insights.","changelogLead":"What changed with each version.","changelogEmpty":"No releases yet. Add the first as a Markdown file in content/changelog.","draft":"Draft","readMore":"Read more","example":{"preview":"Preview","source":"Markdown"},"notFound":{"title":"Page not found","text":"This page does not exist or has moved.","home":"Go to the home page","mainLanguage":"Try in {language}"},"error":{"title":"Something went wrong","text":"The page could not be loaded. Please try again in a moment."},"untranslated":"Not translated: opens the start page"}}

package/i18n/fr.json

@@ -0,0 +1 @@
+{"docs":{"docs":"Documentation","edit":"Modifier cette page","issue":"Signaler un problème","top":"Retour en haut","updated":"Dernière mise à jour","copyPage":"Copier la page","copied":"Copié","copyFailed":"Impossible de copier","table":"Tableau, défilement horizontal","installCommand":"Commande d’installation","searchResults":"Résultats de recherche","copyCommand":"Copier la commande","moreActions":"Autres actions sur la page","viewMarkdown":"Voir en Markdown","viewMarkdownHint":"La page en texte brut","openChatGpt":"Ouvrir dans ChatGPT","openClaude":"Ouvrir dans Claude","askHint":"Poser des questions sur cette page","askPrompt":"Lis {url} et réponds à mes questions sur cette page.","pageActions":"Actions de la page","skip":"Aller au contenu","nav":"Navigation de la documentation","contents":"Sommaire","onThisPage":"Sur cette page","search":"Rechercher","searchPlaceholder":"Rechercher dans la documentation…","searchHint":"Saisissez un mot pour chercher dans les pages et les sections.","noResults":"Aucun résultat pour « {query} ».","searchMove":"pour naviguer","searchOpen":"pour ouvrir","close":"Fermer","previous":"Précédent","next":"Suivant","pager":"Page précédente et page suivante","language":"Langue","sections":"Rubriques","breadcrumb":"Fil d’Ariane","theme":{"label":"Apparence","auto":"Auto","light":"Clair","dark":"Sombre","toggle":"Basculer entre clair et sombre"},"bannerClose":"Fermer le message","footerNav":"Pied de page","builtWith":"Réalisé avec Ginko","toggle":"Afficher ou masquer les sous-pages de {title}","blog":"Blog","changelog":"Nouveautés","by":"Par","rss":"Flux RSS","siteLinks":"Navigation principale","siteMenu":"Menu principal","blogLead":"Actualités, guides et analyses.","changelogLead":"Ce qui a changé à chaque version.","changelogEmpty":"Aucune version pour l’instant. Ajoutez la première sous forme de fichier Markdown dans content/changelog.","draft":"Brouillon","readMore":"Lire la suite","example":{"preview":"Aperçu","source":"Markdown"},"notFound":{"title":"Page introuvable","text":"Cette page n’existe pas ou a été déplacée.","home":"Aller à la page d’accueil","mainLanguage":"Lire en {language}"},"error":{"title":"Une erreur est survenue","text":"La page n’a pas pu être chargée. Réessayez dans un instant."},"untranslated":"Page non traduite : ouvre la page d’accueil"}}

package/nuxt.config.ts

@@ -6,29 +6,14 @@ import { fileURLToPath } from 'node:url'
 
 const here = (path: string) => fileURLToPath(new URL(path, import.meta.url))
 
-// Icons the layer's own components use. They go into the client bundle; icon names in the site's content
-// (the `icon` field) are found by the scan. No icon API: everything is bundled, so static hosting works offline.
-const icons = [
-  'arrow-left', 'arrow-right', 'arrow-up', 'arrow-up-right', 'check', 'chevron-down', 'chevron-right', 'circle-alert',
-  'copy', 'corner-down-left', 'file-text', 'hash', 'languages', 'menu', 'moon', 'panel-left', 'pencil', 'rss',
-  'search', 'sun', 'text-align-start', 'x',
-].map((name) => `lucide:${name}`)
-
 export default defineNuxtConfig({
-  modules: ['@lupinum/ginko-components', '@nuxt/icon', '@lupinum/ginko-docs/pages'],
+  modules: ['@lupinum/ginko-components', '@lupinum/ginko-docs/pages', '@lupinum/ginko-docs/icons'],
   // Tells @lupinum/ginko to keep each page's repository path (`source`) in the served bundle, for "Edit this page".
   // A config hook, not one in modules/pages.ts: it is registered before any module runs, whatever the module order.
   hooks: { 'ginko:files': (options) => { options.keepSource = true } },
   css: [here('./app/assets/docs.css')],
-  icon: {
-    provider: 'none',
-    fallbackToApi: false,
-    customCollections: [{ prefix: 'docs', dir: here('./icons') }],
-    clientBundle: { icons, scan: true, includeCustomCollections: true },
-  },
   // The diagram engine (mermaid + ELK, 462 kB gzip) is loaded only by a page with a ```mermaid block. Left alone, Rolldown
-  // put its small shared module helper into that chunk, the icon runtime on every page imported the helper from there,
-  // and so every page downloaded the engine. A named group of its own keeps the helper out of it (e2e/docs.spec.ts checks).
+  // could put its small shared module helper into that chunk, and every page importing the helper downloaded the engine. A named group of its own keeps the helper out of it (e2e/docs.spec.ts checks).
   vite: {
     build: {
       rolldownOptions: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lupinum/ginko-docs",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "type": "module",
   "description": "Docs sites on Ginko: a Nuxt layer with navigation, search, blog, changelog and Markdown components.",
   "license": "MIT",
@@ -35,7 +35,8 @@
       "types": "./dist/config.d.mts",
       "import": "./dist/config.mjs"
     },
-    "./pages": "./dist/pages.mjs"
+    "./pages": "./dist/pages.mjs",
+    "./icons": "./dist/icons.mjs"
   },
   "publishConfig": {
     "access": "public"
@@ -43,23 +44,23 @@
   "dependencies": {
     "@comark/vue": "0.7.0",
     "@iconify-json/lucide": "^1.2.137",
-    "@lupinum/ginko-components": "^0.4.0",
-    "@nuxt/icon": "^2.5.1",
+    "@iconify/utils": "^3.1.7",
+    "@lupinum/ginko-components": "^0.5.0",
     "@nuxt/kit": "^4.6.0",
     "beautiful-mermaid": "^1.1.3",
     "katex": "^0.18.11"
   },
   "peerDependencies": {
-    "@lupinum/ginko": "^0.4.0",
-    "@lupinum/ginko-content": "^0.4.0",
-    "@lupinum/ginko-i18n": "^0.4.0",
+    "@lupinum/ginko": "^0.5.0",
+    "@lupinum/ginko-content": "^0.5.0",
+    "@lupinum/ginko-i18n": "^0.5.0",
     "nuxt": "^4.6.0 || ^5.0.0-0",
     "vue": "^3.5.0"
   },
   "devDependencies": {
-    "@lupinum/ginko": "0.4.0",
-    "@lupinum/ginko-content": "0.4.0",
-    "@lupinum/ginko-i18n": "0.4.0",
+    "@lupinum/ginko": "0.5.0",
+    "@lupinum/ginko-content": "0.5.0",
+    "@lupinum/ginko-i18n": "0.5.0",
     "nuxt": "4.6.0",
     "unbuild": "3.6.1",
     "vue": "3.5.43"

package/server/lib/blogFeed.ts

@@ -6,7 +6,7 @@ import fileBundles from '#ginko/files'
 import locales from '#ginko/locales'
 import type { Brick } from '@lupinum/ginko'
 import { isVisible, todayIn } from '@lupinum/ginko/internal'
-import { rssXml } from './rss'
+import { rssXml } from '@lupinum/ginko/basics'
 
 export function serveBlogFeed(event: RequestEvent, locale: string) {
   const config = useRuntimeConfig().public.ginko as { name: string; url: string; locales: string[]; timeZone: string; seo: { description?: string } }

package/shared/layerRoutes.ts

@@ -0,0 +1,66 @@
+// Which pages and feeds the layer adds for a site, decided from the site's Ginko config and the paths its own pages
+// already take. Pure, so modules/pages.ts only wires the result into Nuxt and the test can check every case.
+export interface SiteOptions { locales?: readonly string[], pages?: Record<string, Record<string, string> | undefined>, bricks?: Record<string, { route?: Record<string, string> } | undefined> }
+
+export interface LayerPage { name: string, path: string, /** In `app/docs-pages/`. */ file: string }
+
+export interface LayerRoutes {
+  docs: { base: string }
+  /** Where the bricks put the blog list and the changelog (main language), whoever serves them. The app links here. */
+  addresses: { blog?: string, changelog?: string }
+  /** The pages the layer adds: each only where the site has no page of its own. */
+  pages: LayerPage[]
+  /** The blog and changelog the layer serves itself. Feeds are `<blog>/rss.xml` and `/:locale<blog>/rss.xml`. */
+  blog?: string
+  changelog?: string
+  /** A brick is configured but has no address to put a page at (the changelog brick without a route or `pages.changelog`). */
+  noAddress: string[]
+}
+
+/** The brick's address in the main language, with `[slug]` as `:slug()`; the list page is the parent path. */
+function listPath(route: string | undefined): string | undefined {
+  if (!route) return undefined
+  const list = route.replace(/\/\[slug\]$/, '')
+  return list.includes('[') ? undefined : list || '/'
+}
+
+/** A page as Nuxt has it once every `pages:extend` ran: its scanned path and, from the templates' page-paths module, its addresses per language. */
+export interface PageLike { path: string, meta?: { i18n?: false | { paths?: Record<string, string> } } | undefined }
+
+/** The addresses a page answers at in the main language: its path and `meta.i18n.paths[main]` when set (`/news` answers at `/blog`). */
+function addressesOf(page: PageLike, main: string): string[] {
+  const mapped = page.meta?.i18n && page.meta.i18n.paths?.[main]
+  return mapped ? [page.path, mapped] : [page.path]
+}
+
+export function layerRoutes(site: SiteOptions | undefined, pages: Iterable<PageLike>): LayerRoutes {
+  const bricks = site?.bricks ?? {}
+  const main = site?.locales?.[0] ?? ''
+  const taken = new Set<string>()
+  for (const page of pages) for (const path of addressesOf(page, main)) taken.add(path)
+  // docsCollection writes `<base>/[slug]` for the main language; other languages get a prefix from ginko-i18n.
+  const docsBase = bricks.docs?.route?.[main]?.replace(/\/\[slug\]$/, '') ?? '/docs'
+  const blog = bricks.posts ? listPath(bricks.posts.route?.[main]) : undefined
+  // The changelog has no page of its own per entry: its list lives at the route the brick has, else at `pages.changelog`.
+  const changelog = bricks.changelog ? listPath(bricks.changelog.route?.[main]) ?? site?.pages?.changelog?.[main] : undefined
+  const free = (path: string | undefined) => (path && !taken.has(path) ? path : undefined)
+  const noAddress = [...(bricks.posts && !blog ? ['posts'] : []), ...(bricks.changelog && !changelog ? ['changelog'] : [])]
+  const addedBlog = free(blog)
+  const addedChangelog = free(changelog)
+  const wanted: Array<LayerPage | undefined> = [
+    { name: 'docs-slug', path: `${docsBase}/:slug()`, file: 'doc.vue' },
+    { name: 'docs', path: docsBase, file: 'docs.vue' },
+    { name: 'index', path: '/', file: 'index.vue' },
+    addedBlog ? { name: 'blog', path: addedBlog, file: 'blog.vue' } : undefined,
+    addedBlog ? { name: 'blog-slug', path: `${addedBlog}/:slug()`, file: 'post.vue' } : undefined,
+    addedChangelog ? { name: 'changelog', path: addedChangelog, file: 'changelog.vue' } : undefined,
+  ]
+  return {
+    docs: { base: docsBase },
+    addresses: { ...(blog && { blog }), ...(changelog && { changelog }) },
+    pages: wanted.filter((page): page is LayerPage => !!page && !taken.has(page.path)),
+    ...(addedBlog && { blog: addedBlog }),
+    ...(addedChangelog && { changelog: addedChangelog }),
+    noAddress,
+  }
+}

package/dist/shared/ginko-docs.BwbF7JBR.mjs

@@ -1,4 +0,0 @@
-const BLOG_PATH = "/blog";
-const CHANGELOG_PATH = "/changelog";
-
-export { BLOG_PATH as B, CHANGELOG_PATH as C };

package/server/lib/rss.ts

@@ -1,57 +0,0 @@
-// An RSS 2.0 document as a pure function, so it is unit tested without Nitro.
-
-export interface FeedItem {
-  title: string
-  /** Absolute. */
-  link: string
-  description?: string
-  /** `YYYY-MM-DD`. */
-  date: string
-  authors: string[]
-}
-
-export interface Feed {
-  title: string
-  /** Absolute address of the page the feed belongs to. */
-  link: string
-  /** Absolute address of the feed itself. */
-  self: string
-  description: string
-  language: string
-  items: FeedItem[]
-}
-
-const escapeXml = (value: string) => value.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/"/g, '&quot;').replace(/'/g, '&apos;')
-/** RFC 822 date (what RSS 2.0 asks for) for a day; the day counts as midnight UTC. */
-const rfc822 = (day: string) => new Date(`${day}T00:00:00Z`).toUTCString()
-const tag = (name: string, value: string) => `<${name}>${escapeXml(value)}</${name}>`
-
-/** Title and description only, as plain text: the feed links to the page for the full post. */
-export function rssXml(feed: Feed): string {
-  const items = feed.items.map((item) => [
-    '    <item>',
-    `      ${tag('title', item.title)}`,
-    `      ${tag('link', item.link)}`,
-    `      <guid isPermaLink="true">${escapeXml(item.link)}</guid>`,
-    `      ${tag('pubDate', rfc822(item.date))}`,
-    ...(item.description ? [`      ${tag('description', item.description)}`] : []),
-    ...item.authors.map((a) => `      ${tag('dc:creator', a)}`),
-    '    </item>',
-  ].join('\n'))
-  const newest = feed.items.map((i) => i.date).sort().at(-1)
-  return [
-    '<?xml version="1.0" encoding="UTF-8"?>',
-    '<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:dc="http://purl.org/dc/elements/1.1/">',
-    '  <channel>',
-    `    ${tag('title', feed.title)}`,
-    `    ${tag('link', feed.link)}`,
-    `    ${tag('description', feed.description)}`,
-    `    ${tag('language', feed.language)}`,
-    ...(newest ? [`    ${tag('lastBuildDate', rfc822(newest))}`] : []),
-    `    <atom:link href="${escapeXml(feed.self)}" rel="self" type="application/rss+xml"/>`,
-    ...items,
-    '  </channel>',
-    '</rss>',
-    '',
-  ].join('\n')
-}