@riebeckite/plugin-taxonomy 0.0.21 → 0.0.23

package/README.md

@@ -1,5 +1,7 @@
 # @riebeckite/plugin-taxonomy
 
+<!-- Generated from docs/docs/plugins/taxonomy.md. Edit the canonical documentation in docs/docs/plugins and run `pnpm docs:sync`. -->
+
 Build-time tag and folder taxonomy for Riebeckite: listing data, per-term
 RSS / Atom / JSON feeds, related-tag navigation, and SEO metadata. No
 client-side JavaScript is required.
@@ -111,17 +113,7 @@ summary as `content_text` and do not duplicate rendered article HTML.
 
 When `related` is enabled, each tag term carries tags that co-occur on the same
 entries, ranked by shared-entry count then alphabetically, clamped to
-`relatedLimit`. Related navigation is rendered by `renderTaxonomyPage`:
-
-```html
-<nav class="rr-taxonomy__related" aria-label="Related tags" data-rr-taxonomy-related>
-  <ul>
-    <li class="rr-taxonomy__related-item">
-      <a class="rr-taxonomy__related-link" href="/tags/featured" data-rr-taxonomy-related-count="2">#featured</a>
-    </li>
-  </ul>
-</nav>
-```
+`relatedLimit`. Related navigation is rendered by `renderTaxonomyPage` on each taxonomy term page. Visit a tag page with co-occurring tags to see the live navigation.
 
 ## SEO
 
@@ -188,5 +180,5 @@ import "@riebeckite/plugin-taxonomy/style.css";
 
 ## See also
 
-- [Plugin guide](../../../docs/docs/reference/plugin-api.md)
-- [Content system](../../../docs/docs/framework/content-system.md)
+- [Plugin guide](https://github.com/Rerurate514/riebeckite/blob/main/docs/docs/reference/plugin-api.md)
+- [Content system](https://github.com/Rerurate514/riebeckite/blob/main/docs/docs/framework/content-system.md)

package/README_ja.md

@@ -1,5 +1,7 @@
 # @riebeckite/plugin-taxonomy
 
+<!-- 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 は不要です。
@@ -111,17 +113,7 @@ GET /taxonomy/index.json
 
 `related` が有効なとき、各タグ語は同じエントリに共起するタグを保持します。共起
 エントリ数で降順、同数ならアルファベット順に並べ、`relatedLimit` で打ち切ります。
-ナビゲーションは `renderTaxonomyPage` が描画します。
-
-```html
-<nav class="rr-taxonomy__related" aria-label="Related tags" data-rr-taxonomy-related>
-  <ul>
-    <li class="rr-taxonomy__related-item">
-      <a class="rr-taxonomy__related-link" href="/tags/featured" data-rr-taxonomy-related-count="2">#featured</a>
-    </li>
-  </ul>
-</nav>
-```
+ナビゲーションは `renderTaxonomyPage` が各 taxonomy term ページで実際に描画します。共起するタグがあるタグページで確認できます。
 
 ## SEO
 
@@ -188,5 +180,5 @@ import "@riebeckite/plugin-taxonomy/style.css";
 
 ## 関連
 
-- [プラグインガイド](../../../docs/docs/reference/plugin-api.ja.md)
-- [コンテンツシステム](../../../docs/docs/framework/content-system.ja.md)
+- [プラグインガイド](https://github.com/Rerurate514/riebeckite/blob/main/docs/docs/reference/plugin-api.ja.md)
+- [コンテンツシステム](https://github.com/Rerurate514/riebeckite/blob/main/docs/docs/framework/content-system.ja.md)

package/dist/index.js

@@ -499,7 +499,6 @@ function buildDescription(term) {
 var TAXONOMY_PLUGIN_NAME = "taxonomy";
 function taxonomy(options = {}) {
   const resolved = resolveTaxonomyOptions(options);
-  const emittedFeeds = /* @__PURE__ */ new Set();
   return definePlugin({
     name: TAXONOMY_PLUGIN_NAME,
     options,
@@ -509,7 +508,14 @@ function taxonomy(options = {}) {
       {
         id: "taxonomy-term",
         paths: ({ manifest }) => taxonomyPagePaths(manifest.discoverableEntries, resolved),
-        outputDependencies: [{ type: "global" }],
+        outputDependencies: ({ manifest, pathname }) => {
+          const term = findTaxonomyTerm(
+            manifest.discoverableEntries,
+            resolved,
+            pathname
+          );
+          return term ? taxonomyPageOutputDependencies(term, resolved.related) : [{ type: "unknown" }];
+        },
         resolve: ({ manifest, pathname }) => {
           const term = findTaxonomyTerm(
             manifest.discoverableEntries,
@@ -530,7 +536,14 @@ function taxonomy(options = {}) {
       {
         id: "taxonomy-index",
         paths: () => taxonomyIndexPagePaths(resolved),
-        outputDependencies: [{ type: "global" }],
+        outputDependencies: ({ pathname }) => {
+          const kind = resolveTaxonomyIndexPath(pathname, resolved);
+          const dependency = kind === "tag" ? { type: "projection", projection: "taxonomy-tags" } : kind === "folder" ? {
+            type: "projection",
+            projection: "taxonomy-folders"
+          } : void 0;
+          return dependency ? [...pageProjectionDependencies, dependency] : [{ type: "unknown" }];
+        },
         resolve: ({ manifest, pathname }) => {
           const kind = resolveTaxonomyIndexPath(pathname, resolved);
           if (!kind) return null;
@@ -552,24 +565,36 @@ function taxonomy(options = {}) {
         }
       }
     ],
-    buildEnd(context) {
-      const { config, manifest } = context;
-      if (!config) return;
-      const index = buildTaxonomyIndex(manifest.discoverableEntries, resolved);
+    planGeneratedOutputs(context) {
+      if (!context.site) return [];
+      const index = buildTaxonomyIndex(
+        context.manifest.discoverableEntries,
+        resolved
+      );
+      const outputs = [];
       for (const term of [...index.tags, ...index.folders]) {
         for (const format of enabledFormats(resolved)) {
           const path = feedFilePath(term.path, format);
-          if (emittedFeeds.has(path)) continue;
-          emittedFeeds.add(path);
-          context.output.emit({
+          outputs.push({
             path,
-            content: renderTermFeed(config, term, format, resolved.feedLimit),
-            dependencies: [{ type: "global" }]
+            content: renderTermFeed(
+              { site: context.site },
+              term,
+              format,
+              resolved.feedLimit
+            ),
+            dependencies: taxonomyOutputDependencies(term)
           });
         }
       }
+      return outputs;
     },
-    assets: [createStyleAsset(TAXONOMY_PLUGIN_NAME)]
+    assets: [
+      createStyleAsset(
+        TAXONOMY_PLUGIN_NAME,
+        "@riebeckite/plugin-taxonomy/style.css"
+      )
+    ]
   });
 }
 var taxonomyPlugin = taxonomy;
@@ -577,6 +602,23 @@ function taxonomyPagePaths(entries, options) {
   const index = buildTaxonomyIndex(entries, options);
   return [...index.tags, ...index.folders].map((term) => term.path);
 }
+function taxonomyOutputDependencies(term) {
+  return [
+    term.kind === "tag" ? { type: "tag", tag: term.value } : { type: "folder", folder: term.value }
+  ];
+}
+function taxonomyPageOutputDependencies(term, related) {
+  const relatedDependencies = related && term.kind === "tag" ? [{ type: "projection", projection: "taxonomy-tags" }] : [];
+  return [
+    ...pageProjectionDependencies,
+    ...taxonomyOutputDependencies(term),
+    ...relatedDependencies
+  ];
+}
+var pageProjectionDependencies = [
+  { type: "projection", projection: "navigation" },
+  { type: "projection", projection: "recent-posts" }
+];
 function findTaxonomyTerm(entries, options, pathname) {
   const index = buildTaxonomyIndex(entries, options);
   return [...index.tags, ...index.folders].find(

package/dist/src/feeds.d.ts

@@ -5,6 +5,6 @@ import type { TaxonomyFeedFormat, TaxonomyHeadTag, TaxonomyTerm } from "./types.
  * link so a tag subscription is distinguishable from the site-wide feed that
  * `@riebeckite/plugin-seo` owns.
  */
-export declare function renderTermFeed(config: ResolvedRiebeckiteConfig, term: TaxonomyTerm, format: TaxonomyFeedFormat, limit?: number): string;
+export declare function renderTermFeed(config: Pick<ResolvedRiebeckiteConfig, "site">, term: TaxonomyTerm, format: TaxonomyFeedFormat, limit?: number): string;
 /** Builds the `<link rel="alternate">` discovery tags for a term. */
 export declare function buildFeedHeadTags(term: TaxonomyTerm): TaxonomyHeadTag[];

package/dist/src/url.d.ts

@@ -4,4 +4,4 @@ import type { ResolvedRiebeckiteConfig } from "@riebeckite/core";
  * SEO plugin's absolute-URL convention so taxonomy feeds and metadata match the
  * rest of the site without depending on the SEO package.
  */
-export declare function buildTaxonomyAbsoluteUrl(config: ResolvedRiebeckiteConfig, pathOrUrl: string): string;
+export declare function buildTaxonomyAbsoluteUrl(config: Pick<ResolvedRiebeckiteConfig, "site">, pathOrUrl: string): string;

package/package.json

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