@publish.os/nextjs 0.0.1-alpha.2 → 0.0.1-alpha.3

package/dist/kernel/routes/pages/leaf.js

@@ -0,0 +1,397 @@
+// src/kernel/routes/pages/leaf.tsx
+import { MDX } from "@publish.os/nextjs/mdx";
+import { cacheLife, cacheTag } from "next/cache";
+import { notFound } from "next/navigation";
+import {
+  Children,
+  cloneElement,
+  isValidElement
+} from "react";
+
+// src/cache/tags.ts
+import { createHash } from "crypto";
+var MAX_TAG_LEN = 256;
+var MAX_SEGMENT_LEN = 80;
+var TAG_PATTERN = /^[a-z0-9:_./-]+$/;
+function sha256(value) {
+  return createHash("sha256").update(value).digest("hex").slice(0, 16);
+}
+function safeSegment(value) {
+  const raw = value.trim().toLowerCase() || "root";
+  const normalized = raw.replace(/\\/g, "/").replace(/\/+/g, "/").replace(/^\//, "").replace(/\/$/, "").replace(/[^a-z0-9:_./-]+/g, "-").replace(/-+/g, "-").replace(/^-|-$/g, "");
+  const segment = normalized || "root";
+  if (segment.length <= MAX_SEGMENT_LEN) return segment;
+  return `${segment.slice(0, 48)}.${sha256(segment)}`;
+}
+function assertTag(tag) {
+  if (tag.length > MAX_TAG_LEN || !TAG_PATTERN.test(tag)) {
+    return `tag:${sha256(tag)}`;
+  }
+  return tag;
+}
+var tags = {
+  site() {
+    return "site";
+  },
+  pages() {
+    return "pages";
+  },
+  group(group) {
+    return assertTag(`group:${safeSegment(group)}`);
+  },
+  page(group, slug) {
+    const path = Array.isArray(slug) ? slug.join("/") : slug;
+    return assertTag(`page:${safeSegment(group)}:${safeSegment(path)}`);
+  },
+  manifest(contentHash) {
+    return assertTag(`manifest:${safeSegment(contentHash)}`);
+  },
+  sitemap() {
+    return "sitemap";
+  },
+  robots() {
+    return "robots";
+  },
+  llms(scope = "root") {
+    return assertTag(`llms:${safeSegment(scope)}`);
+  },
+  feed(format, scope = "site") {
+    return assertTag(`feed:${safeSegment(format)}:${safeSegment(scope)}`);
+  }
+};
+
+// src/internal/utils/logger.ts
+var isDev = process.env.NODE_ENV !== "production";
+var isDebugEnabled = process.env.NEXT_PRIVATE_DEBUG_CACHE === "1";
+var log = {
+  debug(...args) {
+    if (isDev && isDebugEnabled) console.debug("[publish.os:debug]", ...args);
+  },
+  info(...args) {
+    console.log("[publish.os]", ...args);
+  },
+  warn(...args) {
+    console.warn("[publish.os:warn]", ...args);
+  },
+  error(...args) {
+    console.error("[publish.os:error]", ...args);
+  }
+};
+
+// src/resolvers/manifest-resolver.ts
+function findNodeInTree(nodes, id) {
+  for (const node of nodes) {
+    if (node.type === "page") {
+      if (node.fileID === id) return node;
+    } else if (node.id === id) {
+      return node;
+    }
+    if (node.type === "section" || node.type === "folder") {
+      const found = findNodeInTree(node.children, id);
+      if (found) return found;
+    }
+  }
+  return null;
+}
+function pageNode(page) {
+  return {
+    type: "page",
+    fileID: page.fileID,
+    title: page.title,
+    path: page.path,
+    group: page.group,
+    description: page.description,
+    status: page.status,
+    publishedAt: page.publishedAt,
+    updatedAt: page.updatedAt,
+    authors: page.authors,
+    tags: page.tags,
+    meta: page.meta
+  };
+}
+function resolveLeaf(manifest, group, slug) {
+  const slugPath = Array.isArray(slug) ? slug.join("/") : slug;
+  const page = manifest.pages.find((p) => p.group === group && p.slug === slugPath) ?? null;
+  if (!page) return null;
+  const groupData = manifest.groups[group];
+  if (!groupData) return null;
+  return {
+    site: manifest.site,
+    tree: groupData.tree,
+    node: findNodeInTree(groupData.tree, page.fileID) ?? pageNode(page),
+    page,
+    currentPath: page.path,
+    group
+  };
+}
+function listStaticParams(manifest, group) {
+  const groupData = manifest.groups[group];
+  if (!groupData) return [];
+  return groupData.pages.map((page) => ({ slug: page.slug.split("/") }));
+}
+
+// src/kernel/routes/pages/agent-metadata.ts
+function normalizePath(path) {
+  const prefixed = path.startsWith("/") ? path : `/${path}`;
+  if (prefixed === "/") return prefixed;
+  return prefixed.replace(/\/+$/, "");
+}
+function markdownPathForHtmlPath(path) {
+  const normalized = normalizePath(path);
+  if (normalized === "/") return "/index.md";
+  return `${normalized}.md`;
+}
+function agentReadableAlternates({
+  canonicalPath,
+  manifest,
+  markdownPath
+}) {
+  return {
+    ...manifest.site.url ? { canonical: normalizePath(canonicalPath) } : {},
+    types: {
+      ...markdownPath ? { "text/markdown": normalizePath(markdownPath) } : {},
+      "text/plain": "/llms.txt"
+    }
+  };
+}
+
+// src/kernel/routes/pages/social-metadata.ts
+function isDevelopment() {
+  return process.env.NODE_ENV === "development";
+}
+function absoluteUrl(path, siteUrl) {
+  if (/^https:\/\//.test(path)) return path;
+  if (isDevelopment()) return path;
+  if (!siteUrl) return path;
+  return new URL(path, siteUrl).toString();
+}
+function createSocialMetadata({
+  canonicalPath,
+  description,
+  manifest,
+  ogManifest,
+  title,
+  type = "website"
+}) {
+  const key = ogManifest?.routes?.[canonicalPath];
+  const rootKey = ogManifest?.routes?.["/"];
+  const entry = (key ? ogManifest?.entries?.[key] : void 0) ?? (rootKey ? ogManifest?.entries?.[rootKey] : void 0);
+  if (!entry) {
+    return {
+      openGraph: {
+        description,
+        title,
+        type,
+        url: canonicalPath
+      },
+      twitter: {
+        card: "summary",
+        description,
+        title
+      }
+    };
+  }
+  const imageUrl = absoluteUrl(entry.url, manifest.site.url);
+  return {
+    openGraph: {
+      description,
+      images: [
+        {
+          alt: entry.alt,
+          height: entry.height,
+          url: imageUrl,
+          width: entry.width
+        }
+      ],
+      siteName: manifest.site.name,
+      title,
+      type,
+      url: canonicalPath
+    },
+    twitter: {
+      card: "summary_large_image",
+      description,
+      images: [imageUrl],
+      title
+    }
+  };
+}
+
+// src/kernel/routes/pages/leaf.tsx
+import { jsx, jsxs } from "react/jsx-runtime";
+var manifests = /* @__PURE__ */ new Map();
+var leaves = /* @__PURE__ */ new Map();
+var poweredByFooters = /* @__PURE__ */ new Map();
+function hasClassName(value, className) {
+  return typeof value === "string" && value.split(/\s+/).includes(className);
+}
+function isPlatformMdx(value) {
+  return value === MDX || typeof value === "function" && value.__publishOsMdx === true;
+}
+function findMdxPath(node) {
+  if (!isValidElement(node)) {
+    return null;
+  }
+  if (isPlatformMdx(node.type)) {
+    return [];
+  }
+  const children = Children.toArray(node.props.children);
+  for (let index = 0; index < children.length; index += 1) {
+    const childPath = findMdxPath(children[index]);
+    if (childPath) {
+      return [
+        {
+          childIndex: index,
+          children,
+          element: node
+        },
+        ...childPath
+      ];
+    }
+  }
+  return null;
+}
+function targetDepthForMdxPath(path) {
+  for (let index = path.length - 1; index >= 0; index -= 1) {
+    const entry = path[index];
+    if (entry && entry.childIndex < entry.children.length - 1) {
+      return index;
+    }
+  }
+  for (let index = path.length - 1; index >= 0; index -= 1) {
+    const entry = path[index];
+    if (!hasClassName(entry?.element.props.className, "markdown-prose")) {
+      return index;
+    }
+  }
+  return 0;
+}
+function appendFooterAtPath({
+  currentPath = [],
+  footer,
+  node,
+  targetPath
+}) {
+  if (!isValidElement(node)) {
+    return node;
+  }
+  const children = Children.toArray(node.props.children);
+  if (currentPath.length === targetPath.length) {
+    return cloneElement(node, void 0, ...children, footer);
+  }
+  const childIndex = targetPath[currentPath.length];
+  const nextChildren = children.map(
+    (child, index) => index === childIndex ? appendFooterAtPath({
+      currentPath: [...currentPath, index],
+      footer,
+      node: child,
+      targetPath
+    }) : child
+  );
+  return cloneElement(node, void 0, ...nextChildren);
+}
+function appendPoweredByFooter({
+  footer,
+  node
+}) {
+  const path = findMdxPath(node);
+  if (!path?.length) {
+    return { node, placed: false };
+  }
+  const targetDepth = targetDepthForMdxPath(path);
+  const targetPath = path.slice(0, targetDepth).map((entry) => entry.childIndex);
+  return {
+    node: appendFooterAtPath({ footer, node, targetPath }),
+    placed: true
+  };
+}
+async function CachedLeafPage({
+  group,
+  slug
+}) {
+  "use cache";
+  cacheLife("page");
+  cacheTag(
+    tags.site(),
+    tags.pages(),
+    tags.group(group),
+    tags.page(group, slug)
+  );
+  const manifest = manifests.get(group);
+  const Leaf = leaves.get(group);
+  const PoweredByFooter = poweredByFooters.get(group);
+  if (!manifest || !Leaf) notFound();
+  cacheTag(tags.manifest(manifest.contentHash));
+  log.debug("[cache]", `${group}/${slug.join("/")}`);
+  const resolved = resolveLeaf(manifest, group, slug);
+  if (!resolved) notFound();
+  const attribution = manifest.attribution?.[group] ?? { enabled: false };
+  const leaf = await Leaf(resolved);
+  const footer = attribution.enabled && PoweredByFooter ? /* @__PURE__ */ jsx(PoweredByFooter, { attribution }) : null;
+  const placed = footer ? appendPoweredByFooter({ footer, node: leaf }) : { node: leaf, placed: true };
+  return /* @__PURE__ */ jsxs("div", { className: "flex min-h-full min-w-0 flex-1 flex-col", children: [
+    placed.node,
+    footer && !placed.placed ? footer : null
+  ] });
+}
+function createLeafPage({
+  group,
+  manifest,
+  Leaf,
+  PoweredByFooter
+}) {
+  manifests.set(group, manifest);
+  leaves.set(group, Leaf);
+  if (PoweredByFooter) {
+    poweredByFooters.set(group, PoweredByFooter);
+  } else {
+    poweredByFooters.delete(group);
+  }
+  return async function Page({ params }) {
+    const { slug = [] } = await params;
+    log.debug("[render]", `${group}/${slug.join("/")}`);
+    return /* @__PURE__ */ jsx(CachedLeafPage, { group, slug });
+  };
+}
+function createLeafMetadata({
+  group,
+  manifest,
+  ogManifest
+}) {
+  return async function generateMetadata({
+    params
+  }) {
+    const { slug = [] } = await params;
+    log.debug("[metadata]", `${group}/${slug.join("/")}`);
+    const resolved = resolveLeaf(manifest, group, slug);
+    if (!resolved) return {};
+    return {
+      title: resolved.page.title,
+      description: resolved.page.description,
+      alternates: agentReadableAlternates({
+        canonicalPath: resolved.page.path,
+        manifest,
+        markdownPath: markdownPathForHtmlPath(resolved.page.path)
+      }),
+      ...createSocialMetadata({
+        canonicalPath: resolved.page.path,
+        description: resolved.page.description,
+        manifest,
+        ogManifest,
+        title: resolved.page.title,
+        type: "article"
+      })
+    };
+  };
+}
+function createLeafStaticParams({ group, manifest }) {
+  return function generateStaticParams() {
+    return listStaticParams(manifest, group);
+  };
+}
+export {
+  appendPoweredByFooter,
+  createLeafMetadata,
+  createLeafPage,
+  createLeafStaticParams
+};

package/dist/{pages → kernel/routes/pages}/root.cjs

@@ -17,7 +17,7 @@ var __copyProps = (to, from, except, desc) => {
 };
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
-// src/pages/root.tsx
+// src/kernel/routes/pages/root.tsx
 var root_exports = {};
 __export(root_exports, {
   createRootMetadata: () => createRootMetadata,
@@ -72,14 +72,18 @@ var tags = {
   },
   llms(scope = "root") {
     return assertTag(`llms:${safeSegment(scope)}`);
+  },
+  feed(format, scope = "site") {
+    return assertTag(`feed:${safeSegment(format)}:${safeSegment(scope)}`);
   }
 };
 
 // src/internal/utils/logger.ts
 var isDev = process.env.NODE_ENV !== "production";
+var isDebugEnabled = process.env.NEXT_PRIVATE_DEBUG_CACHE === "1";
 var log = {
   debug(...args) {
-    if (isDev) console.debug("[publish.os:debug]", ...args);
+    if (isDev && isDebugEnabled) console.debug("[publish.os:debug]", ...args);
   },
   info(...args) {
     console.log("[publish.os]", ...args);
@@ -92,7 +96,89 @@ var log = {
   }
 };
 
-// src/pages/root.tsx
+// src/kernel/routes/pages/agent-metadata.ts
+function normalizePath(path) {
+  const prefixed = path.startsWith("/") ? path : `/${path}`;
+  if (prefixed === "/") return prefixed;
+  return prefixed.replace(/\/+$/, "");
+}
+function agentReadableAlternates({
+  canonicalPath,
+  manifest,
+  markdownPath
+}) {
+  return {
+    ...manifest.site.url ? { canonical: normalizePath(canonicalPath) } : {},
+    types: {
+      ...markdownPath ? { "text/markdown": normalizePath(markdownPath) } : {},
+      "text/plain": "/llms.txt"
+    }
+  };
+}
+
+// src/kernel/routes/pages/social-metadata.ts
+function isDevelopment() {
+  return process.env.NODE_ENV === "development";
+}
+function absoluteUrl(path, siteUrl) {
+  if (/^https:\/\//.test(path)) return path;
+  if (isDevelopment()) return path;
+  if (!siteUrl) return path;
+  return new URL(path, siteUrl).toString();
+}
+function createSocialMetadata({
+  canonicalPath,
+  description,
+  manifest,
+  ogManifest,
+  title,
+  type = "website"
+}) {
+  const key = ogManifest?.routes?.[canonicalPath];
+  const rootKey = ogManifest?.routes?.["/"];
+  const entry = (key ? ogManifest?.entries?.[key] : void 0) ?? (rootKey ? ogManifest?.entries?.[rootKey] : void 0);
+  if (!entry) {
+    return {
+      openGraph: {
+        description,
+        title,
+        type,
+        url: canonicalPath
+      },
+      twitter: {
+        card: "summary",
+        description,
+        title
+      }
+    };
+  }
+  const imageUrl = absoluteUrl(entry.url, manifest.site.url);
+  return {
+    openGraph: {
+      description,
+      images: [
+        {
+          alt: entry.alt,
+          height: entry.height,
+          url: imageUrl,
+          width: entry.width
+        }
+      ],
+      siteName: manifest.site.name,
+      title,
+      type,
+      url: canonicalPath
+    },
+    twitter: {
+      card: "summary_large_image",
+      description,
+      images: [imageUrl],
+      title
+    }
+  };
+}
+
+// src/kernel/routes/pages/root.tsx
 var import_jsx_runtime = require("react/jsx-runtime");
 var rootManifest;
 var rootPage;
@@ -114,10 +200,26 @@ function createRootPage({ manifest, RootPage }) {
     return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(CachedRootPage, {});
   };
 }
-function createRootMetadata({ manifest }) {
+function createRootMetadata({
+  manifest,
+  ogManifest
+}) {
+  const description = manifest.site.description;
   return {
-    title: manifest.site.title,
-    description: manifest.site.description
+    title: manifest.site.name,
+    description,
+    alternates: agentReadableAlternates({
+      canonicalPath: "/",
+      manifest,
+      markdownPath: "/sitemap.md"
+    }),
+    ...createSocialMetadata({
+      canonicalPath: "/",
+      description,
+      manifest,
+      ogManifest,
+      title: manifest.site.name
+    })
   };
 }
 // Annotate the CommonJS export names for ESM import in node:

package/dist/{pages → kernel/routes/pages}/root.d.cts

@@ -1,14 +1,16 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { Metadata } from 'next';
 import { ReactElement } from 'react';
-import { RootPageProps, ManifestLike } from '../types.cjs';
+import { RootPageProps, ManifestLike } from '../../../types.cjs';
+import { OgManifestLike } from '../metadata/og-image.cjs';
 
 type RootPageComponent = (props: RootPageProps) => ReactElement | Promise<ReactElement>;
 type RootRouteConfig = {
     manifest: ManifestLike;
+    ogManifest?: OgManifestLike;
     RootPage: RootPageComponent;
 };
 declare function createRootPage({ manifest, RootPage }: RootRouteConfig): () => Promise<react_jsx_runtime.JSX.Element>;
-declare function createRootMetadata({ manifest }: RootRouteConfig): Metadata;
+declare function createRootMetadata({ manifest, ogManifest, }: RootRouteConfig): Metadata;
 
 export { type RootPageComponent, type RootRouteConfig, createRootMetadata, createRootPage };

package/dist/{pages → kernel/routes/pages}/root.d.ts

@@ -1,14 +1,16 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { Metadata } from 'next';
 import { ReactElement } from 'react';
-import { RootPageProps, ManifestLike } from '../types.js';
+import { RootPageProps, ManifestLike } from '../../../types.js';
+import { OgManifestLike } from '../metadata/og-image.js';
 
 type RootPageComponent = (props: RootPageProps) => ReactElement | Promise<ReactElement>;
 type RootRouteConfig = {
     manifest: ManifestLike;
+    ogManifest?: OgManifestLike;
     RootPage: RootPageComponent;
 };
 declare function createRootPage({ manifest, RootPage }: RootRouteConfig): () => Promise<react_jsx_runtime.JSX.Element>;
-declare function createRootMetadata({ manifest }: RootRouteConfig): Metadata;
+declare function createRootMetadata({ manifest, ogManifest, }: RootRouteConfig): Metadata;
 
 export { type RootPageComponent, type RootRouteConfig, createRootMetadata, createRootPage };