@anthusai/papyrus 0.0.0 → 1.0.0-next.1

package/lib/site-brand.ts

@@ -0,0 +1,179 @@
+import type { EditionPresentationFormat } from "./content-types";
+import papyrusSite from "papyrus-site";
+import { threatIntelligenceBrand } from "../publications/threat_intelligence/brand";
+import { pilobolUsBrand } from "../publications/pilobol_us/brand";
+import { anthUsBrand } from "../publications/anth_us/brand";
+import {
+  DEFAULT_THEME_PACK_TOKENS,
+  type HostingConfig,
+  type OpsChrome,
+  type ReaderDeployment,
+  type RendererConfig,
+  type RootRouteConfig,
+  type ThemePackId,
+  type ThemePackTokens,
+} from "./site-stack";
+
+/** Open string: a publication registers its own brand through `papyrus.config.ts` (`defineSite`). */
+export type SiteBrandId = string;
+
+export type SiteBrand = {
+  id: SiteBrandId;
+  appTitle: string;
+  appDescription: string;
+  mastheadTitle: string;
+  mastheadSubtitle: string;
+  mastheadTagline?: string;
+  backToHomeLabel: string;
+  articleTitleSuffix: string;
+  placeholderByline: string;
+  defaultPresentation: EditionPresentationFormat;
+  forcedPresentation?: EditionPresentationFormat;
+  textFont: string;
+  footerTitle?: string;
+  footerSubtitleOverride?: string;
+  mastheadWordSplit: boolean;
+  mastheadDateFormat: "raw" | "formatted";
+  mastheadSource: "edition" | "brand";
+  sectionLinkStrategy: "route" | "anchor";
+  defaultVideoCredit?: string;
+  themePack: ThemePackId;
+  themeTokens: ThemePackTokens;
+  renderer: RendererConfig;
+  hosting: HostingConfig;
+  /** Static reader app when it is not co-hosted with this Papyrus checkout. */
+  readerDeployment?: ReaderDeployment;
+  /**
+   * What the root route (`/`) does. Defaults to `{ kind: "reader" }` (render
+   * the publication home page). Set to `{ kind: "redirect", destination }`
+   * for a CMS-only deployment whose reader lives elsewhere.
+   */
+  rootRoute?: RootRouteConfig;
+  /** Public URL prefix for newsroom routes. Default `/newsroom`; use `""` on a CMS-only subdomain. */
+  newsroomBasePath?: string;
+  opsChrome: OpsChrome;
+  corpusKey: string;
+  steeringConfigPath: string;
+  newsroomSectionsConfigPath: string;
+  analysisProfilesPath: string;
+  publicationName: string;
+};
+
+const SERIF_TEXT_FONT = 'Georgia, "Times New Roman", serif';
+
+const BUILT_IN_SITE_BRANDS: Record<SiteBrandId, SiteBrand> = {
+  papyrus: {
+    id: "papyrus",
+    appTitle: "Papyrus",
+    appDescription: "A Pretext-powered responsive newspaper layout lab.",
+    mastheadTitle: "PAPYRUS",
+    mastheadSubtitle: "Inside Papyrus",
+    backToHomeLabel: "Back to Papyrus",
+    articleTitleSuffix: "Papyrus",
+    placeholderByline: "Papyrus",
+    defaultPresentation: "newsprint",
+    textFont: SERIF_TEXT_FONT,
+    mastheadWordSplit: false,
+    mastheadDateFormat: "raw",
+    mastheadSource: "edition",
+    sectionLinkStrategy: "route",
+    themePack: "papyrus",
+    themeTokens: DEFAULT_THEME_PACK_TOKENS,
+    renderer: { kind: "pretext" },
+    hosting: { kind: "amplify-ssr" },
+    opsChrome: "app",
+    corpusKey: "threat-intelligence",
+    steeringConfigPath: "corpora/papyrus-steering.yml",
+    newsroomSectionsConfigPath: "corpora/papyrus-newsroom-sections.yml",
+    analysisProfilesPath: "corpora/papyrus-analysis-profiles.yml",
+    publicationName: "Anthus Threat Intelligence",
+  },
+  "threat-intelligence": threatIntelligenceBrand,
+  "pilobol-us": pilobolUsBrand,
+  "anth-us": anthUsBrand,
+};
+
+/**
+ * Built-in reference brands plus whatever the publication registered in its
+ * own `papyrus.config.ts` (resolved through the `papyrus-site` alias).
+ */
+const SITE_BRANDS: Record<SiteBrandId, SiteBrand> = {
+  ...BUILT_IN_SITE_BRANDS,
+  ...Object.fromEntries((papyrusSite.brands ?? []).map((brand) => [brand.id, brand])),
+};
+
+export function normalizeSiteBrandId(value: string | undefined | null): SiteBrandId | null {
+  if (!value) return null;
+  const normalized = value.trim().toLowerCase().replace(/[._]/g, "-");
+  if (!normalized) return null;
+  if (normalized === "papyrus") return "papyrus";
+  // NOTE: the bare alias `anthus` has resolved to `threat-intelligence` since
+  // that brand was added and is kept pointing there so existing
+  // PAPYRUS_SITE_BRAND values do not silently change meaning. The Anth.us
+  // publication is therefore addressed as `anth-us` / `anth.us` / `anth_us`
+  // only. Do not "tidy" this by moving `anthus` across.
+  if (normalized === "threat-intelligence" || normalized === "threat-intel" || normalized === "anthus") {
+    return "threat-intelligence";
+  }
+  if (normalized === "anth-us") {
+    // `normalized` has already mapped `.` and `_` to `-`, so this covers
+    // `anth.us` and `anth_us` too.
+    return "anth-us";
+  }
+  // Bare `pilobol` is deliberately NOT an alias (f268e72): the brand name is
+  // Pilobolus; Pilobol.us is the domain and `pilobol-us` the technical id.
+  if (normalized === "pilobol-us" || normalized === "pilobolus") {
+    return "pilobol-us";
+  }
+  // Registered brands (publication-owned `papyrus.config.ts`): exact id only.
+  if (Object.prototype.hasOwnProperty.call(SITE_BRANDS, normalized)) return normalized;
+  return null;
+}
+
+export function resolveSiteBrandId(
+  raw: string | undefined | null = process.env.NEXT_PUBLIC_PAPYRUS_SITE_BRAND ?? process.env.PAPYRUS_SITE_BRAND,
+): SiteBrandId {
+  return normalizeSiteBrandId(raw) ?? papyrusSite.defaultBrand ?? "papyrus";
+}
+
+/** Cookie set by middleware when `?brand=` is present (demo without rebuild). */
+export function resolveRuntimeSiteBrandId(
+  cookieOverride: string | undefined | null = null,
+): SiteBrandId {
+  return normalizeSiteBrandId(cookieOverride) ?? resolveSiteBrandId();
+}
+
+export function getSiteBrand(id: SiteBrandId = resolveSiteBrandId()): SiteBrand {
+  return SITE_BRANDS[id];
+}
+
+export const SITE_BRAND = getSiteBrand();
+
+/** Root-route config for a brand, defaulting to `{ kind: "reader" }`. */
+export function getRootRoute(brand: SiteBrand = SITE_BRAND): RootRouteConfig {
+  return brand.rootRoute ?? { kind: "reader" };
+}
+
+export const rootRoute = getRootRoute();
+
+export function enforcePresentation(presentation: EditionPresentationFormat): EditionPresentationFormat {
+  return SITE_BRAND.forcedPresentation ?? presentation;
+}
+
+export function getPresentationChoices(brand: SiteBrand = SITE_BRAND): EditionPresentationFormat[] {
+  return brand.forcedPresentation
+    ? [brand.forcedPresentation]
+    : ["newsprint", "blog", "magazine"];
+}
+
+export function getForcedPresentation(): EditionPresentationFormat | undefined {
+  return SITE_BRAND.forcedPresentation;
+}
+
+export function getDefaultPretextLayout(): EditionPresentationFormat {
+  return SITE_BRAND.defaultPresentation;
+}
+
+export function getRendererKind(): RendererConfig["kind"] {
+  return SITE_BRAND.renderer.kind;
+}

package/lib/site-renderer.ts

@@ -0,0 +1,17 @@
+import { MarkusSiteRendererError } from "./renderer-config";
+import { SITE_BRAND } from "./site-brand";
+import type { Renderer } from "./renderer";
+import { pretextRenderer } from "../renderers/pretext";
+
+export { MarkusSiteRendererError } from "./renderer-config";
+
+export function assertPretextSite(): void {
+  if (SITE_BRAND.renderer.kind === "markus") {
+    throw new MarkusSiteRendererError("hackerman", SITE_BRAND.id);
+  }
+}
+
+export function getSiteRenderer(): Renderer {
+  assertPretextSite();
+  return pretextRenderer;
+}

package/lib/site-stack.ts

@@ -0,0 +1,195 @@
+/**
+ * Independent site-stack axes. Do not collapse these into one "brand mode".
+ * - themePack / themeTokens: ops + shared Shadcn colors
+ * - opsChrome: newsroom shell (app vs newsprint)
+ * - renderer: publication / reader output (pretext vs markus)
+ * - hosting: where the built site is served
+ *
+ * Shared ops components consume CSS variables only. Pilobolus is the first
+ * extra pack, not the platform default (that remains `papyrus`).
+ */
+/** Open string: publications register their own pack id (see lib/define-site.ts). */
+export type ThemePackId = string;
+
+export type RendererConfig = {
+  kind: "pretext" | "markus";
+};
+
+export type HostingConfig =
+  | { kind: "amplify-ssr" }
+  | { kind: "amplify-static" };
+
+/**
+ * What the root route (`/`) of a Papyrus app does. Independent of hosting and
+ * of where the public reader lives — a site configures this explicitly.
+ *
+ * - `reader`: render the publication home page here (the single-app reader+Cms
+ *   model used by p.apyr.us and Threat Intelligence). Default when omitted.
+ * - `redirect`: redirect `/` to `destination` (a path or absolute URL). Use
+ *   this for CMS-only deployments whose public reader lives on another app.
+ * - `newsroom`: render the newsroom desk at `/` (for a CMS-only subdomain).
+ */
+export type RootRouteConfig =
+  | { kind: "reader" }
+  | { kind: "redirect"; destination: string; permanent?: boolean }
+  | { kind: "newsroom" };
+
+/**
+ * Optional reader deployment when CMS and public reader ship separately
+ * (Pilobolus, Anth.us).
+ *
+ * `domain` and `amplifyAppId` are optional because a reader can legitimately
+ * exist before either is known: a staging port runs on the Amplify-provided
+ * hostname with no custom domain attached, and the app id does not exist until
+ * someone creates the app. Leave them unset rather than writing down a
+ * hostname that is not actually serving this build — a wrong canonical host is
+ * worse than an absent one.
+ */
+export type ReaderDeployment = {
+  kind: "amplify-static";
+  repository: string;
+  domain?: string;
+  amplifyAppId?: string;
+};
+
+export type OpsChrome = "newsprint" | "app";
+
+export type SiteOpsStack = {
+  chrome: OpsChrome;
+  themePack: ThemePackId;
+  themeTokens: ThemePackTokens;
+};
+
+export type SitePublicationStack = {
+  renderer: RendererConfig;
+};
+
+/** Ops UI and publication/reader are independently pluggable. */
+export type SiteStack = {
+  ops: SiteOpsStack;
+  publication: SitePublicationStack;
+  hosting: HostingConfig;
+};
+
+export type SiteStackSource = {
+  themePack: ThemePackId;
+  themeTokens: ThemePackTokens;
+  opsChrome: OpsChrome;
+  renderer: RendererConfig;
+  hosting: HostingConfig;
+};
+
+export function getSiteStack(source: SiteStackSource): SiteStack {
+  return {
+    ops: {
+      chrome: source.opsChrome,
+      themePack: source.themePack,
+      themeTokens: source.themeTokens,
+    },
+    publication: { renderer: source.renderer },
+    hosting: source.hosting,
+  };
+}
+
+export type ThemePackPalette = {
+  paper: string;
+  moss: string;
+  ochre: string;
+  ink: string;
+  muted?: string;
+  card?: string;
+  line?: string;
+  quote?: string;
+  tip?: string;
+  caution?: string;
+  stage?: string;
+};
+
+export type ThemePackTokens = ThemePackPalette & {
+  dark?: ThemePackPalette;
+};
+
+export const DEFAULT_THEME_PACK_TOKENS: ThemePackTokens = {
+  paper: "#f4f4f5",
+  moss: "#18181b",
+  ochre: "#a1a1aa",
+  ink: "#3f3f46",
+};
+
+/**
+ * Pilobolus / fungus-among-us palette copied from AnthusAI/Pilobol.us
+ * `web/css/pilobil-theme-v10.css` (`:root` / `@media (prefers-color-scheme: dark)`).
+ * Colors only — Shadcn owns typography. Do not load that file at runtime.
+ */
+export const PILOBOL_US_THEME_PACK_TOKENS: ThemePackTokens = {
+  ink: "#211d17",
+  muted: "#6b6153",
+  paper: "#f1ead9",
+  card: "#fbf6ea",
+  line: "#d7cbb2",
+  moss: "#3f5d43",
+  ochre: "#a35a2a",
+  quote: "#4a3548",
+  tip: "#4f6b3a",
+  caution: "#8a3324",
+  stage: "#ddd4bf",
+  dark: {
+    ink: "#dfded0",
+    muted: "#8b9184",
+    paper: "#14170f",
+    card: "#1c2117",
+    line: "#333b2a",
+    moss: "#b7d18a",
+    ochre: "#d0895a",
+    quote: "#b7a3c4",
+    tip: "#9fce7a",
+    caution: "#d17e6e",
+    stage: "#0d0f0a",
+  },
+};
+
+/**
+ * Anthus palette, read off the live Gatsby site at `AnthusAI/Anth.us`
+ * (`src/styles/variables.scss` `:root`). Colors only — Shadcn owns typography.
+ * Mapping from that file's names to the pack's slots:
+ *
+ * | pack slot | Anth.us variable          | value     |
+ * | --------- | ------------------------- | --------- |
+ * | `paper`   | `--color-layout-bg`       | `#f1f9fe` |
+ * | `card`    | `--color-wrapper-bg`      | `#ffffff` |
+ * | `ink`     | `--color-text`            | `#333333` |
+ * | `moss`    | `--color-primary`         | `#dc5497` |
+ * | `ochre`   | `--color-active`          | `#ff57b4` |
+ * | `quote`   | `--color-gradient-mid`    | `#9b165d` |
+ * | `tip`     | `--color-gradient-end`    | `#0389d7` |
+ * | `stage`   | `--color-hamburger`       | `#fedded` |
+ *
+ * Two slots have no counterpart on the Gatsby site and are **derived**, which
+ * is called out here so nobody mistakes them for copied brand values:
+ *
+ * - `line`: the site's only rule color is `hr { background: hsla(0,0%,0%,0.2) }`
+ *   over white, flattened to `#cccccc`.
+ * - `muted`: the site has no muted-text token at all — it dims with
+ *   `opacity: 0.5` instead (and references an undefined `--color-text-light`).
+ *   `#5f6b73` is `--color-text` desaturated toward `paper`'s blue.
+ * - `caution`: `#e95800`, which the site uses for one of its `::marker`
+ *   colors; it has no dedicated danger color.
+ *
+ * There is deliberately **no `dark` palette**: the Gatsby site has no dark
+ * mode. Its only `prefers-color-scheme: dark` block overrides two
+ * code-highlight tints. Inventing a dark Anthus palette here would be making
+ * up a look rather than porting one, so `theme.css` pins `color-scheme: light`.
+ */
+export const ANTH_US_THEME_PACK_TOKENS: ThemePackTokens = {
+  ink: "#333333",
+  muted: "#5f6b73",
+  paper: "#f1f9fe",
+  card: "#ffffff",
+  line: "#cccccc",
+  moss: "#dc5497",
+  ochre: "#ff57b4",
+  quote: "#9b165d",
+  tip: "#0389d7",
+  caution: "#e95800",
+  stage: "#fedded",
+};

package/lib/themed-image.ts

@@ -0,0 +1,30 @@
+import type { ArticleImageThemeVariants, ArticleVideoThemeVariants } from "./articles";
+
+export type ResolvedTheme = "light" | "dark";
+
+export function resolveThemedImageSrc(
+  src: string,
+  themeVariants: ArticleImageThemeVariants | undefined,
+  theme: ResolvedTheme,
+): string {
+  if (theme === "dark" && themeVariants?.dark?.src) return themeVariants.dark.src;
+  if (theme === "dark") return resolveStaticDarkSvgFallback(src) ?? src;
+  return src;
+}
+
+export function resolveThemedVideoSrc(
+  src: string,
+  themeVariants: ArticleVideoThemeVariants | undefined,
+  theme: ResolvedTheme,
+): string {
+  if (theme === "light" && themeVariants?.light?.src) return themeVariants.light.src;
+  if (theme === "dark" && themeVariants?.dark?.src) return themeVariants.dark.src;
+  return src;
+}
+
+function resolveStaticDarkSvgFallback(src: string): string | null {
+  if (src.startsWith("/seed-art/threat-intelligence/") && !src.endsWith("-dark.svg") && /\.svg(?:\?.*)?$/i.test(src)) {
+    return src.replace(/\.svg(?:\?.*)?$/i, (suffix) => `-dark${suffix}`);
+  }
+  return null;
+}

package/lib/utils.ts

@@ -0,0 +1,6 @@
+import { clsx, type ClassValue } from "clsx"
+import { twMerge } from "tailwind-merge"
+
+export function cn(...inputs: ClassValue[]) {
+  return twMerge(clsx(inputs))
+}

package/middleware.ts

@@ -0,0 +1,78 @@
+import type { NextRequest } from "next/server";
+import { NextResponse } from "next/server";
+import { getSiteBrand, normalizeSiteBrandId, resolveSiteBrandId } from "./lib/site-brand";
+
+const BRAND_OVERRIDE_COOKIE = "papyrus-site-brand-override";
+
+function usesNewsroomRootPaths(request: NextRequest): boolean {
+  const cookieBrand = request.cookies.get(BRAND_OVERRIDE_COOKIE)?.value;
+  const brandId = normalizeSiteBrandId(cookieBrand)
+    ?? normalizeSiteBrandId(request.nextUrl.searchParams.get("brand"))
+    ?? resolveSiteBrandId();
+  // Brand property (not a hard-coded id) so publication-registered brands work.
+  return getSiteBrand(brandId).rootRoute?.kind === "newsroom" && getSiteBrand(brandId).newsroomBasePath === "";
+}
+
+function isStaticOrApiPath(pathname: string): boolean {
+  return (
+    pathname.startsWith("/_next")
+    || pathname.startsWith("/api")
+    || pathname === "/favicon.ico"
+    || pathname.startsWith("/icon")
+    || /\.[a-zA-Z0-9]+$/.test(pathname)
+  );
+}
+
+export function middleware(request: NextRequest) {
+  const brandParam = request.nextUrl.searchParams.get("brand");
+  const brandId = normalizeSiteBrandId(brandParam);
+  let response: NextResponse | null = null;
+
+  if (brandId) {
+    response = NextResponse.next();
+    response.cookies.set(BRAND_OVERRIDE_COOKIE, brandId, {
+      path: "/",
+      maxAge: 60 * 60 * 24 * 30,
+      sameSite: "lax",
+    });
+  }
+
+  if (!usesNewsroomRootPaths(request)) {
+    return response ?? NextResponse.next();
+  }
+
+  const { pathname } = request.nextUrl;
+  if (isStaticOrApiPath(pathname)) {
+    return response ?? NextResponse.next();
+  }
+
+  if (pathname === "/newsroom" || pathname === "/newsroom/") {
+    return NextResponse.redirect(new URL("/", request.url));
+  }
+  if (pathname.startsWith("/newsroom/")) {
+    const target = pathname.slice("/newsroom".length) || "/";
+    return NextResponse.redirect(new URL(`${target}${request.nextUrl.search}`, request.url));
+  }
+
+  if (pathname === "/" || pathname === "") {
+    return response ?? NextResponse.next();
+  }
+
+  if (!pathname.startsWith("/newsroom")) {
+    const rewriteUrl = request.nextUrl.clone();
+    rewriteUrl.pathname = `/newsroom${pathname}`;
+    const rewrite = NextResponse.rewrite(rewriteUrl);
+    if (response) {
+      for (const cookie of response.cookies.getAll()) {
+        rewrite.cookies.set(cookie);
+      }
+    }
+    return rewrite;
+  }
+
+  return response ?? NextResponse.next();
+}
+
+export const config = {
+  matcher: ["/((?!_next/static|_next/image|favicon.ico|icon).*)"],
+};