@lupinum/ginko-docs 0.4.0 → 0.6.0

package/app/docs-pages/changelog.vue

@@ -1,12 +1,19 @@
 <script setup lang="ts">
+import { releaseAnchor as anchor } from '@lupinum/ginko/basics'
 import { markdownComponents } from '../lib/markdownComponents'
 // The changelog: one page, one section per release, newest first (the collection's order). Each version has an anchor.
-const { t } = useI18n()
+const { t, language } = useI18n()
 const blog = useDocsBlog()
+const langOf = useGinkoLang()
 const entries = blog.changelog()
-useGinkoSeo(() => ({ title: t('docs.changelog') }))
-// `1.2.0` -> `v1-2-0`, a valid id and a stable address for the release.
-const anchor = (version: string) => `v${version.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-|-$/g, '')}`
+// A list page: CollectionPage JSON-LD, so search engines read it as the index of its entries.
+const site = useGinkoSite()
+const route = useRoute()
+useGinkoSeo(() => ({
+  title: t('docs.changelog'),
+  description: t('docs.changelogLead'),
+  jsonLd: [{ '@context': 'https://schema.org', '@type': 'CollectionPage', name: t('docs.changelog'), url: new URL(route.path, site.url).href, inLanguage: language.value }],
+}))
 </script>
 
 <template>
@@ -15,12 +22,13 @@ const anchor = (version: string) => `v${version.toLowerCase().replace(/[^a-z0-9]
       <header class="docs-blog-head">
         <h1>{{ t('docs.changelog') }}</h1>
       </header>
+      <p v-if="!entries.items.length" class="docs-meta">{{ t('docs.changelogEmpty') }}</p>
       <section v-for="entry in entries.items" :id="anchor(entry.data.version)" :key="entry.id" class="docs-release">
         <div class="docs-release-meta">
           <h2><a :href="`#${anchor(entry.data.version)}`">{{ entry.data.version }}</a></h2>
           <p class="docs-meta"><time :datetime="entry.data.date">{{ blog.formatDate(entry.data.date) }}</time></p>
         </div>
-        <GinkoMarkdown :value="entry.data.body" :components="markdownComponents" class="docs-prose" />
+        <GinkoMarkdown :value="entry.data.body" :components="markdownComponents" class="docs-prose" :lang="langOf(entry, 'body')" />
       </section>
     </div>
   </div>

package/app/docs-pages/doc.vue

@@ -1,7 +1,9 @@
 <script setup lang="ts">
 const route = useRoute()
 const doc = useGinkoEntry('docs', () => route.params.slug)
-const toc = computed(() => doc.value.data.body.toc?.links ?? [])
+// The toc comes with the text (page state holds only its ref); the same request as the page's <GinkoMarkdown>.
+const tree = await useGinkoMarkdown(() => doc.value.data.body)
+const toc = computed(() => tree.value?.toc?.links ?? [])
 </script>
 
 <template>

package/app/error.vue

@@ -2,12 +2,26 @@
 // Not found and other errors, inside the site's frame (the layer's layout, or the site's own). A site with its own
 // error.vue replaces this one.
 import type { NuxtError } from '#app'
+import { docsMainLanguagePath } from './lib/docsPage'
 
 const props = defineProps<{ error: NuxtError }>()
-const { t, localePath } = useI18n()
+const { t, localePath, locales, locale } = useI18n()
 const docs = useDocs()
+const route = useRoute()
+const { mainLocale } = useGinkoSite()
 const notFound = computed(() => props.error.statusCode === 404)
 useGinkoSeo(() => ({ title: notFound.value ? t('docs.notFound.title') : t('docs.error.title'), noindex: true }))
+// A 404 under another language's docs address offers the same address in the main language, named in itself. It is a
+// guess (the slug may differ there); the language menu covers the normal way.
+const mainPage = computed(() => {
+  const path = notFound.value ? docsMainLanguagePath(route.path, locales.map((l) => l.code), mainLocale, docs.mainBase, (p) => localePath(p, mainLocale)) : undefined
+  if (!path) return undefined
+  // The language's name in the reader's language; the locale's own name if the runtime does not know the code.
+  const fallback = locales.find((l) => l.code === mainLocale)?.name ?? mainLocale
+  let language = fallback
+  try { language = new Intl.DisplayNames([locale.value], { type: 'language' }).of(mainLocale) ?? fallback } catch { /* keep the fallback */ }
+  return { path, language }
+})
 // Links work without JavaScript; with it, clearError leaves the error state and navigates.
 const leave = (to: string) => clearError({ redirect: to })
 </script>
@@ -22,6 +36,7 @@ const leave = (to: string) => clearError({ redirect: to })
         <div class="docs-error-actions">
           <a :href="localePath('/')" class="docs-button is-large is-primary" @click.prevent="leave(localePath('/'))">{{ t('docs.notFound.home') }}</a>
           <a v-if="docs.first.value" :href="docs.first.value" class="docs-button is-large is-soft" @click.prevent="leave(docs.first.value)">{{ t('docs.docs') }}</a>
+          <a v-if="mainPage" :href="mainPage.path" class="docs-button is-large is-soft" @click.prevent="leave(mainPage.path)">{{ t('docs.notFound.mainLanguage', { language: mainPage.language }) }}</a>
         </div>
       </div>
     </div>

package/app/layouts/default.vue

@@ -3,9 +3,13 @@
 // the docs pages then sit inside the site's frame (the docs body, DocsShell, works either way).
 const { t } = useI18n()
 const { theme, banner } = useAppConfig().docs ?? {}
+provideDocsStandalone()
 useHead({
   // `docs-standalone` turns on the page background, font and color-scheme (docs.css); embedded, the site owns those.
   htmlAttrs: { class: 'docs-standalone', 'data-docs-theme': theme && theme !== 'default' ? theme : undefined },
+  // Inter comes with the page instead of after the stylesheet: text set in the fallback re-wraps when the font
+  // arrives late and pushes the page down (layout shift).
+  link: [{ rel: 'preload', as: 'font', type: 'font/woff2', href: '/_docs/fonts/inter-latin-wght-normal.woff2', crossorigin: '' }],
 })
 // "Skip to content" goes past the docs navigation to the page itself when the page has one (DocsShell), else to main.
 function skip(event: MouseEvent) {

package/app/lib/docsPage.ts

@@ -42,3 +42,43 @@ export function docsAskLinks(prompt: string): Record<DocsAssistant, string> {
   const q = encodeURIComponent(prompt)
   return { chatgpt: `https://chatgpt.com/?q=${q}`, claude: `https://claude.ai/new?q=${q}` }
 }
+
+/**
+ * The main-language address of the docs page `ref`, from the brick's route (`/docs/[slug]`). For a page the current
+ * language lacks: the reader's bundle does not hold it, so this is how its link still leads to the main-language page,
+ * as in Markdown (core's `routeTarget`). Undefined when the route has no `[slug]`. Without the main-language entries
+ * this takes `ref` as the main-language slug: right for links by file name while the main file keeps the slug made
+ * from it; a main file with its own `slug:` or a typo gives a 404 here, where core would report the link.
+ */
+export function docsMainPath(route: Partial<Record<string, string>> | undefined, mainLocale: string, ref: string): string | undefined {
+  const pattern = route?.[mainLocale]
+  return pattern?.includes('[slug]') ? pattern.replace('[slug]', ref) : undefined
+}
+
+/**
+ * A route link outside Markdown (the start page's links and cards, `nav`, `footer.links`, `banner.href`):
+ * `$docs.<page>` names a docs page by its file name or slug, `$page.<key>` a page of `pages` in ginko.config.ts; an
+ * `#anchor` is kept. The same notation as in Markdown, so the link follows the reader's language and survives a
+ * changed slug. Undefined when `raw` is no route link or names nothing.
+ */
+export function docsRouteLink(raw: string, find: { doc: (ref: string) => string | undefined, page: (key: string) => string | undefined }): string | undefined {
+  const match = /^\$(docs|page)\.([^#]+)(#.*)?$/.exec(raw)
+  if (!match) return undefined
+  const path = match[1] === 'docs' ? find.doc(match[2]!) : find.page(match[2]!)
+  return path === undefined ? undefined : path + (match[3] ?? '')
+}
+
+/**
+ * The main-language address for a docs address in another language (`/de/docs/x` gives `/docs/x`), or undefined when
+ * `path` is not under a non-main locale prefix and the main docs base. `resolve` turns the stripped path into the
+ * main language's real address (the site's i18n strategy decides whether it carries a prefix). A guess: the slug may be German and then
+ * 404 again, like `docsMainPath`; the bundle holds no main-language data to check it.
+ */
+export function docsMainLanguagePath(path: string, locales: readonly string[], mainLocale: string, mainBase: string, resolve: (path: string) => string = (p) => p): string | undefined {
+  for (const code of locales) {
+    if (code === mainLocale || !path.startsWith(`/${code}/`)) continue
+    const rest = path.slice(code.length + 1)
+    return rest.startsWith(`${mainBase}/`) ? resolve(rest) : undefined
+  }
+  return undefined
+}

package/app/lib/markdownComponents.ts

@@ -2,7 +2,6 @@
 // a `components` map wins. Both load lazily, so a page without a formula or a diagram never loads KaTeX or mermaid.
 // Math renders on the server (the HTML holds `.katex`); mermaid renders in the browser.
 import { defineAsyncComponent } from 'vue'
-import DocsExample from '../components/DocsExample.vue'
 import DocsTable from '../components/DocsTable.vue'
 
 export const markdownComponents = {
@@ -11,6 +10,6 @@ export const markdownComponents = {
     return Math
   }),
   mermaid: defineAsyncComponent(() => import('@comark/vue/plugins/mermaid').then((m) => m.Mermaid)),
-  example: DocsExample,
+  example: defineAsyncComponent(() => import('../components/DocsExample.vue')),
   table: DocsTable,
 }

package/dist/config.d.mts

@@ -1,16 +1,23 @@
 import * as _lupinum_ginko from '@lupinum/ginko';
-import { Locale } from '@lupinum/ginko';
+import { BrickSource, Locale } from '@lupinum/ginko';
 import * as _lupinum_ginko_internal from '@lupinum/ginko/internal';
 export { components } from '@lupinum/ginko-components/registry';
 
 /** The site's locales, main locale first. The same list as `locales` in `defineSite`, as a plain array or a tuple. */
 type Locales = readonly Locale[];
-/** `base`: where the docs live, default `/docs` (e.g. `/handbook` inside a larger site). */
+/**
+ * Where a brick's content comes from: `'files'` (the default) reads Markdown from `content/`, `'platform'` keeps it on
+ * the Ginko platform, where people edit it in Ginko Studio. Unlike the bricks of `@lupinum/ginko/basics`, docs bricks
+ * read files unless they are told otherwise: docs usually live in Git.
+ */
+type DocsSource = BrickSource | 'platform';
+/** `base`: where the docs live, default `/docs` (e.g. `/handbook` inside a larger site). `source`: see `DocsSource`. */
 declare function docsCollection(opts: {
     locales: Locales;
     label?: string;
     max?: number;
     base?: `/${string}`;
+    source?: DocsSource;
 }): _lupinum_ginko.CollectionBrick<{
     readonly title: _lupinum_ginko_internal.TextField & Omit<_lupinum_ginko_internal.TextField, "type" | "label" | "pos" | "retired" | "default"> & {
         default?: (string | Partial<Record<string, string>>) | undefined;
@@ -55,11 +62,15 @@ declare function docsCollection(opts: {
 /**
  * The optional start page: one Markdown file `content/home[.<locale>].md`. The frontmatter fills the hero (title,
  * description, install command, up to two links) and the feature grid; the text below the frontmatter follows them and
- * may use every component. Without it, `/` opens the first docs page. Add `home: { <main>: '/', <l>: '/<l>' }` to `pages`.
+ * may use every component. Without it, `/` opens the first docs page. Add `home: homePages({ locales })` to `pages`.
+ * `source`: see `DocsSource`.
  */
-declare function docsHome(): _lupinum_ginko.SingleBrick<{
+declare function docsHome(opts?: {
+    source?: DocsSource;
+}): _lupinum_ginko.SingleBrick<{
     readonly title: _lupinum_ginko_internal.TextField & {
         readonly max: 120;
+        readonly default: "Documentation";
     };
     readonly description: _lupinum_ginko_internal.LongTextField & {
         readonly optional: true;
@@ -140,10 +151,13 @@ declare function docsHome(): _lupinum_ginko.SingleBrick<{
  * /blog/<slug> (main locale unprefixed, `/<l>/blog/<slug>` otherwise) and come out newest first.
  * Authors have no page; a post names them in `authors`. Files: `content/posts/<n>.<name>[.<locale>].md`
  * and `content/authors/<name>[.<locale>].yml`. Add `blog: blogPages({ locales })` to `pages` as well.
+ * The bricks are `posts()` and `authors()` of `@lupinum/ginko/basics` with the English labels docs sites store.
+ * `source` (both bricks): see `DocsSource`.
  */
 declare function blogCollections(opts: {
     locales: Locales;
     max?: number;
+    source?: DocsSource;
 }): {
     posts: _lupinum_ginko.CollectionBrick<{
         readonly title: _lupinum_ginko_internal.TextField & Omit<_lupinum_ginko_internal.TextField, "type" | "label" | "pos" | "retired" | "default"> & {
@@ -158,7 +172,7 @@ declare function blogCollections(opts: {
         readonly authors: _lupinum_ginko_internal.RefField & {
             multiple: true;
         } & {
-            readonly to: "authors";
+            readonly to: string;
             readonly optional: true;
         };
         readonly image: _lupinum_ginko_internal.ImageField & {
@@ -169,7 +183,7 @@ declare function blogCollections(opts: {
                 readonly max: 40;
             };
         }> & Omit<{
-            readonly itemLabel: "Tag";
+            readonly itemLabel: Record<string, string>;
             readonly fields: {
                 readonly tag: _lupinum_ginko_internal.TextField & {
                     readonly max: 40;
@@ -195,7 +209,6 @@ declare function blogCollections(opts: {
         readonly avatar: _lupinum_ginko_internal.ImageField & {
             readonly optional: true;
         };
-        /** Shown as a link on the author's name. */
         readonly url: _lupinum_ginko_internal.TextField & {
             readonly format: "url";
             readonly optional: true;
@@ -206,9 +219,12 @@ declare function blogCollections(opts: {
  * The optional changelog: one page at /changelog with one entry per release, newest first. Entries have no
  * page of their own, the page links to each by anchor. Files: `content/changelog/<name>[.<locale>].md`
  * with `version` and `date` in the frontmatter (a dot in the name would read as a language: use `v1-2-0.md`). Add `changelog: changelogPages({ locales })` to `pages` as well.
+ * The brick is `changelog()` of `@lupinum/ginko/basics` with the English labels docs sites store. `source`: see
+ * `DocsSource`.
  */
 declare function changelogCollection(opts?: {
     max?: number;
+    source?: DocsSource;
 }): _lupinum_ginko.CollectionBrick<{
     readonly version: _lupinum_ginko_internal.TextField & {
         readonly max: 40;
@@ -221,6 +237,10 @@ declare function changelogCollection(opts?: {
         readonly profile: "page";
     };
 }, undefined>;
+/** The start page by locale, for `pages` in ginko.config.ts: the main locale at `/`, the others at `/<locale>`. */
+declare const homePages: (opts: {
+    locales: Locales;
+}) => Record<string, "/">;
 /** The list pages by locale, for `pages` in ginko.config.ts: the sitemap and the static build know them from there. */
 declare const blogPages: (opts: {
     locales: Locales;
@@ -229,4 +249,5 @@ declare const changelogPages: (opts: {
     locales: Locales;
 }) => Record<string, "/changelog">;
 
-export { blogCollections, blogPages, changelogCollection, changelogPages, docsCollection, docsHome };
+export { blogCollections, blogPages, changelogCollection, changelogPages, docsCollection, docsHome, homePages };
+export type { DocsSource };

package/dist/config.d.ts

@@ -1,16 +1,23 @@
 import * as _lupinum_ginko from '@lupinum/ginko';
-import { Locale } from '@lupinum/ginko';
+import { BrickSource, Locale } from '@lupinum/ginko';
 import * as _lupinum_ginko_internal from '@lupinum/ginko/internal';
 export { components } from '@lupinum/ginko-components/registry';
 
 /** The site's locales, main locale first. The same list as `locales` in `defineSite`, as a plain array or a tuple. */
 type Locales = readonly Locale[];
-/** `base`: where the docs live, default `/docs` (e.g. `/handbook` inside a larger site). */
+/**
+ * Where a brick's content comes from: `'files'` (the default) reads Markdown from `content/`, `'platform'` keeps it on
+ * the Ginko platform, where people edit it in Ginko Studio. Unlike the bricks of `@lupinum/ginko/basics`, docs bricks
+ * read files unless they are told otherwise: docs usually live in Git.
+ */
+type DocsSource = BrickSource | 'platform';
+/** `base`: where the docs live, default `/docs` (e.g. `/handbook` inside a larger site). `source`: see `DocsSource`. */
 declare function docsCollection(opts: {
     locales: Locales;
     label?: string;
     max?: number;
     base?: `/${string}`;
+    source?: DocsSource;
 }): _lupinum_ginko.CollectionBrick<{
     readonly title: _lupinum_ginko_internal.TextField & Omit<_lupinum_ginko_internal.TextField, "type" | "label" | "pos" | "retired" | "default"> & {
         default?: (string | Partial<Record<string, string>>) | undefined;
@@ -55,11 +62,15 @@ declare function docsCollection(opts: {
 /**
  * The optional start page: one Markdown file `content/home[.<locale>].md`. The frontmatter fills the hero (title,
  * description, install command, up to two links) and the feature grid; the text below the frontmatter follows them and
- * may use every component. Without it, `/` opens the first docs page. Add `home: { <main>: '/', <l>: '/<l>' }` to `pages`.
+ * may use every component. Without it, `/` opens the first docs page. Add `home: homePages({ locales })` to `pages`.
+ * `source`: see `DocsSource`.
  */
-declare function docsHome(): _lupinum_ginko.SingleBrick<{
+declare function docsHome(opts?: {
+    source?: DocsSource;
+}): _lupinum_ginko.SingleBrick<{
     readonly title: _lupinum_ginko_internal.TextField & {
         readonly max: 120;
+        readonly default: "Documentation";
     };
     readonly description: _lupinum_ginko_internal.LongTextField & {
         readonly optional: true;
@@ -140,10 +151,13 @@ declare function docsHome(): _lupinum_ginko.SingleBrick<{
  * /blog/<slug> (main locale unprefixed, `/<l>/blog/<slug>` otherwise) and come out newest first.
  * Authors have no page; a post names them in `authors`. Files: `content/posts/<n>.<name>[.<locale>].md`
  * and `content/authors/<name>[.<locale>].yml`. Add `blog: blogPages({ locales })` to `pages` as well.
+ * The bricks are `posts()` and `authors()` of `@lupinum/ginko/basics` with the English labels docs sites store.
+ * `source` (both bricks): see `DocsSource`.
  */
 declare function blogCollections(opts: {
     locales: Locales;
     max?: number;
+    source?: DocsSource;
 }): {
     posts: _lupinum_ginko.CollectionBrick<{
         readonly title: _lupinum_ginko_internal.TextField & Omit<_lupinum_ginko_internal.TextField, "type" | "label" | "pos" | "retired" | "default"> & {
@@ -158,7 +172,7 @@ declare function blogCollections(opts: {
         readonly authors: _lupinum_ginko_internal.RefField & {
             multiple: true;
         } & {
-            readonly to: "authors";
+            readonly to: string;
             readonly optional: true;
         };
         readonly image: _lupinum_ginko_internal.ImageField & {
@@ -169,7 +183,7 @@ declare function blogCollections(opts: {
                 readonly max: 40;
             };
         }> & Omit<{
-            readonly itemLabel: "Tag";
+            readonly itemLabel: Record<string, string>;
             readonly fields: {
                 readonly tag: _lupinum_ginko_internal.TextField & {
                     readonly max: 40;
@@ -195,7 +209,6 @@ declare function blogCollections(opts: {
         readonly avatar: _lupinum_ginko_internal.ImageField & {
             readonly optional: true;
         };
-        /** Shown as a link on the author's name. */
         readonly url: _lupinum_ginko_internal.TextField & {
             readonly format: "url";
             readonly optional: true;
@@ -206,9 +219,12 @@ declare function blogCollections(opts: {
  * The optional changelog: one page at /changelog with one entry per release, newest first. Entries have no
  * page of their own, the page links to each by anchor. Files: `content/changelog/<name>[.<locale>].md`
  * with `version` and `date` in the frontmatter (a dot in the name would read as a language: use `v1-2-0.md`). Add `changelog: changelogPages({ locales })` to `pages` as well.
+ * The brick is `changelog()` of `@lupinum/ginko/basics` with the English labels docs sites store. `source`: see
+ * `DocsSource`.
  */
 declare function changelogCollection(opts?: {
     max?: number;
+    source?: DocsSource;
 }): _lupinum_ginko.CollectionBrick<{
     readonly version: _lupinum_ginko_internal.TextField & {
         readonly max: 40;
@@ -221,6 +237,10 @@ declare function changelogCollection(opts?: {
         readonly profile: "page";
     };
 }, undefined>;
+/** The start page by locale, for `pages` in ginko.config.ts: the main locale at `/`, the others at `/<locale>`. */
+declare const homePages: (opts: {
+    locales: Locales;
+}) => Record<string, "/">;
 /** The list pages by locale, for `pages` in ginko.config.ts: the sitemap and the static build know them from there. */
 declare const blogPages: (opts: {
     locales: Locales;
@@ -229,4 +249,5 @@ declare const changelogPages: (opts: {
     locales: Locales;
 }) => Record<string, "/changelog">;
 
-export { blogCollections, blogPages, changelogCollection, changelogPages, docsCollection, docsHome };
+export { blogCollections, blogPages, changelogCollection, changelogPages, docsCollection, docsHome, homePages };
+export type { DocsSource };

package/dist/config.mjs

@@ -1,18 +1,24 @@
 import { collection, f, single } from '@lupinum/ginko';
-import { B as BLOG_PATH, C as CHANGELOG_PATH } from './shared/ginko-docs.BwbF7JBR.mjs';
+import { authors, posts, changelog } from '@lupinum/ginko/basics';
+import { labelsIn } from '@lupinum/ginko/internal';
 export { components } from '@lupinum/ginko-components/registry';
 
+const BLOG_PATH = "/blog";
+const CHANGELOG_PATH = "/changelog";
+
+const sourceOf = (source = "files") => source === "files" ? { source } : {};
 function localized(locales, path) {
   const [main] = locales;
   if (main === void 0) throw new Error("[ginko-docs] `locales` is empty. Fix: pass the same list as `locales` in defineSite.");
-  return Object.fromEntries(locales.map((l) => [l, l === main ? path : `/${l}${path}`]));
+  const address = path;
+  return Object.fromEntries(locales.map((l) => [l, l === main ? path : address === "/" ? `/${l}` : `/${l}${path}`]));
 }
 function docsCollection(opts) {
   const { locales } = opts;
   const base = opts.base ?? "/docs";
   return collection({
     label: opts.label ?? "Docs",
-    source: "files",
+    ...sourceOf(opts.source),
     max: opts.max ?? 500,
     order: "manual",
     route: localized(locales, `${base}/[slug]`),
@@ -34,12 +40,12 @@ function docsCollection(opts) {
     }
   });
 }
-function docsHome() {
+function docsHome(opts = {}) {
   return single({
     label: "Start page",
-    source: "files",
+    ...sourceOf(opts.source),
     fields: {
-      title: f.text("Title", { max: 120 }),
+      title: f.text("Title", { max: 120, default: "Documentation" }),
       description: f.longtext("Description", { optional: true, max: 400 }),
       /** A command shown with a copy button, e.g. `pnpm add @lupinum/ginko`. */
       install: f.text("Install command", { optional: true, max: 200, translate: false }),
@@ -63,52 +69,15 @@ function docsHome() {
 function blogCollections(opts) {
   const { locales } = opts;
   return {
-    posts: collection({
-      label: "Posts",
-      source: "files",
-      max: opts.max ?? 500,
-      order: { field: "date", dir: "desc" },
-      route: localized(locales, `${BLOG_PATH}/[slug]`),
-      fields: {
-        title: f.text("Title"),
-        description: f.longtext("Description", { optional: true }),
-        date: f.date("Date"),
-        authors: f.refs("Authors", { to: "authors", optional: true }),
-        image: f.image("Image", { optional: true }),
-        tags: f.list("Tags", { itemLabel: "Tag", fields: { tag: f.text("Tag", { max: 40 }) }, max: 10, optional: true }),
-        slug: f.slug("Address", { from: "title" }),
-        body: f.markdown("Text", { profile: "page" })
-      }
-    }),
-    authors: collection({
-      label: "Authors",
-      source: "files",
-      max: 100,
-      order: "manual",
-      fields: {
-        name: f.text("Name"),
-        role: f.text("Role", { optional: true }),
-        avatar: f.image("Image", { optional: true }),
-        /** Shown as a link on the author's name. */
-        url: f.text("Website", { format: "url", optional: true })
-      }
-    })
+    posts: labelsIn(posts({ ...sourceOf(opts.source), max: opts.max, route: localized(locales, `${BLOG_PATH}/[slug]`) }), "en"),
+    authors: labelsIn(authors(sourceOf(opts.source)), "en")
   };
 }
 function changelogCollection(opts = {}) {
-  return collection({
-    label: "Changelog",
-    source: "files",
-    max: opts.max ?? 500,
-    order: { field: "date", dir: "desc" },
-    fields: {
-      version: f.text("Version", { max: 40, translate: false }),
-      date: f.date("Date"),
-      body: f.markdown("Text", { profile: "page" })
-    }
-  });
+  return labelsIn(changelog({ ...sourceOf(opts.source), max: opts.max }), "en");
 }
+const homePages = (opts) => localized(opts.locales, "/");
 const blogPages = (opts) => localized(opts.locales, BLOG_PATH);
 const changelogPages = (opts) => localized(opts.locales, CHANGELOG_PATH);
 
-export { blogCollections, blogPages, changelogCollection, changelogPages, docsCollection, docsHome };
+export { blogCollections, blogPages, changelogCollection, changelogPages, docsCollection, docsHome, homePages };

package/dist/icons.d.mts

@@ -0,0 +1,38 @@
+import { getIconData } from '@iconify/utils';
+import { NuxtModule } from 'nuxt/schema';
+
+type IconSet = Parameters<typeof getIconData>[0];
+type Entry = [body: string, viewBox: string];
+/**
+ * Code without its comments, so a commented-out icon is not bundled. `//` counts only at a line start or after a space
+ * (not in `https://`). In a .vue file the template keeps its text; only `<!-- -->` and the comments inside `<script>` go.
+ */
+declare const stripComments: (source: string, file?: string) => string;
+/** The icon names in app.config.ts (`icon: 'x'`) or a .vue file (`<Icon name="x">`, `icon="x"`). Comments are ignored. */
+declare const codeIconNames: (source: string, file: string) => string[];
+/**
+ * The icon names a content file names. YAML, JSON and front matter are read whole. In Markdown only the front matter,
+ * the attributes of a component (`:card{icon="x"}`) and the `---` block inside a `::component` count; prose and code are skipped.
+ */
+declare const contentIconNames: (source: string, file: string) => string[];
+/** One icon as [svg body, viewBox], read from the `docs` collection folder or an installed @iconify-json set (looked up from `roots`). */
+declare const readIcon: (name: string, roots: readonly string[], customDir: string, sets?: Map<string, IconSet | undefined>) => Entry | undefined;
+interface CollectOptions {
+    /** The layer's own folder (its `app/` is scanned for literal names, its `icons/` holds the `docs:` logos). */
+    layerRoot: string;
+    /** Root folders of every layer, the site first. Their `content/`, `app.config.ts` and (for the site's own layers) `app/` are scanned. */
+    roots: readonly string[];
+    /** Where to resolve `@iconify-json/<set>` from. */
+    resolveFrom: readonly string[];
+    /** Paths in warnings are shown relative to this folder. */
+    relativeTo: string;
+}
+/** Every icon the layer and the site name, read from the installed sets, plus one warning per name that is not installed. */
+declare const collectIcons: (o: CollectOptions) => {
+    icons: Record<string, Entry>;
+    warnings: string[];
+};
+declare const docsIcons: NuxtModule;
+
+export { codeIconNames, collectIcons, contentIconNames, docsIcons as default, readIcon, stripComments };
+export type { CollectOptions };

package/dist/icons.d.ts

@@ -0,0 +1,38 @@
+import { getIconData } from '@iconify/utils';
+import { NuxtModule } from 'nuxt/schema';
+
+type IconSet = Parameters<typeof getIconData>[0];
+type Entry = [body: string, viewBox: string];
+/**
+ * Code without its comments, so a commented-out icon is not bundled. `//` counts only at a line start or after a space
+ * (not in `https://`). In a .vue file the template keeps its text; only `<!-- -->` and the comments inside `<script>` go.
+ */
+declare const stripComments: (source: string, file?: string) => string;
+/** The icon names in app.config.ts (`icon: 'x'`) or a .vue file (`<Icon name="x">`, `icon="x"`). Comments are ignored. */
+declare const codeIconNames: (source: string, file: string) => string[];
+/**
+ * The icon names a content file names. YAML, JSON and front matter are read whole. In Markdown only the front matter,
+ * the attributes of a component (`:card{icon="x"}`) and the `---` block inside a `::component` count; prose and code are skipped.
+ */
+declare const contentIconNames: (source: string, file: string) => string[];
+/** One icon as [svg body, viewBox], read from the `docs` collection folder or an installed @iconify-json set (looked up from `roots`). */
+declare const readIcon: (name: string, roots: readonly string[], customDir: string, sets?: Map<string, IconSet | undefined>) => Entry | undefined;
+interface CollectOptions {
+    /** The layer's own folder (its `app/` is scanned for literal names, its `icons/` holds the `docs:` logos). */
+    layerRoot: string;
+    /** Root folders of every layer, the site first. Their `content/`, `app.config.ts` and (for the site's own layers) `app/` are scanned. */
+    roots: readonly string[];
+    /** Where to resolve `@iconify-json/<set>` from. */
+    resolveFrom: readonly string[];
+    /** Paths in warnings are shown relative to this folder. */
+    relativeTo: string;
+}
+/** Every icon the layer and the site name, read from the installed sets, plus one warning per name that is not installed. */
+declare const collectIcons: (o: CollectOptions) => {
+    icons: Record<string, Entry>;
+    warnings: string[];
+};
+declare const docsIcons: NuxtModule;
+
+export { codeIconNames, collectIcons, contentIconNames, docsIcons as default, readIcon, stripComments };
+export type { CollectOptions };