@publish.os/nextjs 0.0.1-alpha.91 → 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,34 +243,33 @@ 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;
@@ -252,8 +277,8 @@ type PageProps<TMeta extends Record<string, unknown> = Record<string, unknown>>
 };
 type IndexPageProps = {
     site: SiteData;
-    tree: TreeNode[];
-    node: TreeNode;
+    navigation: ResolvedNavigation;
+    node: NavigationNode;
     currentPath: string;
     group: string;
 };
@@ -274,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/{validate-local-source-SV44DBQT.js → validate-local-source-EN2GW4FR.js}

@@ -1,10 +1,10 @@
 import {
   validateLocalSource
-} from "./chunk-ORIUWJBQ.js";
+} from "./chunk-SBMDONTV.js";
 import "./chunk-NNBJZPFM.js";
-import "./chunk-F3AGNDF4.js";
+import "./chunk-DZ3VWEV5.js";
 import "./chunk-7NY22B5U.js";
-import "./chunk-UYGCOWRF.js";
+import "./chunk-DX7PXFCM.js";
 import "./chunk-EFO6AWXN.js";
 import "./chunk-5KAD7W53.js";
 import "./chunk-WL75GQ5M.js";

package/dist/{validate-publish-os-source-NZJF3TB2.js → validate-publish-os-source-OEWQDB7B.js}

@@ -1,8 +1,8 @@
 import {
   validatePublishOsSource
-} from "./chunk-F3AGNDF4.js";
+} from "./chunk-DZ3VWEV5.js";
 import "./chunk-7NY22B5U.js";
-import "./chunk-UYGCOWRF.js";
+import "./chunk-DX7PXFCM.js";
 import "./chunk-EFO6AWXN.js";
 import "./chunk-5KAD7W53.js";
 import "./chunk-WL75GQ5M.js";

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

@@ -1,54 +1,57 @@
+import { authoredDate, authorNames } from "@components/blog/frontmatter";
 import type {
   IndexPageProps,
-  PageNode,
-  TreeNode,
+  NavigationNode,
+  NavigationPageNode,
 } from "@publish.os/nextjs/types";
 import { prettyDate } from "@publish.os/nextjs/utils/pretty-date";
 import Link from "next/link";
 
-function pageNodes(nodes: TreeNode[]): PageNode[] {
+function pageNodes(nodes: NavigationNode[]): NavigationPageNode[] {
   return nodes.flatMap((node) => {
     if (node.type === "page") return [node];
-    if (node.type === "section" || node.type === "folder") {
+    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, tree }: IndexPageProps) {
-  const posts = pageNodes(tree)
-    .filter((page) => page.status === "published")
-    .sort(
-      (a, b) =>
-        (b.publishedAt ?? "").localeCompare(a.publishedAt ?? "") ||
-        a.path.localeCompare(b.path),
-    );
+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.title}
+        {node.type === "page" ? node.page.frontmatter.title : node.label}
       </h1>
       {posts.length > 0 ? (
         <ul>
           {posts.map((post) => {
-            const authors = post.authors
-              .map((author) => author.name)
-              .join(", ");
-            const date = prettyDate(post.publishedAt);
+            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.path}
+                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.path}
-                  title={post.title}
+                  href={post.href}
+                  title={post.page.frontmatter.title}
                 >
-                  <span className="min-w-0 flex-1 truncate">{post.title}</span>
+                  <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>
@@ -57,7 +60,7 @@ export default function BlogIndex({ node, tree }: IndexPageProps) {
                     {date ? (
                       <time
                         className="shrink-0 whitespace-nowrap"
-                        dateTime={post.publishedAt}
+                        dateTime={publishedAt}
                       >
                         {date}
                       </time>

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

@@ -1,30 +1,45 @@
+import { CopyLink } from "@components/blog/copy-link";
+import { authoredDate, authorNames } from "@components/blog/frontmatter";
+import { Link } from "@components/ui/link";
 import { CaretLeftIcon } from "@phosphor-icons/react/ssr";
 import { MDX } from "@publish.os/nextjs/mdx";
 import type { PageProps } from "@publish.os/nextjs/types";
 import { prettyDate } from "@publish.os/nextjs/utils/pretty-date";
 import Image from "next/image";
-import Link from "next/link";
-import { CopyLink } from "../components/blog/copy-link";
 
 type BlogMeta = {
+  authors?: unknown;
   image?: { src: string; alt: string };
+  publishedAt?: unknown;
 };
 
 export default function BlogLeaf({ page }: PageProps<BlogMeta>) {
-  const authors = page.authors.map((author) => author.name).join(", ");
-  const date = prettyDate(page.publishedAt);
+  const authors = authorNames(page.frontmatter.authors);
+  const publishedAt = authoredDate(page.frontmatter.publishedAt);
+  const date = prettyDate(publishedAt);
+  const image = page.frontmatter.image;
+  const cover =
+    image &&
+    typeof image === "object" &&
+    typeof image.src === "string" &&
+    typeof image.alt === "string"
+      ? image
+      : undefined;
 
   return (
     <div className="flex min-h-0 min-w-0 flex-1 flex-col px-4 pt-6 md:px-5 lg:px-6 lg:pt-8">
       <nav aria-label="Blog" className="mb-8 lg:mb-12">
         <Link
-          className="-ms-2 inline-flex min-h-11 items-center gap-1.5 rounded-button px-2 text-sm text-foreground-3 hover:text-foreground-1 focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-focus-stroke"
+          className="-ms-2 inline-flex min-h-11 items-center px-2 text-foreground-3 hover:text-foreground-1"
           href="/blog"
+          leftIcon={
+            <CaretLeftIcon
+              aria-hidden="true"
+              className="size-3.5 shrink-0 rtl:rotate-180"
+            />
+          }
+          size="sm"
         >
-          <CaretLeftIcon
-            aria-hidden="true"
-            className="size-3.5 shrink-0 rtl:rotate-180"
-          />
           Blog
         </Link>
       </nav>
@@ -32,24 +47,24 @@ export default function BlogLeaf({ page }: PageProps<BlogMeta>) {
         <header>
           <div className="mx-auto w-full max-w-2xl">
             <h1 className="text-balance text-center text-4xl font-medium leading-tight tracking-tight text-foreground-1 md:text-5xl">
-              {page.title}
+              {page.frontmatter.title}
             </h1>
           </div>
-          {page.meta.image ? (
+          {cover ? (
             <Image
-              alt={page.meta.image.alt}
+              alt={cover.alt}
               className="mt-10 aspect-2/1 w-full rounded-media border border-stroke-3 object-cover"
               height={800}
               priority
               sizes="(max-width: 896px) 100vw, 896px"
-              src={page.meta.image.src}
+              src={cover.src}
               width={1600}
             />
           ) : null}
           <div className="mx-auto w-full max-w-2xl">
-            {page.description ? (
+            {page.frontmatter.description ? (
               <p className="mt-12 text-pretty text-center text-base italic leading-7 text-foreground-2">
-                {page.description}
+                {page.frontmatter.description}
               </p>
             ) : null}
             <hr className="my-10 border-stroke-3" />
@@ -64,7 +79,7 @@ export default function BlogLeaf({ page }: PageProps<BlogMeta>) {
               <p className="flex flex-wrap items-baseline gap-x-1.5 text-sm text-foreground-3">
                 {authors ? <span>{authors}</span> : null}
                 {authors && date ? <span aria-hidden="true">·</span> : null}
-                {date ? <time dateTime={page.publishedAt}>{date}</time> : null}
+                {date ? <time dateTime={publishedAt}>{date}</time> : null}
               </p>
             ) : null}
             <CopyLink className="ms-auto" path={page.path} />

package/init/seed/minimal/publish.os/components/blog/copy-link.tsx

@@ -31,7 +31,7 @@ export function CopyLink({
     <div className={className}>
       <Link
         aria-busy={status === "pending" || undefined}
-        className="inline-flex min-h-11 items-center text-foreground-3 hover:text-foreground-1 active:text-foreground-1 motion-safe:transition-[color,scale] motion-safe:duration-150 motion-safe:active:scale-[0.96] motion-reduce:transition-none"
+        className="inline-flex min-h-11 items-center text-foreground-3 hover:text-foreground-1 motion-safe:active:scale-[0.96]"
         href={path}
         leftIcon={<LinkSimpleIcon aria-hidden="true" />}
         onClick={(event) => {

package/init/seed/minimal/publish.os/components/blog/frontmatter.ts

@@ -0,0 +1,41 @@
+export function authorNames(value: unknown): string {
+  if (!Array.isArray(value)) return "";
+  return value
+    .flatMap((author: unknown) => {
+      if (typeof author === "string") return [author];
+      if (
+        author &&
+        typeof author === "object" &&
+        "name" in author &&
+        typeof author.name === "string"
+      ) {
+        return [author.name];
+      }
+      return [];
+    })
+    .join(", ");
+}
+
+export function stringList(value: unknown): string {
+  return Array.isArray(value)
+    ? value
+        .filter((item): item is string => typeof item === "string")
+        .join(", ")
+    : "";
+}
+
+export function authoredDate(value: unknown): string | undefined {
+  if (typeof value !== "string") return undefined;
+  if (
+    !/^\d{4}-\d{2}-\d{2}(?:T\d{2}:\d{2}:\d{2}(?:\.\d+)?(?:Z|[+-]\d{2}:\d{2}))?$/.test(
+      value,
+    )
+  )
+    return undefined;
+  const timestamp = Date.parse(value);
+  if (!Number.isFinite(timestamp)) return undefined;
+  const day = value.slice(0, 10);
+  if (new Date(`${day}T00:00:00Z`).toISOString().slice(0, 10) !== day)
+    return undefined;
+  return value;
+}

package/init/seed/minimal/publish.os/publish.os.config.json

@@ -1,6 +1,6 @@
 {
   "version": 1,
-  "runtime": "@publish.os/nextjs@0.0.1-alpha.91",
+  "runtime": "@publish.os/nextjs@0.0.1-alpha.92",
   "site": {
     "name": "publish.os guides",
     "description": "Documentation and updates for your project."
@@ -16,6 +16,17 @@
   },
   "groups": {
     "docs": { "title": "Docs" },
-    "blog": { "title": "Blog" }
+    "blog": {
+      "title": "Blog",
+      "navigation": {
+        "items": [],
+        "sort": {
+          "source": "frontmatter",
+          "field": "publishedAt",
+          "type": "date",
+          "direction": "desc"
+        }
+      }
+    }
   }
 }

package/init/seed/minimal/seed.json

@@ -17,6 +17,7 @@
     "blog/layout.tsx",
     "blog/page.tsx",
     "components/blog/copy-link.tsx",
+    "components/blog/frontmatter.ts",
     "blog/content/hello-world.mdx",
     "blog/content/series-a.mdx"
   ]

package/init/seed/scratch/publish.os/publish.os.config.json

@@ -1,4 +1,4 @@
 {
   "version": 1,
-  "runtime": "@publish.os/nextjs@0.0.1-alpha.91"
+  "runtime": "@publish.os/nextjs@0.0.1-alpha.92"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@publish.os/nextjs",
-  "version": "0.0.1-alpha.91",
+  "version": "0.0.1-alpha.92",
   "description": "Components and routes for generated publishOS Next.js sites.",
   "homepage": "https://publish.dev",
   "bugs": {
@@ -534,7 +534,6 @@
     "class-variance-authority": "0.7.1",
     "cn": "^0.2.6",
     "fontkit": "^2.0.4",
-    "gray-matter": "^4.0.3",
     "next-mdx-remote": "^6.0.0",
     "next-themes": "^0.4.0",
     "postcss": "8.5.28",
@@ -548,10 +547,11 @@
     "remark-stringify": "^11.0.0",
     "saxes": "^6.0.0",
     "sharp": "0.35.5",
-    "shiki": "^4.4.3",
+    "shiki": "^4.5.0",
     "tar": "7.5.22",
     "unified": "^11.0.5",
-    "zod": "^3.23.8"
+    "yaml": "2.9.1",
+    "zod": "^4.6.7"
   },
   "peerDependencies": {
     "next": ">=16.4.2",

package/release/app/phosphor/package.json

@@ -2,7 +2,7 @@
   "engines": {
     "node": "^24.22.1"
   },
-  "name": "publish-os-nextjs-app-phosphor-install",
+  "name": "publish-os-site",
   "packageManager": "pnpm@12.3.0",
   "private": true,
   "type": "module",