@riebeckite/plugin-series 0.0.24 → 0.0.25

package/dist/components/series-navigation.d.ts

@@ -1,9 +1,9 @@
 import type { ResolvedSeriesOptions, SeriesIndex } from "../src/types.js";
 export type SeriesNavigationProps = {
-    index: SeriesIndex | null;
-    currentSlug: string;
+    index?: SeriesIndex | null;
+    currentSlug?: string;
     className?: string;
     options?: Pick<ResolvedSeriesOptions, "heading" | "positionLabel">;
 };
-declare const SeriesNavigation: ({ index, currentSlug, className, options, }: Readonly<SeriesNavigationProps>) => import("hono/jsx/jsx-dev-runtime").JSX.Element;
+declare const SeriesNavigation: ({ index: explicitIndex, currentSlug: explicitCurrentSlug, className: explicitClassName, options, }: Readonly<SeriesNavigationProps>) => Promise<import("hono/utils/html").HtmlEscapedString>;
 export default SeriesNavigation;

package/dist/components/series-navigation.js

@@ -1,19 +1,145 @@
+// components/series-navigation.tsx
+import { useArticleContext, useSiteContext } from "@riebeckite/ui";
+import { html } from "hono/html";
+
+// src/series.ts
+import {
+  escapeHtml,
+  escapeHtmlAttribute
+} from "@riebeckite/core";
+var DEFAULT_SERIES_CLASS_NAME = "rb-series";
+var DEFAULT_SERIES_BASE_PATH = "/series";
+function resolveSeriesOptions(options = {}) {
+  return {
+    key: options.key ?? "series",
+    orderKey: options.orderKey ?? "series_order",
+    titleKey: options.titleKey ?? "series_title",
+    heading: options.heading ?? true,
+    className: options.className ?? DEFAULT_SERIES_CLASS_NAME,
+    positionLabel: options.positionLabel ?? false,
+    basePath: normalizeBasePath(options.basePath ?? DEFAULT_SERIES_BASE_PATH)
+  };
+}
+function collectSeriesIndexes(manifest, options = {}) {
+  const resolved = resolveSeriesOptions(options);
+  const groups = /* @__PURE__ */ new Map();
+  const titles = /* @__PURE__ */ new Map();
+  for (const entry of manifest.entries) {
+    const name = readSeriesName(entry, resolved.key);
+    if (!name) continue;
+    const group = groups.get(name);
+    if (group) group.push(entry);
+    else groups.set(name, [entry]);
+    if (!titles.has(name)) {
+      const title = readString(entry, resolved.titleKey);
+      if (title) titles.set(name, title);
+    }
+  }
+  const indexes = [];
+  for (const [name, entries] of groups) {
+    const members = [...entries].sort((a, b) => compareEntries(a, b, resolved)).map((entry) => toMember(manifest, entry, resolved, name));
+    indexes.push({ name, title: titles.get(name) ?? name, members });
+  }
+  return indexes;
+}
+var getSeriesNavigation = ({ view, entry, index }) => {
+  if (!index || !view.findDiscoverableBySlug(entry.slug)) return null;
+  const members = index.members.filter(
+    (member) => view.findDiscoverableBySlug(member.slug)
+  );
+  return members.some((member) => member.slug === entry.slug) ? { ...index, members } : null;
+};
+function toMember(manifest, entry, resolved, name) {
+  return {
+    slug: entry.slug,
+    title: entry.title || entry.slug,
+    permalink: manifest.bySlug.get(entry.slug)?.permalink ?? entry.permalink,
+    order: readSeriesOrder(entry, resolved.orderKey) ?? null,
+    series: name
+  };
+}
+function compareEntries(a, b, resolved) {
+  const orderA = readSeriesOrder(a, resolved.orderKey) ?? Number.POSITIVE_INFINITY;
+  const orderB = readSeriesOrder(b, resolved.orderKey) ?? Number.POSITIVE_INFINITY;
+  if (orderA !== orderB) return orderA < orderB ? -1 : 1;
+  const dateA = readSeriesDate(a) ?? Number.POSITIVE_INFINITY;
+  const dateB = readSeriesDate(b) ?? Number.POSITIVE_INFINITY;
+  if (dateA !== dateB) return dateA < dateB ? -1 : 1;
+  if (a.title !== b.title) return a.title < b.title ? -1 : 1;
+  if (a.slug !== b.slug) return a.slug < b.slug ? -1 : 1;
+  return 0;
+}
+function readSeriesName(entry, key) {
+  return readString(entry, key);
+}
+function readSeriesOrder(entry, key) {
+  const value = entry.frontmatter[key];
+  if (typeof value === "number" && Number.isFinite(value)) return value;
+  return void 0;
+}
+function readString(entry, key) {
+  const value = entry.frontmatter[key];
+  if (typeof value !== "string") return void 0;
+  const trimmed = value.trim();
+  return trimmed === "" ? void 0 : trimmed;
+}
+function readSeriesDate(entry) {
+  for (const key of ["date", "created", "published"]) {
+    const time = parseDate(entry.frontmatter[key]);
+    if (time !== void 0) return time;
+  }
+  return void 0;
+}
+function parseDate(value) {
+  if (value instanceof Date) {
+    const time = value.getTime();
+    return Number.isFinite(time) ? time : void 0;
+  }
+  if (typeof value === "string") {
+    const time = Date.parse(value);
+    return Number.isNaN(time) ? void 0 : time;
+  }
+  return void 0;
+}
+function normalizeBasePath(value) {
+  const trimmed = value.trim();
+  if (trimmed === "") return "";
+  const prefixed = trimmed.startsWith("/") ? trimmed : `/${trimmed}`;
+  return prefixed.length > 1 ? prefixed.replace(/\/+$/, "") : prefixed;
+}
+
 // components/series-navigation.tsx
 import { jsx, jsxs } from "hono/jsx/jsx-runtime";
-var SeriesNavigation = (({
-  index,
-  currentSlug,
-  className = "rb-series",
+var SeriesNavigation = (async ({
+  index: explicitIndex,
+  currentSlug: explicitCurrentSlug,
+  className: explicitClassName,
   options
 }) => {
-  if (!index || index.members.length === 0) return null;
+  const site = useSiteContext();
+  const article = useArticleContext();
+  const configured = site ? findSeriesOptions(site.config.plugins) : void 0;
+  const currentSlug = explicitCurrentSlug ?? article?.entry?.slug;
+  const sourceIndex = explicitIndex ?? (site && article?.entry ? collectSeriesIndexes(site.manifest, configured).find(
+    (candidate) => candidate.members.some(
+      (member) => member.slug === article.entry?.slug
+    )
+  ) ?? null : null);
+  const index = site && article?.entry && sourceIndex ? await getSeriesNavigation({
+    view: site.view,
+    entry: article.entry,
+    index: sourceIndex
+  }) : sourceIndex;
+  if (!currentSlug) return html``;
+  if (!index || index.members.length === 0) return html``;
   const position = index.members.findIndex(
     (member) => member.slug === currentSlug
   );
   const previous = position > 0 ? index.members[position - 1] : void 0;
   const next = position >= 0 && position < index.members.length - 1 ? index.members[position + 1] : void 0;
-  const heading = options?.heading ?? true;
-  const positionLabel = options?.positionLabel ?? false;
+  const heading = options?.heading ?? configured?.heading ?? true;
+  const positionLabel = options?.positionLabel ?? configured?.positionLabel ?? false;
+  const className = explicitClassName ?? configured?.className ?? "rb-series";
   return /* @__PURE__ */ jsxs(
     "nav",
     {
@@ -49,6 +175,9 @@ var SeriesNavigation = (({
   );
 });
 var series_navigation_default = SeriesNavigation;
+function findSeriesOptions(plugins) {
+  return plugins.find((plugin) => plugin.name === "series")?.options;
+}
 export {
   series_navigation_default as default
 };

package/dist/index.js

@@ -291,21 +291,39 @@ function normalizeBasePath(value) {
 }
 
 // components/series-navigation.tsx
+import { useArticleContext, useSiteContext } from "@riebeckite/ui";
+import { html } from "hono/html";
 import { jsx, jsxs } from "hono/jsx/jsx-runtime";
-var SeriesNavigation = (({
-  index,
-  currentSlug,
-  className = "rb-series",
+var SeriesNavigation = (async ({
+  index: explicitIndex,
+  currentSlug: explicitCurrentSlug,
+  className: explicitClassName,
   options
 }) => {
-  if (!index || index.members.length === 0) return null;
+  const site = useSiteContext();
+  const article = useArticleContext();
+  const configured = site ? findSeriesOptions(site.config.plugins) : void 0;
+  const currentSlug = explicitCurrentSlug ?? article?.entry?.slug;
+  const sourceIndex = explicitIndex ?? (site && article?.entry ? collectSeriesIndexes(site.manifest, configured).find(
+    (candidate) => candidate.members.some(
+      (member) => member.slug === article.entry?.slug
+    )
+  ) ?? null : null);
+  const index = site && article?.entry && sourceIndex ? await getSeriesNavigation({
+    view: site.view,
+    entry: article.entry,
+    index: sourceIndex
+  }) : sourceIndex;
+  if (!currentSlug) return html``;
+  if (!index || index.members.length === 0) return html``;
   const position = index.members.findIndex(
     (member) => member.slug === currentSlug
   );
   const previous = position > 0 ? index.members[position - 1] : void 0;
   const next = position >= 0 && position < index.members.length - 1 ? index.members[position + 1] : void 0;
-  const heading = options?.heading ?? true;
-  const positionLabel = options?.positionLabel ?? false;
+  const heading = options?.heading ?? configured?.heading ?? true;
+  const positionLabel = options?.positionLabel ?? configured?.positionLabel ?? false;
+  const className = explicitClassName ?? configured?.className ?? "rb-series";
   return /* @__PURE__ */ jsxs(
     "nav",
     {
@@ -341,6 +359,9 @@ var SeriesNavigation = (({
   );
 });
 var series_navigation_default = SeriesNavigation;
+function findSeriesOptions(plugins) {
+  return plugins.find((plugin) => plugin.name === "series")?.options;
+}
 
 // index.ts
 function series(options = {}) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@riebeckite/plugin-series",
-  "version": "0.0.24",
+  "version": "0.0.25",
   "license": "Apache-2.0",
   "type": "module",
   "main": "./dist/index.js",
@@ -22,11 +22,12 @@
   },
   "dependencies": {
     "hono": "^4.12.25",
-    "@riebeckite/core": "0.0.24"
+    "@riebeckite/core": "0.0.25",
+    "@riebeckite/ui": "0.0.25"
   },
   "devDependencies": {
     "tsx": "^4.22.4",
-    "@riebeckite/test": "0.0.24"
+    "@riebeckite/test": "0.0.25"
   },
   "publishConfig": {
     "access": "public"