@anthusai/papyrus 0.0.0 → 1.0.0-next.10

package/lib/video-script.ts

@@ -0,0 +1,63 @@
+export type VideoElementAliases = Record<string, string>;
+
+/**
+ * Rewrites generic VideoML element names in a stored script to the publication's
+ * own scene components, e.g. `{ "quote-card": "acme-quote-card" }`.
+ */
+export function normalizeDevPreviewDsl(dsl: string, elementAliases: VideoElementAliases = {}): string {
+  let normalized = dsl;
+  for (const [generic, branded] of Object.entries(elementAliases)) {
+    const escaped = generic.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+    normalized = normalized.replace(new RegExp(`(</?)${escaped}(?=[\\s/>])`, "g"), `$1${branded}`);
+  }
+  return normalized;
+}
+
+export type VideoScriptTargetKind = "article" | "edition";
+
+export type VideoScriptRef = {
+  slug: string;
+  dsl: string;
+  targetKind: VideoScriptTargetKind;
+};
+
+export function videomlItemSlug(targetSlug: string): string {
+  return `${targetSlug}--videoml`;
+}
+
+export function parseVideoScriptRef(item: {
+  slug: string;
+  editorial?: unknown;
+}): VideoScriptRef | null {
+  const editorial = parseEditorial(item.editorial);
+  const videoScript = editorial?.videoScript;
+  if (!videoScript || typeof videoScript !== "object" || Array.isArray(videoScript)) return null;
+
+  const scriptRecord = videoScript as Record<string, unknown>;
+  const dsl = typeof scriptRecord.dsl === "string" ? scriptRecord.dsl.trim() : "";
+  if (!dsl) return null;
+
+  const target = scriptRecord.target;
+  const targetKind: VideoScriptTargetKind =
+    target && typeof target === "object" && !Array.isArray(target) && (target as Record<string, unknown>).kind === "edition"
+      ? "edition"
+      : "article";
+
+  return { slug: item.slug, dsl, targetKind };
+}
+
+function parseEditorial(editorial: unknown): Record<string, unknown> | null {
+  if (!editorial) return null;
+  if (typeof editorial === "string") {
+    try {
+      const parsed = JSON.parse(editorial) as unknown;
+      return parsed && typeof parsed === "object" && !Array.isArray(parsed) ? (parsed as Record<string, unknown>) : null;
+    } catch {
+      return null;
+    }
+  }
+  if (typeof editorial === "object" && !Array.isArray(editorial)) {
+    return editorial as Record<string, unknown>;
+  }
+  return null;
+}

package/middleware.ts

@@ -0,0 +1,103 @@
+import type { NextRequest } from "next/server";
+import { NextResponse } from "next/server";
+import { getSiteBrand } from "./lib/site-brand";
+import { getSiteEnv, isIndexable } from "./lib/site-env";
+import { getStagingAccess } from "./lib/staging-gate";
+import {
+  isPreviewGatedPath,
+  isStaticPreviewEnabled,
+  previewRewritePathname,
+  shouldRewriteToPreview,
+} from "./lib/staging-preview-object";
+
+function usesNewsroomRootPaths(): boolean {
+  const brand = getSiteBrand();
+  return brand.rootRoute?.kind === "newsroom" && brand.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)
+  );
+}
+
+function isStagingGatedPath(pathname: string): boolean {
+  if (isStaticOrApiPath(pathname)) return false;
+  if (pathname === "/robots.txt") return false;
+  if (pathname === "/newsroom" || pathname.startsWith("/newsroom/")) return false;
+  return true;
+}
+
+function routeRequest(request: NextRequest): NextResponse {
+  if (isStaticPreviewEnabled() && shouldRewriteToPreview(request.nextUrl.pathname)) {
+    const rewriteUrl = request.nextUrl.clone();
+    rewriteUrl.pathname = previewRewritePathname(request.nextUrl.pathname);
+    return NextResponse.rewrite(rewriteUrl);
+  }
+  if (!usesNewsroomRootPaths()) {
+    return NextResponse.next();
+  }
+
+  const { pathname } = request.nextUrl;
+  if (isStaticOrApiPath(pathname)) {
+    return 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 NextResponse.next();
+  }
+
+  if (!pathname.startsWith("/newsroom")) {
+    const rewriteUrl = request.nextUrl.clone();
+    rewriteUrl.pathname = `/newsroom${pathname}`;
+    return NextResponse.rewrite(rewriteUrl);
+  }
+
+  return NextResponse.next();
+}
+
+export async function middleware(request: NextRequest): Promise<NextResponse> {
+  let sessionResponse: NextResponse | null = null;
+  const { pathname } = request.nextUrl;
+  const gated = isStaticPreviewEnabled() ? isPreviewGatedPath(pathname) : isStagingGatedPath(pathname);
+  if (getSiteEnv() === "staging" && gated) {
+    sessionResponse = NextResponse.next();
+    const access = await getStagingAccess(request, sessionResponse);
+    if (access === "anonymous") {
+      return withRobotsHeader(NextResponse.redirect(new URL("/newsroom", request.url)));
+    }
+    if (access === "forbidden") {
+      return withRobotsHeader(new NextResponse("Staging is limited to editors and admins.", { status: 403 }));
+    }
+  }
+
+  const response = routeRequest(request);
+  if (sessionResponse) {
+    for (const cookie of sessionResponse.headers.getSetCookie()) {
+      response.headers.append("set-cookie", cookie);
+    }
+  }
+  return withRobotsHeader(response);
+}
+
+function withRobotsHeader(response: NextResponse): NextResponse {
+  if (!isIndexable()) response.headers.set("X-Robots-Tag", "noindex, nofollow");
+  return response;
+}
+
+export const config = {
+  runtime: "nodejs",
+  matcher: ["/((?!_next/static|_next/image|favicon.ico|icon).*)"],
+};

package/package.json

@@ -1 +1,318 @@
-{"name":"@anthusai/papyrus","version":"0.0.0","description":"Placeholder; releases are published by GitHub Actions.","license":"MIT","repository":{"type":"git","url":"git+https://github.com/AnthusAI/Papyrus.git"}}
+{
+  "name": "@anthusai/papyrus",
+  "description": "Papyrus newsroom app, Pretext renderer, theme packs, Amplify Gen 2 backend definition and app-shell CDK constructs (spike build).",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/AnthusAI/Papyrus.git"
+  },
+  "homepage": "https://github.com/AnthusAI/Papyrus#readme",
+  "keywords": [
+    "newsroom",
+    "publishing",
+    "nextjs",
+    "pretext",
+    "amplify"
+  ],
+  "type": "module",
+  "bin": {
+    "papyrus-app": "./bin/papyrus-app.mjs",
+    "papyrus-infra": "./bin/papyrus-infra.mjs"
+  },
+  "exports": {
+    ".": "./src/with-papyrus.mjs",
+    "./next": {
+      "types": "./src/with-papyrus.d.mts",
+      "default": "./src/with-papyrus.mjs"
+    },
+    "./backend": {
+      "types": "./src/backend.ts",
+      "default": "./src/backend.js"
+    },
+    "./define-site": {
+      "types": "./lib/define-site.ts",
+      "default": "./lib/define-site.js"
+    },
+    "./app/*": [
+      "./app/*.tsx",
+      "./app/*.ts",
+      "./app/*"
+    ],
+    "./components/*": [
+      "./components/*.tsx",
+      "./components/*.ts",
+      "./components/*"
+    ],
+    "./lib/*": [
+      "./lib/*.tsx",
+      "./lib/*.ts",
+      "./lib/*"
+    ],
+    "./renderers/*": [
+      "./renderers/*.tsx",
+      "./renderers/*.ts",
+      "./renderers/*"
+    ],
+    "./amplify/*": [
+      "./amplify/*.ts",
+      "./amplify/*"
+    ],
+    "./routes.manifest.json": "./routes.manifest.json",
+    "./package.json": "./package.json",
+    "./middleware": "./middleware.ts",
+    "./infra": {
+      "types": "./infra/amplify-app-shell.ts",
+      "default": "./infra/index.js"
+    },
+    "./components/ai-elements/conversation": "./components/ai-elements/conversation.tsx",
+    "./components/ai-elements/message": "./components/ai-elements/message.tsx",
+    "./components/ai-elements/model-selector": "./components/ai-elements/model-selector.tsx",
+    "./components/ai-elements/prompt-input": "./components/ai-elements/prompt-input.tsx",
+    "./components/ai-elements/shimmer": "./components/ai-elements/shimmer.tsx",
+    "./components/ai-elements/suggestion": "./components/ai-elements/suggestion.tsx",
+    "./components/ai-elements/tool": "./components/ai-elements/tool.tsx",
+    "./components/amplify-client-provider": "./components/amplify-client-provider.tsx",
+    "./components/archive-grid": "./components/archive-grid.tsx",
+    "./components/archive-shell": "./components/archive-shell.tsx",
+    "./components/article-video": "./components/article-video.tsx",
+    "./components/blog-page-background": "./components/blog-page-background.tsx",
+    "./components/dev-sandbox-editor-sign-in": "./components/dev-sandbox-editor-sign-in.tsx",
+    "./components/markus-ir-preview": "./components/markus-ir-preview.tsx",
+    "./components/news-desk-client-provider": "./components/news-desk-client-provider.tsx",
+    "./components/news-desk-page": "./components/news-desk-page.tsx",
+    "./components/news-desk-taxonomy-client": "./components/news-desk-taxonomy-client.ts",
+    "./components/newspaper": "./components/newspaper.tsx",
+    "./components/newsroom-access-gate": "./components/newsroom-access-gate.tsx",
+    "./components/newsroom-article-editor": "./components/newsroom-article-editor.tsx",
+    "./components/newsroom-articles-view": "./components/newsroom-articles-view.tsx",
+    "./components/newsroom-assignments-view": "./components/newsroom-assignments-view.tsx",
+    "./components/newsroom-ops-overview": "./components/newsroom-ops-overview.tsx",
+    "./components/newsroom-ops-shell": "./components/newsroom-ops-shell.tsx",
+    "./components/newsroom-references-view": "./components/newsroom-references-view.tsx",
+    "./components/newsroom-topics-view": "./components/newsroom-topics-view.tsx",
+    "./components/papyrus-console-shell": "./components/papyrus-console-shell.tsx",
+    "./components/pictogram-figure": "./components/pictogram-figure.tsx",
+    "./components/presentation-footer": "./components/presentation-footer.tsx",
+    "./components/reader-auth-control": "./components/reader-auth-control.tsx",
+    "./components/reader-auth-state": "./components/reader-auth-state.ts",
+    "./components/reader-settings": "./components/reader-settings.ts",
+    "./components/reader-theme-control": "./components/reader-theme-control.tsx",
+    "./components/reference-source-preview": "./components/reference-source-preview.tsx",
+    "./components/settings-page": "./components/settings-page.tsx",
+    "./components/staging-banner": "./components/staging-banner.tsx",
+    "./components/topic-steering-workspace": "./components/topic-steering-workspace.tsx",
+    "./components/ui/badge": "./components/ui/badge.tsx",
+    "./components/ui/button-group": "./components/ui/button-group.tsx",
+    "./components/ui/button": "./components/ui/button.tsx",
+    "./components/ui/card": "./components/ui/card.tsx",
+    "./components/ui/command": "./components/ui/command.tsx",
+    "./components/ui/dialog": "./components/ui/dialog.tsx",
+    "./components/ui/dropdown-menu": "./components/ui/dropdown-menu.tsx",
+    "./components/ui/hover-card": "./components/ui/hover-card.tsx",
+    "./components/ui/input-group": "./components/ui/input-group.tsx",
+    "./components/ui/input": "./components/ui/input.tsx",
+    "./components/ui/scroll-area": "./components/ui/scroll-area.tsx",
+    "./components/ui/select": "./components/ui/select.tsx",
+    "./components/ui/separator": "./components/ui/separator.tsx",
+    "./components/ui/sheet": "./components/ui/sheet.tsx",
+    "./components/ui/spinner": "./components/ui/spinner.tsx",
+    "./components/ui/tabs": "./components/ui/tabs.tsx",
+    "./components/ui/textarea": "./components/ui/textarea.tsx",
+    "./components/ui/tooltip": "./components/ui/tooltip.tsx",
+    "./components/use-resolved-papyrus-theme": "./components/use-resolved-papyrus-theme.ts",
+    "./lib/amplify-outputs-guard": "./lib/amplify-outputs-guard.ts",
+    "./lib/amplify-outputs-path": "./lib/amplify-outputs-path.ts",
+    "./lib/amplify-server-runtime": "./lib/amplify-server-runtime.ts",
+    "./lib/archive-data": "./lib/archive-data.ts",
+    "./lib/archive-types": "./lib/archive-types.ts",
+    "./lib/articles": "./lib/articles.ts",
+    "./lib/cached-content-repository": "./lib/cached-content-repository.ts",
+    "./lib/category-dashboard": "./lib/category-dashboard.ts",
+    "./lib/category-repository": "./lib/category-repository.ts",
+    "./lib/console-chat-client": "./lib/console-chat-client.ts",
+    "./lib/console-web-context": "./lib/console-web-context.ts",
+    "./lib/content-actions-client": "./lib/content-actions-client.ts",
+    "./lib/content-actions-demo": "./lib/content-actions-demo.ts",
+    "./lib/content-load-timing": "./lib/content-load-timing.ts",
+    "./lib/content-repository": "./lib/content-repository.ts",
+    "./lib/content-source-context": "./lib/content-source-context.ts",
+    "./lib/content-types": "./lib/content-types.ts",
+    "./lib/define-site": "./lib/define-site.ts",
+    "./lib/demo-amplify-outputs": "./lib/demo-amplify-outputs.ts",
+    "./lib/dev-sandbox-editor-auth": "./lib/dev-sandbox-editor-auth.ts",
+    "./lib/doctrine": "./lib/doctrine.ts",
+    "./lib/edition-routes": "./lib/edition-routes.ts",
+    "./lib/edition-sections": "./lib/edition-sections.ts",
+    "./lib/empty-edition-layout-plan": "./lib/empty-edition-layout-plan.ts",
+    "./lib/excerpts": "./lib/excerpts.ts",
+    "./lib/graphql-content-repository": "./lib/graphql-content-repository.ts",
+    "./lib/image-url": "./lib/image-url.ts",
+    "./lib/layout-plan": "./lib/layout-plan.ts",
+    "./lib/layout-scenarios": "./lib/layout-scenarios.ts",
+    "./lib/markus-body": "./lib/markus-body.ts",
+    "./lib/markus-ir": "./lib/markus-ir.ts",
+    "./lib/markus-projection": "./lib/markus-projection.ts",
+    "./lib/markus-to-article": "./lib/markus-to-article.ts",
+    "./lib/news-desk-session": "./lib/news-desk-session.ts",
+    "./lib/newspaper-layout": "./lib/newspaper-layout.ts",
+    "./lib/newsroom-articles": "./lib/newsroom-articles.ts",
+    "./lib/newsroom-assignments": "./lib/newsroom-assignments.ts",
+    "./lib/newsroom-base-path": "./lib/newsroom-base-path.ts",
+    "./lib/newsroom-card-layout": "./lib/newsroom-card-layout.ts",
+    "./lib/newsroom-category-drilldown": "./lib/newsroom-category-drilldown.ts",
+    "./lib/newsroom-demo-articles": "./lib/newsroom-demo-articles.ts",
+    "./lib/newsroom-demo-dashboard": "./lib/newsroom-demo-dashboard.ts",
+    "./lib/newsroom-demo-profile": "./lib/newsroom-demo-profile.ts",
+    "./lib/newsroom-forum-routes": "./lib/newsroom-forum-routes.ts",
+    "./lib/newsroom-index-filters": "./lib/newsroom-index-filters.ts",
+    "./lib/newsroom-knowledge-query-request": "./lib/newsroom-knowledge-query-request.ts",
+    "./lib/newsroom-list-selection": "./lib/newsroom-list-selection.ts",
+    "./lib/newsroom-media-backend": "./lib/newsroom-media-backend.ts",
+    "./lib/newsroom-media": "./lib/newsroom-media.ts",
+    "./lib/newsroom-nav": "./lib/newsroom-nav.ts",
+    "./lib/newsroom-references": "./lib/newsroom-references.ts",
+    "./lib/newsroom-sections": "./lib/newsroom-sections.ts",
+    "./lib/newsroom-topics": "./lib/newsroom-topics.ts",
+    "./lib/papyrus-object-kinds": "./lib/papyrus-object-kinds.ts",
+    "./lib/papyrus-web-locations": "./lib/papyrus-web-locations.ts",
+    "./lib/pilobol-sample": "./lib/pilobol-sample.ts",
+    "./lib/presentation-footer": "./lib/presentation-footer.ts",
+    "./lib/pretext-layout": "./lib/pretext-layout.ts",
+    "./lib/public-placeholder-config": "./lib/public-placeholder-config.ts",
+    "./lib/publication-items": "./lib/publication-items.ts",
+    "./lib/reader-route-config": "./lib/reader-route-config.ts",
+    "./lib/reader-static-params": "./lib/reader-static-params.ts",
+    "./lib/reader-storage-url": "./lib/reader-storage-url.ts",
+    "./lib/reference-display": "./lib/reference-display.ts",
+    "./lib/reference-policy": "./lib/reference-policy.ts",
+    "./lib/reference-source-preview": "./lib/reference-source-preview.ts",
+    "./lib/renderer-config": "./lib/renderer-config.ts",
+    "./lib/renderer": "./lib/renderer.ts",
+    "./lib/reporting-story-budget": "./lib/reporting-story-budget.ts",
+    "./lib/semantic-graph": "./lib/semantic-graph.ts",
+    "./lib/site-brand-tenant": "./lib/site-brand-tenant.ts",
+    "./lib/site-brand": "./lib/site-brand.ts",
+    "./lib/site-env": "./lib/site-env.ts",
+    "./lib/site-renderer": "./lib/site-renderer.ts",
+    "./lib/site-stack": "./lib/site-stack.ts",
+    "./lib/staging-gate": "./lib/staging-gate.ts",
+    "./lib/staging-preview-object": "./lib/staging-preview-object.ts",
+    "./lib/themed-image": "./lib/themed-image.ts",
+    "./lib/utils": "./lib/utils.ts",
+    "./lib/video-mode": "./lib/video-mode.ts",
+    "./lib/video-script": "./lib/video-script.ts",
+    "./renderers/markus/index": "./renderers/markus/index.ts",
+    "./renderers/markus/stubs": "./renderers/markus/stubs.tsx",
+    "./renderers/pretext/article-page": "./renderers/pretext/article-page.tsx",
+    "./renderers/pretext/index": "./renderers/pretext/index.ts",
+    "./renderers/pretext/layouts": "./renderers/pretext/layouts.ts",
+    "./renderers/pretext/presentation-shell": "./renderers/pretext/presentation-shell.tsx",
+    "./app/%5F_preview/[[...path]]/route": "./app/%5F_preview/[[...path]]/route.ts",
+    "./app/[year]/[month]/[day]/[articleSlug]/page": "./app/[year]/[month]/[day]/[articleSlug]/page.tsx",
+    "./app/[year]/[month]/[day]/page": "./app/[year]/[month]/[day]/page.tsx",
+    "./app/[year]/[month]/[day]/page/[pageNumber]/page": "./app/[year]/[month]/[day]/page/[pageNumber]/page.tsx",
+    "./app/[year]/[month]/[day]/section/[sectionKey]/page": "./app/[year]/[month]/[day]/section/[sectionKey]/page.tsx",
+    "./app/api/archive/editions/route": "./app/api/archive/editions/route.ts",
+    "./app/api/media/[...path]/route": "./app/api/media/[...path]/route.ts",
+    "./app/api/revalidate/route": "./app/api/revalidate/route.ts",
+    "./app/archive/page": "./app/archive/page.tsx",
+    "./app/articles/[slug]/page": "./app/articles/[slug]/page.tsx",
+    "./app/layout": "./app/layout.tsx",
+    "./app/newsroom/[section]/[...selection]/page": "./app/newsroom/[section]/[...selection]/page.tsx",
+    "./app/newsroom/[section]/page": "./app/newsroom/[section]/page.tsx",
+    "./app/newsroom/articles/[id]/page": "./app/newsroom/articles/[id]/page.tsx",
+    "./app/newsroom/articles/page": "./app/newsroom/articles/page.tsx",
+    "./app/newsroom/forum/[threadId]/page": "./app/newsroom/forum/[threadId]/page.tsx",
+    "./app/newsroom/insights/[threadId]/page": "./app/newsroom/insights/[threadId]/page.tsx",
+    "./app/newsroom/insights/page": "./app/newsroom/insights/page.tsx",
+    "./app/newsroom/layout": "./app/newsroom/layout.tsx",
+    "./app/newsroom/page": "./app/newsroom/page.tsx",
+    "./app/newsroom/sections/[sectionId]/page": "./app/newsroom/sections/[sectionId]/page.tsx",
+    "./app/page": "./app/page.tsx",
+    "./app/settings/page": "./app/settings/page.tsx"
+  },
+  "files": [
+    "app",
+    "components",
+    "lib",
+    "renderers",
+    "amplify",
+    "publications",
+    "scripts",
+    "middleware.ts",
+    "bin",
+    "src",
+    "routes.manifest.json",
+    "LICENSE",
+    "infra"
+  ],
+  "peerDependencies": {
+    "next": "^15.5.18",
+    "react": "^19.2.6",
+    "react-dom": "^19.2.6",
+    "aws-cdk-lib": "^2.257.0",
+    "constructs": "^10.4.2",
+    "@aws-amplify/backend": "^1.22.0",
+    "@aws-amplify/backend-cli": "^1.8.2",
+    "@aws-amplify/seed": "^1.1.2"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependenciesMeta": {
+    "aws-cdk-lib": {
+      "optional": true
+    },
+    "constructs": {
+      "optional": true
+    },
+    "@aws-amplify/backend": {
+      "optional": true
+    },
+    "@aws-amplify/backend-cli": {
+      "optional": true
+    },
+    "@aws-amplify/seed": {
+      "optional": true
+    }
+  },
+  "version": "1.0.0-next.10",
+  "dependencies": {
+    "@aws-amplify/adapter-nextjs": "^1.7.3",
+    "@aws-sdk/client-cognito-identity-provider": "3.1045.0",
+    "@aws-sdk/client-lambda": "^3.1045.0",
+    "@aws-sdk/client-s3": "^3.1045.0",
+    "@aws-sdk/client-ssm": "^3.1045.0",
+    "@aws-sdk/s3-request-presigner": "^3.1045.0",
+    "@base-ui/react": "^1.5.0",
+    "@chenglou/pretext": "^0.0.7",
+    "@radix-ui/colors": "3.0.0",
+    "@streamdown/cjk": "^1.0.3",
+    "@streamdown/code": "^1.1.1",
+    "@streamdown/math": "^1.0.2",
+    "@streamdown/mermaid": "^1.0.2",
+    "@tailwindcss/postcss": "^4.3.0",
+    "ai": "^6.0.191",
+    "anthus-vultus": "github:AnthusAI/Vultus#af98d57",
+    "aws-amplify": "^6.17.0",
+    "class-variance-authority": "^0.7.1",
+    "clsx": "^2.1.1",
+    "cmdk": "^1.1.1",
+    "esbuild": "^0.28.2",
+    "gray-matter": "^4.0.3",
+    "gsap": "^3.15.0",
+    "katex": "^0.17.0",
+    "lucide-react": "^1.16.0",
+    "motion": "^12.40.0",
+    "nanoid": "^5.1.11",
+    "shadcn": "^4.8.0",
+    "streamdown": "^2.5.0",
+    "tailwind-merge": "^3.6.0",
+    "tailwindcss": "^4.3.0",
+    "tsx": "^4.23.15",
+    "tw-animate-css": "^1.4.0",
+    "use-stick-to-bottom": "^1.1.4",
+    "yaml": "^2.9.0",
+    "zod": "^3.25.76"
+  }
+}

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" />;
+}