@riebeckite/plugin-archive 0.0.32 → 0.0.33

package/README.md

@@ -51,6 +51,10 @@ Each resolved page also sets `description` and `language`, so the site's
 document frame can render archive SEO metadata and the `lang` attribute without
 recomputing the period.
 
+## Live example
+
+[Open the October 2026 archive](/archive/2026/10)
+
 ## Options
 
 | Option | Type | Default | Description |
@@ -62,7 +66,7 @@ recomputing the period.
 
 ## Exports
 
-- `archive` / `archivePlugin` — the plugin factory.
+- `archive` / `archive` — the plugin factory.
 - `resolveArchiveOptions` — resolves options with defaults.
 - `buildArchiveCollections` — builds the monthly collections for entries.
 - `archiveDefinitions` — the Core collection definitions used by the plugin.
@@ -74,7 +78,7 @@ recomputing the period.
 
 ## Notes
 
-The plugin ships no stylesheet; the rendered fragment carries `rb-archive`
-classes so a site can style it directly. Set `basePath` to a different prefix if
-`/archive` clashes with existing content, and set it to `""` to turn the
-generated pages off without removing the plugin.
+The plugin includes a responsive archive stylesheet that uses the active theme's
+color and typography tokens. Set `basePath` to a different prefix if `/archive`
+clashes with existing content, and set it to `""` to turn the generated pages
+off without removing the plugin.

package/README_ja.md

@@ -4,9 +4,9 @@
 
 [English](./README.md)
 
-Riebeckite の月別アーカイブ一覧ページです。Core の collection 機構
-(`buildContentCollections`) で一覧を組み立てるため、リンク・順序・ページ
-ネーションはサイト全体と同じ query パイプラインを再利用します。
+Riebeckite の月別アーカイブ一覧ページを生成するプラグインです。一覧は Core の
+collection 機構（`buildContentCollections`）で組み立てるため、リンク・順序・
+ページネーションはサイト全体と同じクエリパイプラインを再利用します。
 
 ## インストール
 
@@ -26,32 +26,36 @@ export default {
 
 ## ページタイプ
 
-`archive` という 1 つの Page Type を登録し、plugin を有効にしている間だけ
-ルートを生成します。ルートはアプリケーションコードではなく plugin が生成
-し、サイトの catch-all content route が配信します。専用のアプリケーション
+`archive` という 1 つの PageType を登録し、プラグインを有効にしている間だけ
+ルートを生成します。ルートはアプリケーションコードではなくプラグインが生成
+し、サイトのキャッチオールのコンテンツルートが配信します。専用のアプリケーション
 ルートは不要です。
 
 - `archive`: `<basePath>/<yyyy>/<mm>` に月ごとの一覧ページを、ページネー
   ションがある場合は `<basePath>/<yyyy>/<mm>/page/<n>` に追加ページを生成
   します。
 
-エントリは `published`、`date`、`created` のうち最初に利用できる日付を月単
-位でグループ化します。月は新しい順に並び、各リンクはエントリの解決済み
-パーマリンクを使います。
+エントリは `published`、`date`、`created` のうち最初に利用できる日付を月単位
+でグループ化します。月は新しい順に並び、各リンクにはエントリの解決済みパーマ
+リンクを使います。
 
-## publication と l10n
+## 公開範囲と言語
 
 一覧は `manifest.discoverableEntries` から組み立てるため、unlisted・下書き・
 スケジュール公開のノートは現れません。期間タイトルと前後ページのラベルは
-`site.locale` に従います。plugin の `locale` で上書きできます。日本語と英語
+`site.locale` に従います。プラグインの `locale` で上書きできます。日本語と英語
 のラベルを用意し、期間は `Intl.DateTimeFormat` で任意のロケール向けに整形し
 ます。`en_US` のようなアンダースコア区切りのロケールは整形前に正規化しま
 す。
 
 解決したページは `description` と `language` も設定するため、サイトの
-document frame は期間を再計算せずにアーカイブの SEO メタデータと `lang` 属性
+ドキュメントフレームは期間を再計算せずにアーカイブの SEO メタデータと `lang` 属性
 を描画できます。
 
+## 実行例
+
+[2026 年 10 月の Archive を開く](/archive/2026/10)
+
 ## オプション
 
 | オプション | 型 | 既定値 | 説明 |
@@ -63,10 +67,10 @@ document frame は期間を再計算せずにアーカイブの SEO メタデー
 
 ## エクスポート
 
-- `archive` / `archivePlugin`：plugin ファクトリ。
+- `archive` / `archive`：プラグインファクトリ。
 - `resolveArchiveOptions`：既定値を適用してオプションを解決します。
 - `buildArchiveCollections`：エントリから月別 collection を組み立てます。
-- `archiveDefinitions`：plugin が使う Core collection 定義。
+- `archiveDefinitions`：プラグインが使う Core collection 定義。
 - `renderArchivePage`：アーカイブ一覧ページを HTML に描画します。
 - `formatArchivePeriod`、`archivePaginationLabels`、
   `buildArchiveDescription`：ロケール補助関数。
@@ -75,7 +79,6 @@ document frame は期間を再計算せずにアーカイブの SEO メタデー
 
 ## 補足
 
-スタイルシートは同梱しません。描画フラグメントは `rb-archive` クラスを持つ
-ので、サイト側で直接スタイルできます。`/archive` が既存コンテンツと衝突す
-る場合は `basePath` を変更し、plugin を残したまま生成ページを止めたい場合は
-`""` を設定します。
+プラグインには、有効なテーマの色と書体トークンを使うレスポンシブなアーカイブ
+スタイルが含まれます。`/archive` が既存コンテンツと衝突する場合は `basePath` を
+変更し、プラグインを残したまま生成ページを止めたい場合は `""` を設定します。

package/dist/index.d.ts

@@ -6,4 +6,3 @@ export { renderArchivePage } from "./src/pages.js";
 export type { ArchiveOptions, ArchivePage, ResolvedArchiveOptions, } from "./src/types.js";
 export declare const ARCHIVE_PLUGIN_NAME = "archive";
 export declare function archive(options?: ArchiveOptions): import("@riebeckite/core").RiebeckitePlugin<ArchiveOptions>;
-export declare const archivePlugin: typeof archive;

package/dist/index.js

@@ -1,5 +1,6 @@
 // index.ts
 import {
+  createStyleAsset,
   definePlugin
 } from "@riebeckite/core";
 
@@ -126,6 +127,9 @@ function archive(options = {}) {
   return definePlugin({
     name: ARCHIVE_PLUGIN_NAME,
     options,
+    assets: [
+      createStyleAsset("archive", "@riebeckite/plugin-archive/style.css")
+    ],
     validateOptions: validateArchiveOptions,
     pageTypes: [
       {
@@ -159,7 +163,6 @@ function archive(options = {}) {
     ]
   });
 }
-var archivePlugin = archive;
 function resolveLocale(config, options) {
   return options.locale ?? config?.site.locale ?? "en";
 }
@@ -192,7 +195,6 @@ export {
   archive,
   archiveDefinitions,
   archivePaginationLabels,
-  archivePlugin,
   buildArchiveCollections,
   buildArchiveDescription,
   formatArchivePeriod,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@riebeckite/plugin-archive",
-  "version": "0.0.32",
+  "version": "0.0.33",
   "license": "Apache-2.0",
   "type": "module",
   "main": "./dist/index.js",
@@ -11,10 +11,11 @@
       "import": "./dist/index.js",
       "source": "./index.ts",
       "default": "./dist/index.js"
-    }
+    },
+    "./style.css": "./style.css"
   },
   "dependencies": {
-    "@riebeckite/core": "0.0.32"
+    "@riebeckite/core": "0.0.33"
   },
   "devDependencies": {
     "tsx": "^4.22.4"
@@ -26,7 +27,8 @@
     "LICENSE",
     "README.md",
     "README_ja.md",
-    "dist"
+    "dist",
+    "style.css"
   ],
   "repository": {
     "type": "git",
@@ -47,7 +49,9 @@
   "engines": {
     "node": "^20.19.0 || >=22.12.0"
   },
-  "sideEffects": false,
+  "sideEffects": [
+    "./style.css"
+  ],
   "scripts": {
     "build": "node ../../../scripts/build_package.mjs",
     "test": "node --import tsx --test \"test/*.test.ts\""

package/style.css

@@ -0,0 +1,69 @@
+[data-rr-archive] {
+  margin-block: clamp(2rem, 6vw, 4.5rem);
+  color: var(--rb-color-ink);
+}
+
+[data-rr-archive] .rb-archive__title {
+  margin: 0 0 clamp(1.5rem, 4vw, 2.75rem);
+  padding-bottom: 0.75rem;
+  border-bottom: 2px solid var(--rb-color-accent);
+  font-family: var(--rb-font-heading, inherit);
+  font-size: clamp(2rem, 1.5rem + 2vw, 3rem);
+  line-height: 1.1;
+}
+
+[data-rr-archive] .rb-archive__list {
+  display: grid;
+  gap: 0;
+  margin: 0;
+  padding: 0;
+  border-top: 1px solid var(--rb-color-border);
+  list-style: none;
+}
+
+[data-rr-archive] .rb-archive__item {
+  border-bottom: 1px solid var(--rb-color-border);
+}
+
+[data-rr-archive] .rb-archive__link {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 1rem;
+  padding: 1rem 0.25rem;
+  color: var(--rb-color-link, var(--rb-color-accent));
+  font-family: var(--rb-font-heading, inherit);
+  font-size: 1.1rem;
+  font-weight: 650;
+  line-height: 1.4;
+  text-decoration: none;
+}
+
+[data-rr-archive] .rb-archive__link::after {
+  flex: none;
+  color: var(--rb-color-muted);
+  content: "→";
+  transition: transform 140ms ease;
+}
+
+[data-rr-archive] .rb-archive__link:hover {
+  color: var(--rb-color-accent);
+  background: var(--rb-color-surface-hover);
+}
+
+[data-rr-archive] .rb-archive__link:hover::after {
+  transform: translateX(0.25rem);
+}
+
+[data-rr-archive] .rb-archive__pagination {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 0.75rem;
+  margin-top: 2rem;
+}
+
+[data-rr-archive] .rb-archive__pagination .rb-archive__link {
+  padding: 0.5rem 0.75rem;
+  border: 1px solid var(--rb-color-border-strong);
+  font-size: 0.9375rem;
+}