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

package/dist/kernel/components/ui/scroll-area.js

@@ -13,7 +13,7 @@ import {
   useRef,
   useState
 } from "react";
-import { jsx, jsxs } from "react/jsx-runtime";
+import { jsx, jsxs } from "@publish.os/nextjs/jsx-runtime";
 var scrollAreaVariants = cva(
   "relative overflow-hidden rounded-scrollarea text-foreground-1",
   {

package/dist/kernel/components/ui/select.js

@@ -6,7 +6,7 @@ import { CaretDownIcon, CheckIcon } from "@phosphor-icons/react/ssr";
 import { useThemeScope } from "@publish.os/nextjs/theme-scope";
 import { cn } from "@publish.os/nextjs/utils/cn";
 import { cva } from "class-variance-authority";
-import { jsx } from "react/jsx-runtime";
+import { jsx } from "@publish.os/nextjs/jsx-runtime";
 var selectTriggerVariants = cva(
   [
     "inline-flex w-full min-w-0 items-center justify-between gap-2 rounded-input border border-stroke-2 bg-surface-1 text-foreground-1 transition-colors",

package/dist/kernel/components/ui/separator.js

@@ -1,7 +1,7 @@
 // src/components/ui/separator.tsx
 import { Separator as BaseSeparator } from "@base-ui/react/separator";
 import { cn } from "@publish.os/nextjs/utils/cn";
-import { jsx } from "react/jsx-runtime";
+import { jsx } from "@publish.os/nextjs/jsx-runtime";
 function Separator({
   className,
   orientation = "horizontal",

package/dist/kernel/components/ui/table.js

@@ -1,6 +1,6 @@
 // src/components/ui/table.tsx
 import { cn } from "@publish.os/nextjs/utils/cn";
-import { jsx } from "react/jsx-runtime";
+import { jsx } from "@publish.os/nextjs/jsx-runtime";
 function Table({
   className,
   ...props

package/dist/kernel/components/ui/tabs.js

@@ -11,7 +11,7 @@ import {
   useLayoutEffect,
   useRef
 } from "react";
-import { jsx } from "react/jsx-runtime";
+import { jsx } from "@publish.os/nextjs/jsx-runtime";
 var tabsListVariants = cva("relative inline-flex items-center", {
   variants: {
     variant: {

package/dist/kernel/components/ui/tag.js

@@ -1,7 +1,7 @@
 // src/components/ui/tag.tsx
 import { cn } from "@publish.os/nextjs/utils/cn";
 import { cva } from "class-variance-authority";
-import { jsx } from "react/jsx-runtime";
+import { jsx } from "@publish.os/nextjs/jsx-runtime";
 var tagVariants = cva(
   "inline-flex shrink-0 items-center justify-center gap-1 whitespace-nowrap rounded-tag border px-2 py-0.5 text-xs font-medium leading-5 [&_svg]:shrink-0",
   {

package/dist/kernel/components/ui/text.d.ts

@@ -6,7 +6,7 @@ import { ElementType, ComponentPropsWithoutRef } from 'react';
 declare const textVariants: (props?: ({
     size?: "xs" | "sm" | "md" | "lg" | "xl" | "2xl" | "3xl" | "4xl" | "5xl" | "6xl" | "7xl" | "8xl" | "9xl" | null | undefined;
     variant?: "body" | "label" | "overline" | "headline" | null | undefined;
-    weight?: "bold" | "default" | "medium" | "semibold" | null | undefined;
+    weight?: "medium" | "default" | "bold" | "semibold" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 type TextProps<T extends ElementType = "p"> = {
     as?: T;

package/dist/kernel/components/ui/text.js

@@ -1,7 +1,7 @@
 // src/components/ui/text.tsx
 import { cn } from "@publish.os/nextjs/utils/cn";
 import { cva } from "class-variance-authority";
-import { jsx } from "react/jsx-runtime";
+import { jsx } from "@publish.os/nextjs/jsx-runtime";
 var textVariants = cva(
   "text-[var(--text-foreground,var(--foreground-1))]",
   {

package/dist/kernel/components/ui/toast.js

@@ -4,7 +4,7 @@
 import { Toast as BaseToast } from "@base-ui/react/toast";
 import { useThemeScope } from "@publish.os/nextjs/theme-scope";
 import { cn } from "@publish.os/nextjs/utils/cn";
-import { jsx } from "react/jsx-runtime";
+import { jsx } from "@publish.os/nextjs/jsx-runtime";
 var createToastManager = BaseToast.createToastManager, useToastManager = BaseToast.useToastManager;
 function ToastProvider(props) {
   return /* @__PURE__ */ jsx(BaseToast.Provider, { ...props });

package/dist/kernel/components/ui/tooltip.js

@@ -4,7 +4,7 @@
 import { Tooltip as BaseTooltip } from "@base-ui/react/tooltip";
 import { useThemeScope } from "@publish.os/nextjs/theme-scope";
 import { cn } from "@publish.os/nextjs/utils/cn";
-import { jsx } from "react/jsx-runtime";
+import { jsx } from "@publish.os/nextjs/jsx-runtime";
 function TooltipProvider(props) {
   return /* @__PURE__ */ jsx(BaseTooltip.Provider, { ...props });
 }

package/dist/kernel/defaults.registry.d.ts

@@ -36,8 +36,8 @@ declare const kernelDefaultsRegistry: {
         readonly name: "AgentActions";
         readonly status: "available";
         readonly description: "Agent-readable page actions for opening Markdown in AI chats, copying Markdown, and linking to Markdown artifacts.";
-        readonly kernelImport: "@publish.os/nextjs/kernel/components/blocks/AgentActions";
-        readonly projectPath: "publish.os/components/blocks/AgentActions.tsx";
+        readonly kernelImport: "@publish.os/nextjs/kernel/components/blocks/agent-actions";
+        readonly projectPath: "publish.os/components/blocks/agent-actions.tsx";
         readonly contract: "AgentActionsProps";
     }, {
         readonly category: "ui";
@@ -245,12 +245,6 @@ declare const kernelDefaultsRegistry: {
         readonly description: "Route transition progress indicator backed by the Progress primitive.";
         readonly kernelImport: "@publish.os/nextjs/kernel/components/blocks/navigation-progress";
         readonly projectPath: "publish.os/components/blocks/navigation-progress.tsx";
-    }, {
-        readonly category: "block";
-        readonly name: "LinkPlayground";
-        readonly status: "available";
-        readonly description: "Design-system playground for tuning UI and MDX link styling.";
-        readonly kernelImport: "@publish.os/nextjs/kernel/components/blocks/link-playground";
     }, {
         readonly category: "block";
         readonly name: "NavBreadcrumb";
@@ -287,13 +281,6 @@ declare const kernelDefaultsRegistry: {
         readonly description: "Current token/color preview block. Will be replaced by DesignSystemPreview.";
         readonly kernelImport: "@publish.os/nextjs/kernel/components/blocks/color-palette";
         readonly projectPath: "publish.os/components/blocks/color-palette.tsx";
-    }, {
-        readonly category: "block";
-        readonly name: "DesignSystemPreview";
-        readonly status: "available";
-        readonly description: "Tabbed preview for active tokens, typography, UI, MDX, and blocks.";
-        readonly kernelImport: "@publish.os/nextjs/kernel/components/blocks/design-system-preview";
-        readonly projectPath: "publish.os/components/blocks/design-system-preview.tsx";
     }, {
         readonly category: "mdx";
         readonly name: "Heading";

package/dist/kernel/defaults.registry.js

@@ -24,8 +24,8 @@ var kernelDefaultsRegistry = {
       name: "AgentActions",
       status: "available",
       description: "Agent-readable page actions for opening Markdown in AI chats, copying Markdown, and linking to Markdown artifacts.",
-      kernelImport: "@publish.os/nextjs/kernel/components/blocks/AgentActions",
-      projectPath: "publish.os/components/blocks/AgentActions.tsx",
+      kernelImport: "@publish.os/nextjs/kernel/components/blocks/agent-actions",
+      projectPath: "publish.os/components/blocks/agent-actions.tsx",
       contract: "AgentActionsProps"
     },
     {
@@ -262,13 +262,6 @@ var kernelDefaultsRegistry = {
       kernelImport: "@publish.os/nextjs/kernel/components/blocks/navigation-progress",
       projectPath: "publish.os/components/blocks/navigation-progress.tsx"
     },
-    {
-      category: "block",
-      name: "LinkPlayground",
-      status: "available",
-      description: "Design-system playground for tuning UI and MDX link styling.",
-      kernelImport: "@publish.os/nextjs/kernel/components/blocks/link-playground"
-    },
     {
       category: "block",
       name: "NavBreadcrumb",
@@ -310,14 +303,6 @@ var kernelDefaultsRegistry = {
       kernelImport: "@publish.os/nextjs/kernel/components/blocks/color-palette",
       projectPath: "publish.os/components/blocks/color-palette.tsx"
     },
-    {
-      category: "block",
-      name: "DesignSystemPreview",
-      status: "available",
-      description: "Tabbed preview for active tokens, typography, UI, MDX, and blocks.",
-      kernelImport: "@publish.os/nextjs/kernel/components/blocks/design-system-preview",
-      projectPath: "publish.os/components/blocks/design-system-preview.tsx"
-    },
     {
       category: "mdx",
       name: "Heading",

package/dist/kernel/routes/agent/markdown.d.ts

@@ -1,3 +1,5 @@
+import { NotFoundScope } from '../not-found.js';
+
 type MarkdownRouteArtifact = {
     body: string;
     bodyHash?: string;
@@ -37,6 +39,7 @@ type MarkdownRouteDiscoveryLinks = {
 };
 type MarkdownRouteHandlerOptions = {
     discoveryLinks?: MarkdownRouteDiscoveryLinks;
+    notFoundScopes?: readonly NotFoundScope[];
 };
 type RouteContext = {
     params?: Promise<{

package/dist/kernel/routes/agent/markdown.js

@@ -34,12 +34,196 @@ function createCachedTextResponse(options) {
   });
 }
 
+// src/route-not-found.ts
+var MAX_PATH_LENGTH = 2048, UNSAFE_PATH_CHARACTERS = /[\p{Cc}\p{Cs}\u200b-\u200f\u2028-\u202f\u2060-\u206f\ufeff]/u, INTERNAL_PATHS = ["/__publishos", "/_next", "/_not-found", "/publishos"], DEFAULT_MARKDOWN = serializeNotFoundMarkdown({
+  recommendations: [],
+  indexes: []
+});
+function normalizePublicPath(pathname) {
+  let path = pathname.split(/[?#]/u, 1)[0];
+  if (!path?.startsWith("/") || path.startsWith("//") || path.length > MAX_PATH_LENGTH || UNSAFE_PATH_CHARACTERS.test(path))
+    return;
+  let segments = [];
+  for (let segment of path.split("/")) {
+    if (!segment) continue;
+    let decoded;
+    try {
+      decoded = decodeURIComponent(segment);
+    } catch {
+      return;
+    }
+    if (decoded === "." || decoded === ".." || /[/\\]/u.test(decoded) || /%[\da-f]{2}/iu.test(decoded) || UNSAFE_PATH_CHARACTERS.test(decoded))
+      return;
+    segments.push(decoded);
+  }
+  return `/${segments.join("/")}`;
+}
+function containsPath({ parent, path }) {
+  return parent === "/" || path === parent || path.startsWith(`${parent}/`);
+}
+function missingPagePath(pathname) {
+  let normalized = normalizePublicPath(pathname);
+  if (!normalized) return;
+  let path = normalized.endsWith(".md") ? normalized.slice(0, -3) || "/" : normalized;
+  return INTERNAL_PATHS.some((parent) => containsPath({ parent, path })) ? void 0 : path;
+}
+function resolveNotFoundScope({
+  scopes,
+  pathname
+}) {
+  let path = missingPagePath(pathname);
+  if (!path) return;
+  let matched, matchedLength = -1;
+  for (let scope of scopes) {
+    let scopePath = normalizePublicPath(scope.path);
+    !scopePath || !containsPath({ parent: scopePath, path }) || (scopePath.length > matchedLength || scopePath.length === matchedLength && scope.group && !matched?.group) && (matched = scope, matchedLength = scopePath.length);
+  }
+  return matched;
+}
+function trustedHostname(origin) {
+  if (origin)
+    try {
+      let url = new URL(origin);
+      return !["http:", "https:"].includes(url.protocol) || url.username || url.password ? void 0 : url.host.replace(/`/gu, "%60");
+    } catch {
+      return;
+    }
+}
+function requestExplanation({
+  pathname,
+  origin
+}) {
+  let path = pathname.split("/").map(encodeURIComponent).join("/"), hostname = trustedHostname(origin);
+  return `No page exists at \`${path}\`${hostname ? ` on ${hostname}` : ""}.`;
+}
+function indexKind(link) {
+  if (link.kind) return link.kind;
+  switch (link.title) {
+    case "Sitemap":
+      return "sitemap";
+    case "Markdown sitemap":
+      return "sitemap-md";
+    case "llms.txt":
+    case "LLMS index":
+      return "llms";
+    case "llms-full.txt":
+      return "llms-full";
+    default:
+      return;
+  }
+}
+function publicRecoveryHref(href) {
+  if (href.includes("\\") || UNSAFE_PATH_CHARACTERS.test(href))
+    return;
+  let relative = href.startsWith("/") && !href.startsWith("//");
+  try {
+    let url = new URL(
+      href,
+      relative ? "https://publishos.invalid" : void 0
+    );
+    return !["http:", "https:"].includes(url.protocol) || url.username || url.password ? void 0 : relative ? `${url.pathname}${url.search}${url.hash}` : url.href;
+  } catch {
+    return;
+  }
+}
+function markdownText(value) {
+  return value.replace(/\s+/gu, " ").replace(/[\p{Cc}\p{Cs}]/gu, "").trim().replace(/[\\`*_[\]{}<>|~]/gu, "\\$&");
+}
+function markdownLink(link) {
+  let title = markdownText(link.title), href = publicRecoveryHref(link.href)?.replace(
+    /[()`<>]/gu,
+    (character) => `%${character.charCodeAt(0).toString(16).toUpperCase()}`
+  );
+  if (!title || !href) return;
+  let description = link.description ? markdownText(link.description) : void 0;
+  return `- [${title}](${href})${description ? `: ${description}` : ""}`;
+}
+function serializeNotFoundMarkdown({
+  recommendations,
+  indexes
+}) {
+  let sections = [
+    { title: "Recommendations", links: recommendations },
+    { title: "For crawlers and agents", links: indexes }
+  ], lines = [
+    "# 404 \u2014 Not Found",
+    "",
+    "This page does not exist. Please check the URL and try again.",
+    ""
+  ];
+  for (let section of sections) {
+    let links = section.links.map(markdownLink).filter((link) => link !== void 0);
+    links.length && lines.push(`## ${section.title}`, "", ...links, "");
+  }
+  return lines.join(`
+`);
+}
+function discoveryHeaders(scope) {
+  let headers = new Headers(), links = [];
+  for (let link of scope?.indexes ?? []) {
+    let kind = indexKind(link), href = /[\s<>"\\]/u.test(link.href) ? void 0 : publicRecoveryHref(link.href);
+    if (!(!kind || !href))
+      switch (kind) {
+        case "llms":
+          if (scope?.describedBy !== void 0) break;
+          links.push(`<${href}>; rel="describedby"; type="text/plain"`), headers.set("x-publishos-llms", href);
+          break;
+        case "llms-full":
+          links.push(
+            `<${href}>; rel="related"; type="text/plain"; title="Full content"`
+          );
+          break;
+        case "sitemap":
+        case "sitemap-md":
+          links.push(
+            `<${href}>; rel="sitemap"; type="${kind === "sitemap-md" ? "text/markdown" : "application/xml"}"`
+          ), headers.set("x-publishos-sitemap", href);
+          break;
+      }
+  }
+  if (scope?.describedBy !== void 0) {
+    let href = /[\s<>"\\]/u.test(scope.describedBy) ? void 0 : publicRecoveryHref(scope.describedBy);
+    href && (links.push(`<${href}>; rel="describedby"; type="text/plain"`), headers.set("x-publishos-llms", href));
+  }
+  return links.length && headers.set("link", links.join(", ")), headers;
+}
+function createNotFoundTextResponse({
+  scope,
+  pathname,
+  method,
+  contentType = "text/markdown; charset=utf-8",
+  vary = !1
+}) {
+  let path = pathname === void 0 ? void 0 : missingPagePath(pathname), resolvedScope = scope && (pathname === void 0 || resolveNotFoundScope({ scopes: [scope], pathname })) ? scope : void 0, body = resolvedScope?.markdown ?? DEFAULT_MARKDOWN;
+  if (resolvedScope && path) {
+    let explanation = requestExplanation({
+      pathname: path,
+      origin: scope?.origin
+    }), headingEnd = body.indexOf(`
+
+`);
+    body = headingEnd === -1 ? `${body}
+
+${explanation}
+` : `${body.slice(0, headingEnd)}
+
+${explanation}
+
+${body.slice(headingEnd + 2)}`;
+  }
+  let headers = discoveryHeaders(resolvedScope);
+  return vary && headers.set("vary", "Accept, User-Agent"), createCachedTextResponse({
+    body,
+    cachePolicy: "short",
+    contentType,
+    headers,
+    method,
+    noindex: !0,
+    status: 404
+  });
+}
+
 // src/route-agent-markdown.ts
-var DEFAULT_DISCOVERY_LINKS = {
-  home: "/",
-  llms: "/llms.txt",
-  sitemap: "/sitemap.md"
-};
 function debugMarkdownResponse(details) {
   log.debug("[agent-route]", "md-response", details);
 }
@@ -62,56 +246,28 @@ function markdownHeaders(artifact) {
     contentType: "text/markdown; charset=utf-8"
   };
 }
-function markdown404Body(discoveryLinks) {
-  return [
-    "# Not found",
-    "",
-    ...[
-      discoveryLinks.home ? `> Home: ${discoveryLinks.home}` : void 0,
-      discoveryLinks.sitemap ? `> Sitemap: ${discoveryLinks.sitemap}` : void 0,
-      discoveryLinks.llms ? `> LLMS index: ${discoveryLinks.llms}` : void 0
-    ].filter((line) => !!line),
-    "",
-    "The requested Markdown page was not found.",
-    ""
-  ].join(`
-`);
-}
-function notFoundResponse(method, discoveryLinks, artifactPath, reason) {
+function notFoundResponse(method, scopes, artifactPath, reason) {
   return debugMarkdownResponse({
     artifactPath,
     method,
     reason,
     status: 404
-  }), createCachedTextResponse({
-    body: markdown404Body(discoveryLinks),
-    cachePolicy: "short",
-    contentType: "text/markdown; charset=utf-8",
-    method,
-    noindex: !0,
-    status: 404
+  }), createNotFoundTextResponse({
+    scope: artifactPath ? resolveNotFoundScope({ scopes, pathname: artifactPath }) : void 0,
+    pathname: artifactPath,
+    method
   });
 }
-async function markdownResponse(artifacts, discoveryLinks, method, context) {
+async function markdownResponse(artifacts, scopes, method, context) {
   let params = await Promise.resolve(context.params), artifactPath = normalizeArtifactPath(params?.path);
   if (!artifactPath)
-    return notFoundResponse(method, discoveryLinks, void 0, "invalid-path");
+    return notFoundResponse(method, scopes, void 0, "invalid-path");
   let artifactKey = findArtifactKey(artifacts.index, artifactPath);
   if (!artifactKey)
-    return notFoundResponse(
-      method,
-      discoveryLinks,
-      artifactPath,
-      "missing-index"
-    );
+    return notFoundResponse(method, scopes, artifactPath, "missing-index");
   let artifact = await artifacts.loadArtifact(artifactKey);
   if (!artifact)
-    return notFoundResponse(
-      method,
-      discoveryLinks,
-      artifactPath,
-      "missing-shard"
-    );
+    return notFoundResponse(method, scopes, artifactPath, "missing-shard");
   let { contentType, headers } = markdownHeaders(artifact);
   return debugMarkdownResponse({
     artifactPath: artifact.markdownPath,
@@ -127,13 +283,28 @@ async function markdownResponse(artifacts, discoveryLinks, method, context) {
   });
 }
 function createMarkdownRouteHandlers(artifacts, options = {}) {
-  let discoveryLinks = {
-    ...DEFAULT_DISCOVERY_LINKS,
-    ...options.discoveryLinks
-  };
+  let links = options.discoveryLinks, recommendations = links?.home ? [{ title: "Go home", href: links.home }] : [], indexes = [
+    ...links?.sitemap ? [
+      {
+        title: "Markdown sitemap",
+        href: links.sitemap,
+        kind: "sitemap-md"
+      }
+    ] : [],
+    ...links?.llms ? [{ title: "llms.txt", href: links.llms, kind: "llms" }] : []
+  ], scopes = options.notFoundScopes ?? (links ? [
+    {
+      id: "root",
+      path: "/",
+      htmlPath: "",
+      recommendations,
+      indexes,
+      markdown: serializeNotFoundMarkdown({ recommendations, indexes })
+    }
+  ] : []);
   return {
-    GET: (_request, context) => markdownResponse(artifacts, discoveryLinks, "GET", context),
-    HEAD: (_request, context) => markdownResponse(artifacts, discoveryLinks, "HEAD", context),
+    GET: (_request, context) => markdownResponse(artifacts, scopes, "GET", context),
+    HEAD: (_request, context) => markdownResponse(artifacts, scopes, "HEAD", context),
     generateStaticParams: () => Object.keys(artifacts.index).map((artifactPath) => ({
       path: artifactPath.replace(/^\//, "").replace(/\.md$/, "").split("/")
     }))

package/dist/kernel/routes/layouts/group.d.ts

@@ -1,6 +1,6 @@
 import * as react from 'react';
 import { ReactElement, ReactNode } from 'react';
-import { M as ManifestLike, L as LayoutProps } from '../../../types-BzkZty3r.js';
+import { M as ManifestLike, L as LayoutProps } from '../../../types-J2w_puPF.js';
 
 type LayoutComponent = (props: LayoutProps) => ReactElement | Promise<ReactElement>;
 type GroupLayoutConfig = {

package/dist/kernel/routes/layouts/group.js

@@ -21,8 +21,8 @@ var isDev = process.env.NODE_ENV !== "production", isDebugEnabled = process.env.
 };
 
 // src/route-layout-group.tsx
-import { jsx } from "react/jsx-runtime";
-var manifests = /* @__PURE__ */ new Map(), layoutChains = /* @__PURE__ */ new Map();
+import { jsx } from "@publish.os/nextjs/jsx-runtime";
+var manifests = /* @__PURE__ */ new Map();
 async function CachedGroupLayoutData({
   routeGroup,
   layoutGroup
@@ -39,12 +39,10 @@ function createGroupLayout({
   manifest,
   layouts
 }) {
-  return manifests.set(group, manifest), layoutChains.set(group, layouts), async function({ children }) {
-    log.debug("[render]", `${group}/layout`);
-    let chain = layoutChains.get(group);
-    chain?.length || notFound();
+  return manifests.set(group, manifest), async function({ children }) {
+    log.debug("[render]", `${group}/layout`), layouts.length || notFound();
     let resolvedLayouts = await Promise.all(
-      chain.map(async (item) => ({
+      layouts.map(async (item) => ({
         item,
         props: await CachedGroupLayoutData({
           layoutGroup: item.group,

package/dist/kernel/routes/metadata/feed.d.ts

@@ -1,4 +1,4 @@
-import { P as PageStatus, M as ManifestLike } from '../../../types-BzkZty3r.js';
+import { P as PageStatus, M as ManifestLike } from '../../../types-J2w_puPF.js';
 
 type FeedScope = "site" | "group" | "self";
 type FeedRouteOptions = {