@anthusai/papyrus 0.0.0 → 1.0.0-next.10

package/routes.manifest.json

@@ -0,0 +1,208 @@
+{
+  "version": "1.0.0-next.10",
+  "routes": [
+    {
+      "file": "app/%5F_preview/[[...path]]/route.ts",
+      "hasDefault": false,
+      "exports": [
+        "GET"
+      ],
+      "config": {
+        "dynamic": "\"force-dynamic\""
+      }
+    },
+    {
+      "file": "app/[year]/[month]/[day]/[articleSlug]/page.tsx",
+      "hasDefault": true,
+      "exports": [
+        "generateMetadata"
+      ],
+      "config": {
+        "revalidate": "3600"
+      }
+    },
+    {
+      "file": "app/[year]/[month]/[day]/page.tsx",
+      "hasDefault": true,
+      "exports": [
+        "generateStaticParams"
+      ],
+      "config": {
+        "revalidate": "3600"
+      }
+    },
+    {
+      "file": "app/[year]/[month]/[day]/page/[pageNumber]/page.tsx",
+      "hasDefault": true,
+      "exports": [],
+      "config": {
+        "revalidate": "3600"
+      }
+    },
+    {
+      "file": "app/[year]/[month]/[day]/section/[sectionKey]/page.tsx",
+      "hasDefault": true,
+      "exports": [],
+      "config": {
+        "revalidate": "3600"
+      }
+    },
+    {
+      "file": "app/api/archive/editions/route.ts",
+      "hasDefault": false,
+      "exports": [
+        "GET"
+      ],
+      "config": {
+        "revalidate": "3600"
+      }
+    },
+    {
+      "file": "app/api/media/[...path]/route.ts",
+      "hasDefault": false,
+      "exports": [
+        "GET"
+      ],
+      "config": {
+        "dynamic": "\"force-dynamic\""
+      }
+    },
+    {
+      "file": "app/api/revalidate/route.ts",
+      "hasDefault": false,
+      "exports": [
+        "POST"
+      ],
+      "config": {
+        "dynamic": "\"force-dynamic\""
+      }
+    },
+    {
+      "file": "app/archive/page.tsx",
+      "hasDefault": true,
+      "exports": [],
+      "config": {
+        "revalidate": "3600"
+      }
+    },
+    {
+      "file": "app/articles/[slug]/page.tsx",
+      "hasDefault": true,
+      "exports": [
+        "generateMetadata",
+        "generateStaticParams"
+      ],
+      "config": {
+        "revalidate": "3600"
+      }
+    },
+    {
+      "file": "app/layout.tsx",
+      "hasDefault": true,
+      "exports": [
+        "generateMetadata"
+      ],
+      "config": {}
+    },
+    {
+      "file": "app/newsroom/[section]/[...selection]/page.tsx",
+      "hasDefault": true,
+      "exports": [],
+      "config": {
+        "dynamic": "\"force-dynamic\""
+      }
+    },
+    {
+      "file": "app/newsroom/[section]/page.tsx",
+      "hasDefault": true,
+      "exports": [],
+      "config": {
+        "dynamic": "\"force-dynamic\""
+      }
+    },
+    {
+      "file": "app/newsroom/articles/[id]/page.tsx",
+      "hasDefault": true,
+      "exports": [],
+      "config": {
+        "dynamic": "\"force-dynamic\""
+      }
+    },
+    {
+      "file": "app/newsroom/articles/page.tsx",
+      "hasDefault": true,
+      "exports": [],
+      "config": {
+        "dynamic": "\"force-dynamic\""
+      }
+    },
+    {
+      "file": "app/newsroom/forum/[threadId]/page.tsx",
+      "hasDefault": true,
+      "exports": [],
+      "config": {
+        "dynamic": "\"force-dynamic\""
+      }
+    },
+    {
+      "file": "app/newsroom/insights/[threadId]/page.tsx",
+      "hasDefault": true,
+      "exports": [],
+      "config": {
+        "dynamic": "\"force-dynamic\""
+      }
+    },
+    {
+      "file": "app/newsroom/insights/page.tsx",
+      "hasDefault": true,
+      "exports": [],
+      "config": {
+        "dynamic": "\"force-dynamic\""
+      }
+    },
+    {
+      "file": "app/newsroom/layout.tsx",
+      "hasDefault": true,
+      "exports": [],
+      "config": {}
+    },
+    {
+      "file": "app/newsroom/page.tsx",
+      "hasDefault": true,
+      "exports": [],
+      "config": {
+        "dynamic": "\"force-dynamic\""
+      }
+    },
+    {
+      "file": "app/newsroom/sections/[sectionId]/page.tsx",
+      "hasDefault": true,
+      "exports": [],
+      "config": {
+        "dynamic": "\"force-dynamic\""
+      }
+    },
+    {
+      "file": "app/page.tsx",
+      "hasDefault": true,
+      "exports": [],
+      "config": {
+        "dynamic": "\"force-dynamic\""
+      }
+    },
+    {
+      "file": "app/settings/page.tsx",
+      "hasDefault": true,
+      "exports": [
+        "metadata"
+      ],
+      "config": {
+        "dynamic": "\"force-dynamic\""
+      }
+    }
+  ],
+  "middleware": {
+    "file": "middleware.ts",
+    "matcher": "[\"/((?!_next/static|_next/image|favicon.ico|icon).*)\"]"
+  }
+}

package/scripts/fixtures/pilobol-sample.ast.json

@@ -0,0 +1,234 @@
+{
+  "type": "document",
+  "schema_version": 1,
+  "front_matter": {
+    "title": "Agents work better with less freedom",
+    "authors": [
+      "Ada Lovelace"
+    ],
+    "date": "2026-09-06"
+  },
+  "children": [
+    {
+      "type": "paragraph",
+      "inline": [
+        {
+          "type": "text",
+          "text": "Developers are learning that reliable agents need less freedom, not more."
+        }
+      ],
+      "line": 8
+    },
+    {
+      "type": "paragraph",
+      "inline": [
+        {
+          "type": "text",
+          "text": "Across demos and tool launches, builders kept circling the same answer."
+        }
+      ],
+      "line": 10
+    },
+    {
+      "type": "directive",
+      "name": "pull-quote",
+      "attributes": {
+        "id": null,
+        "attribution": "Editorial principle",
+        "source": null,
+        "tone": "default",
+        "align": "inline"
+      },
+      "leaf": false,
+      "line": 12,
+      "children": [
+        {
+          "type": "paragraph",
+          "inline": [
+            {
+              "type": "text",
+              "text": "The practical breakthrough is not giving agents a bigger sandbox."
+            }
+          ],
+          "line": 13
+        }
+      ]
+    },
+    {
+      "type": "heading",
+      "level": 2,
+      "inline": [
+        {
+          "type": "text",
+          "text": "Planning state"
+        }
+      ],
+      "line": 16
+    },
+    {
+      "type": "paragraph",
+      "inline": [
+        {
+          "type": "text",
+          "text": "Read-only tools. An inline "
+        },
+        {
+          "type": "code_span",
+          "code": "code_span"
+        },
+        {
+          "type": "text",
+          "text": " should not be confused with a block."
+        }
+      ],
+      "line": 18
+    },
+    {
+      "type": "code",
+      "lang": "python",
+      "value": "def plan():\n    return \"read only\"\n",
+      "line": 20
+    },
+    {
+      "type": "directive",
+      "name": "card-grid",
+      "attributes": {
+        "id": null,
+        "label": null,
+        "columns": 2
+      },
+      "leaf": false,
+      "line": 25,
+      "children": [
+        {
+          "type": "directive",
+          "name": "card",
+          "attributes": {
+            "id": null,
+            "icon": null,
+            "title": "Read",
+            "span": null
+          },
+          "leaf": false,
+          "line": 26,
+          "children": [
+            {
+              "type": "paragraph",
+              "inline": [
+                {
+                  "type": "text",
+                  "text": "Look before you leap."
+                }
+              ],
+              "line": 27
+            }
+          ]
+        },
+        {
+          "type": "directive",
+          "name": "card",
+          "attributes": {
+            "id": null,
+            "icon": null,
+            "title": "Write",
+            "span": null
+          },
+          "leaf": false,
+          "line": 29,
+          "children": [
+            {
+              "type": "paragraph",
+              "inline": [
+                {
+                  "type": "text",
+                  "text": "Only after planning."
+                }
+              ],
+              "line": 30
+            }
+          ]
+        }
+      ]
+    },
+    {
+      "type": "directive",
+      "name": "two-up",
+      "attributes": {
+        "id": null,
+        "ratio": "1:1",
+        "align": "start"
+      },
+      "leaf": false,
+      "line": 34,
+      "children": [
+        {
+          "type": "directive",
+          "name": "column",
+          "attributes": {
+            "id": null
+          },
+          "leaf": false,
+          "line": 35,
+          "children": [
+            {
+              "type": "paragraph",
+              "inline": [
+                {
+                  "type": "text",
+                  "text": "Planning state keeps risk low."
+                }
+              ],
+              "line": 36
+            }
+          ]
+        },
+        {
+          "type": "directive",
+          "name": "column",
+          "attributes": {
+            "id": null
+          },
+          "leaf": false,
+          "line": 38,
+          "children": [
+            {
+              "type": "paragraph",
+              "inline": [
+                {
+                  "type": "text",
+                  "text": "Implementation state is where damage happens."
+                }
+              ],
+              "line": 39
+            }
+          ]
+        }
+      ]
+    },
+    {
+      "type": "directive",
+      "name": "figure",
+      "attributes": {
+        "id": null,
+        "src": "../assets/state-diagram.svg",
+        "alt": "State diagram",
+        "credit": null,
+        "caption": "Two states, one agent"
+      },
+      "leaf": false,
+      "line": 43,
+      "children": []
+    },
+    {
+      "type": "paragraph",
+      "inline": [
+        {
+          "type": "text",
+          "text": "The lesson is not that agents are over."
+        }
+      ],
+      "line": 46
+    }
+  ],
+  "_papyrus_source_sha256": "cf899c47590d54b39b60824dc8718131a3ba8a77b073cc66947d70d2f6145757"
+}

package/scripts/videoml/build-browser-bundle.mjs

@@ -0,0 +1,22 @@
+#!/usr/bin/env node
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { bundleVideoEntries, loadBrandVideoSlot, standardEntryPath } from "./bundle-common.mjs";
+
+export async function buildBrowserBundle(projectRoot = process.cwd(), env = process.env) {
+  const { brandId, bundleEntry } = await loadBrandVideoSlot(projectRoot, env);
+  const result = await bundleVideoEntries({
+    projectRoot,
+    entries: [standardEntryPath, bundleEntry],
+    outfile: path.join(projectRoot, "public/videoml/browser-bundle.js"),
+  });
+  console.error(`VideoML browser bundle for '${brandId}': ${result.outfile} (${result.size} bytes)`);
+  return result;
+}
+
+if (process.argv[1] && path.resolve(process.argv[1]) === fileURLToPath(import.meta.url)) {
+  buildBrowserBundle().catch((error) => {
+    console.error(error.message);
+    process.exit(1);
+  });
+}

package/scripts/videoml/build-preview-bundle.mjs

@@ -0,0 +1,50 @@
+#!/usr/bin/env node
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import {
+  bundleVideoEntries,
+  loadBrandVideoSlot,
+  previewEntryPath,
+  previewHtmlTemplatePath,
+  standardEntryPath,
+} from "./bundle-common.mjs";
+
+const REACT_18_VERSION = "18.3.1";
+const VENDOR_FILES = {
+  "react.production.min.js": `https://unpkg.com/react@${REACT_18_VERSION}/umd/react.production.min.js`,
+  "react-dom.production.min.js": `https://unpkg.com/react-dom@${REACT_18_VERSION}/umd/react-dom.production.min.js`,
+};
+
+async function ensureReactVendor(outDirectory) {
+  const vendorDirectory = path.join(outDirectory, "vendor");
+  fs.mkdirSync(vendorDirectory, { recursive: true });
+  for (const [name, url] of Object.entries(VENDOR_FILES)) {
+    const target = path.join(vendorDirectory, name);
+    if (fs.existsSync(target)) continue;
+    const response = await fetch(url);
+    if (!response.ok) throw new Error(`Failed to download ${url}: ${response.status} ${response.statusText}`);
+    fs.writeFileSync(target, Buffer.from(await response.arrayBuffer()));
+  }
+}
+
+export async function buildPreviewBundle(projectRoot = process.cwd(), env = process.env) {
+  const { brandId, bundleEntry } = await loadBrandVideoSlot(projectRoot, env);
+  const outDirectory = path.join(projectRoot, "public/videoml");
+  await ensureReactVendor(outDirectory);
+  fs.copyFileSync(previewHtmlTemplatePath, path.join(outDirectory, "preview.html"));
+  const result = await bundleVideoEntries({
+    projectRoot,
+    entries: [standardEntryPath, previewEntryPath, bundleEntry],
+    outfile: path.join(outDirectory, "preview-bundle.js"),
+  });
+  console.error(`VideoML preview bundle for '${brandId}': ${result.outfile} (${result.size} bytes)`);
+  return result;
+}
+
+if (process.argv[1] && path.resolve(process.argv[1]) === fileURLToPath(import.meta.url)) {
+  buildPreviewBundle().catch((error) => {
+    console.error(error.message);
+    process.exit(1);
+  });
+}

package/scripts/videoml/bundle-common.mjs

@@ -0,0 +1,129 @@
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath, pathToFileURL } from "node:url";
+import { createRequire } from "node:module";
+
+const scriptsDirectory = path.dirname(fileURLToPath(import.meta.url));
+const require = createRequire(import.meta.url);
+
+const OPTIONAL_DYNAMIC_IMPORTS_OF_VIDEOML = ["p5", "lottie-web", "animejs"];
+
+const REACT_GLOBALS_JSX_RUNTIME = `
+var React = window.React;
+function jsx(type, config, maybeKey) {
+  var props = config || {};
+  var key = maybeKey !== undefined ? maybeKey : props.key;
+  if (key !== undefined) {
+    props = Object.assign({}, props, { key: key });
+  }
+  return React.createElement(type, props);
+}
+exports.Fragment = React.Fragment;
+exports.jsx = jsx;
+exports.jsxs = jsx;
+`;
+
+const reactGlobalsPlugin = {
+  name: "react-globals",
+  setup(build) {
+    const globals = {
+      react: "module.exports = window.React",
+      "react-dom": "module.exports = window.ReactDOM",
+      "react-dom/client": "module.exports = window.ReactDOM",
+      "react/jsx-runtime": REACT_GLOBALS_JSX_RUNTIME,
+      "react/jsx-dev-runtime": REACT_GLOBALS_JSX_RUNTIME,
+    };
+    build.onResolve({ filter: /^react(-dom)?(\/.*)?$/ }, (args) =>
+      args.path in globals ? { path: args.path, namespace: "react-globals" } : undefined,
+    );
+    build.onLoad({ filter: /.*/, namespace: "react-globals" }, (args) => ({
+      contents: globals[args.path],
+      loader: "js",
+    }));
+  },
+};
+
+export function resolveSelectedBrandId(site, env) {
+  const requested = (env.PAPYRUS_SITE_BRAND ?? "").trim();
+  return requested || site.defaultBrand || "papyrus";
+}
+
+/**
+ * Loads the publication's `papyrus.config.ts` from the project root and returns the
+ * selected brand's `video` slot. Fails with a message naming the missing piece.
+ */
+export async function loadBrandVideoSlot(projectRoot, env = process.env) {
+  const configPath = path.join(projectRoot, "papyrus.config.ts");
+  if (!fs.existsSync(configPath)) {
+    throw new Error(`No papyrus.config.ts in ${projectRoot}. Run the VideoML bundle builder from the publication root.`);
+  }
+  const { tsImport } = await import("tsx/esm/api");
+  // Inside a Papyrus checkout, brand components import lib/site-brand, which imports this
+  // config: load site-brand first so the cycle resolves in the same order as in the app.
+  const checkoutSiteBrand = path.join(projectRoot, "lib/site-brand.ts");
+  if (fs.existsSync(checkoutSiteBrand)) await tsImport(pathToFileURL(checkoutSiteBrand).href, import.meta.url);
+  const loaded = await tsImport(pathToFileURL(configPath).href, import.meta.url);
+  const exported = loaded.default ?? loaded;
+  const site = exported.brands === undefined && exported.default ? exported.default : exported;
+  const brandId = resolveSelectedBrandId(site, env);
+  const brand = (site.brands ?? []).find((candidate) => candidate.id === brandId);
+  if (!brand) {
+    const registered = (site.brands ?? []).map((candidate) => candidate.id).join(", ") || "none";
+    throw new Error(`Brand '${brandId}' is not registered in papyrus.config.ts (registered: ${registered}).`);
+  }
+  if (!brand.video || typeof brand.video.bundleEntry !== "string" || !brand.video.bundleEntry) {
+    throw new Error(
+      `Brand '${brandId}' has no brand.video.bundleEntry in papyrus.config.ts. ` +
+        "Set brand.video = { bundleEntry: \"<path to a TSX module that registers the brand's VideoML scene components>\" }.",
+    );
+  }
+  const bundleEntry = path.resolve(projectRoot, brand.video.bundleEntry);
+  if (!fs.existsSync(bundleEntry)) {
+    throw new Error(`brand.video.bundleEntry for '${brandId}' does not exist: ${bundleEntry}`);
+  }
+  return { brandId, bundleEntry, video: brand.video };
+}
+
+function resolveEsbuild(projectRoot) {
+  for (const base of [projectRoot, scriptsDirectory]) {
+    try {
+      return require(require.resolve("esbuild", { paths: [base] }));
+    } catch {
+      continue;
+    }
+  }
+  throw new Error("esbuild not found. Install it in the publication (npm install --save-dev esbuild).");
+}
+
+/**
+ * Bundles [standard entry, optional extra entries, brand entry] into one IIFE.
+ * React comes from `window.React` / `window.ReactDOM` (the render shell loads React 18 UMD).
+ */
+export async function bundleVideoEntries({ projectRoot, entries, outfile }) {
+  const esbuild = resolveEsbuild(projectRoot);
+  fs.mkdirSync(path.dirname(outfile), { recursive: true });
+  const importLines = entries.map((entry) => `import ${JSON.stringify(entry)};`).join("\n");
+  await esbuild.build({
+    stdin: { contents: importLines, resolveDir: projectRoot, sourcefile: "papyrus-videoml-entry.ts", loader: "ts" },
+    bundle: true,
+    format: "iife",
+    platform: "browser",
+    jsx: "automatic",
+    outfile,
+    absWorkingDir: projectRoot,
+    nodePaths: [path.join(projectRoot, "node_modules")],
+    external: OPTIONAL_DYNAMIC_IMPORTS_OF_VIDEOML,
+    plugins: [reactGlobalsPlugin],
+    loader: { ".tsx": "tsx", ".ts": "ts" },
+    define: { "process.env.NODE_ENV": '"production"' },
+    sourcemap: true,
+    logLevel: "warning",
+  });
+  const size = fs.statSync(outfile).size;
+  if (size === 0) throw new Error(`VideoML bundle is empty: ${outfile}`);
+  return { outfile, size };
+}
+
+export const standardEntryPath = path.join(scriptsDirectory, "standard-entry.tsx");
+export const previewEntryPath = path.join(scriptsDirectory, "preview/preview-entry.tsx");
+export const previewHtmlTemplatePath = path.join(scriptsDirectory, "preview.html");