@riebeckite/plugin-webmention 0.0.21 → 0.0.23

package/README.md

@@ -1,5 +1,7 @@
 # @riebeckite/plugin-webmention
 
+<!-- Generated from docs/docs/plugins/webmention.md. Edit the canonical documentation in docs/docs/plugins and run `pnpm docs:sync`. -->
+
 Receive Webmentions, verify that the source document really links to the
 target, store them through a pluggable provider, and render verified mentions
 near articles. The core plugin contains **no Cloudflare, Worker, database, or
@@ -40,7 +42,7 @@ export default {
 
 Without a provider the plugin uses an in-memory provider, which is fine for
 local previews but loses mentions between processes. Supply a durable adapter
-(see [`@riebeckite/webmention-cloudflare`](../../integrations/webmention-cloudflare/README.md))
+(see [`@riebeckite/webmention-cloudflare`](https://github.com/Rerurate514/riebeckite/blob/main/packages/integrations/webmention-cloudflare/README.md))
 for production.
 
 ## Endpoints
@@ -56,24 +58,26 @@ Rejection codes: `invalid_request`, `missing_source_or_target`,
 
 ## Rendering
 
-At `onManifestCreated` the plugin queries the provider once, groups verified
-mentions by target, and appends a section to each matching entry's HTML. Core
-synchronizes that HTML with the content the route renders, using stable hooks:
-
-```html
-<section class="rr-webmention" data-webmention data-webmention-count="2">
-  <h2 class="rr-webmention__heading">Mentions</h2>
-  <ul class="rr-webmention__list">
-    <li class="rr-webmention__item rr-webmention__item--like"
-        data-webmention-type="like">…</li>
-  </ul>
-</section>
+The Site owns JSX placement. Keep the Provider instance in Site composition,
+pass that same instance to `webmention()`, then obtain typed component props
+with `getWebmentionSectionData`. The helper accepts a `PublicContentView`, so
+draft and scheduled entries cannot be rendered.
+
+```tsx
+const mentions = await getWebmentionSectionData({
+  view,
+  slug,
+  config,
+  provider: webmentionProvider,
+});
+
+<WebmentionSection {...mentions} />
 ```
 
-Set `render: false` to skip build-time injection. Applications that render at
-request time can call `getWebmentionsForEntry({ manifest, config, provider,
-slug })` and `renderWebmentionSection(mentions, options)` directly, or consume
-the JSON feed.
+An empty provider returns an empty model and `WebmentionSection` renders
+nothing. The plugin does not inject build-time manifest HTML. Applications can
+also call `getWebmentionsForEntry({ manifest, config, provider, slug })` or
+consume the JSON feed where a lower-level query is appropriate.
 
 ## Options
 
@@ -81,7 +85,6 @@ the JSON feed.
 | ------ | ------- | ----------- |
 | `provider` | in-memory | Storage adapter implementing `WebmentionProvider`. |
 | `endpoint` | `"/webmentions"` | Receive (POST) and feed (GET) path. |
-| `render` | `true` | Append stored mentions to matching entries at manifest time. |
 | `headingText` | `"Mentions"` | Heading for the rendered section. |
 | `limit` | `20` | Maximum mentions rendered per article. |
 | `className` | `"rr-webmention"` | Root CSS class of the rendered section. |
@@ -109,12 +112,11 @@ manifest time, mentions whose target is not a published entry are reported as
 - `MemoryWebmentionProvider`, provider/capability types and errors
 - `parseWebmentionSource`, `findTargetLink`, `verifyWebmention`,
   `createWebmentionSourceFetcher`
-- `renderWebmentionSection`, `getWebmentionsForEntry`,
+- `WebmentionSection`, `getWebmentionSectionData`, `getWebmentionsForEntry`,
   `groupMentionsBySlug`, `buildFeed`
 - `resolveWebmentionOptions`, `validateWebmentionOptions`
 
 ## See also
 
-- [Plugin guide](../../../docs/docs/reference/plugin-api.md)
-- [@riebeckite/webmention-cloudflare](../../integrations/webmention-cloudflare/README.md)
-
+- [Plugin guide](https://github.com/Rerurate514/riebeckite/blob/main/docs/docs/reference/plugin-api.md)
+- [@riebeckite/webmention-cloudflare](https://github.com/Rerurate514/riebeckite/blob/main/packages/integrations/webmention-cloudflare/README.md)

package/README_ja.md

@@ -1,5 +1,7 @@
 # @riebeckite/plugin-webmention
 
+<!-- Generated from docs/docs/plugins/webmention.ja.md. Edit the canonical documentation in docs/docs/plugins and run `pnpm docs:sync`. -->
+
 Webmention を受信し、送信元ドキュメントが本当にターゲットへリンクしているかを検証し、
 プラガブルな provider 経由で保存して、検証済みのメンションを記事の近くに表示します。
 コアプラグインには **Cloudflare・Worker・データベース・ベンダー固有のコードは一切なく**、
@@ -38,8 +40,8 @@ export default {
 ```
 
 provider を省略するとインメモリ provider が使われます。ローカルプレビューには
-十分ですが、プロセスをまたぐとメンションは失われます。本番では永続 adapter
-（[`@riebeckite/webmention-cloudflare`](../../integrations/webmention-cloudflare/README_ja.md) を参照）
+十分ですが、プロセスをまたぐとメンションは失われます。本産では永続 adapter
+（[`@riebeckite/webmention-cloudflare`](https://github.com/Rerurate514/riebeckite/blob/main/packages/integrations/webmention-cloudflare/README_ja.md) を参照）
 を指定してください。
 
 ## エンドポイント
@@ -54,23 +56,26 @@ provider を省略するとインメモリ provider が使われます。ロー
 
 ## 表示
 
-`onManifestCreated` で provider を一度 query し、検証済みメンションをターゲット別に
-グループ化して、対応する entry の HTML へセクションを追記します。Core がその HTML を
-コンテンツルートの描画 HTML と同期します。フックは安定した `rr-webmention` 名です。
-
-```html
-<section class="rr-webmention" data-webmention data-webmention-count="2">
-  <h2 class="rr-webmention__heading">Mentions</h2>
-  <ul class="rr-webmention__list">
-    <li class="rr-webmention__item rr-webmention__item--like"
-        data-webmention-type="like">…</li>
-  </ul>
-</section>
+Site が JSX の配置を所有します。Provider のインスタンスは Site の composition で保持し、
+同じインスタンスを `webmention()` へ渡してから、`getWebmentionSectionData` で
+コンポーネントの型付き props を取得します。helper は `PublicContentView` を受け取るため、
+draft と scheduled の entry は描画できません。
+
+```tsx
+const mentions = await getWebmentionSectionData({
+  view,
+  slug,
+  config,
+  provider: webmentionProvider,
+});
+
+<WebmentionSection {...mentions} />
 ```
 
-`render: false` でビルド時の追記を無効化できます。リクエスト時に描画する
-アプリケーションは `getWebmentionsForEntry({ manifest, config, provider, slug })` と
-`renderWebmentionSection(mentions, options)` を直接呼ぶか、JSON フィードを利用します。
+空の Provider は空の model を返し、`WebmentionSection` は何も描画しません。Plugin は
+ビルド時に manifest HTML を注入しません。より低レベルな query が必要な場合は、
+`getWebmentionsForEntry({ manifest, config, provider, slug })` を直接呼ぶか、JSON フィードを
+利用できます。
 
 ## オプション
 
@@ -78,7 +83,6 @@ provider を省略するとインメモリ provider が使われます。ロー
 | ---------- | ------ | ---- |
 | `provider` | インメモリ | `WebmentionProvider` を実装するストレージ adapter。 |
 | `endpoint` | `"/webmentions"` | 受信（POST）とフィード（GET）のパス。 |
-| `render` | `true` | manifest 生成時に対応 entry へメンションを追記します。 |
 | `headingText` | `"Mentions"` | 表示セクションの見出し。 |
 | `limit` | `20` | 記事ごとに表示する最大メンション数。 |
 | `className` | `"rr-webmention"` | 表示セクションのルート CSS クラス。 |
@@ -106,12 +110,12 @@ manifest 生成時、公開 entry に一致しないターゲットのメンシ
 - `MemoryWebmentionProvider`、provider / capability の型とエラー
 - `parseWebmentionSource`、`findTargetLink`、`verifyWebmention`、
   `createWebmentionSourceFetcher`
-- `renderWebmentionSection`、`getWebmentionsForEntry`、`groupMentionsBySlug`、
+- `WebmentionSection`、`getWebmentionSectionData`、`getWebmentionsForEntry`、
+  `groupMentionsBySlug`、
   `buildFeed`
 - `resolveWebmentionOptions`、`validateWebmentionOptions`
 
 ## 関連
 
-- [プラグインガイド](../../../docs/docs/reference/plugin-api.ja.md)
-- [@riebeckite/webmention-cloudflare](../../integrations/webmention-cloudflare/README_ja.md)
-
+- [プラグインガイド](https://github.com/Rerurate514/riebeckite/blob/main/docs/docs/reference/plugin-api.ja.md)
+- [@riebeckite/webmention-cloudflare](https://github.com/Rerurate514/riebeckite/blob/main/packages/integrations/webmention-cloudflare/README_ja.md)

package/dist/components/webmention-section.d.ts

@@ -0,0 +1,8 @@
+import type { WebmentionMention } from "../src/mention.js";
+export type WebmentionSectionProps = {
+    readonly mentions: readonly WebmentionMention[];
+    readonly heading?: string;
+    readonly className?: string;
+};
+declare const WebmentionSection: ({ mentions, heading, className, }: Readonly<WebmentionSectionProps>) => import("hono/jsx/jsx-dev-runtime").JSX.Element;
+export default WebmentionSection;

package/dist/components/webmention-section.js

@@ -0,0 +1,45 @@
+// components/webmention-section.tsx
+import { jsx, jsxs } from "hono/jsx/jsx-runtime";
+var WebmentionSection = (({
+  mentions,
+  heading = "Mentions",
+  className = "rr-webmention"
+}) => {
+  if (mentions.length === 0) return null;
+  return /* @__PURE__ */ jsxs(
+    "section",
+    {
+      class: className,
+      "data-webmention": true,
+      "data-webmention-count": mentions.length,
+      children: [
+        /* @__PURE__ */ jsx("h2", { class: `${className}__heading`, children: heading }),
+        /* @__PURE__ */ jsx("ul", { class: `${className}__list`, children: mentions.map((mention) => /* @__PURE__ */ jsxs(
+          "li",
+          {
+            class: `${className}__item ${className}__item--${mention.type}`,
+            children: [
+              /* @__PURE__ */ jsx(
+                "a",
+                {
+                  class: `${className}__source`,
+                  href: mention.source,
+                  rel: "nofollow ugc",
+                  children: mention.title ?? mention.author?.name ?? mention.source
+                }
+              ),
+              mention.author?.name && mention.title ? /* @__PURE__ */ jsx("span", { class: `${className}__author`, children: mention.author.name }) : null,
+              mention.publishedAt ? /* @__PURE__ */ jsx("time", { datetime: mention.publishedAt, children: mention.publishedAt }) : null,
+              mention.excerpt ? /* @__PURE__ */ jsx("p", { class: `${className}__excerpt`, children: mention.excerpt }) : null
+            ]
+          },
+          mention.source
+        )) })
+      ]
+    }
+  );
+});
+var webmention_section_default = WebmentionSection;
+export {
+  webmention_section_default as default
+};

package/dist/index.d.ts

@@ -1,5 +1,7 @@
 import { buildWebmentionDiagnostics } from "./src/diagnostics.js";
 import type { WebmentionOptions } from "./src/types.js";
+export type { WebmentionSectionProps } from "./components/webmention-section.js";
+export { default as WebmentionSection } from "./components/webmention-section.js";
 export { createWebmentionEndpoints } from "./src/endpoints.js";
 export type { WebmentionFeed, WebmentionFeedEntry, WebmentionFeedMention, } from "./src/feed.js";
 export { buildFeed, createWebmentionFeedHandler, summarizeEntry, } from "./src/feed.js";
@@ -14,7 +16,8 @@ export { assertWebmentionQuerySupported, requiredCapabilityForQuery, supportsWeb
 export type { AllMentionsQuery, AllMentionsResult, MentionsForTargetQuery, MentionsForTargetResult, WebmentionQuery, WebmentionQueryResult, } from "./src/query.js";
 export { createWebmentionReceiveHandler, parseWebmentionRequestBody, } from "./src/receive.js";
 export { renderWebmentionItem, renderWebmentionSection, WEBMENTION_ATTRIBUTE, } from "./src/render.js";
-export { compareMentions, countUnmatchedMentions, getWebmentionsForEntry, groupMentionsBySlug, } from "./src/server.js";
+export type { WebmentionSectionData, WebmentionSectionDataInput, } from "./src/server.js";
+export { compareMentions, countUnmatchedMentions, getWebmentionSectionData, getWebmentionsForEntry, groupMentionsBySlug, queryWebmentionsForEntry, } from "./src/server.js";
 export { entryPublicUrl, findTargetEntry, isAllowedTarget, } from "./src/targets.js";
 export type { ResolvedWebmentionOptions, WebmentionOptions, } from "./src/types.js";
 export { normalizeWebmentionUrl, resolvePublicUrl, urlComparisonKey, } from "./src/url.js";
@@ -38,7 +41,6 @@ export declare const webmentionPlugin: typeof webmention;
 export declare function webmention(options?: WebmentionOptions): import("@riebeckite/core").RiebeckitePlugin<Readonly<{
     provider?: import("./index.js").WebmentionProvider;
     endpoint?: string;
-    render?: boolean;
     headingText?: string;
     limit?: number;
     className?: string;

package/dist/index.js

@@ -1,8 +1,8 @@
 // index.ts
 import {
-  appendContentBodySlot,
   createStyleAsset,
-  definePlugin
+  definePlugin,
+  fingerprintExternalValue
 } from "@riebeckite/core";
 
 // src/provider.ts
@@ -34,15 +34,15 @@ function assertWebmentionQuerySupported(provider, query) {
 
 // src/diagnostics.ts
 var WEBMENTION_PLUGIN_NAME = "webmention";
-function buildWebmentionDiagnostics(provider, options) {
+function buildWebmentionDiagnostics(provider) {
   const diagnostics = [];
-  if (options.render && !supportsWebmentionCapability(provider, "query")) {
+  if (!supportsWebmentionCapability(provider, "query")) {
     diagnostics.push({
-      code: "webmention-render-requires-query",
+      code: "webmention-query-unavailable",
       severity: "warning",
       pluginName: WEBMENTION_PLUGIN_NAME,
-      message: "The webmention provider cannot query, so stored mentions will not render near articles.",
-      suggestion: 'Use a provider that advertises the "query" capability or set render: false.'
+      message: "The webmention provider cannot query, so stored mentions are unavailable to the Site.",
+      suggestion: 'Use a provider that advertises the "query" capability.'
     });
   }
   if (!supportsWebmentionCapability(provider, "store")) {
@@ -170,7 +170,7 @@ function createWebmentionFeedHandler(options, provider) {
 function buildFeed(manifest, config, mentions) {
   return {
     version: "1",
-    generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
+    generatedAt: latestVerificationTime(mentions),
     count: mentions.length,
     mentions: mentions.map((mention) => ({
       ...mention,
@@ -178,6 +178,12 @@ function buildFeed(manifest, config, mentions) {
     }))
   };
 }
+function latestVerificationTime(mentions) {
+  return mentions.reduce(
+    (latest, mention) => mention.verifiedAt > latest ? mention.verifiedAt : latest,
+    "1970-01-01T00:00:00.000Z"
+  );
+}
 function summarizeEntry(manifest, config, target) {
   const entry = findTargetEntry(manifest, config, target);
   if (!entry) return null;
@@ -830,7 +836,6 @@ function resolveWebmentionOptions(options = {}) {
   return {
     provider: options.provider ?? new MemoryWebmentionProvider(),
     endpoint: normalizeEndpoint(options.endpoint),
-    render: options.render ?? true,
     headingText: normalizeText(
       options.headingText,
       DEFAULT_WEBMENTION_HEADING_TEXT
@@ -886,7 +891,7 @@ function validateWebmentionOptions(options) {
       message: "Expected a positive integer."
     });
   }
-  for (const key of ["render", "nofollow", "allowPrivateHosts"]) {
+  for (const key of ["nofollow", "allowPrivateHosts"]) {
     const value = options[key];
     if (value !== void 0 && typeof value !== "boolean") {
       issues.push({ path: key, message: "Expected a boolean." });
@@ -960,42 +965,49 @@ function isAbsoluteHttpUrl(value) {
   }
 }
 
-// src/render.ts
-import { escapeHtml, escapeHtmlAttribute } from "@riebeckite/core";
-var WEBMENTION_ATTRIBUTE = "data-webmention";
-function renderWebmentionSection(mentions, options) {
-  if (mentions.length === 0) return "";
-  const className = escapeHtmlAttribute(options.className);
-  const items = mentions.map((mention) => renderWebmentionItem(mention, options)).join("");
-  return `<section class="${className}" ${WEBMENTION_ATTRIBUTE} data-webmention-count="${mentions.length}"><h2 class="${className}__heading">${escapeHtml(options.headingText)}</h2><ul class="${className}__list">${items}</ul></section>`;
-}
-function renderWebmentionItem(mention, options) {
-  const className = escapeHtmlAttribute(options.className);
-  const rel = options.nofollow ? ' rel="nofollow ugc"' : "";
-  const label = firstNonEmpty(mention.title, mention.author?.name) ?? mention.source;
-  const author = mention.author?.name !== void 0 && mention.title !== void 0 ? `<span class="${className}__author">${escapeHtml(mention.author.name)}</span>` : "";
-  const date = mention.publishedAt === void 0 ? "" : `<time class="${className}__date" datetime="${escapeHtmlAttribute(
-    mention.publishedAt
-  )}">${escapeHtml(formatDate(mention.publishedAt))}</time>`;
-  const excerpt = mention.excerpt === void 0 ? "" : `<p class="${className}__excerpt">${escapeHtml(mention.excerpt)}</p>`;
-  return `<li class="${className}__item ${className}__item--${mention.type}" data-webmention-type="${mention.type}"><a class="${className}__source" href="${escapeHtmlAttribute(
-    mention.source
-  )}"${rel}>${escapeHtml(label)}</a>${author}${date}${excerpt}</li>`;
-}
-function firstNonEmpty(...values) {
-  for (const value of values) {
-    if (value !== void 0 && value.trim() !== "") return value;
+// src/server.ts
+var getWebmentionSectionData = async ({
+  view,
+  slug,
+  config,
+  provider,
+  heading = "Mentions",
+  className = "rr-webmention",
+  limit
+}) => {
+  const entry = view.findRoutableBySlug(slug);
+  if (!entry || !supportsWebmentionCapability(provider, "query")) {
+    return { mentions: [], heading, className };
   }
-  return void 0;
+  const target = entryPublicUrl(entry, config);
+  if (target === null) return { mentions: [], heading, className };
+  const result = await provider.query({
+    type: "mentions_for_target",
+    target,
+    limit
+  });
+  return {
+    mentions: [...result.mentions].sort(compareMentions2),
+    heading,
+    className
+  };
+};
+function getWebmentionsForEntry(input) {
+  if ("mentions" in input) {
+    return input.mentions.filter(
+      (mention) => hasEntryTarget(mention.target, input.entry.permalink)
+    ).toSorted(compareMentions2).slice(0, input.limit);
+  }
+  return queryWebmentionsForEntry(input);
 }
-function formatDate(value) {
-  const date = new Date(value);
-  if (Number.isNaN(date.getTime())) return value;
-  return date.toISOString().slice(0, 10);
+function hasEntryTarget(target, permalink) {
+  try {
+    return new URL(target).pathname === permalink;
+  } catch {
+    return false;
+  }
 }
-
-// src/server.ts
-async function getWebmentionsForEntry(input) {
+async function queryWebmentionsForEntry(input) {
   const entry = input.manifest.bySlug.get(input.slug);
   if (!entry) return [];
   const target = entryPublicUrl(entry, input.config);
@@ -1042,6 +1054,83 @@ function compareMentions2(left, right) {
   ) || left.source.localeCompare(right.source);
 }
 
+// components/webmention-section.tsx
+import { jsx, jsxs } from "hono/jsx/jsx-runtime";
+var WebmentionSection = (({
+  mentions,
+  heading = "Mentions",
+  className = "rr-webmention"
+}) => {
+  if (mentions.length === 0) return null;
+  return /* @__PURE__ */ jsxs(
+    "section",
+    {
+      class: className,
+      "data-webmention": true,
+      "data-webmention-count": mentions.length,
+      children: [
+        /* @__PURE__ */ jsx("h2", { class: `${className}__heading`, children: heading }),
+        /* @__PURE__ */ jsx("ul", { class: `${className}__list`, children: mentions.map((mention) => /* @__PURE__ */ jsxs(
+          "li",
+          {
+            class: `${className}__item ${className}__item--${mention.type}`,
+            children: [
+              /* @__PURE__ */ jsx(
+                "a",
+                {
+                  class: `${className}__source`,
+                  href: mention.source,
+                  rel: "nofollow ugc",
+                  children: mention.title ?? mention.author?.name ?? mention.source
+                }
+              ),
+              mention.author?.name && mention.title ? /* @__PURE__ */ jsx("span", { class: `${className}__author`, children: mention.author.name }) : null,
+              mention.publishedAt ? /* @__PURE__ */ jsx("time", { datetime: mention.publishedAt, children: mention.publishedAt }) : null,
+              mention.excerpt ? /* @__PURE__ */ jsx("p", { class: `${className}__excerpt`, children: mention.excerpt }) : null
+            ]
+          },
+          mention.source
+        )) })
+      ]
+    }
+  );
+});
+var webmention_section_default = WebmentionSection;
+
+// src/render.ts
+import { escapeHtml, escapeHtmlAttribute } from "@riebeckite/core";
+var WEBMENTION_ATTRIBUTE = "data-webmention";
+function renderWebmentionSection(mentions, options) {
+  if (mentions.length === 0) return "";
+  const className = escapeHtmlAttribute(options.className);
+  const items = mentions.map((mention) => renderWebmentionItem(mention, options)).join("");
+  return `<section class="${className}" ${WEBMENTION_ATTRIBUTE} data-webmention-count="${mentions.length}"><h2 class="${className}__heading">${escapeHtml(options.headingText)}</h2><ul class="${className}__list">${items}</ul></section>`;
+}
+function renderWebmentionItem(mention, options) {
+  const className = escapeHtmlAttribute(options.className);
+  const rel = options.nofollow ? ' rel="nofollow ugc"' : "";
+  const label = firstNonEmpty(mention.title, mention.author?.name) ?? mention.source;
+  const author = mention.author?.name !== void 0 && mention.title !== void 0 ? `<span class="${className}__author">${escapeHtml(mention.author.name)}</span>` : "";
+  const date = mention.publishedAt === void 0 ? "" : `<time class="${className}__date" datetime="${escapeHtmlAttribute(
+    mention.publishedAt
+  )}">${escapeHtml(formatDate(mention.publishedAt))}</time>`;
+  const excerpt = mention.excerpt === void 0 ? "" : `<p class="${className}__excerpt">${escapeHtml(mention.excerpt)}</p>`;
+  return `<li class="${className}__item ${className}__item--${mention.type}" data-webmention-type="${mention.type}"><a class="${className}__source" href="${escapeHtmlAttribute(
+    mention.source
+  )}"${rel}>${escapeHtml(label)}</a>${author}${date}${excerpt}</li>`;
+}
+function firstNonEmpty(...values) {
+  for (const value of values) {
+    if (value !== void 0 && value.trim() !== "") return value;
+  }
+  return void 0;
+}
+function formatDate(value) {
+  const date = new Date(value);
+  if (Number.isNaN(date.getTime())) return value;
+  return date.toISOString().slice(0, 10);
+}
+
 // index.ts
 var webmentionPlugin = webmention;
 function webmention(options = {}) {
@@ -1053,46 +1142,60 @@ function webmention(options = {}) {
       version: "webmention-v1",
       dependencyMode: "none"
     },
-    outputDependencies: [{ type: "unknown" }],
+    contentOutputDependencies: [
+      { type: "external", id: "webmention:all-mentions" }
+    ],
     options,
     validateOptions: validateWebmentionOptions,
-    onManifestCreated: async (context) => {
-      if (!resolved.render || !supportsWebmentionCapability(provider, "query")) {
-        return;
+    resolveExternalDependencies: async () => {
+      if (!supportsWebmentionCapability(provider, "query")) {
+        return [];
       }
-      let mentions;
       try {
         const result = await provider.query({ type: "all_mentions" });
-        mentions = result.mentions;
+        return [
+          {
+            kind: "resolved",
+            snapshot: {
+              id: "webmention:all-mentions",
+              fingerprint: fingerprintExternalValue(result.mentions),
+              scope: { type: "content" },
+              value: result.mentions
+            }
+          }
+        ];
       } catch (error) {
+        return [
+          {
+            kind: "unavailable",
+            failure: {
+              id: "webmention:all-mentions",
+              reason: error instanceof Error ? error.message : String(error)
+            }
+          }
+        ];
+      }
+    },
+    onManifestCreated: async (context) => {
+      if (!supportsWebmentionCapability(provider, "query")) {
+        return;
+      }
+      const snapshot = context.externalDependencies?.get(
+        "webmention:all-mentions"
+      );
+      if (!snapshot) {
         context.diagnostics.push({
           code: "webmention-query-failed",
           severity: "warning",
           pluginName: WEBMENTION_PLUGIN_NAME,
           message: "The webmention provider could not be queried, so mentions were not rendered.",
           meta: {
-            cause: error instanceof Error ? error.message : String(error)
+            cause: "The external dependency snapshot was unavailable."
           }
         });
         return;
       }
-      const grouped = groupMentionsBySlug(
-        context.manifest,
-        context.config,
-        mentions
-      );
-      for (const [slug, list] of grouped) {
-        const entry = context.manifest.bySlug.get(slug);
-        if (!entry) continue;
-        const section = renderWebmentionSection(
-          list.slice(0, resolved.limit),
-          resolved
-        );
-        if (section === "") continue;
-        if (!hasSlotFragment(entry.bodySlots?.["article.footer"], section)) {
-          appendContentBodySlot(entry, "article.footer", section);
-        }
-      }
+      const mentions = snapshot.value;
       const unmatched = countUnmatchedMentions(
         context.manifest,
         context.config,
@@ -1108,17 +1211,15 @@ function webmention(options = {}) {
       }
     },
     endpoints: createWebmentionEndpoints(resolved),
-    assets: [createStyleAsset(WEBMENTION_PLUGIN_NAME)],
-    addDiagnostics: () => buildWebmentionDiagnostics(provider, resolved)
+    assets: [
+      createStyleAsset(
+        WEBMENTION_PLUGIN_NAME,
+        "@riebeckite/plugin-webmention/style.css"
+      )
+    ],
+    addDiagnostics: () => buildWebmentionDiagnostics(provider)
   });
 }
-function hasSlotFragment(slot, fragment) {
-  return slot === fragment || slot?.startsWith(`${fragment}
-`) || slot?.endsWith(`
-${fragment}`) || slot?.includes(`
-${fragment}
-`) || false;
-}
 export {
   DEFAULT_WEBMENTION_CLASS_NAME,
   DEFAULT_WEBMENTION_ENDPOINT,
@@ -1132,6 +1233,7 @@ export {
   WEBMENTION_ATTRIBUTE,
   WEBMENTION_CAPABILITIES,
   WEBMENTION_TYPES,
+  webmention_section_default as WebmentionSection,
   assertWebmentionQuerySupported,
   buildFeed,
   buildWebmentionDiagnostics,
@@ -1144,12 +1246,14 @@ export {
   entryPublicUrl,
   findTargetEntry,
   findTargetLink,
+  getWebmentionSectionData,
   getWebmentionsForEntry,
   groupMentionsBySlug,
   isAllowedTarget,
   normalizeWebmentionUrl,
   parseWebmentionRequestBody,
   parseWebmentionSource,
+  queryWebmentionsForEntry,
   renderWebmentionItem,
   renderWebmentionSection,
   requiredCapabilityForQuery,

package/dist/src/diagnostics.d.ts

@@ -1,6 +1,5 @@
 import type { Diagnostic } from "@riebeckite/core";
 import { type WebmentionProvider } from "./provider.js";
-import type { ResolvedWebmentionOptions } from "./types.js";
 export declare const WEBMENTION_PLUGIN_NAME = "webmention";
-/** Structured health checks for the configured provider and rendering mode. */
-export declare function buildWebmentionDiagnostics(provider: WebmentionProvider, options: ResolvedWebmentionOptions): Diagnostic[];
+/** Structured health checks for the configured provider. */
+export declare function buildWebmentionDiagnostics(provider: WebmentionProvider): Diagnostic[];

package/dist/src/server.d.ts

@@ -1,18 +1,41 @@
-import type { ContentManifest, ResolvedRiebeckiteConfig } from "@riebeckite/core";
+import type { ContentManifest, PluginDataHelper, PublicContentEntry, PublicContentView, ResolvedRiebeckiteConfig } from "@riebeckite/core";
 import type { WebmentionMention } from "./mention.js";
-import type { WebmentionProvider } from "./provider.js";
+import { type WebmentionProvider } from "./provider.js";
 /**
  * Reads verified mentions for one entry. Application routes call this at
  * request/SSR time when they render mentions themselves instead of relying on
  * build-time injection.
  */
-export declare function getWebmentionsForEntry(input: {
+type WebmentionSnapshotInput = {
+    readonly entry: PublicContentEntry;
+    readonly mentions: readonly WebmentionMention[];
+    readonly limit?: number;
+};
+type WebmentionQueryInput = {
     manifest: ContentManifest;
     config: ResolvedRiebeckiteConfig | undefined;
     provider: WebmentionProvider;
     slug: string;
     limit?: number;
-}): Promise<WebmentionMention[]>;
+};
+export type WebmentionSectionData = {
+    readonly mentions: readonly WebmentionMention[];
+    readonly heading: string;
+    readonly className: string;
+};
+export type WebmentionSectionDataInput = {
+    readonly view: PublicContentView;
+    readonly slug: string;
+    readonly config: ResolvedRiebeckiteConfig | undefined;
+    readonly provider: WebmentionProvider;
+    readonly heading?: string;
+    readonly className?: string;
+    readonly limit?: number;
+};
+export declare const getWebmentionSectionData: PluginDataHelper<WebmentionSectionDataInput, WebmentionSectionData>;
+export declare function getWebmentionsForEntry(input: Readonly<WebmentionSnapshotInput>): readonly WebmentionMention[];
+export declare function getWebmentionsForEntry(input: Readonly<WebmentionQueryInput>): Promise<WebmentionMention[]>;
+export declare function queryWebmentionsForEntry(input: WebmentionQueryInput): Promise<WebmentionMention[]>;
 /**
  * Groups mentions by the manifest entry they target. Mentions whose target is
  * not a published entry are omitted; callers that need them can query the
@@ -22,3 +45,4 @@ export declare function groupMentionsBySlug(manifest: ContentManifest, config: R
 /** Counts mentions whose target does not match a published entry. */
 export declare function countUnmatchedMentions(manifest: ContentManifest, config: ResolvedRiebeckiteConfig | undefined, mentions: readonly WebmentionMention[]): number;
 export declare function compareMentions(left: WebmentionMention, right: WebmentionMention): number;
+export {};

package/dist/src/targets.d.ts

@@ -3,7 +3,7 @@ import type { ContentManifest, ContentManifestEntry, ResolvedRiebeckiteConfig }
  * Resolves an entry's public URL. Relative permalinks need the configured
  * base URL; without one, only an already-absolute permalink can be matched.
  */
-export declare function entryPublicUrl(entry: ContentManifestEntry, config: ResolvedRiebeckiteConfig | undefined): string | null;
+export declare function entryPublicUrl(entry: Pick<ContentManifestEntry, "permalink">, config: ResolvedRiebeckiteConfig | undefined): string | null;
 /** Finds the content entry whose public URL matches `target`, if any. */
 export declare function findTargetEntry(manifest: ContentManifest, config: ResolvedRiebeckiteConfig | undefined, target: string): ContentManifestEntry | undefined;
 /** Whether `target` is explicitly allowed by `allowedTargets`. */

package/dist/src/types.d.ts

@@ -13,8 +13,6 @@ export type WebmentionOptions = Readonly<{
     provider?: WebmentionProvider;
     /** Receive (POST) and feed (GET) path. Defaults to `/webmentions`. */
     endpoint?: string;
-    /** Render stored mentions near articles. Defaults to `true`. */
-    render?: boolean;
     /** Heading text for the rendered section. Defaults to `"Mentions"`. */
     headingText?: string;
     /** Maximum mentions rendered per article. Defaults to `20`. */
@@ -40,7 +38,6 @@ export type WebmentionOptions = Readonly<{
 export type ResolvedWebmentionOptions = Readonly<{
     provider: WebmentionProvider;
     endpoint: string;
-    render: boolean;
     headingText: string;
     limit: number;
     className: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@riebeckite/plugin-webmention",
-  "version": "0.0.21",
+  "version": "0.0.23",
   "license": "Apache-2.0",
   "type": "module",
   "main": "./dist/index.js",
@@ -12,10 +12,17 @@
       "source": "./index.ts",
       "default": "./dist/index.js"
     },
+    "./components": {
+      "types": "./dist/components/webmention-section.d.ts",
+      "import": "./dist/components/webmention-section.js",
+      "source": "./components/webmention-section.tsx",
+      "default": "./dist/components/webmention-section.js"
+    },
     "./style.css": "./style.css"
   },
   "dependencies": {
-    "@riebeckite/core": "0.0.21"
+    "hono": "^4.12.25",
+    "@riebeckite/core": "0.0.23"
   },
   "devDependencies": {
     "tsx": "^4.22.4"