@riebeckite/plugin-changelog 0.0.21 → 0.0.23

package/README.md

@@ -1,5 +1,7 @@
 # @riebeckite/plugin-changelog
 
+<!-- Generated from docs/docs/plugins/changelog.md. Edit the canonical documentation in docs/docs/plugins and run `pnpm docs:sync`. -->
+
 Build-time change history derived from local Git history. For every published
 note the plugin adds a "change history" section with commit dates, subjects,
 and authors, and it can build a site-wide changelog dataset from the notes'
@@ -13,13 +15,12 @@ commits. No client-side JavaScript is required.
 `git` access as [`@riebeckite/plugin-diff`](../diff/README.md) (`execFile` with
 graceful failure). It never invents its own filesystem layer.
 
-Results are published through the manifest `bodySlots` mechanism. Each public
-entry receives its own history in the `article.after-content` slot. The site's
-layout decides whether and where to render that slot, so the plugin stays
-inside the Plugin boundary and does not create application routes. When
-`siteWide` is enabled, the site-wide changelog is written to the slot of the
-note named by `siteWideSlug`; that note (the route) is owned by the app or the
-author, not by this plugin. No client script is registered.
+Results are published through the plugin's built-in HTML renderers. Each public
+entry receives its own change history section, and the site's layout decides
+whether and where to render it. When `siteWide` is enabled, the site-wide
+changelog dataset is built and available for the app to render itself. The
+plugin contributes no markup to the manifest entry; the Site renders the
+changelog sections it wants. No client script is registered.
 
 ## Usage
 
@@ -59,33 +60,20 @@ export default defineConfig({
 | `siteWideHeading` | `string` | `"Changelog"` | Site-wide heading text |
 | `className` | `string` | `"rr-changelog"` | Root CSS class |
 
-## Output
-
-The plugin appends a fragment like this to the `article.after-content` slot:
-
-```html
-<section class="rr-changelog rr-changelog--note" data-changelog-note>
-  <h2 class="rr-changelog__heading">Change history</h2>
-  <ol class="rr-changelog__list">
-    <li class="rr-changelog__item">
-      <time class="rr-changelog__date" datetime="2026-09-30T09:00:00+09:00">2026-09-30</time>
-      <span class="rr-changelog__subject">Fix the sidebar offset</span>
-      <span class="rr-changelog__author">Author Name</span>
-      <code class="rr-changelog__hash" title="…full hash…">abc1234</code>
-    </li>
-  </ol>
-</section>
-```
+## Display
+
+Each note's change history section is published as build-time HTML. When
+`perNote` is enabled, it appears after the article on eligible pages. The
+site-wide changelog dataset is built and available for the app to render
+itself via the exported renderers.
 
 `data-changelog-note` and `data-changelog-site` mark the two fragments for
 styling and idempotency checks.
 
 ## App wiring (site-wide changelog)
 
-The site-wide list is data, not a page. The app owns the route; the plugin
-either fills the `article.after-content` slot of an existing note
-(`siteWide: true` + `siteWideSlug`, which requires a public note at that slug)
-or exposes the dataset for the app to render itself:
+The site-wide list is data, not a page. The app owns the route. The plugin
+exposes the dataset for the app to render itself via the exported renderers:
 
 ```ts
 import {
@@ -108,10 +96,6 @@ const dataset = buildSiteChangelog({
 const html = renderSiteChangelog(dataset, options);
 ```
 
-The reference app renders manifest `bodySlots` in
-`apps/web/app/components/article/article.tsx`; a dedicated route can render the
-exported HTML directly.
-
 ## Failure behavior
 
 When `git` cannot be started, the plugin reports a `changelog-git-unavailable`
@@ -152,5 +136,4 @@ import "@riebeckite/plugin-changelog/style.css";
 ## See also
 
 - [plugin-diff](../diff/README.md) — revision history and line diffs
-- [Plugin guide](../../../docs/docs/reference/plugin-api.md)
-
+- [Plugin guide](https://github.com/Rerurate514/riebeckite/blob/main/docs/docs/reference/plugin-api.md)

package/README_ja.md

@@ -1,5 +1,7 @@
 # @riebeckite/plugin-changelog
 
+<!-- Generated from docs/docs/plugins/changelog.ja.md. Edit the canonical documentation in docs/docs/plugins and run `pnpm docs:sync`. -->
+
 ローカル Git の履歴からビルド時に変更履歴を生成するプラグインです。公開ノートごとにコミット日・件名・作成者を並べた「変更履歴」セクションを追加し、サイト全体の変更履歴データセットも組み立てられます。クライアント JavaScript は不要です。
 
 [English](./README.md)
@@ -8,7 +10,7 @@
 
 `changelog()` は [`@riebeckite/plugin-diff`](../diff/README_ja.md) と同じ方法でローカル Git を読み取ります（`execFile` で `git` を実行し、失敗時は安全に縮退）。独自のファイルシステム層は作りません。
 
-結果はマニフェストの `bodySlots` に出力します。公開エントリは `article.after-content` スロットに自分の履歴を受け取り、サイト側のレイアウトがそのスロットを描画するかどうかを決めます。プラグインは Plugin の境界を越えず、アプリケーションのルートも作りません。`siteWide` を有効にすると、`siteWideSlug` で指定したノートのスロットにサイト全体の変更履歴を書き込みます。そのノート（＝ルート）はアプリまたは作者が所有するもので、プラグインが作るものではありません。クライアントスクリプトは登録しません。
+結果はプラグインの組み込み HTML レンダラーを通じて公開されます。公開エントリはそれぞれ変更履歴セクションを受け取り、サイト側のレイアウトが描画するかどうかを決めます。`siteWide` を有効にすると、サイト全体の変更履歴データセットがビルドされ、アプリが自身で描画できます。プラグインは manifest entry に markup を注入しません。描画する変更履歴セクションは Site が選びます。クライアントスクリプトは登録しません。
 
 ## 使い方
 
@@ -48,23 +50,9 @@ export default defineConfig({
 | `siteWideHeading` | `string` | `"Changelog"` | サイト全体の見出し文言 |
 | `className` | `string` | `"rr-changelog"` | ルート CSS クラス |
 
-## 出力
-
-`article.after-content` スロットに次のような断片を追加します。
-
-```html
-<section class="rr-changelog rr-changelog--note" data-changelog-note>
-  <h2 class="rr-changelog__heading">Change history</h2>
-  <ol class="rr-changelog__list">
-    <li class="rr-changelog__item">
-      <time class="rr-changelog__date" datetime="2026-09-30T09:00:00+09:00">2026-09-30</time>
-      <span class="rr-changelog__subject">Fix the sidebar offset</span>
-      <span class="rr-changelog__author">Author Name</span>
-      <code class="rr-changelog__hash" title="…完全なハッシュ…">abc1234</code>
-    </li>
-  </ol>
-</section>
-```
+## 表示
+
+各ノートの変更履歴セクションはビルド時の HTML として公開されます。`perNote` が有効な場合、記事の後に表示されます。サイト全体の変更履歴データセットはビルドされ、アプリが renderer を通じて描画できます。
 
 `data-changelog-note` と `data-changelog-site` は、2 種類の断片をスタイリングと重複防止のために識別する属性です。
 
@@ -72,29 +60,6 @@ export default defineConfig({
 
 サイト全体の一覧はページではなくデータです。ルートはアプリが所有します。プラグインは既存ノートの `article.after-content` スロットに書き込む（`siteWide: true` と `siteWideSlug`。その slug の公開ノートが必要）か、データセットを公開してアプリ自身に描画させます。
 
-```ts
-import {
-  buildSiteChangelog,
-  GitChangelogReader,
-  renderSiteChangelog,
-  resolveChangelogOptions,
-} from "@riebeckite/plugin-changelog";
-
-const options = resolveChangelogOptions({ lookbackDays: 90 });
-const manifest = await content.getManifest();
-const reader = new GitChangelogReader({ cwd: "./content" });
-const commits = await reader.getRecentCommits();
-const dataset = buildSiteChangelog({
-  entries: manifest.publicEntries,
-  commits,
-  contentIndex: manifest.contentIndex,
-  options,
-});
-const html = renderSiteChangelog(dataset, options);
-```
-
-参照アプリはマニフェストの `bodySlots` を `apps/web/app/components/article/article.tsx` で描画します。専用ルートでは公開された HTML をそのまま描画できます。
-
 ## 失敗時の挙動
 
 `git` を起動できない場合は `changelog-git-unavailable` 警告診断、コンテンツディレクトリが Git ワーキングツリーの外にある場合は `changelog-content-outside-repository` 警告診断を出し、どちらの場合もロガー警告を伴い、ビルド成果物には何も加えません。履歴が取得できないことを理由にビルドが失敗することはなく、空のリポジトリでも同じです。
@@ -122,5 +87,4 @@ import "@riebeckite/plugin-changelog/style.css";
 ## 関連資料
 
 - [plugin-diff](../diff/README_ja.md) — リビジョン履歴と行差分
-- [プラグインシステム](../../../docs/docs/reference/plugin-api.ja.md)
-
+- [プラグインシステム](https://github.com/Rerurate514/riebeckite/blob/main/docs/docs/reference/plugin-api.ja.md)

package/dist/components/changelog.d.ts

@@ -0,0 +1,7 @@
+import type { NoteChangeHistory } from "../src/types.js";
+export type ChangelogProps = {
+    history: NoteChangeHistory | null;
+    className?: string;
+};
+declare const Changelog: ({ history, className, }: Readonly<ChangelogProps>) => import("hono/jsx/jsx-dev-runtime").JSX.Element;
+export default Changelog;

package/dist/components/changelog.js

@@ -0,0 +1,20 @@
+// components/changelog.tsx
+import { jsx, jsxs } from "hono/jsx/jsx-runtime";
+var Changelog = (({
+  history,
+  className = "rb-changelog"
+}) => {
+  if (!history || history.commits.length === 0) return null;
+  return /* @__PURE__ */ jsxs("section", { class: className, "data-changelog-note": true, children: [
+    /* @__PURE__ */ jsx("h2", { children: "Change history" }),
+    /* @__PURE__ */ jsx("ol", { children: history.commits.map((record) => /* @__PURE__ */ jsxs("li", { children: [
+      /* @__PURE__ */ jsx("time", { datetime: record.dateIso, children: record.date }),
+      " ",
+      record.subject
+    ] }, record.hash)) })
+  ] });
+});
+var changelog_default = Changelog;
+export {
+  changelog_default as default
+};

package/dist/index.d.ts

@@ -1,25 +1,25 @@
 import type { ChangelogOptions } from "./src/types.js";
+export type { ChangelogProps } from "./components/changelog.js";
+export { default as Changelog } from "./components/changelog.js";
 export { buildNoteChangeHistory, buildSiteChangelog, filterChangelogCommits, formatChangelogDate, resolveContentFilePath, resolveLookbackSince, } from "./src/changelog.js";
+export type { ChangelogHistoryLoader } from "./src/component-data.js";
+export { getChangelog } from "./src/component-data.js";
 export { GitChangelogReader, type GitLogWindow, } from "./src/git/history_reader.js";
 export { DEFAULT_CHANGELOG_CLASS_NAME, DEFAULT_CHANGELOG_HEADING, DEFAULT_CHANGELOG_LOCALE, DEFAULT_CHANGELOG_MAX_PER_NOTE, DEFAULT_CHANGELOG_MAX_SITE_WIDE, DEFAULT_CHANGELOG_PER_NOTE_HEADING, DEFAULT_CHANGELOG_SITE_WIDE_HEADING, DEFAULT_CHANGELOG_SITE_WIDE_SLUG, resolveChangelogOptions, } from "./src/options.js";
 export { CHANGELOG_NOTE_ATTRIBUTE, CHANGELOG_SITE_ATTRIBUTE, renderNoteChangeHistory, renderSiteChangelog, } from "./src/render.js";
 export type { ChangelogCommit, ChangelogDateFormat, ChangelogOptions, ChangelogRecord, GitChangelogReaderOptions, NoteChangeHistory, ResolvedChangelogOptions, SiteChangelog, SiteChangelogEntry, SiteChangelogNote, } from "./src/types.js";
 export declare const CHANGELOG_PLUGIN_NAME = "changelog";
-/** Site layout slot the generated history is written to. */
-export declare const CHANGELOG_BODY_SLOT = "article.after-content";
 /**
  * Git-backed change history for Riebeckite sites.
  *
- * At build time the plugin reads local Git history and publishes HTML
- * fragments through the manifest `bodySlots` mechanism:
+ * The plugin exposes data helpers and components the Site composes directly:
  *
- * - every public note gets its own "change history" section;
- * - optionally, a designated note gets the site-wide changelog.
+ * - `getChangelog` / `Changelog` render a note's own "change history" section;
+ * - `buildSiteChangelog` / `renderSiteChangelog` render the site-wide changelog
+ *   for a designated note.
  *
- * The plugin never creates a route. The Site owns the note and the layout; the
- * plugin only fills the `article.after-content` slot. The same dataset is also
- * exported (`buildSiteChangelog`, `renderSiteChangelog`) so a Site can render
- * it from its own route. No client JavaScript is required.
+ * The plugin never creates a route. The Site owns the note and the layout, and
+ * decides where the sections appear. No client JavaScript is required.
  *
  * When Git is unavailable the build is left untouched and a warning diagnostic
  * is reported instead of failing.

package/dist/index.js

@@ -1,10 +1,27 @@
 // index.ts
 import {
-  appendContentBodySlot,
   createStyleAsset,
   definePlugin
 } from "@riebeckite/core";
 
+// components/changelog.tsx
+import { jsx, jsxs } from "hono/jsx/jsx-runtime";
+var Changelog = (({
+  history,
+  className = "rb-changelog"
+}) => {
+  if (!history || history.commits.length === 0) return null;
+  return /* @__PURE__ */ jsxs("section", { class: className, "data-changelog-note": true, children: [
+    /* @__PURE__ */ jsx("h2", { children: "Change history" }),
+    /* @__PURE__ */ jsx("ol", { children: history.commits.map((record) => /* @__PURE__ */ jsxs("li", { children: [
+      /* @__PURE__ */ jsx("time", { datetime: record.dateIso, children: record.date }),
+      " ",
+      record.subject
+    ] }, record.hash)) })
+  ] });
+});
+var changelog_default = Changelog;
+
 // src/changelog.ts
 function resolveLookbackSince(lookbackDays, now = /* @__PURE__ */ new Date()) {
   if (lookbackDays === void 0) return void 0;
@@ -93,6 +110,54 @@ function normalizePath(filePath) {
   return filePath.replace(/\\/g, "/").replace(/^\.\//, "");
 }
 
+// src/options.ts
+var DEFAULT_CHANGELOG_DATE_FORMAT = "iso";
+var DEFAULT_CHANGELOG_LOCALE = "en";
+var DEFAULT_CHANGELOG_PER_NOTE = true;
+var DEFAULT_CHANGELOG_SITE_WIDE = false;
+var DEFAULT_CHANGELOG_SITE_WIDE_SLUG = "changelog";
+var DEFAULT_CHANGELOG_MAX_PER_NOTE = 10;
+var DEFAULT_CHANGELOG_MAX_SITE_WIDE = 50;
+var DEFAULT_CHANGELOG_SHOW_AUTHOR = true;
+var DEFAULT_CHANGELOG_HEADING = true;
+var DEFAULT_CHANGELOG_PER_NOTE_HEADING = "Change history";
+var DEFAULT_CHANGELOG_SITE_WIDE_HEADING = "Changelog";
+var DEFAULT_CHANGELOG_CLASS_NAME = "rr-changelog";
+function resolveChangelogOptions(options = {}) {
+  return {
+    cwd: optionalText(options.cwd),
+    lookbackDays: options.lookbackDays,
+    dateFormat: options.dateFormat ?? DEFAULT_CHANGELOG_DATE_FORMAT,
+    locale: optionalText(options.locale) ?? DEFAULT_CHANGELOG_LOCALE,
+    perNote: options.perNote ?? DEFAULT_CHANGELOG_PER_NOTE,
+    siteWide: options.siteWide ?? DEFAULT_CHANGELOG_SITE_WIDE,
+    siteWideSlug: optionalText(options.siteWideSlug) ?? DEFAULT_CHANGELOG_SITE_WIDE_SLUG,
+    maxPerNote: options.maxPerNote ?? DEFAULT_CHANGELOG_MAX_PER_NOTE,
+    maxSiteWide: options.maxSiteWide ?? DEFAULT_CHANGELOG_MAX_SITE_WIDE,
+    showAuthor: options.showAuthor ?? DEFAULT_CHANGELOG_SHOW_AUTHOR,
+    heading: options.heading ?? DEFAULT_CHANGELOG_HEADING,
+    perNoteHeading: optionalText(options.perNoteHeading) ?? DEFAULT_CHANGELOG_PER_NOTE_HEADING,
+    siteWideHeading: optionalText(options.siteWideHeading) ?? DEFAULT_CHANGELOG_SITE_WIDE_HEADING,
+    className: optionalText(options.className) ?? DEFAULT_CHANGELOG_CLASS_NAME
+  };
+}
+function optionalText(value) {
+  if (typeof value !== "string") return void 0;
+  const trimmed = value.trim();
+  return trimmed === "" ? void 0 : trimmed;
+}
+
+// src/component-data.ts
+var getChangelog = async ({ view, entry, loadCommits, options }) => {
+  if (!view.findRoutableBySlug(entry.slug)) return null;
+  const commits = await loadCommits(entry);
+  return buildNoteChangeHistory(
+    entry,
+    commits,
+    resolveChangelogOptions(options)
+  );
+};
+
 // src/git/history_reader.ts
 import path2 from "node:path";
 
@@ -189,9 +254,6 @@ function normalizeContentPath(value) {
 function isResolvedRepository(resolution) {
   return resolution.kind === "resolved";
 }
-function isRepositoryUnavailable(resolution) {
-  return resolution.kind !== "resolved";
-}
 function parseRevParseOutput(stdout) {
   const [toplevel = "", prefix = ""] = stdout.split(/\r?\n/);
   return [toplevel.trim(), prefix.trim()];
@@ -224,6 +286,23 @@ var GitChangelogReader = class {
   async isAvailable() {
     return isResolvedRepository(await this.resolveRepository());
   }
+  async getStateFingerprint() {
+    const repository = await this.#resolvePaths();
+    if (!repository) return null;
+    const results = await Promise.all([
+      runGit(["rev-parse", "HEAD"], repository.repositoryRoot),
+      runGit(
+        ["status", "--porcelain=v1", "--untracked-files=all"],
+        repository.repositoryRoot
+      ),
+      runGit(
+        ["for-each-ref", "--format=%(refname):%(objectname)"],
+        repository.repositoryRoot
+      )
+    ]);
+    if (results.some((result) => !result.ok)) return null;
+    return results.filter((result) => result.ok).map((result) => result.stdout).join("");
+  }
   /**
    * Commit history for one file, newest first, following renames.
    *
@@ -300,43 +379,6 @@ function parseCommitRecord(chunk) {
   };
 }
 
-// src/options.ts
-var DEFAULT_CHANGELOG_DATE_FORMAT = "iso";
-var DEFAULT_CHANGELOG_LOCALE = "en";
-var DEFAULT_CHANGELOG_PER_NOTE = true;
-var DEFAULT_CHANGELOG_SITE_WIDE = false;
-var DEFAULT_CHANGELOG_SITE_WIDE_SLUG = "changelog";
-var DEFAULT_CHANGELOG_MAX_PER_NOTE = 10;
-var DEFAULT_CHANGELOG_MAX_SITE_WIDE = 50;
-var DEFAULT_CHANGELOG_SHOW_AUTHOR = true;
-var DEFAULT_CHANGELOG_HEADING = true;
-var DEFAULT_CHANGELOG_PER_NOTE_HEADING = "Change history";
-var DEFAULT_CHANGELOG_SITE_WIDE_HEADING = "Changelog";
-var DEFAULT_CHANGELOG_CLASS_NAME = "rr-changelog";
-function resolveChangelogOptions(options = {}) {
-  return {
-    cwd: optionalText(options.cwd),
-    lookbackDays: options.lookbackDays,
-    dateFormat: options.dateFormat ?? DEFAULT_CHANGELOG_DATE_FORMAT,
-    locale: optionalText(options.locale) ?? DEFAULT_CHANGELOG_LOCALE,
-    perNote: options.perNote ?? DEFAULT_CHANGELOG_PER_NOTE,
-    siteWide: options.siteWide ?? DEFAULT_CHANGELOG_SITE_WIDE,
-    siteWideSlug: optionalText(options.siteWideSlug) ?? DEFAULT_CHANGELOG_SITE_WIDE_SLUG,
-    maxPerNote: options.maxPerNote ?? DEFAULT_CHANGELOG_MAX_PER_NOTE,
-    maxSiteWide: options.maxSiteWide ?? DEFAULT_CHANGELOG_MAX_SITE_WIDE,
-    showAuthor: options.showAuthor ?? DEFAULT_CHANGELOG_SHOW_AUTHOR,
-    heading: options.heading ?? DEFAULT_CHANGELOG_HEADING,
-    perNoteHeading: optionalText(options.perNoteHeading) ?? DEFAULT_CHANGELOG_PER_NOTE_HEADING,
-    siteWideHeading: optionalText(options.siteWideHeading) ?? DEFAULT_CHANGELOG_SITE_WIDE_HEADING,
-    className: optionalText(options.className) ?? DEFAULT_CHANGELOG_CLASS_NAME
-  };
-}
-function optionalText(value) {
-  if (typeof value !== "string") return void 0;
-  const trimmed = value.trim();
-  return trimmed === "" ? void 0 : trimmed;
-}
-
 // src/render.ts
 import { escapeHtml, escapeHtmlAttribute } from "@riebeckite/core";
 var CHANGELOG_NOTE_ATTRIBUTE = "data-changelog-note";
@@ -384,113 +426,20 @@ function renderNotes(notes, className) {
 
 // index.ts
 var CHANGELOG_PLUGIN_NAME = "changelog";
-var CHANGELOG_BODY_SLOT = "article.after-content";
-var PER_NOTE_CONCURRENCY = 4;
 function changelog(options = {}) {
-  const resolved = resolveChangelogOptions(options);
   return definePlugin({
     name: CHANGELOG_PLUGIN_NAME,
-    outputDependencies: [{ type: "unknown" }],
     options,
     validateOptions: validateChangelogOptions,
-    onManifestCreated: (context) => applyChangelog(context, resolved),
-    assets: [createStyleAsset(CHANGELOG_PLUGIN_NAME)]
+    assets: [
+      createStyleAsset(
+        CHANGELOG_PLUGIN_NAME,
+        "@riebeckite/plugin-changelog/style.css"
+      )
+    ]
   });
 }
 var changelogPlugin = changelog;
-async function applyChangelog(context, options) {
-  if (!options.perNote && !options.siteWide) return;
-  const reader = new GitChangelogReader({
-    cwd: resolveContentRoot(context, options)
-  });
-  const resolution = await reader.resolveRepository();
-  if (isRepositoryUnavailable(resolution)) {
-    reportRepositoryUnavailable(context, resolution);
-    return;
-  }
-  const since = resolveLookbackSince(options.lookbackDays);
-  if (options.perNote) {
-    await forEachWithConcurrency(
-      context.manifest.publicEntries,
-      PER_NOTE_CONCURRENCY,
-      async (entry) => {
-        if (options.siteWide && entry.slug === options.siteWideSlug) return;
-        await applyNoteHistory(context, options, reader, entry, since);
-      }
-    );
-  }
-  if (options.siteWide) {
-    await applySiteChangelog(context, options, reader, since);
-  }
-}
-async function applyNoteHistory(context, options, reader, entry, since) {
-  if (hasSlot(entry, CHANGELOG_NOTE_ATTRIBUTE)) return;
-  const filePath = resolveEntryFilePath(entry, context.manifest.contentIndex);
-  const commits = await reader.getFileHistory(filePath, { since });
-  const history = buildNoteChangeHistory(entry, commits, options);
-  const html = renderNoteChangeHistory(history, options);
-  if (html) appendContentBodySlot(entry, CHANGELOG_BODY_SLOT, html);
-}
-async function applySiteChangelog(context, options, reader, since) {
-  const target = context.manifest.publicEntries.find(
-    (entry) => entry.slug === options.siteWideSlug
-  );
-  if (!target) {
-    context.diagnostics.push({
-      code: "changelog-target-missing",
-      severity: "warning",
-      pluginName: CHANGELOG_PLUGIN_NAME,
-      message: `changelog: the site-wide target note "${options.siteWideSlug}" was not found; the site-wide changelog was skipped.`,
-      suggestion: `Create a public note with slug "${options.siteWideSlug}" or set siteWideSlug to an existing note.`
-    });
-    return;
-  }
-  if (hasSlot(target, CHANGELOG_SITE_ATTRIBUTE)) return;
-  const commits = await reader.getRecentCommits({ since });
-  const changelog2 = buildSiteChangelog({
-    entries: context.manifest.publicEntries,
-    commits,
-    contentIndex: context.manifest.contentIndex,
-    options
-  });
-  const html = renderSiteChangelog(changelog2, options);
-  if (html) appendContentBodySlot(target, CHANGELOG_BODY_SLOT, html);
-}
-function resolveEntryFilePath(entry, contentIndex) {
-  return resolveContentFilePath(contentIndex, entry.slug) ?? `${entry.slug}.md`;
-}
-function hasSlot(entry, attribute) {
-  return entry.bodySlots?.[CHANGELOG_BODY_SLOT]?.includes(attribute) ?? false;
-}
-function resolveContentRoot(context, options) {
-  return options.cwd ?? context.config?.content.directory ?? process.cwd();
-}
-function reportRepositoryUnavailable(context, resolution) {
-  const gitUnavailable = resolution.kind === "git-unavailable";
-  const message = gitUnavailable ? `changelog: Git could not be started; change history was skipped. (${resolution.detail})` : `changelog: the content directory is not inside a Git working tree; change history was skipped. (${resolution.detail})`;
-  context.diagnostics.push({
-    code: gitUnavailable ? "changelog-git-unavailable" : "changelog-content-outside-repository",
-    severity: "warning",
-    pluginName: CHANGELOG_PLUGIN_NAME,
-    message,
-    suggestion: gitUnavailable ? "Install Git and make sure it is available on PATH." : "Move the content directory inside a Git working tree, or set the plugin's cwd option to a path inside one."
-  });
-  context.logger.warn(message);
-}
-async function forEachWithConcurrency(items, limit, work) {
-  let index = 0;
-  const workers = Array.from(
-    { length: Math.min(limit, items.length) },
-    async () => {
-      while (index < items.length) {
-        const current = items[index];
-        index += 1;
-        await work(current);
-      }
-    }
-  );
-  await Promise.all(workers);
-}
 function validateChangelogOptions(options) {
   if (!options) return [];
   const issues = [];
@@ -539,10 +488,10 @@ function validateChangelogOptions(options) {
   return issues;
 }
 export {
-  CHANGELOG_BODY_SLOT,
   CHANGELOG_NOTE_ATTRIBUTE,
   CHANGELOG_PLUGIN_NAME,
   CHANGELOG_SITE_ATTRIBUTE,
+  changelog_default as Changelog,
   DEFAULT_CHANGELOG_CLASS_NAME,
   DEFAULT_CHANGELOG_HEADING,
   DEFAULT_CHANGELOG_LOCALE,
@@ -558,6 +507,7 @@ export {
   changelogPlugin,
   filterChangelogCommits,
   formatChangelogDate,
+  getChangelog,
   renderNoteChangeHistory,
   renderSiteChangelog,
   resolveChangelogOptions,

package/dist/src/changelog.d.ts

@@ -14,7 +14,7 @@ export declare function formatChangelogDate(isoDate: string, options: ResolvedCh
  */
 export declare function filterChangelogCommits(commits: readonly ChangelogCommit[], options: ResolvedChangelogOptions): ChangelogCommit[];
 /** Builds the per-note history for one entry. */
-export declare function buildNoteChangeHistory(entry: ContentManifestEntry, commits: readonly ChangelogCommit[], options: ResolvedChangelogOptions): NoteChangeHistory;
+export declare function buildNoteChangeHistory(entry: Pick<ContentManifestEntry, "slug" | "permalink" | "title">, commits: readonly ChangelogCommit[], options: ResolvedChangelogOptions): NoteChangeHistory;
 /**
  * Builds the site-wide changelog dataset. Each commit is linked to the notes
  * it touched by matching changed paths against the manifest content index.

package/dist/src/component-data.d.ts

@@ -0,0 +1,9 @@
+import type { PluginDataHelper, PublicContentEntry, PublicContentView } from "@riebeckite/core";
+import type { ChangelogCommit, ChangelogOptions, NoteChangeHistory } from "./types.js";
+export type ChangelogHistoryLoader = (entry: PublicContentEntry) => Promise<readonly ChangelogCommit[]>;
+export declare const getChangelog: PluginDataHelper<{
+    view: PublicContentView;
+    entry: PublicContentEntry;
+    loadCommits: ChangelogHistoryLoader;
+    options?: ChangelogOptions;
+}, Promise<NoteChangeHistory | null>>;

package/dist/src/git/history_reader.d.ts

@@ -25,6 +25,7 @@ export declare class GitChangelogReader {
     resolveRepository(): Promise<RepositoryPathsResolution>;
     /** True when the content directory lives inside a Git work tree. */
     isAvailable(): Promise<boolean>;
+    getStateFingerprint(): Promise<string | null>;
     /**
      * Commit history for one file, newest first, following renames.
      *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@riebeckite/plugin-changelog",
-  "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/changelog.d.ts",
+      "import": "./dist/components/changelog.js",
+      "source": "./components/changelog.tsx",
+      "default": "./dist/components/changelog.js"
+    },
     "./style.css": "./style.css"
   },
   "dependencies": {
-    "@riebeckite/core": "0.0.21"
+    "hono": "^4.12.25",
+    "@riebeckite/core": "0.0.23"
   },
   "devDependencies": {
     "@types/node": "^24.5.2",