@riebeckite/plugin-archive 0.0.31 → 0.0.32

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,12 @@ 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.
 
 ## Options
 
@@ -60,7 +67,8 @@ and English labels are provided, and the period is formatted through
 - `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`.
 

package/README_ja.md

@@ -28,7 +28,8 @@ export default {
 
 `archive` という 1 つの Page Type を登録し、plugin を有効にしている間だけ
 ルートを生成します。ルートはアプリケーションコードではなく plugin が生成
-します。
+し、サイトの catch-all content route が配信します。専用のアプリケーション
+ルートは不要です。
 
 - `archive`: `<basePath>/<yyyy>/<mm>` に月ごとの一覧ページを、ページネー
   ションがある場合は `<basePath>/<yyyy>/<mm>/page/<n>` に追加ページを生成
@@ -44,7 +45,12 @@ export default {
 スケジュール公開のノートは現れません。期間タイトルと前後ページのラベルは
 `site.locale` に従います。plugin の `locale` で上書きできます。日本語と英語
 のラベルを用意し、期間は `Intl.DateTimeFormat` で任意のロケール向けに整形し
-ます。
+ます。`en_US` のようなアンダースコア区切りのロケールは整形前に正規化しま
+す。
+
+解決したページは `description` と `language` も設定するため、サイトの
+document frame は期間を再計算せずにアーカイブの SEO メタデータと `lang` 属性
+を描画できます。
 
 ## オプション
 
@@ -62,7 +68,8 @@ export default {
 - `buildArchiveCollections`：エントリから月別 collection を組み立てます。
 - `archiveDefinitions`：plugin が使う Core collection 定義。
 - `renderArchivePage`：アーカイブ一覧ページを HTML に描画します。
-- `formatArchivePeriod`、`archivePaginationLabels`：ロケール補助関数。
+- `formatArchivePeriod`、`archivePaginationLabels`、
+  `buildArchiveDescription`：ロケール補助関数。
 - `DEFAULT_ARCHIVE_BASE_PATH`、`DEFAULT_ARCHIVE_PAGE_SIZE`、
   `DEFAULT_ARCHIVE_CLASS_NAME`、`ARCHIVE_COLLECTION_KIND`。
 

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 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";

package/dist/index.js

@@ -12,16 +12,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));
@@ -140,6 +150,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
           };
         }
@@ -182,6 +194,7 @@ export {
   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.32",
   "license": "Apache-2.0",
   "type": "module",
   "main": "./dist/index.js",
@@ -14,7 +14,7 @@
     }
   },
   "dependencies": {
-    "@riebeckite/core": "0.0.31"
+    "@riebeckite/core": "0.0.32"
   },
   "devDependencies": {
     "tsx": "^4.22.4"