@takazudo/zudo-doc 5.19.0 → 5.20.0

package/dist/factory-context/index.d.ts

@@ -1,4 +1,4 @@
-import type { Settings } from "../settings.js";
+import type { LocaleConfig, Settings } from "../settings.js";
 import type { AssetManifest, ColorScheme, ThemePackRegistry } from "../route-context-payload/types.js";
 import type { UrlHelpers } from "../url-helpers/index.js";
 import type { NavSourceDocsAPI } from "../nav-source-docs/index.js";
@@ -130,11 +130,8 @@ export interface RouteContext<S = Settings> extends UrlHelpers, NavSourceDocsAPI
     defaultLocale: string;
     /** All supported locale codes, default first. */
     locales: readonly string[];
-    /** Per-locale `{ label, dir }` config lookup. */
-    getLocaleConfig(locale: string): {
-        label: string;
-        dir: string;
-    } | undefined;
+    /** Per-locale configuration lookup, including an optional home description. */
+    getLocaleConfig(locale: string): LocaleConfig | undefined;
     /** Display label for a locale. */
     getLocaleLabel(locale: string): string;
     /**

package/dist/format-date/index.d.ts

@@ -3,14 +3,23 @@ export interface IsoDateParts {
     month: number;
     day: number;
 }
+/** "locale" keeps today's Intl behaviour; anything else is a token pattern. */
+export type DateFormatPattern = "locale" | (string & {});
 export declare function parseIsoDate(iso: string): IsoDateParts | undefined;
 /** Format an ISO date for display while retaining the established locale map. */
-export declare function formatDate(iso: string, locale: string): string;
+export declare function formatDate(iso: string, locale: string, pattern?: DateFormatPattern): string;
 /** Format the localized month/day portion of an ISO date in UTC. */
-export declare function formatMonthDayLabel(iso: string, locale: string): string;
+export declare function formatMonthDayLabel(iso: string, locale: string, pattern?: DateFormatPattern): string;
 /** Format the localized year portion of an ISO date in UTC. */
-export declare function formatYear(iso: string, locale: string): string;
+export declare function formatYear(iso: string, locale: string, pattern?: DateFormatPattern): string;
 /** Format a year/month label with the year first in every locale. */
-export declare function formatYearMonth(iso: string, locale: string): string;
-/** Return the stable numeric month/day portion of a calendar-valid ISO date. */
-export declare function formatMonthDay(iso: string): string;
+export declare function formatYearMonth(iso: string, locale: string, pattern?: DateFormatPattern): string;
+/**
+ * Return the stable numeric month/day portion of a calendar-valid ISO date.
+ *
+ * The parameter order is deliberately `(iso, pattern, locale)`: this formatter
+ * had no locale parameter at all, so `locale` is appended last and is only
+ * consulted for the `MMM`/`MMMM` tokens. Input stays strictly date-only in both
+ * the default and the pattern path — full timestamps are returned unchanged.
+ */
+export declare function formatMonthDay(iso: string, pattern?: DateFormatPattern, locale?: string): string;

package/dist/format-date/index.js

@@ -9,29 +9,86 @@ function parseIsoDate(iso) {
   const year = Number(match[1]);
   const month = Number(match[2]);
   const day = Number(match[3]);
-  const date = /* @__PURE__ */ new Date(0);
-  date.setUTCHours(0, 0, 0, 0);
-  date.setUTCFullYear(year, month - 1, day);
+  const date = utcDateFromParts({ year, month, day });
   if (date.getUTCFullYear() !== year || date.getUTCMonth() !== month - 1 || date.getUTCDate() !== day) {
     return void 0;
   }
   return { year, month, day };
 }
+function utcDateFromParts(parts) {
+  const date = /* @__PURE__ */ new Date(0);
+  date.setUTCHours(0, 0, 0, 0);
+  date.setUTCFullYear(parts.year, parts.month - 1, parts.day);
+  return date;
+}
 function toUtcDate(iso) {
   const parts = parseIsoDate(iso);
-  if (parts) {
-    const date = /* @__PURE__ */ new Date(0);
-    date.setUTCHours(0, 0, 0, 0);
-    date.setUTCFullYear(parts.year, parts.month - 1, parts.day);
-    return date;
-  }
+  if (parts) return utcDateFromParts(parts);
   if (!/^\d{4}-\d{2}-\d{2}T/.test(iso)) return void 0;
   const timestamp = new Date(iso);
   return Number.isNaN(timestamp.getTime()) ? void 0 : timestamp;
 }
-function formatDate(iso, locale) {
+const PATTERN_TOKENS = ["YYYY", "YY", "MMMM", "MMM", "MM", "M", "DD", "D"];
+function monthName(date, locale, width) {
+  return new Intl.DateTimeFormat(LOCALE_TO_BCP47[locale] ?? "en-US", {
+    month: width,
+    timeZone: "UTC"
+  }).format(date);
+}
+function renderToken(token, date, locale) {
+  switch (token) {
+    case "YYYY":
+      return String(date.getUTCFullYear()).padStart(4, "0");
+    case "YY":
+      return String(date.getUTCFullYear() % 100).padStart(2, "0");
+    case "MMMM":
+      return monthName(date, locale, "long");
+    case "MMM":
+      return monthName(date, locale, "short");
+    case "MM":
+      return String(date.getUTCMonth() + 1).padStart(2, "0");
+    case "M":
+      return String(date.getUTCMonth() + 1);
+    case "DD":
+      return String(date.getUTCDate()).padStart(2, "0");
+    case "D":
+      return String(date.getUTCDate());
+  }
+}
+function applyPattern(date, pattern, locale) {
+  let out = "";
+  let index = 0;
+  while (index < pattern.length) {
+    const char = pattern[index];
+    if (char === "[") {
+      const close = pattern.indexOf("]", index + 1);
+      if (close !== -1) {
+        out += pattern.slice(index + 1, close);
+        index = close + 1;
+        continue;
+      }
+      out += char;
+      index += 1;
+      continue;
+    }
+    const token = PATTERN_TOKENS.find((candidate) => pattern.startsWith(candidate, index));
+    if (token) {
+      out += renderToken(token, date, locale);
+      index += token.length;
+      continue;
+    }
+    out += char;
+    index += 1;
+  }
+  return out;
+}
+function usesPattern(pattern) {
+  return pattern !== void 0 && pattern !== "locale";
+}
+function formatDate(iso, locale, pattern) {
   const date = toUtcDate(iso);
   if (!date) return iso;
+  if (usesPattern(pattern)) return applyPattern(date, pattern, locale);
   return new Intl.DateTimeFormat(LOCALE_TO_BCP47[locale] ?? "en-US", {
     year: "numeric",
     month: "short",
@@ -39,26 +96,29 @@ function formatDate(iso, locale) {
     timeZone: "UTC"
   }).format(date);
 }
-function formatMonthDayLabel(iso, locale) {
+function formatMonthDayLabel(iso, locale, pattern) {
   const date = toUtcDate(iso);
   if (!date) return iso;
+  if (usesPattern(pattern)) return applyPattern(date, pattern, locale);
   return new Intl.DateTimeFormat(LOCALE_TO_BCP47[locale] ?? "en-US", {
     month: "short",
     day: "numeric",
     timeZone: "UTC"
   }).format(date);
 }
-function formatYear(iso, locale) {
+function formatYear(iso, locale, pattern) {
   const date = toUtcDate(iso);
   if (!date) return iso;
+  if (usesPattern(pattern)) return applyPattern(date, pattern, locale);
   return new Intl.DateTimeFormat(LOCALE_TO_BCP47[locale] ?? "en-US", {
     year: "numeric",
     timeZone: "UTC"
   }).format(date);
 }
-function formatYearMonth(iso, locale) {
+function formatYearMonth(iso, locale, pattern) {
   const date = toUtcDate(iso.length === 7 ? `${iso}-01` : iso);
   if (!date) return iso;
+  if (usesPattern(pattern)) return applyPattern(date, pattern, locale);
   const year = new Intl.DateTimeFormat(LOCALE_TO_BCP47[locale] ?? "en-US", {
     year: "numeric",
     timeZone: "UTC"
@@ -69,9 +129,13 @@ function formatYearMonth(iso, locale) {
   }).format(date);
   return locale === "ja" ? `${year}${month}` : `${year} ${month}`;
 }
-function formatMonthDay(iso) {
+function formatMonthDay(iso, pattern, locale) {
   const parts = parseIsoDate(iso);
-  return parts ? `${String(parts.month).padStart(2, "0")}-${String(parts.day).padStart(2, "0")}` : iso;
+  if (!parts) return iso;
+  if (usesPattern(pattern)) {
+    return applyPattern(utcDateFromParts(parts), pattern, locale ?? "en");
+  }
+  return `${String(parts.month).padStart(2, "0")}-${String(parts.day).padStart(2, "0")}`;
 }
 export {
   formatDate,

package/dist/header-with-defaults/index.js

@@ -10,6 +10,7 @@ import { SidebarToggle } from "../sidebar-toggle-island/index.js";
 import { buildGitHubRepoUrl as buildGitHubRepoUrlBase } from "../github-helpers/index.js";
 import { assertChromeContext } from "../chrome/assert-chrome-context.js";
 import {
+  deriveDateFormats,
   deriveGetUnavailableVersions,
   deriveNavDataPrep,
   deriveSearchWidgetSlot,
@@ -18,6 +19,7 @@ import {
 function createHeaderWithDefaults(ctx) {
   assertChromeContext(ctx, "createHeaderWithDefaults");
   const settings = ctx.settings;
+  const dateFormatsFor = deriveDateFormats(ctx);
   const defaultLocale = ctx.defaultLocale;
   const locales = ctx.locales;
   const t = ctx.t;
@@ -54,8 +56,10 @@ function createHeaderWithDefaults(ctx) {
           currentSlug,
           rootMenuItems,
           backToMenuLabel,
+          locale: lang,
           localeLinks,
-          themeDefaultMode
+          themeDefaultMode,
+          dateFormats: dateFormatsFor(lang)
         }
       )
     });

package/dist/home-page/index.js

@@ -8,7 +8,7 @@ import { TagNav } from "../nav-indexing/tag-nav.js";
 import { CategoryLinkIcon } from "../tree-nav-shared/index.js";
 import { createHeadWithDefaults } from "../head-with-defaults/index.js";
 import { resolveThemePackSsrSlug } from "../theme/theme-pack-provider.js";
-import { deriveComposeMetaTitle, deriveBodyEndIslands } from "../chrome/derive.js";
+import { deriveComposeMetaTitle, deriveBodyEndIslands, deriveDateFormats } from "../chrome/derive.js";
 import { derivePrimaryChromeSlots } from "../chrome/primary-slots.js";
 import { assertChromeContext } from "../chrome/assert-chrome-context.js";
 import { prepareHomeData } from "./prepare-home-data.js";
@@ -18,6 +18,7 @@ function cssUrl(url) {
 function createHomePageView(ctx) {
   assertChromeContext(ctx, "createHomePageView");
   const settings = ctx.settings;
+  const dateFormatsFor = deriveDateFormats(ctx);
   const categoryIgnore = settings.siteTreeNavIgnore ?? [];
   const t = ctx.t;
   const withBase = ctx.withBase;
@@ -52,7 +53,7 @@ function createHomePageView(ctx) {
     const rowItems = [];
     if (primary) {
       rowItems.push(
-        /* @__PURE__ */ jsx("a", { href: primary.href, class: "text-fg underline hover:text-accent", children: primary.label })
+        /* @__PURE__ */ jsx("a", { href: primary.href, class: "whitespace-nowrap text-fg underline hover:text-accent", children: primary.label })
       );
     }
     if (settings.githubUrl) {
@@ -61,7 +62,7 @@ function createHomePageView(ctx) {
           "a",
           {
             href: settings.githubUrl,
-            class: "inline-flex items-center gap-[0.3em] text-fg underline hover:text-accent",
+            class: "inline-flex items-center gap-[0.3em] whitespace-nowrap text-fg underline hover:text-accent",
             target: "_blank",
             rel: "noopener noreferrer",
             children: [
@@ -116,10 +117,10 @@ function createHomePageView(ctx) {
                 "aria-hidden": "true"
               }
             ) : null,
-            /* @__PURE__ */ jsxs("div", { children: [
+            /* @__PURE__ */ jsxs("div", { class: "min-w-0", children: [
               /* @__PURE__ */ jsx("h1", { class: "text-heading font-bold mb-vsp-2xs break-words", children: settings.siteName }),
-              /* @__PURE__ */ jsx("p", { class: "text-muted text-small mb-vsp-sm", children: settings.siteDescription }),
-              /* @__PURE__ */ jsx("div", { class: "flex items-center justify-center lg:justify-start gap-hsp-md text-small", children: rowItems.map((item, index) => /* @__PURE__ */ jsxs(Fragment2, { children: [
+              /* @__PURE__ */ jsx("p", { class: "text-muted text-small mb-vsp-sm", children: settings.locales[locale]?.description ?? settings.siteDescription }),
+              /* @__PURE__ */ jsx("div", { class: "flex flex-wrap items-center justify-center lg:justify-start gap-hsp-md text-small", children: rowItems.map((item, index) => /* @__PURE__ */ jsxs(Fragment2, { children: [
                 index > 0 && /* @__PURE__ */ jsx("span", { class: "text-muted", children: "/" }),
                 item
               ] }, index)) })
@@ -135,7 +136,8 @@ function createHomePageView(ctx) {
                 categoryIgnore,
                 initiallyCollapsedCategorySlugs,
                 locale,
-                updatedLabel: t("doc.updated", locale)
+                updatedLabel: t("doc.updated", locale),
+                dateFormats: dateFormatsFor(locale)
               }
             )
           }),

package/dist/nav-indexing/note-tray-index-parts/card-list.js

@@ -17,7 +17,15 @@ function CardBody({
         /* @__PURE__ */ jsx("span", { class: "flex h-[1lh] items-center", children: /* @__PURE__ */ jsx(CategoryLinkIcon, { className: "w-icon-sm" }) }),
         item.label
       ] }) }),
-      props.showDate && /* @__PURE__ */ jsx("span", { class: hasStamp ? "sm:hidden" : void 0, children: /* @__PURE__ */ jsx(DateLine, { item, locale: props.locale, updatedLabel: props.updatedLabel }) })
+      props.showDate && /* @__PURE__ */ jsx("span", { class: hasStamp ? "sm:hidden" : void 0, children: /* @__PURE__ */ jsx(
+        DateLine,
+        {
+          item,
+          locale: props.locale,
+          updatedLabel: props.updatedLabel,
+          dateFormats: props.dateFormats
+        }
+      ) })
     ] }),
     item.description && /* @__PURE__ */ jsx("p", { class: descriptionClass, children: item.description })
   ] });
@@ -27,7 +35,8 @@ function DateStamp({
   updated,
   locale,
   updatedLabel,
-  positioned
+  positioned,
+  dateFormats
 }) {
   return /* @__PURE__ */ jsxs(
     "time",
@@ -35,12 +44,12 @@ function DateStamp({
       datetime: date,
       class: positioned ? "hidden sm:flex sm:col-start-2 sm:row-start-1 sm:row-span-2 w-[6.5rem] flex-col items-end self-stretch border-l border-muted pl-hsp-xl text-muted tabular-nums" : "hidden sm:flex w-[6.5rem] flex-col items-end self-stretch border-l border-muted pl-hsp-xl text-muted tabular-nums",
       children: [
-        /* @__PURE__ */ jsx("span", { class: "block text-title leading-tight font-medium", children: formatMonthDayLabel(date, locale) }),
-        /* @__PURE__ */ jsx("span", { class: "block text-caption", children: formatYear(date, locale) }),
+        /* @__PURE__ */ jsx("span", { class: "block text-title leading-tight font-medium", children: formatMonthDayLabel(date, locale, dateFormats?.monthDay) }),
+        /* @__PURE__ */ jsx("span", { class: "block text-caption", children: formatYear(date, locale, dateFormats?.year) }),
         updated && /* @__PURE__ */ jsxs("span", { class: "mt-vsp-3xs block text-micro", children: [
           updatedLabel,
           " ",
-          formatMonthDayLabel(updated, locale)
+          formatMonthDayLabel(updated, locale, dateFormats?.monthDay)
         ] })
       ]
     }
@@ -74,6 +83,7 @@ function CardList(props) {
                   updated: item.updated,
                   locale: props.locale,
                   updatedLabel: props.updatedLabel,
+                  dateFormats: props.dateFormats,
                   positioned: true
                 }
               )
@@ -96,6 +106,7 @@ function CardList(props) {
               updated: item.updated,
               locale: props.locale,
               updatedLabel: props.updatedLabel,
+              dateFormats: props.dateFormats,
               positioned: true
             }
           )
@@ -123,6 +134,7 @@ function CardList(props) {
                 updated: item.updated,
                 locale: props.locale,
                 updatedLabel: props.updatedLabel,
+                dateFormats: props.dateFormats,
                 positioned: false
               }
             )
@@ -145,6 +157,7 @@ function CardList(props) {
             updated: item.updated,
             locale: props.locale,
             updatedLabel: props.updatedLabel,
+            dateFormats: props.dateFormats,
             positioned: false
           }
         )

package/dist/nav-indexing/note-tray-index-parts/date-line.d.ts

@@ -1,12 +1,14 @@
 /** @jsxRuntime automatic */
 /** @jsxImportSource preact */
 import type { JSX } from "preact";
+import type { ResolvedDateFormats } from "../../settings.js";
 import type { NoteTrayIndexItem } from "../note-tray-index.js";
 import type { TagNavLabels } from "../types.js";
-export declare function DateLine({ item, locale, updatedLabel, }: {
+export declare function DateLine({ item, locale, updatedLabel, dateFormats, }: {
     item: NoteTrayIndexItem;
     locale: string;
     updatedLabel: string;
+    dateFormats?: ResolvedDateFormats;
 }): JSX.Element | null;
 export declare function ItemTags({ item, labels }: {
     item: NoteTrayIndexItem;

package/dist/nav-indexing/note-tray-index-parts/date-line.js

@@ -4,16 +4,17 @@ import { TagNav } from "../tag-nav.js";
 function DateLine({
   item,
   locale,
-  updatedLabel
+  updatedLabel,
+  dateFormats
 }) {
   if (!item.date && !item.updated) return null;
   return /* @__PURE__ */ jsxs("span", { class: "tabular-nums text-caption text-muted", children: [
-    item.date && /* @__PURE__ */ jsx("time", { datetime: item.date, children: formatDate(item.date, locale) }),
+    item.date && /* @__PURE__ */ jsx("time", { datetime: item.date, children: formatDate(item.date, locale, dateFormats?.full) }),
     item.date && item.updated && /* @__PURE__ */ jsx("span", { "aria-hidden": "true", children: " \xB7 " }),
     item.updated && /* @__PURE__ */ jsxs("span", { children: [
       updatedLabel,
       " ",
-      /* @__PURE__ */ jsx("time", { datetime: item.updated, children: formatDate(item.updated, locale) })
+      /* @__PURE__ */ jsx("time", { datetime: item.updated, children: formatDate(item.updated, locale, dateFormats?.full) })
     ] })
   ] });
 }

package/dist/nav-indexing/note-tray-index-parts/index-list.js

@@ -14,7 +14,15 @@ function IndexList(props) {
       /* @__PURE__ */ jsxs("span", { class: "min-w-0", children: [
         /* @__PURE__ */ jsx("span", { class: labelClass, children: item.label }),
         item.description && /* @__PURE__ */ jsx("span", { class: detailClass, children: item.description }),
-        props.showDate && /* @__PURE__ */ jsx("span", { class: dateClass, children: /* @__PURE__ */ jsx(DateLine, { item, locale: props.locale, updatedLabel: props.updatedLabel }) })
+        props.showDate && /* @__PURE__ */ jsx("span", { class: dateClass, children: /* @__PURE__ */ jsx(
+          DateLine,
+          {
+            item,
+            locale: props.locale,
+            updatedLabel: props.updatedLabel,
+            dateFormats: props.dateFormats
+          }
+        ) })
       ] })
     ] });
     return /* @__PURE__ */ jsx("li", { class: rowClass, children: item.href ? /* @__PURE__ */ jsx("a", { href: item.href, class: "group grid grid-cols-[auto_1fr] gap-x-hsp-lg py-vsp-md", children: rowContent }) : /* @__PURE__ */ jsx("span", { class: "grid grid-cols-[auto_1fr] gap-x-hsp-lg py-vsp-md", children: rowContent }) }, item.slug);

package/dist/nav-indexing/note-tray-index-parts/timeline.js

@@ -9,7 +9,7 @@ import { ItemTags } from "./date-line.js";
 function Timeline(props) {
   const groups = groupItems(props.items, "month", props.order ?? "asc");
   return /* @__PURE__ */ jsx("div", { class: "space-y-vsp-lg", children: groups.map((group) => /* @__PURE__ */ jsxs("section", { children: [
-    /* @__PURE__ */ jsx("h2", { class: "mb-vsp-sm text-small font-medium text-fg", children: formatYearMonthLabel(group.key, props.locale) }),
+    /* @__PURE__ */ jsx("h2", { class: "mb-vsp-sm text-small font-medium text-fg", children: formatYearMonthLabel(group.key, props.locale, props.dateFormats?.yearMonth) }),
     /* @__PURE__ */ jsx("ol", { class: "ml-hsp-md border-l border-muted [&_li]:mb-0", children: group.items.map((item) => /* @__PURE__ */ jsxs("li", { class: "relative grid gap-vsp-2xs pl-hsp-xl pb-vsp-lg last:pb-0", children: [
       item.href ? /* @__PURE__ */ jsx(
         "a",
@@ -26,7 +26,7 @@ function Timeline(props) {
           class: "absolute top-hsp-2xs -left-[calc(var(--spacing-icon-lg)/2)] grid size-icon-lg place-items-center rounded-full border border-muted bg-bg text-caption leading-none tabular-nums text-muted peer-hover:border-accent peer-hover:text-accent peer-focus-visible:border-accent peer-focus-visible:text-accent",
           children: [
             /* @__PURE__ */ jsx("span", { "aria-hidden": "true", children: item.date ? parseIsoDate(item.date)?.day ?? "" : "" }),
-            /* @__PURE__ */ jsx("span", { class: "sr-only", children: item.date ? formatDate(item.date, props.locale) : "" })
+            /* @__PURE__ */ jsx("span", { class: "sr-only", children: item.date ? formatDate(item.date, props.locale, props.dateFormats?.full) : "" })
           ]
         }
       ),

package/dist/nav-indexing/note-tray-index.d.ts

@@ -3,6 +3,7 @@
 import type { JSX } from "preact";
 import type { TagLink, TagNavLabels } from "./types.js";
 import type { NoteTrayOrder } from "../note-tray-model/index.js";
+import type { ResolvedDateFormats } from "../settings.js";
 export type NoteTrayIndexStyle = "index" | "cards" | "timeline";
 export interface NoteTrayIndexItem {
     slug: string;
@@ -25,5 +26,13 @@ export interface NoteTrayIndexProps {
     dated: boolean;
     order?: NoteTrayOrder;
     tagLabels?: TagNavLabels;
+    /**
+     * Per-role date patterns already resolved for `locale` by the SSR wrapper
+     * (`note-tray-index`). `NoteTrayIndex` spreads its props into the style
+     * parts, so `IndexList` / `CardList` / `Timeline` receive this unchanged.
+     * Optional and absent-safe — omitted means every role behaves as `"locale"`
+     * (#4075).
+     */
+    dateFormats?: ResolvedDateFormats;
 }
 export declare function NoteTrayIndex(props: NoteTrayIndexProps): JSX.Element | null;

package/dist/note-tray-index/index.d.ts

@@ -2,6 +2,7 @@
 /** @jsxImportSource preact */
 import type { JSX } from "preact";
 import { type NoteTrayIndexItem, type NoteTrayIndexStyle } from "../nav-indexing/index.js";
+import type { DateFormatSetting } from "../settings.js";
 export interface NoteTrayIndexNode extends NoteTrayIndexItem {
     shape?: "note-tray";
     sortOrder?: "asc" | "desc";
@@ -41,5 +42,13 @@ export interface NoteTrayIndexDeps {
     tagHref: (tag: string, locale: string) => string;
     t: (key: string, locale: string) => string;
     versionedDocsUrl: (slug: string, versionSlug: string, lang: string) => string;
+    /**
+     * The raw `dateFormat` setting (`ctx.settings.dateFormat`). Resolved for the
+     * render locale and handed to `<NoteTrayIndex>` as `dateFormats`; the
+     * note-tray parts are plain prop-driven components with no ChromeContext of
+     * their own, so this prop chain is their only route to the setting (#4075).
+     * Optional — omitted means every role resolves to `"locale"`.
+     */
+    dateFormat?: DateFormatSetting;
 }
 export declare function createNoteTrayIndexWrapper(deps: NoteTrayIndexDeps): (props: NoteTrayIndexWrapperProps) => JSX.Element | null;

package/dist/note-tray-index/index.js

@@ -4,6 +4,7 @@ import {
   NoteTrayIndex
 } from "../nav-indexing/index.js";
 import { findContainingNoteTray, getNoteTrayItems } from "../note-tray-model/index.js";
+import { resolveDateFormats } from "../date-format-resolve/index.js";
 function createNoteTrayIndexWrapper(deps) {
   return function NoteTrayIndexWrapper({
     style = "index",
@@ -42,7 +43,8 @@ function createNoteTrayIndexWrapper(deps) {
         tagLabels: {
           tags: deps.t("doc.tags", lang),
           taggedWith: deps.t("doc.taggedWith", lang)
-        }
+        },
+        dateFormats: resolveDateFormats(deps.dateFormat, lang)
       }
     );
   };

package/dist/note-tray-model/index.d.ts

@@ -1,6 +1,6 @@
-import { formatDate, parseIsoDate, type IsoDateParts } from "../format-date/index.js";
+import { formatDate, parseIsoDate, type DateFormatPattern, type IsoDateParts } from "../format-date/index.js";
 export { formatDate, parseIsoDate };
-export type { IsoDateParts };
+export type { DateFormatPattern, IsoDateParts };
 export type NoteTrayOrder = "asc" | "desc";
 export type NoteTrayGrouping = "year" | "month";
 /** Minimal structural node accepted by every note-tray consumer. */
@@ -26,6 +26,16 @@ export declare function getNoteTrayItems<T extends NoteTrayNode>(tray: T): T[];
 export declare function rankWidth(itemsOrCount: readonly unknown[] | number): number;
 export declare function yearKey(iso: string): string;
 export declare function yearMonthKey(iso: string): string;
-export declare function formatYearMonthLabel(isoOrKey: string, locale: string): string;
+export declare function formatYearMonthLabel(isoOrKey: string, locale: string, pattern?: DateFormatPattern): string;
+/**
+ * Format a year-group heading from a `yearKey` ("YYYY") or a full ISO date.
+ *
+ * Without a pattern this returns the key verbatim rather than routing through
+ * `formatYear`: the bare year is what year headings have always rendered, and
+ * the default output must stay byte-identical (a JA `Intl` year would become
+ * "2026年"). A pattern is applied against January 1 of that year, so a
+ * `year` pattern carrying month/day tokens renders that boundary date.
+ */
+export declare function formatYearLabel(isoOrKey: string, locale: string, pattern?: DateFormatPattern): string;
 /** Group dated items chronologically and keep rank order within each group. */
 export declare function groupItems<T extends NoteTrayNode>(items: readonly T[], grouping: NoteTrayGrouping, order: NoteTrayOrder): NoteTrayGroup<T>[];

package/dist/note-tray-model/index.js

@@ -1,5 +1,6 @@
 import {
   formatDate,
+  formatYear,
   formatYearMonth,
   parseIsoDate
 } from "../format-date/index.js";
@@ -39,8 +40,13 @@ function yearMonthKey(iso) {
   const parts = parseIsoDate(iso);
   return parts ? `${String(parts.year).padStart(4, "0")}-${String(parts.month).padStart(2, "0")}` : "";
 }
-function formatYearMonthLabel(isoOrKey, locale) {
-  return formatYearMonth(isoOrKey, locale);
+function formatYearMonthLabel(isoOrKey, locale, pattern) {
+  return formatYearMonth(isoOrKey, locale, pattern);
+}
+function formatYearLabel(isoOrKey, locale, pattern) {
+  if (pattern === void 0 || pattern === "locale") return isoOrKey;
+  const iso = /^\d{4}$/.test(isoOrKey) ? `${isoOrKey}-01-01` : isoOrKey;
+  return formatYear(iso, locale, pattern);
 }
 function groupItems(items, grouping, order) {
   const groups = /* @__PURE__ */ new Map();
@@ -64,6 +70,7 @@ export {
   findContainingNoteTray,
   findNoteTray,
   formatDate,
+  formatYearLabel,
   formatYearMonthLabel,
   getNoteTrayItems,
   groupItems,

package/dist/plugins/internal/claude-resources/generate.js

@@ -249,7 +249,8 @@ function generateOverviewIndex(config, {
     })) {
       writeGeneratedIndex(
         overviewPath,
-        renderOverviewIndex(config, locale, categorySlugs)
+        renderOverviewIndex(config, locale, categorySlugs),
+        "/docs/claude/"
       );
     } else {
       removeGeneratedIndex(overviewPath);
@@ -341,7 +342,7 @@ function writeLocaleCategoryIndex(config, locale, localeDir, categoryDir, presen
     position,
     resourceLabel(config, locale, descriptionKey, fallbackDescription),
     formatClaudeFrontmatterString,
-    writeGeneratedIndex
+    (absolutePath, content) => writeGeneratedIndex(absolutePath, content, `/docs/${categoryDir}/`)
   );
 }
 function generateClaudeResourcesDocs(config) {

package/dist/plugins/internal/codex-resources/overview.js

@@ -37,7 +37,8 @@ function generateOverview(config, presence) {
     })) {
       writeGeneratedIndex(
         overviewPath,
-        renderOverview(config, locale, slugs)
+        renderOverview(config, locale, slugs),
+        "/docs/codex/"
       );
     } else {
       removeGeneratedIndex(overviewPath);
@@ -105,7 +106,7 @@ function emitLocaleCategoryIndexes(config, locale, localeDir, presence) {
         fallbackLiteral: fallbackDescription
       }),
       formatFrontmatterString,
-      writeGeneratedIndex
+      (absolutePath, content) => writeGeneratedIndex(absolutePath, content, `/docs/${slug}/`)
     );
   };
   write(

package/dist/plugins/internal/resource-docs-shared/fs.d.ts

@@ -26,7 +26,7 @@ export declare function cleanDir(dir: string): void;
  * content. A missing file is created; an existing file is only replaced when
  * its frontmatter explicitly carries `generated: true`.
  */
-export declare function writeGeneratedIndex(absPath: string, mdx: string): void;
+export declare function writeGeneratedIndex(absPath: string, mdx: string, routePrefix?: string): void;
 /**
  * Remove a generated locale index that is no longer backed by a source
  * category. Authored files are intentionally left untouched: locale trees

package/dist/plugins/internal/resource-docs-shared/fs.js

@@ -52,7 +52,7 @@ function cleanDir(dir) {
   if (!fs.existsSync(dir)) return;
   fs.rmSync(dir, { recursive: true, force: true });
 }
-function writeGeneratedIndex(absPath, mdx) {
+function writeGeneratedIndex(absPath, mdx, routePrefix) {
   if (fs.existsSync(absPath)) {
     let existing;
     try {
@@ -64,8 +64,9 @@ function writeGeneratedIndex(absPath, mdx) {
     }
     const parsed = parseFrontmatter(existing);
     if (parsed?.data.generated !== true) {
+      const remedy = routePrefix === void 0 ? "add this route to defaultLocaleOnlyPrefixes" : `add "${routePrefix}" to defaultLocaleOnlyPrefixes`;
       throw new Error(
-        `resource-docs: refusing to overwrite authored locale index "${absPath}" because its frontmatter does not contain generated: true. Remove or rename the file, then retry.`
+        `resource-docs: refusing to overwrite authored locale index "${absPath}" because its frontmatter does not contain generated: true. Remove or rename the file, or ${remedy} to keep this locale's file authoritative, then retry.`
       );
     }
   }

package/dist/routes/_context.d.ts

@@ -16,10 +16,7 @@ export declare const colorSchemes: Record<string, ColorScheme> | null;
  *  plugin did not thread one (ADR `docs/adr/theme-packs.md`, Decision 2). */
 export declare const themePackRegistry: ThemePackRegistry | null;
 export declare const assetManifest: AssetManifest | null;
-export declare const i18n: import("../factory-context/index.js").FactoryI18n, defaultLocale: string, locales: readonly string[], getLocaleConfig: (locale: string) => {
-    label: string;
-    dir: string;
-} | undefined, getLocaleLabel: (locale: string) => string, t: (key: string, locale?: string) => string, urlHelpers: import("../url-helpers/index.js").UrlHelpers, withBase: (path: string) => string, stripBase: (path: string) => string, docsUrl: (slug: string, lang?: string) => string, versionedDocsUrl: (slug: string, versionSlug: string, lang?: string) => string, navHref: (path: string, lang: string | undefined, currentVersion: string | undefined, versioned?: boolean) => string, isDefaultLocaleOnlyPath: (path: string) => boolean, absoluteUrl: (pageUrl: string) => string | undefined, isExternal: (href: string) => boolean, resolveHref: (href: string) => string, buildLocaleLinks: (currentPath: string, currentLang: string) => import("../url-helpers/index.js").LocaleLink[], getCategoryOrder: () => string[], getNavSectionForSlug: (slug: string) => string | undefined, getNavSubtree: (tree: import("./_chrome.js").DocNavNode[], categoryMatch?: string) => import("./_chrome.js").DocNavNode[], extractHeadings: (body: string) => import("../extract-headings/index.js").HeadingItem[], resolveTagBound: (raw: string) => import("../tag-helpers/index.js").ResolvedTag, collectTags: (entries: ReadonlyArray<{
+export declare const i18n: import("../factory-context/index.js").FactoryI18n, defaultLocale: string, locales: readonly string[], getLocaleConfig: (locale: string) => import("../settings.js").LocaleConfig | undefined, getLocaleLabel: (locale: string) => string, t: (key: string, locale?: string) => string, urlHelpers: import("../url-helpers/index.js").UrlHelpers, withBase: (path: string) => string, stripBase: (path: string) => string, docsUrl: (slug: string, lang?: string) => string, versionedDocsUrl: (slug: string, versionSlug: string, lang?: string) => string, navHref: (path: string, lang: string | undefined, currentVersion: string | undefined, versioned?: boolean) => string, isDefaultLocaleOnlyPath: (path: string) => boolean, absoluteUrl: (pageUrl: string) => string | undefined, isExternal: (href: string) => boolean, resolveHref: (href: string) => string, buildLocaleLinks: (currentPath: string, currentLang: string) => import("../url-helpers/index.js").LocaleLink[], getCategoryOrder: () => string[], getNavSectionForSlug: (slug: string) => string | undefined, getNavSubtree: (tree: import("./_chrome.js").DocNavNode[], categoryMatch?: string) => import("./_chrome.js").DocNavNode[], extractHeadings: (body: string) => import("../extract-headings/index.js").HeadingItem[], resolveTagBound: (raw: string) => import("../tag-helpers/index.js").ResolvedTag, collectTags: (entries: ReadonlyArray<{
     slug: string;
     data: {
         slug?: string;