@riebeckite/plugin-archive 0.0.31 → 0.0.33

package/README.md

@@ -27,7 +27,9 @@ export default {
 ## Page types
 
 The plugin registers a single Page Type, `archive`, and only while the plugin is
-enabled. Routes are generated by the plugin, not by application code.
+enabled. Routes are generated by the plugin, not by application code: the site's
+catch-all content route serves them, so no dedicated application route is
+needed.
 
 - `archive`: one listing page per month at `<basePath>/<yyyy>/<mm>`, with
   additional pages at `<basePath>/<yyyy>/<mm>/page/<n>` when pagination applies.
@@ -42,7 +44,16 @@ Listings are built from `manifest.discoverableEntries`, so unlisted, draft, and
 scheduled notes never appear. The period title and the previous/next pagination
 labels follow `site.locale`; set `locale` on the plugin to override it. Japanese
 and English labels are provided, and the period is formatted through
-`Intl.DateTimeFormat` for any locale.
+`Intl.DateTimeFormat` for any locale. Locale tags written with underscores, such
+as `en_US`, are normalized before formatting.
+
+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
 
@@ -55,18 +66,19 @@ and English labels are provided, and the period is formatted through
 
 ## 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.
 - `renderArchivePage` — renders one archive listing page to HTML.
-- `formatArchivePeriod`, `archivePaginationLabels` — locale helpers.
+- `formatArchivePeriod`, `archivePaginationLabels`,
+  `buildArchiveDescription` — locale helpers.
 - `DEFAULT_ARCHIVE_BASE_PATH`, `DEFAULT_ARCHIVE_PAGE_SIZE`,
   `DEFAULT_ARCHIVE_CLASS_NAME`, `ARCHIVE_COLLECTION_KIND`.
 
 ## 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,25 +26,35 @@ export default {
 
 ## ページタイプ
 
-`archive` という 1 つの Page Type を登録し、plugin を有効にしている間だけ
-ルートを生成します。ルートはアプリケーションコードではなく plugin が生成
-します。
+`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` も設定するため、サイトの
+ドキュメントフレームは期間を再計算せずにアーカイブの SEO メタデータと `lang` 属性
+を描画できます。
+
+## 実行例
+
+[2026 年 10 月の Archive を開く](/archive/2026/10)
 
 ## オプション
 
@@ -57,18 +67,18 @@ export default {
 
 ## エクスポート
 
-- `archive` / `archivePlugin`：plugin ファクトリ。
+- `archive` / `archive`：プラグインファクトリ。
 - `resolveArchiveOptions`：既定値を適用してオプションを解決します。
 - `buildArchiveCollections`：エントリから月別 collection を組み立てます。
-- `archiveDefinitions`：plugin が使う Core collection 定義。
+- `archiveDefinitions`：プラグインが使う Core collection 定義。
 - `renderArchivePage`：アーカイブ一覧ページを HTML に描画します。
-- `formatArchivePeriod`、`archivePaginationLabels`：ロケール補助関数。
+- `formatArchivePeriod`、`archivePaginationLabels`、
+  `buildArchiveDescription`：ロケール補助関数。
 - `DEFAULT_ARCHIVE_BASE_PATH`、`DEFAULT_ARCHIVE_PAGE_SIZE`、
   `DEFAULT_ARCHIVE_CLASS_NAME`、`ARCHIVE_COLLECTION_KIND`。
 
 ## 補足
 
-スタイルシートは同梱しません。描画フラグメントは `rb-archive` クラスを持つ
-ので、サイト側で直接スタイルできます。`/archive` が既存コンテンツと衝突す
-る場合は `basePath` を変更し、plugin を残したまま生成ページを止めたい場合は
-`""` を設定します。
+プラグインには、有効なテーマの色と書体トークンを使うレスポンシブなアーカイブ
+スタイルが含まれます。`/archive` が既存コンテンツと衝突する場合は `basePath` を
+変更し、プラグインを残したまま生成ページを止めたい場合は `""` を設定します。

package/dist/index.d.ts

@@ -1,9 +1,8 @@
 import type { ArchiveOptions } from "./src/types.js";
 export { ARCHIVE_COLLECTION_KIND, archiveDefinitions, buildArchiveCollections, } from "./src/collections.js";
-export { archivePaginationLabels, formatArchivePeriod } from "./src/locale.js";
+export { archivePaginationLabels, buildArchiveDescription, formatArchivePeriod, } from "./src/locale.js";
 export { DEFAULT_ARCHIVE_BASE_PATH, DEFAULT_ARCHIVE_CLASS_NAME, DEFAULT_ARCHIVE_PAGE_SIZE, resolveArchiveOptions, } from "./src/options.js";
 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";
 
@@ -12,16 +13,26 @@ import {
 function archivePaginationLabels(locale) {
   return isJapanese(locale) ? { previous: "前のページ", next: "次のページ" } : { previous: "Previous", next: "Next" };
 }
+function buildArchiveDescription(siteTitle, period, locale) {
+  return isJapanese(locale) ? `${siteTitle} の ${period} の記事一覧です。` : `Posts from ${period} on ${siteTitle}.`;
+}
+function normalizeArchiveLocale(locale) {
+  const value = locale?.trim();
+  return value ? value.replace(/_/g, "-") : "en-US";
+}
 function formatArchivePeriod(value, locale) {
   const match = /^(\d{4})(?:-(\d{1,2}))?$/.exec(value);
   if (!match) return value;
   const year = Number(match[1]);
   const month = match[2] ? Number(match[2]) : null;
-  const tag = isJapanese(locale) ? "ja-JP" : locale && locale.trim() !== "" ? locale : "en-US";
   const options = month === null ? { year: "numeric", timeZone: "UTC" } : { year: "numeric", month: "long", timeZone: "UTC" };
-  return new Intl.DateTimeFormat(tag, options).format(
-    new Date(Date.UTC(year, (month ?? 1) - 1, 1))
-  );
+  const date = new Date(Date.UTC(year, (month ?? 1) - 1, 1));
+  const tag = isJapanese(locale) ? "ja-JP" : normalizeArchiveLocale(locale);
+  try {
+    return new Intl.DateTimeFormat(tag, options).format(date);
+  } catch {
+    return new Intl.DateTimeFormat("en-US", options).format(date);
+  }
 }
 function isJapanese(locale) {
   return Boolean(locale && /^ja($|[-_])/i.test(locale));
@@ -116,6 +127,9 @@ function archive(options = {}) {
   return definePlugin({
     name: ARCHIVE_PLUGIN_NAME,
     options,
+    assets: [
+      createStyleAsset("archive", "@riebeckite/plugin-archive/style.css")
+    ],
     validateOptions: validateArchiveOptions,
     pageTypes: [
       {
@@ -140,6 +154,8 @@ function archive(options = {}) {
             type: "archive",
             pathname: collection.path,
             title: page.title,
+            description: config ? buildArchiveDescription(config.site.title, page.title, locale) : void 0,
+            language: normalizeArchiveLocale(locale),
             body: page.html
           };
         }
@@ -147,7 +163,6 @@ function archive(options = {}) {
     ]
   });
 }
-var archivePlugin = archive;
 function resolveLocale(config, options) {
   return options.locale ?? config?.site.locale ?? "en";
 }
@@ -180,8 +195,8 @@ export {
   archive,
   archiveDefinitions,
   archivePaginationLabels,
-  archivePlugin,
   buildArchiveCollections,
+  buildArchiveDescription,
   formatArchivePeriod,
   renderArchivePage,
   resolveArchiveOptions

package/dist/src/locale.d.ts

@@ -2,4 +2,6 @@ export declare function archivePaginationLabels(locale: string | null | undefine
     previous: string;
     next: string;
 };
+export declare function buildArchiveDescription(siteTitle: string, period: string, locale: string | null | undefined): string;
+export declare function normalizeArchiveLocale(locale: string | null | undefined): string;
 export declare function formatArchivePeriod(value: string, locale: string | null | undefined): string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@riebeckite/plugin-archive",
-  "version": "0.0.31",
+  "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.31"
+    "@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;
+}