@riebeckite/plugin-recent-posts 0.0.20 → 0.0.22

package/README.md

@@ -1,5 +1,7 @@
 # @riebeckite/plugin-recent-posts
 
+<!-- Generated from docs/docs/plugins/recent-posts.md. Edit the canonical documentation in docs/docs/plugins and run `pnpm docs:sync`. -->
+
 Recent posts list rendering: shows the latest published notes sorted by
 frontmatter date.
 
@@ -7,13 +9,13 @@ frontmatter date.
 
 ## Overview
 
-`recentPosts()` provides a `RecentPosts` component that renders an ordered list
-of recently posted articles. `getRecentPosts()` reads
+`RecentPosts` renders an ordered list of recently posted articles.
+`getRecentPosts()` reads
 `manifest.discoverableEntries`, so `unlisted`, `draft`, and scheduled notes are
 excluded. It derives a date from the frontmatter (`date` falling back to
 `created`), sorts newest first, and truncates to `limit` items. Notes without a
-parseable date are dropped. Whether and where to place the list is the site's
-decision.
+parseable date are dropped. Official `starter` and `showcase` sites place the
+list explicitly in their homepage route after the page content.
 
 With no posts, the component renders nothing.
 
@@ -30,21 +32,25 @@ export default defineConfig({
 ```
 
 `recentPostsPlugin()` registers the plugin in the plugin list and bundles
-`style.css` into the app stylesheet.
+`style.css` into the app stylesheet; it never renders UI itself. The generated
+`starter` and `showcase` demonstrate the recommended homepage placement.
 
-### Render the component
+### Custom placement
 
 ```tsx
-import RecentPosts, { getRecentPosts } from "@riebeckite/plugin-recent-posts";
-import { content } from "../content";
+import { RecentPosts, getRecentPosts } from "@riebeckite/plugin-recent-posts";
+import { content } from "virtual:riebeckite/content";
 
 const recentPosts = getRecentPosts({ manifest: await content.getManifest() });
 
-// ...in your route
-return <Article afterContent={<RecentPosts posts={recentPosts} />} />;
+// ...in a homepage route or site-owned layout
+return <RecentPosts posts={recentPosts} />;
 ```
 
 `getRecentPosts()` filters out the `index` note before collecting posts.
+To disable the generated homepage list, remove its `RecentPosts` import and
+`afterContent` prop. To reposition it, move that same element to the desired
+existing route or layout slot.
 
 ## Component
 
@@ -71,4 +77,4 @@ target.
 
 ## See also
 
-- [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,12 +1,14 @@
 # @riebeckite/plugin-recent-posts
 
+<!-- Generated from docs/docs/plugins/recent-posts.ja.md. Edit the canonical documentation in docs/docs/plugins and run `pnpm docs:sync`. -->
+
 公開済みノートを日付順に並べ、最新の記事一覧として表示するプラグインです。
 
 [English](./README.md)
 
 ## できること
 
-`getRecentPosts()` は `manifest.discoverableEntries` を読み、unlisted・draft・予約公開のノートと `index` ノートを除き、`frontmatter.date`、なければ `created` を基準に新しい順へ並べます。日付を解釈できないノートは一覧から外れます。`RecentPosts` は結果が空なら何も描画しません。一覧を置くかどうか、どこへ置くかは Site 側で決めます。
+`getRecentPosts()` は `manifest.discoverableEntries` を読み、unlisted・draft・予約公開のノートと `index` ノートを除き、`frontmatter.date`、なければ `created` を基準に新しい順へ並べます。日付を解釈できないノートは一覧から外れます。`RecentPosts` は結果が空なら何も描画しません。公式の `starter` と `showcase` は、ホームページ route で一覧を本文の後に明示的に配置します。
 
 ## 設定と配置
 
@@ -17,16 +19,18 @@ import { recentPostsPlugin } from "@riebeckite/plugin-recent-posts";
 export default defineConfig({ plugins: [recentPostsPlugin()] });
 ```
 
-一覧を置く場所はアプリ側で決めます。
+`recentPostsPlugin()` は UI を自動描画しません。生成された `starter` と `showcase` は推奨するホームページ配置を実装しています。独自の配置では、アプリ側で表示位置を決めます。
 
 ```tsx
-import RecentPosts, { getRecentPosts } from "@riebeckite/plugin-recent-posts";
-import { content } from "../content";
+import { RecentPosts, getRecentPosts } from "@riebeckite/plugin-recent-posts";
+import { content } from "virtual:riebeckite/content";
 
 const posts = getRecentPosts({ manifest: await content.getManifest() });
-return <Article afterContent={<RecentPosts posts={posts} />} />;
+return <RecentPosts posts={posts} />;
 ```
 
+生成されたホームページの一覧を無効にするには、`RecentPosts` の import と `afterContent` prop を削除します。位置を変える場合は、同じ要素を既存の route または layout の目的の slot へ移動します。
+
 | オプション | 既定値 | 内容 |
 | --- | --- | --- |
 | `manifest` | 必須 | 候補ノートの取得元（`discoverableEntries`） |
@@ -41,5 +45,4 @@ return <Article afterContent={<RecentPosts posts={posts} />} />;
 
 ## 関連資料
 
-- [プラグインシステム](../../../docs/docs/reference/plugin-api.ja.md)
-
+- [プラグインシステム](https://github.com/Rerurate514/riebeckite/blob/main/docs/docs/reference/plugin-api.ja.md)

package/dist/components/recent-posts.d.ts

@@ -1,6 +1,6 @@
 import type { RecentPost } from "../src/recent-posts.js";
 type Props = {
-    posts: RecentPost[];
+    posts?: RecentPost[];
 };
 export default function RecentPosts(props: Props): import("hono/jsx/jsx-dev-runtime").JSX.Element;
 export {};

package/dist/components/recent-posts.js

@@ -1,10 +1,11 @@
 // components/recent-posts.tsx
 import { jsx, jsxs } from "hono/jsx/jsx-runtime";
 function RecentPosts(props) {
-  if (props.posts.length === 0) return null;
+  const posts = props.posts ?? [];
+  if (posts.length === 0) return null;
   return /* @__PURE__ */ jsxs("section", { class: "rr-recent-posts", "aria-labelledby": "recent-posts-title", children: [
     /* @__PURE__ */ jsx("div", { class: "rr-recent-posts__header", children: /* @__PURE__ */ jsx("h2", { class: "rr-recent-posts__title", id: "recent-posts-title", children: "Recent Posts" }) }),
-    /* @__PURE__ */ jsx("ol", { class: "rr-recent-posts__list", children: props.posts.map((post) => {
+    /* @__PURE__ */ jsx("ol", { class: "rr-recent-posts__list", children: posts.map((post) => {
       const formattedDate = formatPostedDate(post.postedAt);
       return /* @__PURE__ */ jsx("li", { class: "rr-recent-posts__item", children: /* @__PURE__ */ jsxs("a", { class: "rr-recent-posts__link", href: post.permalink, children: [
         /* @__PURE__ */ jsx(

package/dist/index.js

@@ -4,10 +4,11 @@ import { definePlugin } from "@riebeckite/core";
 // components/recent-posts.tsx
 import { jsx, jsxs } from "hono/jsx/jsx-runtime";
 function RecentPosts(props) {
-  if (props.posts.length === 0) return null;
+  const posts = props.posts ?? [];
+  if (posts.length === 0) return null;
   return /* @__PURE__ */ jsxs("section", { class: "rr-recent-posts", "aria-labelledby": "recent-posts-title", children: [
     /* @__PURE__ */ jsx("div", { class: "rr-recent-posts__header", children: /* @__PURE__ */ jsx("h2", { class: "rr-recent-posts__title", id: "recent-posts-title", children: "Recent Posts" }) }),
-    /* @__PURE__ */ jsx("ol", { class: "rr-recent-posts__list", children: props.posts.map((post) => {
+    /* @__PURE__ */ jsx("ol", { class: "rr-recent-posts__list", children: posts.map((post) => {
       const formattedDate = formatPostedDate(post.postedAt);
       return /* @__PURE__ */ jsx("li", { class: "rr-recent-posts__item", children: /* @__PURE__ */ jsxs("a", { class: "rr-recent-posts__link", href: post.permalink, children: [
         /* @__PURE__ */ jsx(

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@riebeckite/plugin-recent-posts",
-  "version": "0.0.20",
+  "version": "0.0.22",
   "license": "Apache-2.0",
   "type": "module",
   "main": "./dist/index.js",
@@ -22,7 +22,7 @@
   },
   "dependencies": {
     "hono": "^4.12.25",
-    "@riebeckite/core": "0.0.20"
+    "@riebeckite/core": "0.0.22"
   },
   "devDependencies": {
     "tsx": "^4.22.4"

package/style.css

@@ -1,8 +1,9 @@
 @layer components {
   .rr-recent-posts {
-    margin-top: 4rem;
+    margin-top: var(--rb-space-6, 3rem);
     padding-top: 1.5rem;
-    border-top: 1px solid color-mix(in srgb, currentColor 18%, transparent);
+    border-top: 1px solid
+      var(--rb-color-border, color-mix(in srgb, currentColor 18%, transparent));
   }
 
   .rr-recent-posts__header {
@@ -11,7 +12,8 @@
 
   .rr-recent-posts__title {
     margin: 0;
-    font-size: clamp(1.5rem, 4vw, 2rem);
+    font-size: 1.125rem;
+    font-weight: 700;
     line-height: 1.2;
     letter-spacing: -0.02em;
   }