@domphy/press 0.19.0

package/dist/cli.js

@@ -0,0 +1,92 @@
+#!/usr/bin/env node
+#!/usr/bin/env node
+
+// src/cli.ts
+import { existsSync, watch } from "fs";
+import { resolve } from "path";
+import { pathToFileURL } from "url";
+var args = process.argv.slice(2);
+var command = args[0];
+function flag(name) {
+  const index = args.indexOf(name);
+  return index !== -1 ? args[index + 1] : void 0;
+}
+async function loadConfig(configFile) {
+  const configPath = resolve(process.cwd(), configFile);
+  if (!existsSync(configPath)) {
+    console.error(`Config not found: ${configPath}`);
+    process.exit(1);
+  }
+  const { default: userConfig } = await import(pathToFileURL(configPath).href);
+  return typeof userConfig === "function" ? await userConfig() : userConfig;
+}
+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 publicDir = resolve(process.cwd(), "public");
+  const { buildSite } = await import("./build-6Q2QN246.js");
+  await buildSite({
+    config: { ...config, srcDir: config.srcDir ?? ".", outDir: config.outDir ?? "dist" },
+    srcDir,
+    outDir,
+    publicDir: existsSync(publicDir) ? publicDir : void 0
+  });
+} else if (command === "dev") {
+  const port = Number(flag("--port") ?? 3e3);
+  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 publicDir = resolve(process.cwd(), "public");
+  const { buildSite } = await import("./build-6Q2QN246.js");
+  const { startDevServer } = await import("./serve-LQBYPP6C.js");
+  async function rebuild() {
+    const start = Date.now();
+    try {
+      await buildSite({
+        config: { ...config, srcDir: config.srcDir ?? ".", outDir: config.outDir ?? ".press-dev" },
+        srcDir,
+        outDir,
+        publicDir: existsSync(publicDir) ? publicDir : void 0
+      });
+      console.log(`Rebuilt in ${Date.now() - start}ms`);
+    } catch (error) {
+      console.error("Build error:", error);
+    }
+  }
+  await rebuild();
+  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 (rebuildTimer) clearTimeout(rebuildTimer);
+    rebuildTimer = setTimeout(async () => {
+      rebuildTimer = null;
+      console.log(`Changed: ${filename}`);
+      await rebuild();
+      notify();
+    }, 150);
+  });
+  console.log(`Watching ${srcDir}`);
+} else if (command === "preview") {
+  const port = Number(flag("--port") ?? 4173);
+  const configFile = flag("--config") ?? "press.config.ts";
+  let outDir = flag("--out");
+  if (!outDir) {
+    const config = existsSync(resolve(process.cwd(), configFile)) ? await loadConfig(configFile) : null;
+    outDir = resolve(process.cwd(), config?.outDir ?? "dist");
+  } else {
+    outDir = resolve(process.cwd(), outDir);
+  }
+  if (!existsSync(outDir)) {
+    console.error(`No build at ${outDir}. Run "domphy-press build" first.`);
+    process.exit(1);
+  }
+  const { startServer } = await import("./serve-LQBYPP6C.js");
+  startServer(outDir, port);
+} else {
+  console.error(`Unknown command: ${command ?? "(none)"}`);
+  console.error("Usage: domphy-press build | dev | preview");
+  process.exit(1);
+}

package/dist/index.d.ts

@@ -0,0 +1,203 @@
+import { DomphyElement, ElementNode } from '@domphy/core';
+import { TocEntry } from '@domphy/markdown';
+export { TocEntry } from '@domphy/markdown';
+import { Server } from 'node:http';
+
+interface NavItem {
+    text: string;
+    link?: string;
+    items?: {
+        text: string;
+        link: string;
+    }[];
+}
+interface SidebarItem {
+    text: string;
+    link?: string;
+    items?: SidebarItem[];
+    collapsed?: boolean;
+    badge?: {
+        text: string;
+        type?: "tip" | "info" | "warning" | "danger";
+    };
+}
+interface SocialLink {
+    /** Built-in names: "github" | "twitter" | "discord" | "youtube" | "linkedin" | "mastodon".
+     *  Or an absolute URL to a custom SVG/image. */
+    icon: string;
+    link: string;
+    ariaLabel?: string;
+}
+interface EditLink {
+    /** Pattern with :path placeholder, e.g. "https://github.com/org/repo/edit/main/docs/:path" */
+    pattern: string;
+    text?: string;
+}
+interface ThemeConfig {
+    nav: NavItem[];
+    /** Keys are route prefixes (e.g. "/guide/"). Longest match wins. */
+    sidebar: Record<string, SidebarItem[]>;
+    logo?: string;
+    search?: false | {
+        placeholder?: string;
+        limit?: number;
+    };
+    footerMessage?: string;
+    socialLinks?: SocialLink[];
+    editLink?: EditLink;
+    /** TOC heading level range. Default [2, 3]. */
+    outline?: {
+        level: [number, number];
+    };
+    /** Enable mermaid diagrams. Pass { cdn } to override CDN URL. */
+    mermaid?: boolean | {
+        cdn?: string;
+    };
+    /** Dismissible announcement bar shown above the page. */
+    announcementBar?: {
+        id?: string;
+        text: string;
+        dismissible?: boolean;
+    };
+}
+interface LocaleConfig {
+    label: string;
+    lang: string;
+    title?: string;
+    description?: string;
+    themeConfig?: Partial<ThemeConfig>;
+}
+interface SiteConfig {
+    title: string;
+    description: string;
+    base: string;
+    hostname: string;
+    srcDir: string;
+    outDir: string;
+    head: string[];
+    themeConfig: ThemeConfig;
+    locales?: Record<string, LocaleConfig>;
+    /** Show last-updated date sourced from git. Default false. */
+    lastUpdated?: boolean;
+}
+interface IslandRef {
+    id: string;
+    kind: "search";
+}
+interface RenderedDoc {
+    frontmatter: Record<string, unknown>;
+    body: DomphyElement[];
+    toc: TocEntry[];
+    islands: IslandRef[];
+    title: string;
+}
+interface RenderDocOptions {
+    filePath: string;
+    docsDir: string;
+    repoRoot: string;
+    highlight: (code: string, lang: string) => string;
+}
+interface SearchDocument {
+    route: string;
+    title: string;
+    text: string;
+    toc: TocEntry[];
+}
+interface PageEntry {
+    route: string;
+    outFile: string;
+    filePath: string;
+}
+
+type UserConfig = Omit<SiteConfig, "base" | "srcDir" | "outDir" | "head"> & {
+    base?: string;
+    srcDir?: string;
+    outDir?: string;
+    head?: string[];
+};
+declare function defineConfig(config: UserConfig): SiteConfig;
+
+interface BuildOptions {
+    config: SiteConfig;
+    srcDir: string;
+    outDir: string;
+    publicDir?: string;
+}
+declare function buildSite(options: BuildOptions): Promise<void>;
+
+declare function startServer(root: string, port: number): Server;
+declare function startDevServer(root: string, port: number): {
+    server: Server;
+    notify: () => void;
+};
+
+declare function renderDoc(source: string, options: RenderDocOptions): Promise<RenderedDoc>;
+
+declare function routeForFile(srcRelativePath: string): string;
+declare function outFileForRoute(route: string): string;
+declare function discoverPages(srcDir: string): PageEntry[];
+declare function flattenSidebar(items: SidebarItem[]): {
+    text: string;
+    link: string;
+}[];
+declare function sidebarForRoute(route: string, config: SiteConfig): SidebarItem[];
+declare function prevNextForRoute(route: string, config: SiteConfig): {
+    prev?: {
+        text: string;
+        link: string;
+    };
+    next?: {
+        text: string;
+        link: string;
+    };
+};
+
+interface SearchResult {
+    route: string;
+    pageTitle: string;
+    heading: string;
+    slug: string;
+    isPage: boolean;
+    score: number;
+    href: string;
+}
+declare function buildSearchIndex(docs: SearchDocument[]): string;
+declare function queryIndex(serializedIndex: string, query: string, limit?: number): SearchResult[];
+interface SearchWidgetOptions {
+    indexUrl?: string;
+    placeholder?: string;
+    limit?: number;
+}
+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 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 };