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

package/dist/types.d.ts

@@ -1,11 +1,103 @@
+import { RefObject } from 'react';
+
+type SearchInput = {
+    filters?: {
+        author?: string;
+        group?: string;
+        tag?: string;
+    };
+    limit?: number;
+    offset?: number;
+    q: string;
+};
+type SearchStatus = "idle" | "building" | "stale" | "ready" | "error";
+type SearchSubResult = {
+    excerpt: string;
+    plainExcerpt: string;
+    title: string;
+    url: string;
+};
+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;
+    subResults: SearchSubResult[];
+    title: string;
+    url: string;
+};
+type SearchOutput = {
+    items: SearchResult[];
+    message?: string;
+    nextOffset: number | null;
+    status: SearchStatus;
+    total: number;
+};
+type SearchBlockVariant = "desktop" | "mobile";
+type SearchBlockState = {
+    displayResults: SearchResult[];
+    isTyping: boolean;
+    loading: boolean;
+    message?: string;
+    open: boolean;
+    query: string;
+    selectedValue: string;
+    status: SearchStatus;
+    total: number;
+};
+type SearchBlockActions = {
+    handleInputChange(value: string): void;
+    navigateToResult(result: SearchResult): void;
+    setOpen(open: boolean): void;
+    setQuery(value: string): void;
+    setSelectedValue(id: string): void;
+};
+type SearchBlockMeta = {
+    inputId: string;
+    inputRef: RefObject<HTMLInputElement | null>;
+    listId: string;
+    listRef: RefObject<HTMLDivElement | null>;
+    shortcut: string;
+    variant: SearchBlockVariant;
+};
+type SearchBlockContextValue = {
+    actions: SearchBlockActions;
+    meta: SearchBlockMeta;
+    state: SearchBlockState;
+};
+
 type Heading = {
     id: string;
     depth: number;
     text: string;
 };
 type SiteData = {
-    title: string;
+    name: string;
     description?: string;
+    url?: string;
+    og?: OgMetadata;
+};
+type OgImageMetadata = string | {
+    src: string;
+    alt?: string;
+};
+type OgMetadata = {
+    title?: string;
+    description?: string;
+    image?: OgImageMetadata;
 };
 type Author = {
     id?: string;
@@ -16,7 +108,6 @@ type Author = {
 };
 type PageStatus = "published" | "draft" | "archived";
 type PageFrontmatter = {
-    id: string;
     title: string;
     slug?: string;
     description?: string;
@@ -28,7 +119,7 @@ type PageFrontmatter = {
     [key: string]: unknown;
 };
 type PageData<TMeta extends Record<string, unknown> = Record<string, unknown>> = {
-    id: string;
+    fileID: string;
     group: string;
     slug: string;
     path: string;
@@ -39,6 +130,7 @@ type PageData<TMeta extends Record<string, unknown> = Record<string, unknown>> =
     updatedAt?: string;
     authors: Author[];
     tags: string[];
+    og?: OgMetadata;
     meta: TMeta;
     body: string;
 };
@@ -47,7 +139,7 @@ type PageSummary<TMeta extends Record<string, unknown> = Record<string, unknown>
 };
 type PageNode = {
     type: "page";
-    id: string;
+    fileID: string;
     title: string;
     path: string;
     group: string;
@@ -57,6 +149,7 @@ type PageNode = {
     updatedAt?: string;
     authors: Author[];
     tags?: string[];
+    og?: OgMetadata;
     meta: Record<string, unknown>;
 };
 type SectionNode = {
@@ -71,6 +164,7 @@ type FolderNode = {
     type: "folder";
     id: string;
     title: string;
+    path?: string;
     group?: string;
     children: TreeNode[];
 };
@@ -87,16 +181,26 @@ type NavSection = SectionNode;
 type NavFolder = FolderNode;
 type NavItem = TreeNode;
 type RouteRecord = {
-    id: string;
+    fileID: string;
     slug: string;
     path: string;
     group: string;
 };
+type ResolvedAttribution = {
+    enabled: false;
+} | {
+    enabled: true;
+    variant: "publish-dev";
+    label?: string;
+    hrefLabel?: string;
+    href: string;
+};
 type GroupManifest = {
     key: string;
     title: string;
     path: string;
-    contentDir: string;
+    ancestry?: string[];
+    meta?: Record<string, unknown>;
     tree: TreeNode[];
     pages: PageData[];
 };
@@ -106,12 +210,16 @@ type ManifestLike = {
     routes: RouteRecord[];
     pages: PageData[];
     tree: TreeNode[];
+    attribution?: Record<string, ResolvedAttribution>;
     contentHash: string;
 };
 type RootLayoutProps = {
     children: React.ReactNode;
     site: SiteData;
     tree: TreeNode[];
+    currentPath?: string;
+    currentGroup?: GroupContext;
+    activeGroups?: readonly GroupContext[];
 };
 type RootPageProps = {
     site: SiteData;
@@ -140,5 +248,22 @@ type IndexPageProps = {
     currentPath: string;
     group: string;
 };
+type ThemeMode = "system" | "light" | "dark";
+type GroupForcedMode = "light" | "dark" | "none";
+type GroupContext = {
+    key: string;
+    title: string;
+    path: string;
+    ancestry: readonly string[];
+    hasThemeCss: boolean;
+    hasFontScope: boolean;
+    defaultMode?: ThemeMode;
+    forcedMode?: GroupForcedMode;
+    resolvedForcedMode?: "light" | "dark";
+    escapesForcedMode?: boolean;
+    meta?: Record<string, unknown>;
+};
+
+declare const __publishOsTypesModule = true;
 
-export type { Author, FolderNode, GroupManifest, Heading, IndexPageProps, LayoutProps, LinkNode, ManifestLike, NavFolder, NavItem, NavLink, NavPage, NavSection, PageData, PageFrontmatter, PageNode, PageProps, PageStatus, PageSummary, RootLayoutProps, RootPageProps, RouteRecord, SectionNode, SiteData, TreeNode };
+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 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 SearchBlockVariant, type SearchInput, type SearchOutput, type SearchResult, type SearchStatus, type SearchSubResult, type SectionNode, type SiteData, type ThemeMode, type TreeNode, __publishOsTypesModule };

package/dist/types.js

@@ -0,0 +1,5 @@
+// src/types.ts
+var __publishOsTypesModule = true;
+export {
+  __publishOsTypesModule
+};

package/dist/utils/heading-ids.cjs

@@ -0,0 +1,119 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/utils/heading-ids.ts
+var heading_ids_exports = {};
+__export(heading_ids_exports, {
+  cleanHeadingText: () => cleanHeadingText,
+  createHeadingIdGenerator: () => createHeadingIdGenerator,
+  extractMdxHeadings: () => extractMdxHeadings,
+  headingToHTMLId: () => headingToHTMLId,
+  urlIdToText: () => urlIdToText
+});
+module.exports = __toCommonJS(heading_ids_exports);
+var import_react = require("react");
+var SELF_CLOSING_TAG_RE = new RegExp("<[^>]+/>", "g");
+var PAIRED_TAG_RE = /<\/?\w[^>]*>/g;
+var MDX_BOLD_RE = /\*\*(.*?)\*\*/g;
+var MDX_ITALIC_RE = /\*(.*?)\*/g;
+var MDX_UNDERLINE_BOLD_RE = /__(.*?)__/g;
+var MDX_UNDERLINE_ITALIC_RE = /_(.*?)_/g;
+var MDX_STRIKETHROUGH_RE = /~~(.*?)~~/g;
+var MDX_INLINE_CODE_RE = /`(.*?)`/g;
+var MDX_LINK_RE = /\[(.*?)\]\(.*?\)/g;
+var NON_ALPHANUMERIC_RE = /[^a-z0-9]+/g;
+var LEADING_TRAILING_HYPHEN_RE = /^-+|-+$/g;
+var LEADING_DIGIT_RE = /^(\d)/;
+var HEADING_RE = /^(#{1,6})[ \t]+(.+?)\s*#*\s*$/gm;
+var FENCED_CODE_RE = /```[\s\S]*?```|~~~[\s\S]*?~~~/g;
+function extractText(node) {
+  if (typeof node === "string") return node;
+  if (typeof node === "number") return String(node);
+  if (node == null || typeof node === "boolean") return "";
+  if (Array.isArray(node)) {
+    return node.map(extractText).join("");
+  }
+  if ((0, import_react.isValidElement)(node)) {
+    const element = node;
+    return element.props.children === void 0 ? "" : extractText(element.props.children);
+  }
+  return "";
+}
+function cleanHeadingText(input) {
+  const text = typeof input === "string" ? input : extractText(input);
+  return text.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 slugify(text) {
+  return text.toLowerCase().replace(NON_ALPHANUMERIC_RE, "-").replace(LEADING_TRAILING_HYPHEN_RE, "").replace(LEADING_DIGIT_RE, "id-$1");
+}
+function headingToHTMLId(input) {
+  try {
+    const id = slugify(cleanHeadingText(input));
+    return id || "empty-heading";
+  } catch {
+    return "empty-heading";
+  }
+}
+function createHeadingIdGenerator() {
+  const usedIds = /* @__PURE__ */ new Map();
+  return (input) => {
+    const baseId = headingToHTMLId(input);
+    if (baseId === "empty-heading") return baseId;
+    const count = usedIds.get(baseId) ?? 0;
+    usedIds.set(baseId, count + 1);
+    return count === 0 ? baseId : `${baseId}-${count}`;
+  };
+}
+function extractMdxHeadings(content = "", levels) {
+  const [minDepth, maxDepth] = levels;
+  const headingId = createHeadingIdGenerator();
+  const headings = [];
+  const searchableContent = content.replace(FENCED_CODE_RE, "");
+  HEADING_RE.lastIndex = 0;
+  while (true) {
+    const match = HEADING_RE.exec(searchableContent);
+    if (!match) break;
+    const marker = match[1];
+    const rawText = match[2];
+    if (!marker || !rawText) continue;
+    const level = marker.length;
+    const text = cleanHeadingText(rawText);
+    const id = headingId(rawText);
+    if (!text || id === "empty-heading") continue;
+    if (level < minDepth || level > maxDepth) continue;
+    headings.push({ id, level, text });
+  }
+  return headings;
+}
+function urlIdToText(urlId) {
+  try {
+    if (typeof urlId !== "string") return "";
+    return urlId.replace(/^id-/, "").replace(/-/g, " ").replace(/\b\w/g, (char) => char.toUpperCase());
+  } catch {
+    return "";
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  cleanHeadingText,
+  createHeadingIdGenerator,
+  extractMdxHeadings,
+  headingToHTMLId,
+  urlIdToText
+});

package/dist/utils/heading-ids.d.cts

@@ -0,0 +1,15 @@
+import { ReactNode } from 'react';
+
+type HeadingIdGenerator = (input: ReactNode) => string;
+type MdxHeadingItem = {
+    id: string;
+    level: number;
+    text: string;
+};
+declare function cleanHeadingText(input: ReactNode): string;
+declare function headingToHTMLId(input: ReactNode): string;
+declare function createHeadingIdGenerator(): HeadingIdGenerator;
+declare function extractMdxHeadings(content: string | undefined, levels: [number, number]): MdxHeadingItem[];
+declare function urlIdToText(urlId: string): string;
+
+export { type HeadingIdGenerator, type MdxHeadingItem, cleanHeadingText, createHeadingIdGenerator, extractMdxHeadings, headingToHTMLId, urlIdToText };

package/dist/utils/heading-ids.d.ts

@@ -0,0 +1,15 @@
+import { ReactNode } from 'react';
+
+type HeadingIdGenerator = (input: ReactNode) => string;
+type MdxHeadingItem = {
+    id: string;
+    level: number;
+    text: string;
+};
+declare function cleanHeadingText(input: ReactNode): string;
+declare function headingToHTMLId(input: ReactNode): string;
+declare function createHeadingIdGenerator(): HeadingIdGenerator;
+declare function extractMdxHeadings(content: string | undefined, levels: [number, number]): MdxHeadingItem[];
+declare function urlIdToText(urlId: string): string;
+
+export { type HeadingIdGenerator, type MdxHeadingItem, cleanHeadingText, createHeadingIdGenerator, extractMdxHeadings, headingToHTMLId, urlIdToText };

package/dist/utils/heading-ids.js

@@ -0,0 +1,90 @@
+// src/utils/heading-ids.ts
+import { isValidElement } from "react";
+var SELF_CLOSING_TAG_RE = new RegExp("<[^>]+/>", "g");
+var PAIRED_TAG_RE = /<\/?\w[^>]*>/g;
+var MDX_BOLD_RE = /\*\*(.*?)\*\*/g;
+var MDX_ITALIC_RE = /\*(.*?)\*/g;
+var MDX_UNDERLINE_BOLD_RE = /__(.*?)__/g;
+var MDX_UNDERLINE_ITALIC_RE = /_(.*?)_/g;
+var MDX_STRIKETHROUGH_RE = /~~(.*?)~~/g;
+var MDX_INLINE_CODE_RE = /`(.*?)`/g;
+var MDX_LINK_RE = /\[(.*?)\]\(.*?\)/g;
+var NON_ALPHANUMERIC_RE = /[^a-z0-9]+/g;
+var LEADING_TRAILING_HYPHEN_RE = /^-+|-+$/g;
+var LEADING_DIGIT_RE = /^(\d)/;
+var HEADING_RE = /^(#{1,6})[ \t]+(.+?)\s*#*\s*$/gm;
+var FENCED_CODE_RE = /```[\s\S]*?```|~~~[\s\S]*?~~~/g;
+function extractText(node) {
+  if (typeof node === "string") return node;
+  if (typeof node === "number") return String(node);
+  if (node == null || typeof node === "boolean") return "";
+  if (Array.isArray(node)) {
+    return node.map(extractText).join("");
+  }
+  if (isValidElement(node)) {
+    const element = node;
+    return element.props.children === void 0 ? "" : extractText(element.props.children);
+  }
+  return "";
+}
+function cleanHeadingText(input) {
+  const text = typeof input === "string" ? input : extractText(input);
+  return text.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 slugify(text) {
+  return text.toLowerCase().replace(NON_ALPHANUMERIC_RE, "-").replace(LEADING_TRAILING_HYPHEN_RE, "").replace(LEADING_DIGIT_RE, "id-$1");
+}
+function headingToHTMLId(input) {
+  try {
+    const id = slugify(cleanHeadingText(input));
+    return id || "empty-heading";
+  } catch {
+    return "empty-heading";
+  }
+}
+function createHeadingIdGenerator() {
+  const usedIds = /* @__PURE__ */ new Map();
+  return (input) => {
+    const baseId = headingToHTMLId(input);
+    if (baseId === "empty-heading") return baseId;
+    const count = usedIds.get(baseId) ?? 0;
+    usedIds.set(baseId, count + 1);
+    return count === 0 ? baseId : `${baseId}-${count}`;
+  };
+}
+function extractMdxHeadings(content = "", levels) {
+  const [minDepth, maxDepth] = levels;
+  const headingId = createHeadingIdGenerator();
+  const headings = [];
+  const searchableContent = content.replace(FENCED_CODE_RE, "");
+  HEADING_RE.lastIndex = 0;
+  while (true) {
+    const match = HEADING_RE.exec(searchableContent);
+    if (!match) break;
+    const marker = match[1];
+    const rawText = match[2];
+    if (!marker || !rawText) continue;
+    const level = marker.length;
+    const text = cleanHeadingText(rawText);
+    const id = headingId(rawText);
+    if (!text || id === "empty-heading") continue;
+    if (level < minDepth || level > maxDepth) continue;
+    headings.push({ id, level, text });
+  }
+  return headings;
+}
+function urlIdToText(urlId) {
+  try {
+    if (typeof urlId !== "string") return "";
+    return urlId.replace(/^id-/, "").replace(/-/g, " ").replace(/\b\w/g, (char) => char.toUpperCase());
+  } catch {
+    return "";
+  }
+}
+export {
+  cleanHeadingText,
+  createHeadingIdGenerator,
+  extractMdxHeadings,
+  headingToHTMLId,
+  urlIdToText
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@publish.os/nextjs",
-  "version": "0.0.1-alpha.2",
+  "version": "0.0.1-alpha.3",
   "type": "module",
   "license": "UNLICENSED",
   "repository": {
@@ -18,76 +18,73 @@
       "types": "./dist/index.d.ts",
       "default": "./dist/index.js"
     },
-    "./routes/*": {
-      "types": "./dist/routes/*.d.ts",
-      "default": "./dist/routes/*.js"
-    },
     "./resolvers/*": {
       "types": "./dist/resolvers/*.d.ts",
       "default": "./dist/resolvers/*.js"
     },
     "./mdx/*": {
-      "types": "./dist/mdx/*.d.ts",
-      "default": "./dist/mdx/*.js"
+      "types": "./dist/kernel/components/mdx/*.d.ts",
+      "default": "./dist/kernel/components/mdx/*.js"
     },
     "./mdx": {
-      "types": "./dist/mdx/mdx.d.ts",
-      "default": "./dist/mdx/mdx.js"
-    },
-    "./pages/leaf": {
-      "types": "./dist/pages/leaf.d.ts",
-      "default": "./dist/pages/leaf.js"
-    },
-    "./pages/group": {
-      "types": "./dist/pages/group.d.ts",
-      "default": "./dist/pages/group.js"
-    },
-    "./pages/root": {
-      "types": "./dist/pages/root.d.ts",
-      "default": "./dist/pages/root.js"
-    },
-    "./layouts/group": {
-      "types": "./dist/layouts/group.d.ts",
-      "default": "./dist/layouts/group.js"
+      "types": "./dist/kernel/components/mdx/mdx.d.ts",
+      "default": "./dist/kernel/components/mdx/mdx.js"
     },
     "./cache/tags": {
       "types": "./dist/cache/tags.d.ts",
       "default": "./dist/cache/tags.js"
     },
+    "./config": {
+      "types": "./dist/config.d.ts",
+      "default": "./dist/config.js"
+    },
+    "./keyboard-shortcuts": {
+      "types": "./dist/keyboard-shortcuts.d.ts",
+      "default": "./dist/keyboard-shortcuts.js"
+    },
+    "./search": {
+      "types": "./dist/search.d.ts",
+      "default": "./dist/search.js"
+    },
     "./types": {
       "types": "./dist/types.d.ts",
       "default": "./dist/types.js"
     },
-    "./routes/llms": {
-      "types": "./dist/routes/llms.d.ts",
-      "default": "./dist/routes/llms.js"
-    },
-    "./routes/robots": {
-      "types": "./dist/routes/robots.d.ts",
-      "default": "./dist/routes/robots.js"
+    "./kernel/defaults.registry": {
+      "types": "./dist/kernel/defaults.registry.d.ts",
+      "default": "./dist/kernel/defaults.registry.js"
     },
-    "./routes/sitemap": {
-      "types": "./dist/routes/sitemap.d.ts",
-      "default": "./dist/routes/sitemap.js"
-    },
-    "./components/*": {
-      "types": "./dist/components/*.d.ts",
-      "default": "./dist/components/*.js"
+    "./kernel/*": {
+      "types": "./dist/kernel/*.d.ts",
+      "default": "./dist/kernel/*.js"
     },
     "./utils/pretty-date": {
       "types": "./dist/utils/pretty-date.d.ts",
       "default": "./dist/utils/pretty-date.js"
     },
+    "./utils/cn": {
+      "types": "./dist/utils/cn.d.ts",
+      "default": "./dist/utils/cn.js"
+    },
+    "./utils/heading-ids": {
+      "types": "./dist/utils/heading-ids.d.ts",
+      "default": "./dist/utils/heading-ids.js"
+    },
     "./config/*": {
       "types": "./dist/config/*.d.ts",
       "default": "./dist/config/*.js"
     }
   },
   "dependencies": {
+    "@base-ui/react": "1.5.0",
+    "@types/mdx": "2.0.13",
+    "class-variance-authority": "0.7.1",
     "clsx": "^2.1.1",
+    "lucide-react": "0.468.0",
     "next-mdx-remote": "^6.0.0",
     "next-themes": "^0.4.0",
     "react": "^19.2.0",
+    "react-medium-image-zoom": "^5.4.8",
     "remark-gfm": "^4.0.1",
     "tailwind-merge": "^3.0.0",
     "tslib": "^2.8.1"