@anthusai/papyrus 0.0.0 → 1.0.0-next.2

package/renderers/markus/index.ts

@@ -0,0 +1,25 @@
+import type { EditionPresentationFormat } from "../../lib/content-types";
+import type { Renderer } from "../../lib/renderer";
+import { MarkusArticleStub, MarkusEditionStub, MarkusItemStub } from "./stubs";
+
+/** CSS paths relative to the static site root (`web/dist/`). */
+export const MARKUS_STYLESHEETS = ["css/markus-vendor.css", "css/site-theme.css"] as const;
+
+export function markusSupportsLayout(_layout: EditionPresentationFormat): boolean {
+  return false;
+}
+
+/**
+ * Markus renderer: Python build emits static HTML under `web/dist/`.
+ * Preview with `python -m http.server` on that folder — no Next.js shell.
+ */
+export const markusRenderer: Renderer = {
+  id: "markus",
+  renderEdition: MarkusEditionStub,
+  renderArticle: MarkusArticleStub,
+  renderItem: MarkusItemStub,
+  stylesheets: () => [...MARKUS_STYLESHEETS],
+  supportsLayout: markusSupportsLayout,
+};
+
+export { MarkusArticleStub, MarkusEditionStub, MarkusItemStub } from "./stubs";

package/renderers/markus/stubs.tsx

@@ -0,0 +1,33 @@
+"use client";
+
+import type { RenderArticleProps, RenderEditionProps, RenderItemProps } from "../../lib/renderer";
+
+/**
+ * Markus renders exclusively via the Python static build
+ * (`poetry run papyrus renderers markus-build` → `web/dist/`).
+ * These components satisfy the Renderer interface but are not wired into
+ * `app/*` routes and must not become a second render path.
+ */
+function StaticRendererNotice({ label }: { label: string }) {
+  return (
+    <main className="markus-static-notice">
+      <p>
+        <strong>{label}</strong> uses the Markus static build output only. Run{" "}
+        <code>poetry run papyrus renderers markus-build</code>, then preview{" "}
+        <code>web/dist/</code> with a plain static file server — not Next.js.
+      </p>
+    </main>
+  );
+}
+
+export function MarkusEditionStub(_props: RenderEditionProps) {
+  return <StaticRendererNotice label="Edition view" />;
+}
+
+export function MarkusArticleStub(_props: RenderArticleProps) {
+  return <StaticRendererNotice label="Article view" />;
+}
+
+export function MarkusItemStub(_props: RenderItemProps) {
+  return <StaticRendererNotice label="Item view" />;
+}

package/renderers/pretext/article-page.tsx

@@ -0,0 +1,174 @@
+"use client";
+
+import Link from "next/link";
+import type { Article } from "../../lib/articles";
+import type { PublicationItem } from "../../lib/publication-items";
+import { getPublicationItemVideoAsset } from "../../lib/publication-items";
+import type { ArticlePageEditionFooter, RenderArticleProps, RenderItemProps } from "../../lib/renderer";
+import { SITE_BRAND } from "../../lib/site-brand";
+import { ArticleVideoFigure } from "../../components/article-video";
+import { PictogramFigure as ThreatIntelligencePictogramFigure } from "../../publications/threat_intelligence/pictograms/figure";
+import { PictogramFigure as GenericPictogramFigure } from "../../components/pictogram-figure";
+import { PresentationFooter } from "../../components/presentation-footer";
+
+// Threat Intelligence supplies its own pictogram figure media; any other
+// publication gets the generic fallback (components/pictogram-figure.tsx).
+// Same decoupling as renderers/pretext/presentation-shell.tsx -- see
+// docs/pluggable-publishers.md section 2.6 and PPY-d79ff2.
+const PictogramFigure = SITE_BRAND.id === "threat-intelligence" ? ThreatIntelligencePictogramFigure : GenericPictogramFigure;
+
+export type { ArticlePageEditionFooter };
+
+type ArticlePageViewProps = RenderArticleProps;
+
+export function ArticlePageView({ article, backHref, backLabel = SITE_BRAND.backToHomeLabel, editionFooter, editionDate }: ArticlePageViewProps) {
+  const articleDate = editionDate ? formatArticleDate(editionDate) : null;
+
+  return (
+    <main className={getArticleShellClassName(editionFooter)}>
+      <nav className="article-nav">
+        <Link href={backHref}>{backLabel}</Link>
+        <span>{article.section}</span>
+      </nav>
+      <article className="article-page">
+        {article.video ? (
+          <div className="article-page__hero-video">
+            <ArticleVideoFigure slug={article.slug} video={article.video} />
+          </div>
+        ) : null}
+        <header>
+          <p className="story-label">{article.section}</p>
+          <h1>{article.headline}</h1>
+          <p className="article-deck">{article.deck}</p>
+          <div className="story-byline">
+            <span>{article.byline}</span>
+            <span>{article.dateline}</span>
+            {articleDate ? <time dateTime={editionDate}>{articleDate}</time> : null}
+          </div>
+        </header>
+        <div className="article-body">
+          <ArticleLeadPictogram article={article} />
+          {article.body.map((paragraph) => (
+            <p key={paragraph}>{paragraph}</p>
+          ))}
+        </div>
+      </article>
+      {editionFooter ? <ArticleEditionFooter footer={editionFooter} /> : null}
+    </main>
+  );
+}
+
+type ItemPageViewProps = RenderItemProps;
+
+export function ItemPageView({ item, backHref, backLabel = "Back to edition", editionFooter, editionDate }: ItemPageViewProps) {
+  if (item.type === "article") {
+    return <ArticlePageView article={item} backHref={backHref} backLabel={backLabel} editionFooter={editionFooter} editionDate={editionDate} />;
+  }
+
+  const itemDate = editionDate ? formatArticleDate(editionDate) : null;
+  const itemVideo = getPublicationItemVideoAsset(item);
+
+  return (
+    <main className={getArticleShellClassName(editionFooter)}>
+      <nav className="article-nav">
+        <Link href={backHref}>{backLabel}</Link>
+        <span>{item.section ?? item.type}</span>
+      </nav>
+      <article className="article-page" data-item-type={item.type}>
+        {itemVideo ? (
+          <div className="article-page__hero-video">
+            <ArticleVideoFigure slug={item.slug} video={itemVideo} />
+          </div>
+        ) : null}
+        <header>
+          <p className="story-label">{item.section ?? item.type}</p>
+          <h1>{item.title}</h1>
+          {item.deck ? <p className="article-deck">{item.deck}</p> : null}
+          {itemDate ? (
+            <div className="story-byline">
+              <time dateTime={editionDate}>{itemDate}</time>
+            </div>
+          ) : null}
+        </header>
+        <div className="article-body">
+          <ItemLeadPictogram item={item} />
+          {(item.body ?? []).map((paragraph) => (
+            <p key={paragraph}>{paragraph}</p>
+          ))}
+        </div>
+      </article>
+      {editionFooter ? <ArticleEditionFooter footer={editionFooter} /> : null}
+    </main>
+  );
+}
+
+function ArticleLeadPictogram({ article }: { article: Article }) {
+  if (!article.image) return null;
+  return (
+    <PictogramFigure
+      alt={article.image.alt}
+      caption={article.image.caption}
+      credit={article.image.credit}
+      figureClassName="article-photo"
+      height={680}
+      layout={article.image.layout}
+      priority
+      sizes="(max-width: 980px) 100vw, 900px"
+      slug={article.slug}
+      src={article.image.src}
+      themeVariants={article.image.themeVariants}
+      width={1200}
+    />
+  );
+}
+
+function ItemLeadPictogram({ item }: { item: PublicationItem }) {
+  const image = item.type === "article" ? item.image : item.image;
+  if (!image) return null;
+  return (
+    <PictogramFigure
+      alt={image.alt}
+      caption={image.caption}
+      credit={image.credit}
+      figureClassName="article-photo"
+      height={680}
+      layout={image.layout}
+      priority
+      sizes="(max-width: 980px) 100vw, 900px"
+      slug={item.slug}
+      src={image.src}
+      themeVariants={image.themeVariants}
+      width={1200}
+    />
+  );
+}
+
+function ArticleEditionFooter({ footer }: { footer: ArticlePageEditionFooter }) {
+  return (
+    <PresentationFooter
+      editionBasePath={footer.editionBasePath}
+      entries={footer.entries}
+      resolveSectionHref={(entry) => `${footer.editionBasePath}#section-${entry.sectionKey}`}
+      subtitle={footer.subtitle}
+      title={footer.title}
+    />
+  );
+}
+
+function getArticleShellClassName(editionFooter: ArticlePageEditionFooter | undefined): string {
+  return editionFooter ? "article-shell article-shell--edition" : "article-shell";
+}
+
+function formatArticleDate(value: string): string {
+  const normalized = value.trim();
+  if (!normalized) return value;
+
+  const date = new Date(`${normalized}T00:00:00`);
+  if (Number.isNaN(date.getTime())) return value;
+
+  return new Intl.DateTimeFormat("en-US", {
+    day: "numeric",
+    month: "long",
+    year: "numeric",
+  }).format(date);
+}

package/renderers/pretext/index.ts

@@ -0,0 +1,30 @@
+import type { Renderer } from "../../lib/renderer";
+import { PRETEXT_LAYOUTS, pretextSupportsLayout } from "./layouts";
+import { ArticlePageView, ItemPageView } from "./article-page";
+import { PresentationShell } from "./presentation-shell";
+
+export { ArticlePageView, ItemPageView } from "./article-page";
+export { PresentationShell } from "./presentation-shell";
+export type { PresentationTarget } from "./presentation-shell";
+export { PRETEXT_LAYOUTS, pretextSupportsLayout } from "./layouts";
+
+/**
+ * The Pretext renderer: the existing client-side layout solver
+ * (`@chenglou/pretext` + `components/newspaper.tsx` +
+ * `renderers/pretext/presentation-shell.tsx`), retrofitted onto the
+ * `Renderer` interface (lib/renderer.ts). This is a pure retrofit -- no
+ * rendering behavior changed, only how the existing implementation is
+ * exposed.
+ */
+export const pretextRenderer: Renderer = {
+  id: "pretext",
+  renderEdition: PresentationShell,
+  renderArticle: ArticlePageView,
+  renderItem: ItemPageView,
+  // Pretext's CSS is not extracted from the monolithic app/globals.css
+  // bundle imported unconditionally by app/layout.tsx, so there is nothing
+  // additional for this renderer to declare today. See lib/renderer.ts's
+  // `stylesheets` doc comment.
+  stylesheets: () => [],
+  supportsLayout: pretextSupportsLayout,
+};

package/renderers/pretext/layouts.ts

@@ -0,0 +1,16 @@
+import type { PretextLayout } from "../../lib/renderer-config";
+
+/**
+ * Layout ("newsprint" | "blog" | "magazine") is Pretext-internal: it is the
+ * look within Pretext, not a concept every renderer needs to share. This is
+ * the canonical list of layouts the Pretext renderer actually supports,
+ * consumed both by `renderers/pretext`'s `supportsLayout` and by
+ * `lib/site-brand.ts`'s `getPresentationChoices` (today the only renderer,
+ * so "layouts the app can choose from" and "layouts Pretext supports" are
+ * the same list).
+ */
+export const PRETEXT_LAYOUTS: readonly PretextLayout[] = ["newsprint", "blog", "magazine"];
+
+export function pretextSupportsLayout(layout: PretextLayout): boolean {
+  return PRETEXT_LAYOUTS.includes(layout);
+}