@domphy/press 0.19.1 → 0.20.0

package/dist/cli.js

@@ -23,11 +23,18 @@ async function loadConfig(configFile) {
 if (command === "build") {
   const config = await loadConfig(flag("--config") ?? "press.config.ts");
   const srcDir = resolve(process.cwd(), flag("--src") ?? config.srcDir ?? ".");
-  const outDir = resolve(process.cwd(), flag("--out") ?? config.outDir ?? "dist");
+  const outDir = resolve(
+    process.cwd(),
+    flag("--out") ?? config.outDir ?? "dist"
+  );
   const publicDir = resolve(process.cwd(), "public");
-  const { buildSite } = await import("./build-QKFFWX4D.js");
+  const { buildSite } = await import("./build-SVIPUB2K.js");
   await buildSite({
-    config: { ...config, srcDir: config.srcDir ?? ".", outDir: config.outDir ?? "dist" },
+    config: {
+      ...config,
+      srcDir: config.srcDir ?? ".",
+      outDir: config.outDir ?? "dist"
+    },
     srcDir,
     outDir,
     publicDir: existsSync(publicDir) ? publicDir : void 0
@@ -37,15 +44,22 @@ if (command === "build") {
   const configFile = flag("--config") ?? "press.config.ts";
   const config = await loadConfig(configFile);
   const srcDir = resolve(process.cwd(), flag("--src") ?? config.srcDir ?? ".");
-  const outDir = resolve(process.cwd(), flag("--out") ?? config.outDir ?? ".press-dev");
+  const outDir = resolve(
+    process.cwd(),
+    flag("--out") ?? config.outDir ?? ".press-dev"
+  );
   const publicDir = resolve(process.cwd(), "public");
-  const { buildSite } = await import("./build-QKFFWX4D.js");
-  const { startDevServer } = await import("./serve-LQBYPP6C.js");
+  const { buildSite } = await import("./build-SVIPUB2K.js");
+  const { startDevServer } = await import("./serve-CMS6MDDF.js");
   async function rebuild() {
     const start = Date.now();
     try {
       await buildSite({
-        config: { ...config, srcDir: config.srcDir ?? ".", outDir: config.outDir ?? ".press-dev" },
+        config: {
+          ...config,
+          srcDir: config.srcDir ?? ".",
+          outDir: config.outDir ?? ".press-dev"
+        },
         srcDir,
         outDir,
         publicDir: existsSync(publicDir) ? publicDir : void 0
@@ -59,7 +73,8 @@ if (command === "build") {
   const { notify } = startDevServer(outDir, port);
   let rebuildTimer = null;
   watch(srcDir, { recursive: true }, (_event, filename) => {
-    if (!filename?.endsWith(".md") && !filename?.endsWith(".ts") && !filename?.endsWith(".js")) return;
+    if (!filename?.endsWith(".md") && !filename?.endsWith(".ts") && !filename?.endsWith(".js"))
+      return;
     if (rebuildTimer) clearTimeout(rebuildTimer);
     rebuildTimer = setTimeout(async () => {
       rebuildTimer = null;
@@ -83,7 +98,7 @@ if (command === "build") {
     console.error(`No build at ${outDir}. Run "domphy-press build" first.`);
     process.exit(1);
   }
-  const { startServer } = await import("./serve-LQBYPP6C.js");
+  const { startServer } = await import("./serve-CMS6MDDF.js");
   startServer(outDir, port);
 } else {
   console.error(`Unknown command: ${command ?? "(none)"}`);

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 import { DomphyElement, ElementNode } from '@domphy/core';
+export { DomphyElement } from '@domphy/core';
 import { TocEntry } from '@domphy/markdown';
 export { TocEntry } from '@domphy/markdown';
 import { Server } from 'node:http';
@@ -33,6 +34,22 @@ interface EditLink {
     pattern: string;
     text?: string;
 }
+/** Override built-in layout slots. Each function receives the full LayoutContext
+ *  and must return a DomphyElement (or null to omit the slot entirely). */
+interface LayoutSlots {
+    /** Replace the entire header bar. */
+    header?: (ctx: unknown) => DomphyElement | null;
+    /** Replace the sidebar navigation. */
+    sidebar?: (ctx: unknown) => DomphyElement | null;
+    /** Replace the TOC aside panel. */
+    aside?: (ctx: unknown) => DomphyElement | null;
+    /** Replace the prev/next pagination row. */
+    prevNext?: (ctx: unknown) => DomphyElement | null;
+    /** Replace the doc footer (edit link + last updated). */
+    docFooter?: (ctx: unknown) => DomphyElement | null;
+    /** Replace the page footer bar. */
+    footer?: (ctx: unknown) => DomphyElement | null;
+}
 interface ThemeConfig {
     nav: NavItem[];
     /** Keys are route prefixes (e.g. "/guide/"). Longest match wins. */
@@ -65,6 +82,8 @@ interface ThemeConfig {
         text: string;
         dismissible?: boolean;
     };
+    /** Override individual layout slots with custom components. */
+    slots?: LayoutSlots;
 }
 interface LocaleConfig {
     label: string;
@@ -115,6 +134,14 @@ interface PageEntry {
     filePath: string;
 }
 
+interface BuildOptions {
+    config: SiteConfig;
+    srcDir: string;
+    outDir: string;
+    publicDir?: string;
+}
+declare function buildSite(options: BuildOptions): Promise<void>;
+
 type UserConfig = Omit<SiteConfig, "base" | "srcDir" | "outDir" | "head"> & {
     base?: string;
     srcDir?: string;
@@ -123,19 +150,32 @@ type UserConfig = Omit<SiteConfig, "base" | "srcDir" | "outDir" | "head"> & {
 };
 declare function defineConfig(config: UserConfig): SiteConfig;
 
-interface BuildOptions {
-    config: SiteConfig;
-    srcDir: string;
-    outDir: string;
-    publicDir?: string;
+interface FenceMeta {
+    lang: string;
+    highlightLines: Set<number>;
+    lineNumbers: boolean;
+    title: string | null;
 }
-declare function buildSite(options: BuildOptions): Promise<void>;
+declare function parseFenceInfo(info: string): FenceMeta;
+declare function createHighlighter(): Promise<(code: string, lang: string) => string>;
+declare function renderFence(code: string, info: string, highlight: (code: string, lang: string) => string): string;
 
-declare function startServer(root: string, port: number): Server;
-declare function startDevServer(root: string, port: number): {
-    server: Server;
-    notify: () => void;
-};
+interface LayoutContext {
+    route: string;
+    title: string;
+    body: DomphyElement[];
+    toc: TocEntry[];
+    frontmatter: Record<string, unknown>;
+    config: SiteConfig;
+    /** ISO date string from git log, if lastUpdated:true and git available. */
+    lastUpdated?: string;
+    /** Estimated reading time in minutes. */
+    readingTime?: number;
+    /** Relative path from srcDir (e.g. "guide/index.md"), used for editLink. */
+    filePath?: string;
+}
+declare function pageShell(ctx: LayoutContext): DomphyElement;
+declare function homeShell(ctx: LayoutContext): DomphyElement;
 
 declare function renderDoc(source: string, options: RenderDocOptions): Promise<RenderedDoc>;
 
@@ -177,33 +217,12 @@ interface SearchWidgetOptions {
 declare function searchWidget(options?: SearchWidgetOptions): DomphyElement;
 declare function mountSearch(host: HTMLElement, options?: SearchWidgetOptions): ElementNode;
 
-interface FenceMeta {
-    lang: string;
-    highlightLines: Set<number>;
-    lineNumbers: boolean;
-    title: string | null;
-}
-declare function parseFenceInfo(info: string): FenceMeta;
-declare function createHighlighter(): Promise<(code: string, lang: string) => string>;
-declare function renderFence(code: string, info: string, highlight: (code: string, lang: string) => string): string;
-
-interface LayoutContext {
-    route: string;
-    title: string;
-    body: DomphyElement[];
-    toc: TocEntry[];
-    frontmatter: Record<string, unknown>;
-    config: SiteConfig;
-    /** ISO date string from git log, if lastUpdated:true and git available. */
-    lastUpdated?: string;
-    /** Estimated reading time in minutes. */
-    readingTime?: number;
-    /** Relative path from srcDir (e.g. "guide/index.md"), used for editLink. */
-    filePath?: string;
-}
-declare function pageShell(ctx: LayoutContext): DomphyElement;
-declare function homeShell(ctx: LayoutContext): DomphyElement;
+declare function startServer(root: string, port: number): Server;
+declare function startDevServer(root: string, port: number): {
+    server: Server;
+    notify: () => void;
+};
 
 declare function pressCSS(): string;
 
-export { type EditLink, type FenceMeta, type IslandRef, type LayoutContext, type LocaleConfig, type NavItem, type PageEntry, type RenderDocOptions, type RenderedDoc, type SearchDocument, type SearchResult, type SearchWidgetOptions, type SidebarItem, type SiteConfig, type SocialLink, type ThemeConfig, type UserConfig, buildSearchIndex, buildSite, createHighlighter, defineConfig, discoverPages, flattenSidebar, homeShell, mountSearch, outFileForRoute, pageShell, parseFenceInfo, pressCSS, prevNextForRoute, queryIndex, renderDoc, renderFence, routeForFile, searchWidget, sidebarForRoute, startDevServer, startServer };
+export { type EditLink, type FenceMeta, type IslandRef, type LayoutContext, type LayoutSlots, type LocaleConfig, type NavItem, type PageEntry, type RenderDocOptions, type RenderedDoc, type SearchDocument, type SearchResult, type SearchWidgetOptions, type SidebarItem, type SiteConfig, type SocialLink, type ThemeConfig, type UserConfig, buildSearchIndex, buildSite, createHighlighter, defineConfig, discoverPages, flattenSidebar, homeShell, mountSearch, outFileForRoute, pageShell, parseFenceInfo, pressCSS, prevNextForRoute, queryIndex, renderDoc, renderFence, routeForFile, searchWidget, sidebarForRoute, startDevServer, startServer };