@riebeckite/plugin-taxonomy 0.0.32 → 0.0.33

package/README.md

@@ -8,6 +8,10 @@ client-side JavaScript is required.
 
 [日本語](./README_ja.md)
 
+## Live example
+
+Browse the generated [tags](/tags) and [folders](/folders) indexes. Each index page is produced by this plugin from the site's notes.
+
 ## Overview
 
 `taxonomy()` reads the manifest's public entries and produces two sets of
@@ -157,7 +161,7 @@ import "@riebeckite/plugin-taxonomy/style.css";
 ## Exports
 
 - `taxonomy(options?)` — plugin factory
-- `taxonomyPlugin` — alias of `taxonomy`
+- `taxonomy` — alias of `taxonomy`
 - `resolveTaxonomyOptions(options?)` — apply option defaults
 - `resolveTaxonomyOptionsFromConfig(config)` — read resolved options back from a config
 - `buildTaxonomyIndex(entries, options)` — build tag and folder terms

package/README_ja.md

@@ -2,28 +2,24 @@
 
 <!-- Generated from docs/docs/plugins/taxonomy.ja.md. Edit the canonical documentation in docs/docs/plugins and run `pnpm docs:sync`. -->
 
-Riebeckite のビルド時タクソノミー（タグ・フォルダ）プラグインです。一覧用データ、
-語ごとの RSS / Atom / JSON フィード、関連タグナビゲーション、SEO メタデータを
-生成します。クライアント JavaScript は不要です。
+Riebeckite のビルド時タクソノミー（タグ・フォルダ）プラグインです。一覧用データ、タームごとの RSS / Atom / JSON フィード、関連タグナビゲーション、SEO メタデータを生成します。クライアント JavaScript は不要です。
 
 [English](./README.md)
 
+## 実行例
+
+生成された [タグ](/tags) と [フォルダ](/folders) の一覧を開いてください。どちらもノートからこのプラグインが生成しています。
+
 ## 概要
 
-`taxonomy()` はマニフェストの公開エントリを読み、Core の collection の取り決め
-（`buildContentCollections`）で 2 種類の一覧語を生成します。
+`taxonomy()` はマニフェストの公開エントリを読み、Core のコレクションの取り決め（`buildContentCollections`）でタグとフォルダという 2 種類のタームを生成します。
 
-- **タグ**: `tags` でグルーピングし `/tags/<slug>` に配置します。
-- **フォルダ**: フォルダでグルーピングし `/folders/<path>` に配置します。
+- **タグターム**: `tags` でグルーピングし `/tags/<slug>` に配置します。
+- **フォルダターム**: フォルダでグルーピングし `/folders/<path>` に配置します。
 
-エントリのリンクには常に解決済みの `permalink` を使い、slug から URL を組み立てる
-ことはありません。
+エントリのリンクには常に解決済みの `permalink` を使い、slug から URL を組み立てることはありません。
 
-このプラグインはデータ・フィード・SEO に加え、`/tags/<tag>` と
-`/folders/<path>` の Page Type を提供します。語ごとのフィードは build の
-generated-output sink 経由で静的ファイルとして出力します。サイトは共通の
-Riebeckite catch-all route で Page Type を描画するため、taxonomy 専用の
-アプリケーションルートは不要です。
+このプラグインはデータ・フィード・SEO に加え、`/tags/<tag>` と `/folders/<path>` のページ種別を提供します。タームごとのフィードはビルド時に generated-output sink 経由で静的ファイルとして出力します。サイトは共通の Riebeckite catch-all ルートでページ種別を描画するため、タクソノミー専用のアプリケーションルートは不要です。
 
 ## 使い方
 
@@ -47,24 +43,23 @@ export default defineConfig({
 
 | オプション | 型 | 既定値 | 説明 |
 | ---------- | -- | ------ | ---- |
-| `tags` | `boolean` | `true` | タグ語を生成する |
-| `folders` | `boolean` | `true` | フォルダ語を生成する |
+| `tags` | `boolean` | `true` | タグタームを生成する |
+| `folders` | `boolean` | `true` | フォルダタームを生成する |
 | `tagsBasePath` | `string` | `"/tags"` | タグ一覧のパス接頭辞 |
 | `foldersBasePath` | `string` | `"/folders"` | フォルダ一覧のパス接頭辞 |
 | `folderDepth` | `number` | `0` | フォルダのグルーピング深さ。`0` は完全パス |
-| `minEntries` | `number` | `1` | これ未満のエントリ数しかない語を除外する |
+| `minEntries` | `number` | `1` | エントリ数がこれ未満のタームを除外する |
 | `related` | `boolean` | `true` | 関連タグナビゲーションを生成する |
 | `relatedLimit` | `number` | `8` | タグごとの関連タグ上限 |
-| `feeds` | `{ rss?, atom?, json? }` | すべて `true` | 語ごとのフィード形式 |
+| `feeds` | `{ rss?, atom?, json? }` | すべて `true` | タームごとのフィード形式 |
 | `feedLimit` | `number` | `50` | フィードあたりの最大エントリ数 |
-| `resolveTitle` | `(context) => string` | `#value` / パス | 語の表示タイトル |
+| `resolveTitle` | `(context) => string` | `#value` / パス | タームの表示タイトル |
 | `className` | `string` | `"rr-taxonomy"` | ページ断片のルート CSS クラス |
 | `dataEndpoint` | `string` | `"/taxonomy/index.json"` | JSON データのエンドポイント |
 
 ## データエンドポイント
 
-プラグインは JSON エンドポイントを 1 つ登録します（endpoint の取り決めは HonoX
-integration が接続するため、プラグイン自身は framework のルーティングを持ちません）。
+プラグインは JSON エンドポイントを 1 つ登録します（エンドポイントの取り決めは HonoX 連携が接続するため、プラグイン自身はフレームワークのルーティングを持ちません）。
 
 ```
 GET /taxonomy/index.json
@@ -89,12 +84,11 @@ GET /taxonomy/index.json
 }
 ```
 
-ペイロードは決定的で JSON 安全な射影です。描画済み HTML を含まないため、アプリの
-ルートやブラウザへそのまま渡せます。
+ペイロードは決定的で JSON 安全な射影です。描画済み HTML を含まないため、アプリのルートやブラウザへそのまま渡せます。
 
 ## 生成されるフィード
 
-ビルド時に、語と形式ごとに 1 つのフィードを `context.output.emit` で出力します。
+ビルド時に、タームと形式ごとに 1 つのフィードを `context.output.emit` で出力します。
 
 | 形式 | パス |
 | ---- | ---- |
@@ -102,52 +96,31 @@ GET /taxonomy/index.json
 | Atom | `/tags/<slug>/atom.xml` |
 | JSON Feed 1.1 | `/tags/<slug>/feed.json` |
 
-フォルダ語も同じファイルを `/folders/<path>/…` に持ちます。フィードの channel は
-語ごとのタイトルと self link を持つため、タグの購読と
-`@riebeckite/plugin-seo` が持つサイト全体のフィードを区別できます。公開かつ
-`noindex` でないエントリだけがマニフェストの公開ビューに入り、フィードへ届きます。
-語ごとの RSS と Atom はエントリの要約を出します。語ごとの JSON Feed は同じ要約を
-`content_text` として出し、描画済みの記事 HTML は複製しません。
+フォルダタームも同じファイルを `/folders/<path>/…` に持ちます。フィードのチャネルはタームごとのタイトルと自己リンクを持つため、タグの購読と `@riebeckite/plugin-seo` が持つサイト全体のフィードを区別できます。公開かつ `noindex` でないエントリだけがマニフェストの公開ビューに入り、フィードへ届きます。タームごとの RSS と Atom はエントリの要約を出します。タームごとの JSON Feed は同じ要約を `content_text` として出し、描画済みの記事 HTML は複製しません。
 
 ## 関連タグ
 
-`related` が有効なとき、各タグ語は同じエントリに共起するタグを保持します。共起
-エントリ数で降順、同数ならアルファベット順に並べ、`relatedLimit` で打ち切ります。
-ナビゲーションは `renderTaxonomyPage` が各 taxonomy term ページで実際に描画します。共起するタグがあるタグページで確認できます。
+`related` が有効なとき、各タグタームは同じエントリに共起するタグを保持します。共起エントリ数で降順、同数ならアルファベット順に並べ、`relatedLimit` で打ち切ります。ナビゲーションは `renderTaxonomyPage` が各タームページで実際に描画します。共起するタグがあるタグページで確認できます。
 
 ## SEO
 
-`buildTaxonomySeo(config, term)` は一覧ページの `SeoMetadata` を返します。設定済みの
-Core `seo` 拡張ポイント（たとえば `@riebeckite/plugin-seo`）へ委譲するため、
-タイトル・canonical URL・JSON-LD がサイト全体と揃います。SEO プロバイダーが無い
-場合は最小限のオブジェクトへフォールバックします。
+`buildTaxonomySeo(config, term)` は一覧ページの `SeoMetadata` を返します。設定済みの Core `seo` 拡張ポイント（たとえば `@riebeckite/plugin-seo`）へ委譲するため、タイトル・canonical URL・JSON-LD がサイト全体と揃います。SEO プロバイダーが無い場合は最小限のオブジェクトへフォールバックします。
 
-## フォルダ index note
+## フォルダの index ノート
 
 フォルダ入口の解決は
 [`@riebeckite/plugin-folder-pages`](../folder-pages/README_ja.md) が所有します。
-taxonomy はマニフェストの公開ビューからタグ語とフォルダ語だけを生成します。
-`<folder>/README.md` や `<folder>/index.md` をフォルダのランディングページに
-する場合は、そのプラグインを有効にしてください。
+タクソノミーはマニフェストの公開ビューからタグタームとフォルダタームだけを生成します。`<folder>/README.md` や `<folder>/index.md` をフォルダのランディングページにする場合は、そのプラグインを有効にしてください。
 
-## Page Type
+## ページ種別
 
-`taxonomy()` は 2 つの Page Type を登録します。`taxonomy-term` は 1 つのタグ・
-フォルダページを描画し、フィード検出用の `<link rel="alternate">` メタデータを
-含みます。`taxonomy-index` は `tagsBasePath` に全タグ一覧、`foldersBasePath` に
-全フォルダ一覧を描画し、各語へリンクします。どちらも SSG のパスと resolver を
-公開マニフェストから作るため、非公開エントリがタグ・フォルダ・一覧ページへ
-入ることはありません。
+`taxonomy()` は 2 つのページ種別を登録します。`taxonomy-term` は 1 つのタグ・フォルダページを描画し、フィード検出用の `<link rel="alternate">` メタデータを含みます。`taxonomy-index` は `tagsBasePath` に全タグ一覧、`foldersBasePath` に全フォルダ一覧を描画し、各タームへリンクします。どちらも SSG のパスとリゾルバーを公開マニフェストから作るため、非公開エントリがタグ・フォルダ・一覧ページへ入ることはありません。
 
-サイトの共通 catch-all route では、`@riebeckite/honox/server` の
-`pluginPageSsgParams(content)` と `resolveRiebeckiteRoute(content, path)` を使います。
-これはすべての Plugin Page Type に共通の配線です。
+サイトの共通 catch-all ルートでは、`@riebeckite/honox/server` の `pluginPageSsgParams(content)` と `resolveRiebeckiteRoute(content, path)` を使います。これはすべてのプラグインのページ種別に共通の配線です。
 
 ## スタイル
 
-パッケージは安定した `rr-taxonomy` ルートフックと `--rr-taxonomy-*` トークン
-（`--rb-*` へフォールバック）を持つ `style.css` を同梱します。他のプラグイン
-スタイルシートと同じように登録してください。
+パッケージは安定した `rr-taxonomy` ルートフックと `--rr-taxonomy-*` トークン（`--rb-*` へフォールバック）を持つ `style.css` を同梱します。他のプラグインのスタイルシートと同じように登録してください。
 
 ```ts
 import "@riebeckite/plugin-taxonomy/style.css";
@@ -155,15 +128,15 @@ import "@riebeckite/plugin-taxonomy/style.css";
 
 ## エクスポート
 
-- `taxonomy(options?)`：プラグインファクトリー
-- `taxonomyPlugin`：`taxonomy` の別名
+- `taxonomy(options?)`：プラグインファクトリ
+- `taxonomy`：`taxonomy` の別名
 - `resolveTaxonomyOptions(options?)`：既定値を適用する
 - `resolveTaxonomyOptionsFromConfig(config)`：config から解決済みオプションを読む
-- `buildTaxonomyIndex(entries, options)`：タグ・フォルダ語を構築する
+- `buildTaxonomyIndex(entries, options)`：タグ・フォルダタームを構築する
 - `serializeTaxonomyIndex(index)` / `serializeTaxonomyTerm(term)`：JSON 安全な射影
 - `renderTaxonomyPage(term, options)` / `renderRelatedTerms(term, options)`：ページ断片
 - `renderTaxonomyIndexPage(kind, terms, options)`：全タグ・全フォルダ一覧のページ断片
-- `renderTermFeed(config, term, format, limit?)` / `buildFeedHeadTags(term)`：語ごとのフィード
+- `renderTermFeed(config, term, format, limit?)` / `buildFeedHeadTags(term)`：タームごとのフィード
 - `buildTaxonomySeo(config, term)`：一覧ページの SEO メタデータ
 - `slugifyTaxonomyValue(value)`：URL・ファイル用の slug
 - `buildTaxonomyAbsoluteUrl(config, pathOrUrl)`：絶対 URL
@@ -172,10 +145,10 @@ import "@riebeckite/plugin-taxonomy/style.css";
 ## 制約
 
 - タクソノミーはビルド時に固定されます。フルビルドで常に正しく再計算されます。
-- 語ごとのフィードは静的なビルド成果物です。実行時のサーフェスは固定の JSON
-  データエンドポイントだけです。dev サーバーは語ごとのフィードファイルを列挙
-  しません。
-- 語はマニフェストの公開ビューのみを反映します。非公開または `noindex` の
+- タームごとのフィードは静的なビルド成果物です。実行時のサーフェスは固定の JSON
+  データエンドポイントだけです。開発サーバーはタームごとのフィードファイルを
+  列挙しません。
+- タームはマニフェストの公開ビューのみを反映します。非公開または `noindex` の
   エントリは除外されます。
 
 ## 関連

package/dist/index.d.ts

@@ -5,7 +5,7 @@ export { buildFeedHeadTags, renderTermFeed } from "./src/feeds.js";
 export { DEFAULT_TAXONOMY_CLASS_NAME, DEFAULT_TAXONOMY_DATA_ENDPOINT, DEFAULT_TAXONOMY_FEED_LIMIT, DEFAULT_TAXONOMY_FOLDERS_BASE_PATH, DEFAULT_TAXONOMY_MIN_ENTRIES, DEFAULT_TAXONOMY_RELATED_LIMIT, DEFAULT_TAXONOMY_TAGS_BASE_PATH, resolveTaxonomyOptions, } from "./src/options.js";
 export { renderRelatedTerms, renderTaxonomyIndexPage, renderTaxonomyPage, } from "./src/pages.js";
 export { buildTaxonomySeo } from "./src/seo.js";
-export { slugifyTaxonomyValue } from "./src/slug.js";
+export { buildTaxonomyTagHref, slugifyTaxonomyValue } from "./src/slug.js";
 export type { ResolvedTaxonomyOptions, TaxonomyEntryReference, TaxonomyFeedFormat, TaxonomyFeedLinks, TaxonomyFeedOptions, TaxonomyHeadTag, TaxonomyIndex, TaxonomyIndexData, TaxonomyKind, TaxonomyOptions, TaxonomyPage, TaxonomyRelatedTerm, TaxonomyTerm, TaxonomyTermContext, TaxonomyTermData, } from "./src/types.js";
 export { buildTaxonomyAbsoluteUrl } from "./src/url.js";
 export declare const TAXONOMY_PLUGIN_NAME = "taxonomy";
@@ -19,8 +19,6 @@ export declare const TAXONOMY_PLUGIN_NAME = "taxonomy";
  * generated-output sink, so no client JavaScript is required.
  */
 export declare function taxonomy(options?: TaxonomyOptions): import("@riebeckite/core").RiebeckitePlugin<TaxonomyOptions>;
-/** Alias matching the `*Plugin` suffix used by other plugin factories. */
-export declare const taxonomyPlugin: typeof taxonomy;
 /**
  * Reads the taxonomy plugin's resolved options back from a Riebeckite config.
  *

package/dist/index.js

@@ -16,6 +16,12 @@ import {
 function slugifyTaxonomyValue(value) {
   return value.split("/").map(slugifyTaxonomySegment).filter((segment) => segment.length > 0).join("/");
 }
+function buildTaxonomyTagHref(tag, tagsBasePath) {
+  const slug = slugifyTaxonomyValue(tag);
+  const trimmedBase = tagsBasePath.trim().replace(/\/+$/, "");
+  const base = trimmedBase === "" || trimmedBase.startsWith("/") ? trimmedBase : `/${trimmedBase}`;
+  return slug ? `${base}/${slug}` : base;
+}
 function slugifyTaxonomySegment(segment) {
   const slug = segment.trim().toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
   if (slug) return slug;
@@ -24,18 +30,20 @@ function slugifyTaxonomySegment(segment) {
 }
 
 // src/collections.ts
-function buildTaxonomyIndex(entries, options) {
+function buildTaxonomyIndex(entries, options, icons) {
   const tags = options.tags ? buildTerms(entries, {
     kind: "tag",
     basePath: options.tagsBasePath,
     groupBy: { by: "tags" },
-    options
+    options,
+    icon: findRegistryIcon(icons?.tags)
   }) : [];
   const folders = options.folders ? buildTerms(entries, {
     kind: "folder",
     basePath: options.foldersBasePath,
     groupBy: options.folderDepth > 0 ? { by: "folder", depth: options.folderDepth } : { by: "folder" },
-    options
+    options,
+    icon: findRegistryIcon(icons?.folders)
   }) : [];
   if (options.related && tags.length > 0) {
     attachRelatedTerms(tags, entries, options);
@@ -52,7 +60,8 @@ function serializeTaxonomyTerm(term) {
     count: term.entries.length,
     entries: term.entries.map(toEntryReference),
     related: term.related,
-    feeds: term.feeds
+    feeds: term.feeds,
+    ...term.icon ? { icon: term.icon } : {}
   };
 }
 function serializeTaxonomyIndex(index) {
@@ -67,11 +76,12 @@ function toEntryReference(entry) {
     permalink: entry.permalink,
     title: entry.title,
     updated: getEntryUpdatedTime(entry),
-    summary: getEntrySummary(entry)
+    summary: getEntrySummary(entry),
+    ...entry.icon ? { icon: entry.icon } : {}
   };
 }
 function buildTerms(entries, input) {
-  const { kind, basePath, groupBy, options } = input;
+  const { kind, basePath, groupBy, options, icon } = input;
   const definition = {
     kind,
     basePath,
@@ -88,11 +98,13 @@ function buildTerms(entries, input) {
     const path = normalizeTermPath(collection.path, basePath);
     if (seen.has(path)) continue;
     seen.add(path);
+    const termIcon = icon?.(collection.value);
     terms.push({
       kind,
       value: collection.value,
       title: collection.title,
       path,
+      ...termIcon ? { icon: termIcon } : {},
       entries: collection.entries,
       related: [],
       feeds: buildFeedLinks(path, options),
@@ -141,7 +153,8 @@ function attachRelatedTerms(tags, entries, options) {
       title: related.title,
       path: related.path,
       permalink: related.path,
-      count
+      count,
+      ...related.icon ? { icon: related.icon } : {}
     }));
   }
 }
@@ -181,6 +194,17 @@ function getEntryUpdatedTime(entry) {
   const date = new Date(value);
   return Number.isNaN(date.getTime()) ? null : date.toISOString();
 }
+function findRegistryIcon(registry) {
+  if (!registry) return void 0;
+  return (value) => {
+    if (registry[value]) return registry[value];
+    const lower = value.toLowerCase();
+    for (const [candidate, icon] of Object.entries(registry)) {
+      if (candidate.toLowerCase() === lower) return icon;
+    }
+    return void 0;
+  };
+}
 
 // src/url.ts
 function buildTaxonomyAbsoluteUrl(config, pathOrUrl) {
@@ -395,13 +419,13 @@ function renderTaxonomyPage(term, options) {
   const entries = term.entries.map(
     (entry) => `<li class="${className}__item"><a class="${className}__link" href="${escapeHtmlAttribute(
       entry.permalink
-    )}">${escapeHtml(entry.title)}</a></li>`
+    )}">${renderIcon(entry.icon)}${escapeHtml(entry.title)}</a></li>`
   ).join("");
   const feeds = renderFeedLinks(term, className);
   const related = renderRelatedTerms(term, options);
   const html = `<section class="${className}" data-rr-taxonomy="${term.kind}" data-rr-taxonomy-value="${escapeHtmlAttribute(
     term.value
-  )}"><h1 class="${className}__title">${escapeHtml(term.title)}</h1><p class="${className}__count" data-rr-taxonomy-count="${term.entries.length}">${term.entries.length}</p>${feeds}<ul class="${className}__list">${entries}</ul>${related}</section>`;
+  )}"><h1 class="${className}__title">${renderIcon(term.icon)}${escapeHtml(term.title)}</h1><p class="${className}__count" data-rr-taxonomy-count="${term.entries.length}">${term.entries.length}</p>${feeds}<ul class="${className}__list">${entries}</ul>${related}</section>`;
   return {
     title: term.title,
     frontmatter: { title: term.title },
@@ -417,7 +441,7 @@ function renderRelatedTerms(term, options) {
   const items = term.related.map(
     (related) => `<li class="${className}__related-item"><a class="${className}__related-link" href="${escapeHtmlAttribute(
       related.path
-    )}" data-rr-taxonomy-related-count="${related.count}">${escapeHtml(related.title)}</a></li>`
+    )}" data-rr-taxonomy-related-count="${related.count}">${renderIcon(related.icon)}${escapeHtml(related.title)}</a></li>`
   ).join("");
   return `<nav class="${className}__related" aria-label="Related tags" data-rr-taxonomy-related><ul>${items}</ul></nav>`;
 }
@@ -427,7 +451,7 @@ function renderTaxonomyIndexPage(kind, terms, options) {
   const items = terms.map(
     (term) => `<li class="${className}__item"><a class="${className}__link" href="${escapeHtmlAttribute(
       term.path
-    )}" data-rr-taxonomy-count="${term.entries.length}">${escapeHtml(
+    )}" data-rr-taxonomy-count="${term.entries.length}">${renderIcon(term.icon)}${escapeHtml(
       term.title
     )}</a></li>`
   ).join("");
@@ -441,6 +465,9 @@ function renderTaxonomyIndexPage(kind, terms, options) {
     headTags: []
   };
 }
+function renderIcon(icon) {
+  return icon ? `<span class="rr-taxonomy__icon">${icon.html}</span>` : "";
+}
 function renderFeedLinks(term, className) {
   const links = [];
   if (term.feeds.rss) {
@@ -512,7 +539,8 @@ function taxonomy(options = {}) {
           const term = findTaxonomyTerm(
             manifest.discoverableEntries,
             resolved,
-            pathname
+            pathname,
+            manifest.icons
           );
           return term ? taxonomyPageOutputDependencies(term, resolved.related) : [{ type: "unknown" }];
         },
@@ -520,7 +548,8 @@ function taxonomy(options = {}) {
           const term = findTaxonomyTerm(
             manifest.discoverableEntries,
             resolved,
-            pathname
+            pathname,
+            manifest.icons
           );
           if (!term) return null;
           const page = renderTaxonomyPage(term, resolved);
@@ -549,7 +578,8 @@ function taxonomy(options = {}) {
           if (!kind) return null;
           const index = buildTaxonomyIndex(
             manifest.discoverableEntries,
-            resolved
+            resolved,
+            manifest.icons
           );
           const page = renderTaxonomyIndexPage(
             kind,
@@ -597,7 +627,6 @@ function taxonomy(options = {}) {
     ]
   });
 }
-var taxonomyPlugin = taxonomy;
 function taxonomyPagePaths(entries, options) {
   const index = buildTaxonomyIndex(entries, options);
   return [...index.tags, ...index.folders].map((term) => term.path);
@@ -619,8 +648,8 @@ var pageProjectionDependencies = [
   { type: "projection", projection: "navigation" },
   { type: "projection", projection: "recent-posts" }
 ];
-function findTaxonomyTerm(entries, options, pathname) {
-  const index = buildTaxonomyIndex(entries, options);
+function findTaxonomyTerm(entries, options, pathname, icons) {
+  const index = buildTaxonomyIndex(entries, options, icons);
   return [...index.tags, ...index.folders].find(
     (term) => term.path === pathname
   );
@@ -659,7 +688,11 @@ function createTaxonomyEndpoints(resolved) {
       resolved.dataEndpoint,
       ({ manifest }) => ({
         json: serializeTaxonomyIndex(
-          buildTaxonomyIndex(manifest.discoverableEntries, resolved)
+          buildTaxonomyIndex(
+            manifest.discoverableEntries,
+            resolved,
+            manifest.icons
+          )
         )
       }),
       { cacheControl: "public, max-age=300" }
@@ -755,6 +788,7 @@ export {
   buildTaxonomyAbsoluteUrl,
   buildTaxonomyIndex,
   buildTaxonomySeo,
+  buildTaxonomyTagHref,
   renderRelatedTerms,
   renderTaxonomyIndexPage,
   renderTaxonomyPage,
@@ -765,6 +799,5 @@ export {
   serializeTaxonomyTerm,
   slugifyTaxonomyValue,
   taxonomy,
-  taxonomyPlugin,
   toEntryReference
 };

package/dist/src/collections.d.ts

@@ -1,4 +1,4 @@
-import { type ContentManifestEntry } from "@riebeckite/core";
+import { type ContentIconRegistry, type ContentManifestEntry } from "@riebeckite/core";
 import type { ResolvedTaxonomyOptions, TaxonomyEntryReference, TaxonomyIndex, TaxonomyIndexData, TaxonomyTerm, TaxonomyTermData } from "./types.js";
 /**
  * Builds the tag and folder taxonomy for the given entries. It reuses the Core
@@ -9,7 +9,7 @@ import type { ResolvedTaxonomyOptions, TaxonomyEntryReference, TaxonomyIndex, Ta
  * `entries` should be the manifest's public view; unpublished notes never reach
  * generated data or feeds.
  */
-export declare function buildTaxonomyIndex(entries: readonly ContentManifestEntry[], options: ResolvedTaxonomyOptions): TaxonomyIndex;
+export declare function buildTaxonomyIndex(entries: readonly ContentManifestEntry[], options: ResolvedTaxonomyOptions, icons?: ContentIconRegistry): TaxonomyIndex;
 /** Projects a term into a JSON-safe shape for endpoints and client data. */
 export declare function serializeTaxonomyTerm(term: TaxonomyTerm): TaxonomyTermData;
 /** Projects the whole index into a JSON-safe shape. */

package/dist/src/slug.d.ts

@@ -8,3 +8,4 @@
  * percent-encoded text so distinct values never share a URL.
  */
 export declare function slugifyTaxonomyValue(value: string): string;
+export declare function buildTaxonomyTagHref(tag: string, tagsBasePath: string): string;

package/dist/src/types.d.ts

@@ -1,4 +1,4 @@
-import type { ContentManifestEntry, SeoMetadata } from "@riebeckite/core";
+import type { ContentIcon, ContentManifestEntry, SeoMetadata } from "@riebeckite/core";
 /** Feed formats the taxonomy plugin can generate per term. */
 export type TaxonomyFeedFormat = "rss" | "atom" | "json";
 /** A taxonomy grouping category. */
@@ -67,6 +67,7 @@ export type TaxonomyEntryReference = {
     title: string;
     updated: string | null;
     summary: string;
+    icon?: ContentIcon;
 };
 /** A related-term reference used by related-tag navigation. */
 export type TaxonomyRelatedTerm = {
@@ -76,6 +77,7 @@ export type TaxonomyRelatedTerm = {
     path: string;
     permalink: string;
     count: number;
+    icon?: ContentIcon;
 };
 /** Resolved feed URLs for one term. */
 export type TaxonomyFeedLinks = {
@@ -90,6 +92,8 @@ export type TaxonomyTerm = {
     value: string;
     /** Display title, `#value` for tags by default. */
     title: string;
+    /** Resolved icon for the term, when one is configured. */
+    icon?: ContentIcon;
     /** Site-local listing path, for example `/tags/guide/intro`. */
     path: string;
     /** Resolved entries, in manifest query order. */
@@ -117,6 +121,7 @@ export type TaxonomyTermData = {
     entries: TaxonomyEntryReference[];
     related: TaxonomyRelatedTerm[];
     feeds: TaxonomyFeedLinks;
+    icon?: ContentIcon;
 };
 /** JSON-safe projection of a {@link TaxonomyIndex}. */
 export type TaxonomyIndexData = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@riebeckite/plugin-taxonomy",
-  "version": "0.0.32",
+  "version": "0.0.33",
   "license": "Apache-2.0",
   "type": "module",
   "main": "./dist/index.js",
@@ -15,7 +15,7 @@
     "./style.css": "./style.css"
   },
   "dependencies": {
-    "@riebeckite/core": "0.0.32"
+    "@riebeckite/core": "0.0.33"
   },
   "devDependencies": {
     "tsx": "^4.22.4"