@publish.os/nextjs 0.0.1-alpha.90 → 0.0.1-alpha.92

package/dist/types.d.ts

@@ -1,10 +1,90 @@
 import { RefObject } from 'react';
 
+type OgImageMetadata$1 = string | {
+    src: string;
+    alt?: string;
+};
+type OgMetadata$1 = {
+    title?: string;
+    description?: string;
+    image?: OgImageMetadata$1;
+};
+type PageStatus$1 = "published" | "draft";
+type PageMetadata$1 = {
+    openGraph?: OgMetadata$1;
+    robots?: {
+        index?: boolean;
+        follow?: boolean;
+    };
+};
+type PageFrontmatter$1<TCustom extends Record<string, unknown> = Record<string, unknown>> = TCustom & {
+    title: string;
+    description: string;
+    slug: string;
+    status: PageStatus$1;
+    metadata: PageMetadata$1;
+};
+type PageData$1<TCustom extends Record<string, unknown> = Record<string, unknown>> = {
+    fileID: string;
+    group: string;
+    path: string;
+    frontmatter: PageFrontmatter$1<TCustom>;
+    body: string;
+};
+type NavigationPageNode = {
+    id: string;
+    type: "page";
+    label: string;
+    href: string;
+    page: Omit<PageData$1, "body">;
+    children?: NavigationNode[];
+};
+type NavigationGroupNode = {
+    id: string;
+    type: "group";
+    label: string;
+    groupKey: string;
+    route: string;
+    presentation: "page" | "folder";
+    href?: string;
+    children: NavigationNode[];
+};
+type NavigationContainerNode = {
+    id: string;
+    type: "section" | "folder";
+    label: string;
+    children: NavigationNode[];
+};
+type NavigationLinkNode = {
+    id: string;
+    type: "link";
+    label: string;
+    href: string;
+};
+type NavigationViewNode = {
+    id: string;
+    type: "view";
+    label?: string;
+    viewId?: string;
+    items: NavigationNode[];
+};
+type NavigationSwitchViewNode = {
+    id: string;
+    type: "switch-view";
+    label: string;
+    target: string | {
+        view: string;
+    };
+};
+type NavigationNode = NavigationPageNode | NavigationGroupNode | NavigationContainerNode | NavigationLinkNode | NavigationViewNode | NavigationSwitchViewNode;
+type ResolvedNavigation = {
+    rootGroup: string;
+    items: NavigationNode[];
+};
+
 type SearchInput = {
     filters?: {
-        author?: string;
         group?: string;
-        tag?: string;
     };
     limit?: number;
     offset?: number;
@@ -21,17 +101,12 @@ type SearchResult = {
     excerpt: string;
     id: string;
     meta: {
-        author?: string;
         description?: string;
         group?: string;
-        image?: string;
         nodeId?: string;
         path?: string;
-        publishedAt?: string;
         section?: string;
-        tags?: string;
         title?: string;
-        updatedAt?: string;
     };
     plainExcerpt: string;
     score?: number;
@@ -88,7 +163,7 @@ type SiteData = {
     name: string;
     description?: string;
     origin?: string;
-    og?: OgIndexMetadata;
+    metadata?: IndexMetadata;
 };
 type OgImageMetadata = string | {
     src: string;
@@ -99,8 +174,10 @@ type OgMetadata = {
     description?: string;
     image?: OgImageMetadata;
 };
-type OgIndexMetadata = OgMetadata & {
-    scope?: "page" | "subtree";
+type IndexMetadata = {
+    openGraph?: OgMetadata & {
+        scope?: "page" | "subtree";
+    };
 };
 type Author = {
     id?: string;
@@ -109,83 +186,32 @@ type Author = {
     avatar?: string;
     url?: string;
 };
-type PageStatus = "published" | "draft" | "archived";
-type PageFrontmatter = {
+type PageStatus = "published" | "draft";
+type PageMetadata = {
+    openGraph?: OgMetadata;
+    robots?: {
+        index?: boolean;
+        follow?: boolean;
+    };
+};
+type PageFrontmatter<TCustom extends Record<string, unknown> = Record<string, unknown>> = TCustom & {
     title: string;
-    slug?: string;
-    description?: string;
-    status?: PageStatus;
-    publishedAt?: string;
-    updatedAt?: string;
-    authors?: (string | Author)[];
-    tags?: string[];
-    [key: string]: unknown;
-};
-type PageData<TMeta extends Record<string, unknown> = Record<string, unknown>> = {
-    fileID: string;
-    group: string;
+    description: string;
     slug: string;
-    path: string;
-    title: string;
-    description?: string;
     status: PageStatus;
-    publishedAt?: string;
-    updatedAt?: string;
-    authors: Author[];
-    tags: string[];
-    og?: OgMetadata;
-    meta: TMeta;
-    body: string;
-};
-type PageSummary<TMeta extends Record<string, unknown> = Record<string, unknown>> = Omit<PageData<TMeta>, "body"> & {
-    body?: string;
+    metadata: PageMetadata;
 };
-type PageNode = {
-    type: "page";
+type PageData<TCustom extends Record<string, unknown> = Record<string, unknown>> = {
     fileID: string;
-    title: string;
-    path: string;
-    href?: string;
     group: string;
-    description?: string;
-    status: PageStatus;
-    publishedAt?: string;
-    updatedAt?: string;
-    authors: Author[];
-    tags?: string[];
-    og?: OgMetadata;
-    meta: Record<string, unknown>;
-};
-type SectionNode = {
-    type: "section";
-    id: string;
-    title: string;
-    path?: string;
-    href?: string;
-    group?: string;
-    children: TreeNode[];
-};
-type FolderNode = {
-    type: "folder";
-    id: string;
-    title: string;
-    path?: string;
-    href?: string;
-    group?: string;
-    children: TreeNode[];
+    path: string;
+    frontmatter: PageFrontmatter<TCustom>;
+    body: string;
 };
-type LinkNode = {
-    type: "link";
-    id: string;
-    title: string;
-    href: string;
+type PageSummary<TCustom extends Record<string, unknown> = Record<string, unknown>> = Omit<PageData<TCustom>, "body"> & {
+    body?: string;
 };
-type TreeNode = PageNode | SectionNode | FolderNode | LinkNode;
-type NavPage = PageNode;
-type NavLink = LinkNode;
-type NavSection = SectionNode;
-type NavFolder = FolderNode;
-type NavItem = TreeNode;
+
 type RouteRecord = {
     fileID: string;
     slug: string;
@@ -207,9 +233,9 @@ type GroupManifest = {
     path: string;
     origin?: string;
     ancestry?: string[];
-    og?: OgIndexMetadata;
+    metadata?: IndexMetadata;
     meta?: Record<string, unknown>;
-    tree: TreeNode[];
+    navigation: ResolvedNavigation;
     pages: PageData[];
 };
 type ManifestLike = {
@@ -217,42 +243,42 @@ type ManifestLike = {
     groups: Record<string, GroupManifest>;
     routes: RouteRecord[];
     pages: PageData[];
-    tree: TreeNode[];
     attribution?: Record<string, ResolvedAttribution>;
     contentHash: string;
 };
 type RootLayoutProps = {
     children: React.ReactNode;
     site: SiteData;
-    tree: TreeNode[];
+    navigation: ResolvedNavigation;
     currentPath?: string;
     currentGroup?: GroupContext;
     activeGroups?: readonly GroupContext[];
 };
 type RootPageProps = {
     site: SiteData;
-    tree: TreeNode[];
+    navigation: ResolvedNavigation;
 };
 type LayoutProps = {
     children: React.ReactNode;
     site: SiteData;
-    tree: TreeNode[];
-    node: TreeNode;
+    navigation: ResolvedNavigation;
+    node: NavigationNode;
     currentPath: string;
     group: string;
 };
 type PageProps<TMeta extends Record<string, unknown> = Record<string, unknown>> = {
     site: SiteData;
-    tree: TreeNode[];
-    node: TreeNode;
+    navigation: ResolvedNavigation;
+    node: NavigationNode;
     page: PageData<TMeta>;
+    markdownRevision?: string;
     currentPath: string;
     group: string;
 };
 type IndexPageProps = {
     site: SiteData;
-    tree: TreeNode[];
-    node: TreeNode;
+    navigation: ResolvedNavigation;
+    node: NavigationNode;
     currentPath: string;
     group: string;
 };
@@ -273,4 +299,4 @@ type GroupContext = {
 
 declare const __publishOsTypesModule = true;
 
-export { type Author, type FolderNode, type GroupContext, type GroupForcedMode, type GroupManifest, type Heading, type IndexPageProps, type LayoutProps, type LinkNode, type ManifestLike, type NavFolder, type NavItem, type NavLink, type NavPage, type NavSection, type OgImageMetadata, type OgIndexMetadata, type OgMetadata, type PageData, type PageFrontmatter, type PageNode, type PageProps, type PageStatus, type PageSummary, type ResolvedAttribution, type RootLayoutProps, type RootPageProps, type RouteRecord, type SearchBlockActions, type SearchBlockContextValue, type SearchBlockMeta, type SearchBlockState, type SearchInput, type SearchOutput, type SearchResult, type SearchStatus, type SearchSubResult, type SectionNode, type SiteData, type ThemeMode, type TreeNode, __publishOsTypesModule };
+export { type Author, type GroupContext, type GroupForcedMode, type GroupManifest, type Heading, type IndexMetadata, type IndexPageProps, type LayoutProps, type ManifestLike, type NavigationContainerNode, type NavigationGroupNode, type NavigationLinkNode, type NavigationNode, type NavigationPageNode, type NavigationSwitchViewNode, type NavigationViewNode, type OgImageMetadata, type OgMetadata, type PageData, type PageFrontmatter, type PageMetadata, type PageProps, type PageStatus, type PageSummary, type ResolvedAttribution, type ResolvedNavigation, type RootLayoutProps, type RootPageProps, type RouteRecord, type SearchBlockActions, type SearchBlockContextValue, type SearchBlockMeta, type SearchBlockState, type SearchInput, type SearchOutput, type SearchResult, type SearchStatus, type SearchSubResult, type SiteData, type ThemeMode, __publishOsTypesModule };

package/dist/utils/heading-ids.js

@@ -1,6 +1,29 @@
 // src/components/mdx/heading-ids.ts
 import { isValidElement } from "react";
-var SELF_CLOSING_TAG_RE = new RegExp("<[^>]+/>", "g"), PAIRED_TAG_RE = /<\/?\w[^>]*>/g, MDX_BOLD_RE = /\*\*(.*?)\*\*/g, MDX_ITALIC_RE = /\*(.*?)\*/g, MDX_UNDERLINE_BOLD_RE = /__(.*?)__/g, MDX_UNDERLINE_ITALIC_RE = /_(.*?)_/g, MDX_STRIKETHROUGH_RE = /~~(.*?)~~/g, MDX_INLINE_CODE_RE = /`(.*?)`/g, MDX_LINK_RE = /\[(.*?)\]\(.*?\)/g, NON_ALPHANUMERIC_RE = /[^a-z0-9]+/g, LEADING_TRAILING_HYPHEN_RE = /^-+|-+$/g, LEADING_DIGIT_RE = /^(\d)/, HEADING_RE = /^(#{1,6})[ \t]+(.+?)\s*#*\s*$/gm, FENCED_CODE_RE = /```[\s\S]*?```|~~~[\s\S]*?~~~/g;
+
+// src/components/mdx/heading-string.ts
+var SELF_CLOSING_TAG_RE = /<[^>]+\/>/g, PAIRED_TAG_RE = /<\/?\w[^>]*>/g, MDX_BOLD_RE = /\*\*(.*?)\*\*/g, MDX_ITALIC_RE = /\*(.*?)\*/g, MDX_UNDERLINE_BOLD_RE = /__(.*?)__/g, MDX_UNDERLINE_ITALIC_RE = /_(.*?)_/g, MDX_STRIKETHROUGH_RE = /~~(.*?)~~/g, MDX_INLINE_CODE_RE = /`(.*?)`/g, MDX_LINK_RE = /\[(.*?)\]\(.*?\)/g, NON_ALPHANUMERIC_RE = /[^a-z0-9]+/g, LEADING_TRAILING_HYPHEN_RE = /^-+|-+$/g, LEADING_DIGIT_RE = /^(\d)/;
+function cleanHeadingString(input) {
+  return input.replace(SELF_CLOSING_TAG_RE, "").replace(PAIRED_TAG_RE, "").replace(MDX_BOLD_RE, "$1").replace(MDX_ITALIC_RE, "$1").replace(MDX_UNDERLINE_BOLD_RE, "$1").replace(MDX_UNDERLINE_ITALIC_RE, "$1").replace(MDX_STRIKETHROUGH_RE, "$1").replace(MDX_INLINE_CODE_RE, "$1").replace(MDX_LINK_RE, "$1").trim();
+}
+function headingStringToHTMLId(input) {
+  let text = cleanHeadingString(input);
+  return text ? text.toLowerCase().replace(NON_ALPHANUMERIC_RE, "-").replace(LEADING_TRAILING_HYPHEN_RE, "").replace(LEADING_DIGIT_RE, "id-$1") || "heading" : "empty-heading";
+}
+function createHeadingStringIdGenerator() {
+  let nextSuffix = /* @__PURE__ */ new Map(), usedIds = /* @__PURE__ */ new Set();
+  return (input) => {
+    let baseId = headingStringToHTMLId(input);
+    if (baseId === "empty-heading") return baseId;
+    let suffix = nextSuffix.get(baseId) ?? 0, id = suffix === 0 ? baseId : `${baseId}-${suffix}`;
+    for (; usedIds.has(id); )
+      suffix += 1, id = `${baseId}-${suffix}`;
+    return nextSuffix.set(baseId, suffix + 1), usedIds.add(id), id;
+  };
+}
+
+// src/components/mdx/heading-ids.ts
+var HEADING_RE = /^(#{1,6})[ \t]+(.+?)\s*#*\s*$/gm, FENCED_CODE_RE = /```[\s\S]*?```|~~~[\s\S]*?~~~/g;
 function extractText(node) {
   if (typeof node == "string") return node;
   if (typeof node == "number") return String(node);
@@ -14,26 +37,22 @@ function extractText(node) {
   return "";
 }
 function cleanHeadingText(input) {
-  return (typeof input == "string" ? input : extractText(input)).replace(SELF_CLOSING_TAG_RE, "").replace(PAIRED_TAG_RE, "").replace(MDX_BOLD_RE, "$1").replace(MDX_ITALIC_RE, "$1").replace(MDX_UNDERLINE_BOLD_RE, "$1").replace(MDX_UNDERLINE_ITALIC_RE, "$1").replace(MDX_STRIKETHROUGH_RE, "$1").replace(MDX_INLINE_CODE_RE, "$1").replace(MDX_LINK_RE, "$1").trim();
+  let text = typeof input == "string" ? input : extractText(input);
+  return cleanHeadingString(text);
 }
 function slugify(text) {
-  return text.toLowerCase().replace(NON_ALPHANUMERIC_RE, "-").replace(LEADING_TRAILING_HYPHEN_RE, "").replace(LEADING_DIGIT_RE, "id-$1");
+  return headingStringToHTMLId(text);
 }
 function headingToHTMLId(input) {
   try {
-    return slugify(cleanHeadingText(input)) || "empty-heading";
+    return slugify(cleanHeadingText(input)) || (cleanHeadingText(input) ? "heading" : "empty-heading");
   } catch {
     return "empty-heading";
   }
 }
 function createHeadingIdGenerator() {
-  let usedIds = /* @__PURE__ */ new Map();
-  return (input) => {
-    let baseId = headingToHTMLId(input);
-    if (baseId === "empty-heading") return baseId;
-    let count = usedIds.get(baseId) ?? 0;
-    return usedIds.set(baseId, count + 1), count === 0 ? baseId : `${baseId}-${count}`;
-  };
+  let headingId = createHeadingStringIdGenerator();
+  return (input) => headingId(cleanHeadingText(input));
 }
 function extractMdxHeadings(content = "", levels) {
   let [minDepth, maxDepth] = levels, headingId = createHeadingIdGenerator(), headings = [], searchableContent = content.replace(FENCED_CODE_RE, "");

package/dist/utils/toc-selection.d.ts

@@ -0,0 +1,7 @@
+type HeadingPosition = {
+    id: string;
+    top: number;
+};
+declare function findActiveHeadingIndex(headings: readonly HeadingPosition[], readingLine: number, isAtBottom?: boolean): number;
+
+export { type HeadingPosition, findActiveHeadingIndex };

package/dist/utils/toc-selection.js

@@ -0,0 +1,14 @@
+// src/components/block/toc/selection.ts
+function findActiveHeadingIndex(headings, readingLine, isAtBottom = !1) {
+  if (headings.length === 0) return -1;
+  if (isAtBottom) return headings.length - 1;
+  let low = 0, high = headings.length;
+  for (; low < high; ) {
+    let middle = low + Math.floor((high - low) / 2), heading = headings[middle];
+    heading && heading.top <= readingLine ? low = middle + 1 : high = middle;
+  }
+  return Math.max(0, low - 1);
+}
+export {
+  findActiveHeadingIndex
+};

package/dist/validate-local-source-EN2GW4FR.js

@@ -0,0 +1,16 @@
+import {
+  validateLocalSource
+} from "./chunk-SBMDONTV.js";
+import "./chunk-NNBJZPFM.js";
+import "./chunk-DZ3VWEV5.js";
+import "./chunk-7NY22B5U.js";
+import "./chunk-DX7PXFCM.js";
+import "./chunk-EFO6AWXN.js";
+import "./chunk-5KAD7W53.js";
+import "./chunk-WL75GQ5M.js";
+import "./chunk-AI2UULNX.js";
+import "./chunk-5J3YUNRY.js";
+import "./chunk-22RSSUNV.js";
+export {
+  validateLocalSource
+};

package/dist/validate-publish-os-source-OEWQDB7B.js

@@ -0,0 +1,14 @@
+import {
+  validatePublishOsSource
+} from "./chunk-DZ3VWEV5.js";
+import "./chunk-7NY22B5U.js";
+import "./chunk-DX7PXFCM.js";
+import "./chunk-EFO6AWXN.js";
+import "./chunk-5KAD7W53.js";
+import "./chunk-WL75GQ5M.js";
+import "./chunk-AI2UULNX.js";
+import "./chunk-5J3YUNRY.js";
+import "./chunk-22RSSUNV.js";
+export {
+  validatePublishOsSource
+};

package/init/seed/minimal/publish.os/assets/blog/hello-world.svg

@@ -0,0 +1,13 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="1600" height="800" viewBox="0 0 1600 800" fill="none">
+  <rect width="1600" height="800" fill="#101214"/>
+  <g stroke="#343A40" stroke-width="2">
+    <path d="M160 240H1440M160 320H1440M160 480H1440M160 560H1440"/>
+    <path d="M160 400H560C640 400 640 280 720 280H880C960 280 960 400 1040 400H1440"/>
+    <path d="M160 400H560C640 400 640 520 720 520H880C960 520 960 400 1040 400H1440"/>
+  </g>
+  <path d="M160 400H1440" stroke="#A9CFFF" stroke-width="3"/>
+  <circle cx="800" cy="400" r="50" fill="#101214" stroke="#A9CFFF" stroke-width="3"/>
+  <path d="m786 383-17 17 17 17m28-34 17 17-17 17" stroke="#A9CFFF" stroke-width="3" stroke-linecap="round" stroke-linejoin="round"/>
+  <g fill="#727C86"><circle cx="160" cy="240" r="4"/><circle cx="160" cy="320" r="4"/><circle cx="160" cy="480" r="4"/><circle cx="160" cy="560" r="4"/></g>
+  <circle cx="160" cy="400" r="4" fill="#A9CFFF"/>
+</svg>

package/init/seed/minimal/publish.os/assets/favicon.dark.svg

@@ -0,0 +1,13 @@
+<svg width="512" height="512" viewBox="0 0 512 512" fill="none" xmlns="http://www.w3.org/2000/svg">
+<rect width="512" height="512" rx="120" fill="#181818"/>
+<rect x="6" y="6" width="500" height="500" rx="114" stroke="white" stroke-opacity="0.18" stroke-width="12"/>
+<g clip-path="url(#clip0_1715_626)">
+<path d="M273.137 237.996L306.335 157.85L343.538 173.259L310.7 252.535L372.044 191.192L400.518 219.666L339.839 280.343L419.988 247.145L435.398 284.348L307.078 337.498L312.354 339.684H196.574L201.851 337.498L73.5332 284.348L88.9434 247.145L166.473 279.258L106.881 219.666L135.354 191.192L194.937 250.774L162.829 173.259L200.032 157.85L232.869 237.124V152.184H273.137V237.996Z" fill="white"/>
+<rect x="68.5" y="319.551" width="375" height="40.2685" fill="white"/>
+</g>
+<defs>
+<clipPath id="clip0_1715_626">
+<rect width="375" height="375" fill="white" transform="translate(68.5 68.5)"/>
+</clipPath>
+</defs>
+</svg>

package/init/seed/minimal/publish.os/assets/favicon.svg

@@ -0,0 +1,13 @@
+<svg width="512" height="512" viewBox="0 0 512 512" fill="none" xmlns="http://www.w3.org/2000/svg">
+<rect width="512" height="512" rx="120" fill="white"/>
+<rect x="6" y="6" width="500" height="500" rx="114" stroke="#291E00" stroke-opacity="0.2" stroke-width="12"/>
+<g clip-path="url(#clip0_1715_611)">
+<path d="M273.137 237.996L306.335 157.85L343.538 173.259L310.7 252.535L372.044 191.192L400.518 219.666L339.839 280.343L419.988 247.145L435.398 284.348L307.078 337.498L312.354 339.684H196.574L201.851 337.498L73.5332 284.348L88.9434 247.145L166.473 279.258L106.881 219.666L135.354 191.192L194.937 250.774L162.829 173.259L200.032 157.85L232.869 237.124V152.184H273.137V237.996Z" fill="#161000"/>
+<rect x="68.5" y="319.551" width="375" height="40.2685" fill="#161000"/>
+</g>
+<defs>
+<clipPath id="clip0_1715_611">
+<rect width="375" height="375" fill="white" transform="translate(68.5 68.5)"/>
+</clipPath>
+</defs>
+</svg>

package/init/seed/minimal/publish.os/blog/content/hello-world.mdx

@@ -0,0 +1,48 @@
+---
+title: Hello, world.
+description: Publish your first post and make this blog your own.
+publishedAt: 2026-10-20
+authors: [Matthew B]
+tags: [Press]
+image:
+  src: /assets/blog/hello-world.svg
+  alt: A code symbol where several publishing paths meet.
+---
+
+Use this blog to share news, releases, and what you learn. Edit this post in `publish.os/blog/content/hello-world.mdx`.
+
+## Add a post
+
+Create another `.mdx` file in `publish.os/blog/content/`:
+
+```mdx
+---
+title: A small beginning
+description: Why this project exists.
+publishedAt: 2026-10-21
+authors: [Matthew B]
+---
+
+This project starts with one problem and one useful solution.
+```
+
+The blog index shows published posts, newest first. Set `publishedAt` to edit the publication date. 
+
+## Customize the blog
+
+Edit `index.tsx` to change the post list at `/blog`. Edit `page.tsx` to change individual posts. The shared [theme](/docs/themes) supplies colors and typography.
+
+```txt
+publish.os/blog/
+├── layout.tsx
+├── index.tsx
+├── page.tsx
+└── content/
+    ├── hello-world.mdx
+    └── series-a.mdx
+```
+
+
+Edit `layout.tsx` to change the blog layout.
+
+Add `tags` and an `image` with `src` and `alt` to a post's frontmatter to customize its header. Keep local images in `publish.os/assets/` and reference them with `/assets/` paths.

package/init/seed/minimal/publish.os/blog/content/series-a.mdx

@@ -0,0 +1,11 @@
+---
+title: Our $5M Series A
+description: A fictional funding announcement for your starter blog.
+publishedAt: 2026-10-18
+authors: [Matthew B]
+tags: [Company news]
+---
+
+Example Co. raised $5 million in Series A funding to help teams publish useful documentation. We will use the investment to grow the team and improve the product.
+
+This is a fictional announcement for the starter site. Replace it with your own news.

package/init/seed/minimal/publish.os/blog/index.tsx

@@ -0,0 +1,85 @@
+import { authoredDate, authorNames } from "@components/blog/frontmatter";
+import type {
+  IndexPageProps,
+  NavigationNode,
+  NavigationPageNode,
+} from "@publish.os/nextjs/types";
+import { prettyDate } from "@publish.os/nextjs/utils/pretty-date";
+import Link from "next/link";
+
+function pageNodes(nodes: NavigationNode[]): NavigationPageNode[] {
+  return nodes.flatMap((node) => {
+    if (node.type === "page") return [node];
+    if (
+      node.type === "section" ||
+      node.type === "folder" ||
+      node.type === "group"
+    ) {
+      return pageNodes(node.children);
+    }
+    if (node.type === "view") return pageNodes(node.items);
+    return [];
+  });
+}
+
+export default function BlogIndex({ node, navigation }: IndexPageProps) {
+  const posts = pageNodes(navigation.items).filter(
+    (entry) => entry.page.frontmatter.status === "published",
+  );
+
+  return (
+    <section className="w-full px-4 py-12 md:px-5 lg:px-6 lg:py-16">
+      <h1 className="mb-10 text-balance text-5xl font-medium leading-none tracking-tight text-foreground-1">
+        {node.type === "page" ? node.page.frontmatter.title : node.label}
+      </h1>
+      {posts.length > 0 ? (
+        <ul>
+          {posts.map((post) => {
+            const authors = authorNames(post.page.frontmatter.authors);
+            const publishedAt = authoredDate(post.page.frontmatter.publishedAt);
+            const date = prettyDate(publishedAt);
+
+            return (
+              <li
+                className="border-b border-stroke-4 last:border-b-0"
+                key={post.page.path}
+              >
+                <Link
+                  className="-mx-4 flex min-h-12 items-center gap-6 rounded-card px-4 py-4 text-sm text-foreground-1 hover:bg-surface-hover active:bg-surface-active focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-focus-stroke"
+                  href={post.href}
+                  title={post.page.frontmatter.title}
+                >
+                  <span className="min-w-0 flex-1 truncate">
+                    {post.page.frontmatter.title}
+                  </span>
+                  <span className="hidden min-w-0 max-w-[45%] items-baseline gap-1.5 text-foreground-3 md:flex">
+                    {authors ? (
+                      <span className="truncate">{authors}</span>
+                    ) : null}
+                    {authors && date ? <span aria-hidden="true">·</span> : null}
+                    {date ? (
+                      <time
+                        className="shrink-0 whitespace-nowrap"
+                        dateTime={publishedAt}
+                      >
+                        {date}
+                      </time>
+                    ) : null}
+                  </span>
+                  <span
+                    aria-hidden="true"
+                    className="shrink-0 text-foreground-2 md:hidden rtl:rotate-180"
+                  >
+                    →
+                  </span>
+                </Link>
+              </li>
+            );
+          })}
+        </ul>
+      ) : (
+        <p className="text-sm text-foreground-2">No posts yet.</p>
+      )}
+    </section>
+  );
+}

package/init/seed/minimal/publish.os/blog/layout.tsx

@@ -0,0 +1,13 @@
+import type { LayoutProps } from "@publish.os/nextjs/types";
+
+export default function BlogLayout({ children }: LayoutProps) {
+  return (
+    <main
+      className="mx-auto flex min-h-0 min-w-0 w-full max-w-(--layout-site-max-width) flex-1 flex-col border-x border-stroke-3 bg-surface-1"
+      id="main-content"
+      tabIndex={-1}
+    >
+      {children}
+    </main>
+  );
+}