npm - @marlinjai/clearify - Versions diffs - 1.5.0 - Mend

@marlinjai/clearify 1.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (80) hide show

package/LICENSE +21 -0
package/README.md +81 -0
package/bin/clearify.js +2 -0
package/dist/node/chunk-5TD7NQIW.js +25 -0
package/dist/node/chunk-B2Q23JW3.js +55 -0
package/dist/node/chunk-CQ4MNGBE.js +301 -0
package/dist/node/chunk-GFD54GNO.js +223 -0
package/dist/node/chunk-IBK35HZR.js +194 -0
package/dist/node/chunk-L24ILRSX.js +125 -0
package/dist/node/chunk-NXQNNLGC.js +395 -0
package/dist/node/chunk-PRTER35L.js +48 -0
package/dist/node/chunk-SCZZB7OE.js +9 -0
package/dist/node/chunk-V7LLYIRO.js +8 -0
package/dist/node/chunk-WT5W333R.js +136 -0
package/dist/node/cli/index.d.ts +2 -0
package/dist/node/cli/index.js +41 -0
package/dist/node/core/config.d.ts +9 -0
package/dist/node/core/config.js +16 -0
package/dist/node/core/mermaid-renderer.d.ts +22 -0
package/dist/node/core/mermaid-renderer.js +125 -0
package/dist/node/core/mermaid-utils.d.ts +3 -0
package/dist/node/core/mermaid-utils.js +6 -0
package/dist/node/core/navigation.d.ts +2 -0
package/dist/node/core/navigation.js +13 -0
package/dist/node/core/openapi-parser.d.ts +14 -0
package/dist/node/core/openapi-parser.js +6 -0
package/dist/node/core/remark-mermaid.d.ts +10 -0
package/dist/node/core/remark-mermaid.js +11 -0
package/dist/node/core/search.d.ts +31 -0
package/dist/node/core/search.js +6 -0
package/dist/node/node/build.d.ts +3 -0
package/dist/node/node/build.js +14 -0
package/dist/node/node/check.d.ts +3 -0
package/dist/node/node/check.js +10 -0
package/dist/node/node/index.d.ts +11 -0
package/dist/node/node/index.js +108 -0
package/dist/node/node/init.d.ts +6 -0
package/dist/node/node/init.js +6 -0
package/dist/node/presets/nestjs.d.ts +15 -0
package/dist/node/presets/nestjs.js +98 -0
package/dist/node/types/index.d.ts +79 -0
package/dist/node/types/index.js +6 -0
package/dist/node/vite-plugin/index.d.ts +13 -0
package/dist/node/vite-plugin/index.js +11 -0
package/package.json +94 -0
package/src/client/App.tsx +101 -0
package/src/client/Page.tsx +15 -0
package/src/client/entry-server.tsx +79 -0
package/src/client/index.html +18 -0
package/src/client/main.tsx +11 -0
package/src/theme/CodeBlock.tsx +103 -0
package/src/theme/Content.tsx +32 -0
package/src/theme/Footer.tsx +53 -0
package/src/theme/Head.tsx +80 -0
package/src/theme/HeadContext.tsx +32 -0
package/src/theme/Header.tsx +177 -0
package/src/theme/Layout.tsx +44 -0
package/src/theme/MDXComponents.tsx +40 -0
package/src/theme/NotFound.tsx +246 -0
package/src/theme/Search.tsx +359 -0
package/src/theme/Sidebar.tsx +325 -0
package/src/theme/TableOfContents.tsx +153 -0
package/src/theme/ThemeProvider.tsx +77 -0
package/src/theme/components/Accordion.tsx +109 -0
package/src/theme/components/Badge.tsx +72 -0
package/src/theme/components/Breadcrumbs.tsx +88 -0
package/src/theme/components/Callout.tsx +115 -0
package/src/theme/components/Card.tsx +103 -0
package/src/theme/components/CodeGroup.tsx +79 -0
package/src/theme/components/Columns.tsx +42 -0
package/src/theme/components/Frame.tsx +55 -0
package/src/theme/components/Mermaid.tsx +99 -0
package/src/theme/components/MermaidStatic.tsx +32 -0
package/src/theme/components/OpenAPI.tsx +160 -0
package/src/theme/components/OpenAPIPage.tsx +16 -0
package/src/theme/components/Steps.tsx +76 -0
package/src/theme/components/Tabs.tsx +75 -0
package/src/theme/components/Tooltip.tsx +108 -0
package/src/theme/components/index.ts +14 -0
package/src/theme/styles/globals.css +363 -0

package/dist/node/core/mermaid-renderer.d.ts ADDED Viewed

@@ -0,0 +1,22 @@
+interface RenderedMermaid {
+    lightSvg: string;
+    darkSvg: string;
+}
+declare class MermaidRenderer {
+    private cacheDir;
+    private browser;
+    private page;
+    constructor(options: {
+        cacheDir: string;
+    });
+    launch(): Promise<void>;
+    render(definition: string): Promise<RenderedMermaid>;
+    renderBatch(definitions: Map<string, string>): Promise<Map<string, RenderedMermaid>>;
+    close(): Promise<void>;
+    private renderWithTheme;
+    private readCache;
+    private writeCache;
+    private static loadPuppeteer;
+}
+export { MermaidRenderer, type RenderedMermaid };

package/dist/node/core/mermaid-renderer.js ADDED Viewed

@@ -0,0 +1,125 @@
+import {
+  mermaidContentHash
+} from "../chunk-SCZZB7OE.js";
+// src/core/mermaid-renderer.ts
+import { resolve } from "path";
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
+var MermaidRenderer = class _MermaidRenderer {
+  cacheDir;
+  browser = null;
+  page = null;
+  constructor(options) {
+    this.cacheDir = options.cacheDir;
+    mkdirSync(this.cacheDir, { recursive: true });
+  }
+  async launch() {
+    const puppeteer = await _MermaidRenderer.loadPuppeteer();
+    this.browser = await puppeteer.launch({ headless: true, args: ["--no-sandbox"] });
+    this.page = await this.browser.newPage();
+    await this.page.setContent(`
+      <!DOCTYPE html>
+      <html><head></head><body>
+        <div id="container"></div>
+        <script type="module">
+          import mermaid from 'https://cdn.jsdelivr.net/npm/mermaid@11/dist/mermaid.esm.min.mjs';
+          window.__mermaid = mermaid;
+          window.__mermaidReady = true;
+        </script>
+      </body></html>
+    `);
+    await this.page.waitForFunction("window.__mermaidReady === true", { timeout: 3e4 });
+  }
+  async render(definition) {
+    const hash = mermaidContentHash(definition);
+    const cached = this.readCache(hash);
+    if (cached) return cached;
+    if (!this.page) {
+      throw new Error("MermaidRenderer not launched. Call launch() first.");
+    }
+    const lightSvg = await this.renderWithTheme(definition, "default", `light-${hash}`);
+    const darkSvg = await this.renderWithTheme(definition, "dark", `dark-${hash}`);
+    const result = { lightSvg, darkSvg };
+    this.writeCache(hash, result);
+    return result;
+  }
+  async renderBatch(definitions) {
+    const results = /* @__PURE__ */ new Map();
+    const uncached = /* @__PURE__ */ new Map();
+    for (const [hash, definition] of definitions) {
+      const cached = this.readCache(hash);
+      if (cached) {
+        results.set(hash, cached);
+      } else {
+        uncached.set(hash, definition);
+      }
+    }
+    if (uncached.size === 0) return results;
+    if (!this.page) {
+      throw new Error("MermaidRenderer not launched. Call launch() first.");
+    }
+    for (const [hash, definition] of uncached) {
+      try {
+        const lightSvg = await this.renderWithTheme(definition, "default", `light-${hash}`);
+        const darkSvg = await this.renderWithTheme(definition, "dark", `dark-${hash}`);
+        const result = { lightSvg, darkSvg };
+        this.writeCache(hash, result);
+        results.set(hash, result);
+      } catch (err) {
+        console.warn(`  Warning: Failed to render mermaid diagram (${hash}):`, err instanceof Error ? err.message : err);
+      }
+    }
+    return results;
+  }
+  async close() {
+    if (this.browser) {
+      await this.browser.close();
+      this.browser = null;
+      this.page = null;
+    }
+  }
+  async renderWithTheme(definition, theme, id) {
+    return await this.page.evaluate(
+      async (def, thm, diagId) => {
+        const mermaid = window.__mermaid;
+        mermaid.initialize({ startOnLoad: false, theme: thm, securityLevel: "loose" });
+        const { svg } = await mermaid.render(diagId, def);
+        return svg;
+      },
+      definition,
+      theme,
+      id
+    );
+  }
+  readCache(hash) {
+    const cachePath = resolve(this.cacheDir, `${hash}.json`);
+    if (existsSync(cachePath)) {
+      try {
+        return JSON.parse(readFileSync(cachePath, "utf-8"));
+      } catch {
+        return null;
+      }
+    }
+    return null;
+  }
+  writeCache(hash, data) {
+    const cachePath = resolve(this.cacheDir, `${hash}.json`);
+    writeFileSync(cachePath, JSON.stringify(data));
+  }
+  static async loadPuppeteer() {
+    try {
+      const moduleName = "puppeteer";
+      return await import(
+        /* @vite-ignore */
+        moduleName
+      );
+    } catch {
+      throw new Error(
+        'Puppeteer is required for mermaid build-time rendering.\nInstall it with: npm install puppeteer\nOr set mermaid.strategy to "client" in your clearify config.'
+      );
+    }
+  }
+};
+export {
+  MermaidRenderer
+};

package/dist/node/core/mermaid-utils.d.ts ADDED Viewed

@@ -0,0 +1,3 @@
+declare function mermaidContentHash(definition: string): string;
+export { mermaidContentHash };

package/dist/node/core/mermaid-utils.js ADDED Viewed

@@ -0,0 +1,6 @@
+import {
+  mermaidContentHash
+} from "../chunk-SCZZB7OE.js";
+export {
+  mermaidContentHash
+};

package/dist/node/core/navigation.d.ts ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ import '../types/index.js';
2	+ export { D as DocFile, S as SectionData, b as buildNavigation, a as buildRoutes, c as buildSectionData, s as scanDocs } from './search.js';

package/dist/node/core/navigation.js ADDED Viewed

@@ -0,0 +1,13 @@
+import {
+  buildNavigation,
+  buildRoutes,
+  buildSectionData,
+  scanDocs
+} from "../chunk-L24ILRSX.js";
+import "../chunk-5TD7NQIW.js";
+export {
+  buildNavigation,
+  buildRoutes,
+  buildSectionData,
+  scanDocs
+};

package/dist/node/core/openapi-parser.d.ts ADDED Viewed

@@ -0,0 +1,14 @@
+interface OpenAPIOperation {
+    method: string;
+    path: string;
+    summary: string;
+    operationId?: string;
+}
+interface OpenAPITagGroup {
+    tag: string;
+    description?: string;
+    operations: OpenAPIOperation[];
+}
+declare function parseOpenAPISpec(spec: Record<string, any>): OpenAPITagGroup[];
+export { type OpenAPIOperation, type OpenAPITagGroup, parseOpenAPISpec };

package/dist/node/core/openapi-parser.js ADDED Viewed

@@ -0,0 +1,6 @@
+import {
+  parseOpenAPISpec
+} from "../chunk-B2Q23JW3.js";
+export {
+  parseOpenAPISpec
+};

package/dist/node/core/remark-mermaid.d.ts ADDED Viewed

@@ -0,0 +1,10 @@
+import { Root } from 'mdast';
+declare function setPreRenderedMermaidSvgs(svgs: Map<string, {
+    lightSvg: string;
+    darkSvg: string;
+}>): void;
+declare function clearPreRenderedMermaidSvgs(): void;
+declare function remarkMermaidToComponent(): (tree: Root) => void;
+export { clearPreRenderedMermaidSvgs, remarkMermaidToComponent, setPreRenderedMermaidSvgs };

package/dist/node/core/remark-mermaid.js ADDED Viewed

@@ -0,0 +1,11 @@
+import {
+  clearPreRenderedMermaidSvgs,
+  remarkMermaidToComponent,
+  setPreRenderedMermaidSvgs
+} from "../chunk-PRTER35L.js";
+import "../chunk-SCZZB7OE.js";
+export {
+  clearPreRenderedMermaidSvgs,
+  remarkMermaidToComponent,
+  setPreRenderedMermaidSvgs
+};

package/dist/node/core/search.d.ts ADDED Viewed

@@ -0,0 +1,31 @@
+import { PageFrontmatter, ResolvedSection, SectionNavigation, RouteEntry, NavigationItem } from '../types/index.js';
+interface SearchEntry {
+    id: number;
+    path: string;
+    title: string;
+    description: string;
+    content: string;
+    sectionId?: string;
+    sectionLabel?: string;
+}
+declare function buildSearchIndex(docs: DocFile[], sectionId?: string, sectionLabel?: string): SearchEntry[];
+interface DocFile {
+    filePath: string;
+    routePath: string;
+    frontmatter: PageFrontmatter;
+}
+declare function scanDocs(docsDir: string, exclude?: string[], basePath?: string): DocFile[];
+declare function buildNavigation(docs: DocFile[], basePath?: string): NavigationItem[];
+declare function buildRoutes(docs: DocFile[], sectionId?: string): RouteEntry[];
+interface SectionData {
+    section: ResolvedSection;
+    docs: DocFile[];
+    navigation: SectionNavigation;
+    routes: RouteEntry[];
+    searchEntries: SearchEntry[];
+}
+declare function buildSectionData(section: ResolvedSection, changelogPath?: string, customNavigation?: NavigationItem[] | null): SectionData;
+export { type DocFile as D, type SectionData as S, type SearchEntry, buildRoutes as a, buildNavigation as b, buildSearchIndex, buildSectionData as c, scanDocs as s };

package/dist/node/core/search.js ADDED Viewed

@@ -0,0 +1,6 @@
+import {
+  buildSearchIndex
+} from "../chunk-5TD7NQIW.js";
+export {
+  buildSearchIndex
+};

package/dist/node/node/build.d.ts ADDED Viewed

@@ -0,0 +1,3 @@
+declare function buildSite(): Promise<void>;
+export { buildSite };

package/dist/node/node/build.js ADDED Viewed

@@ -0,0 +1,14 @@
+import {
+  buildSite
+} from "../chunk-CQ4MNGBE.js";
+import "../chunk-PRTER35L.js";
+import "../chunk-SCZZB7OE.js";
+import "../chunk-NXQNNLGC.js";
+import "../chunk-B2Q23JW3.js";
+import "../chunk-IBK35HZR.js";
+import "../chunk-V7LLYIRO.js";
+import "../chunk-L24ILRSX.js";
+import "../chunk-5TD7NQIW.js";
+export {
+  buildSite
+};

package/dist/node/node/check.d.ts ADDED Viewed

@@ -0,0 +1,3 @@
+declare function checkLinks(): Promise<void>;
+export { checkLinks };

package/dist/node/node/check.js ADDED Viewed

@@ -0,0 +1,10 @@
+import {
+  checkLinks
+} from "../chunk-WT5W333R.js";
+import "../chunk-IBK35HZR.js";
+import "../chunk-V7LLYIRO.js";
+import "../chunk-L24ILRSX.js";
+import "../chunk-5TD7NQIW.js";
+export {
+  checkLinks
+};

package/dist/node/node/index.d.ts ADDED Viewed

@@ -0,0 +1,11 @@
+import * as vite from 'vite';
+export { buildSite as build } from './build.js';
+export { init } from './init.js';
+export { checkLinks } from './check.js';
+declare function createServer(options?: {
+    port?: number;
+    host?: boolean;
+}): Promise<vite.ViteDevServer>;
+export { createServer };

package/dist/node/node/index.js ADDED Viewed

@@ -0,0 +1,108 @@
+import {
+  buildSite
+} from "../chunk-CQ4MNGBE.js";
+import {
+  remarkMermaidToComponent
+} from "../chunk-PRTER35L.js";
+import "../chunk-SCZZB7OE.js";
+import {
+  clearifyPlugin
+} from "../chunk-NXQNNLGC.js";
+import "../chunk-B2Q23JW3.js";
+import {
+  init
+} from "../chunk-GFD54GNO.js";
+import {
+  checkLinks
+} from "../chunk-WT5W333R.js";
+import {
+  loadUserConfig,
+  resolveConfig
+} from "../chunk-IBK35HZR.js";
+import "../chunk-V7LLYIRO.js";
+import "../chunk-L24ILRSX.js";
+import "../chunk-5TD7NQIW.js";
+// src/node/index.ts
+import { createServer as createViteServer } from "vite";
+import react from "@vitejs/plugin-react";
+import mdx from "@mdx-js/rollup";
+import remarkGfm from "remark-gfm";
+import remarkFrontmatter from "remark-frontmatter";
+import remarkMdxFrontmatter from "remark-mdx-frontmatter";
+import rehypeShiki from "@shikijs/rehype";
+import { resolve } from "path";
+import { fileURLToPath } from "url";
+import tailwindcss from "@tailwindcss/vite";
+import { existsSync } from "fs";
+function findPackageRoot() {
+  let dir = fileURLToPath(new URL(".", import.meta.url));
+  for (let i = 0; i < 10; i++) {
+    if (existsSync(resolve(dir, "package.json"))) return dir;
+    const parent = resolve(dir, "..");
+    if (parent === dir) break;
+    dir = parent;
+  }
+  return process.cwd();
+}
+function resolveClientPath(...segments) {
+  const packageRoot = findPackageRoot();
+  return resolve(packageRoot, "src", "client", ...segments);
+}
+function createDevConfig(overrides = {}) {
+  const root = resolveClientPath();
+  const { userRoot, mermaidStrategy, ...viteOverrides } = overrides;
+  return {
+    root,
+    plugins: [
+      tailwindcss(),
+      ...clearifyPlugin({
+        root: userRoot ?? process.cwd(),
+        mermaidStrategy
+      }),
+      { enforce: "pre", ...mdx({
+        providerImportSource: "@mdx-js/react",
+        remarkPlugins: [remarkMermaidToComponent, remarkGfm, remarkFrontmatter, [remarkMdxFrontmatter, { name: "frontmatter" }]],
+        rehypePlugins: [
+          [rehypeShiki, {
+            themes: { light: "github-light", dark: "github-dark" },
+            defaultColor: false
+          }]
+        ]
+      }) },
+      react({ include: /\.(jsx|tsx|md|mdx)$/ })
+    ],
+    server: {
+      port: 4747,
+      ...viteOverrides.server
+    },
+    resolve: {
+      alias: {
+        "@clearify": resolve(root, "..")
+      }
+    },
+    ...viteOverrides
+  };
+}
+async function createServer(options = {}) {
+  const userRoot = process.cwd();
+  const userConfig = await loadUserConfig(userRoot);
+  const siteConfig = resolveConfig(userConfig, userRoot);
+  const mermaidStrategy = siteConfig.mermaid?.strategy ?? "client";
+  const config = createDevConfig({
+    userRoot,
+    mermaidStrategy,
+    server: {
+      port: options.port ?? siteConfig.port,
+      host: options.host
+    }
+  });
+  const server = await createViteServer(config);
+  return server;
+}
+export {
+  buildSite as build,
+  checkLinks,
+  createServer,
+  init
+};

package/dist/node/node/init.d.ts ADDED Viewed

@@ -0,0 +1,6 @@
+interface InitOptions {
+    noInternal?: boolean;
+}
+declare function init(options?: InitOptions): Promise<void>;
+export { type InitOptions, init };

package/dist/node/node/init.js ADDED Viewed

@@ -0,0 +1,6 @@
+import {
+  init
+} from "../chunk-GFD54GNO.js";
+export {
+  init
+};

package/dist/node/presets/nestjs.d.ts ADDED Viewed

@@ -0,0 +1,15 @@
+interface NestJSPresetOptions {
+    /** Path to the NestJS app module (default: './src/app.module.ts') */
+    appModule?: string;
+    /** Output path for the generated spec (default: './docs/openapi.json') */
+    output?: string;
+    /** Swagger document title */
+    title?: string;
+    /** Swagger document description */
+    description?: string;
+    /** API version */
+    version?: string;
+}
+declare function generateSpec(options?: NestJSPresetOptions): Promise<void>;
+export { type NestJSPresetOptions, generateSpec };

package/dist/node/presets/nestjs.js ADDED Viewed

@@ -0,0 +1,98 @@
+// src/presets/nestjs.ts
+import { resolve } from "path";
+import { pathToFileURL } from "url";
+import { writeFileSync, mkdirSync, rmSync } from "fs";
+import { dirname } from "path";
+import { tmpdir } from "os";
+import { randomBytes } from "crypto";
+async function bundleModule(entryPoint) {
+  const { build } = await import("esbuild");
+  const tmpId = randomBytes(4).toString("hex");
+  const outFile = resolve(tmpdir(), `clearify-nestjs-${tmpId}.mjs`);
+  try {
+    await build({
+      entryPoints: [entryPoint],
+      outfile: outFile,
+      bundle: true,
+      format: "esm",
+      platform: "node",
+      write: true,
+      // Keep NestJS packages external — they're loaded from node_modules at runtime
+      external: ["@nestjs/*", "reflect-metadata", "class-transformer", "class-validator", "rxjs", "rxjs/*"]
+    });
+    return await import(pathToFileURL(outFile).href);
+  } finally {
+    try {
+      rmSync(outFile, { force: true });
+    } catch {
+    }
+  }
+}
+async function generateSpec(options = {}) {
+  const {
+    appModule = "./src/app.module.ts",
+    output = "./docs/openapi.json",
+    title = "API Documentation",
+    description = "",
+    version = "1.0.0"
+  } = options;
+  let NestFactory;
+  let SwaggerModule;
+  let DocumentBuilder;
+  const nestCorePkg = "@nestjs/core";
+  const swaggerPkg = "@nestjs/swagger";
+  try {
+    const nestCore = await import(
+      /* @vite-ignore */
+      nestCorePkg
+    );
+    NestFactory = nestCore.NestFactory;
+  } catch {
+    throw new Error(
+      "@nestjs/core is not installed. Install it to use the NestJS preset:\n  npm install @nestjs/core @nestjs/common"
+    );
+  }
+  try {
+    const swagger = await import(
+      /* @vite-ignore */
+      swaggerPkg
+    );
+    SwaggerModule = swagger.SwaggerModule;
+    DocumentBuilder = swagger.DocumentBuilder;
+  } catch {
+    throw new Error(
+      "@nestjs/swagger is not installed. Install it to generate OpenAPI specs:\n  npm install @nestjs/swagger"
+    );
+  }
+  const modulePath = resolve(process.cwd(), appModule);
+  let AppModule;
+  try {
+    const mod = modulePath.endsWith(".ts") || modulePath.endsWith(".tsx") ? await bundleModule(modulePath) : await import(
+      /* @vite-ignore */
+      pathToFileURL(modulePath).href
+    );
+    AppModule = mod.AppModule ?? mod.default;
+  } catch (err) {
+    throw new Error(
+      `Failed to import NestJS app module from "${modulePath}":
+  ${err instanceof Error ? err.message : err}`
+    );
+  }
+  if (!AppModule) {
+    throw new Error(`No AppModule export found in "${modulePath}"`);
+  }
+  const app = await NestFactory.create(AppModule, { logger: false });
+  try {
+    const config = new DocumentBuilder().setTitle(title).setDescription(description).setVersion(version).build();
+    const document = SwaggerModule.createDocument(app, config);
+    const outputPath = resolve(process.cwd(), output);
+    mkdirSync(dirname(outputPath), { recursive: true });
+    writeFileSync(outputPath, JSON.stringify(document, null, 2));
+    console.log(`  OpenAPI spec written to ${output}`);
+  } finally {
+    await app.close();
+  }
+}
+export {
+  generateSpec
+};

package/dist/node/types/index.d.ts ADDED Viewed

@@ -0,0 +1,79 @@
+interface SectionConfig {
+    label: string;
+    docsDir: string;
+    basePath?: string;
+    draft?: boolean;
+    sitemap?: boolean;
+    exclude?: string[];
+}
+interface ResolvedSection {
+    id: string;
+    label: string;
+    docsDir: string;
+    basePath: string;
+    draft: boolean;
+    sitemap: boolean;
+    exclude: string[];
+}
+interface SectionNavigation {
+    id: string;
+    label: string;
+    basePath: string;
+    navigation: NavigationItem[];
+}
+interface ClearifyConfig {
+    name: string;
+    docsDir: string;
+    outDir: string;
+    port: number;
+    siteUrl?: string;
+    sections?: SectionConfig[];
+    theme: {
+        primaryColor: string;
+        mode: 'light' | 'dark' | 'auto';
+    };
+    logo?: {
+        light?: string;
+        dark?: string;
+    };
+    navigation?: NavigationItem[] | null;
+    exclude?: string[];
+    mermaid?: {
+        strategy?: 'client' | 'build';
+    };
+    openapi?: {
+        spec: string;
+        basePath?: string;
+        generatePages?: boolean;
+    };
+    links?: {
+        github?: string;
+        [key: string]: string | undefined;
+    };
+    customCss?: string;
+    headTags?: string[];
+}
+interface NavigationItem {
+    label: string;
+    path?: string;
+    icon?: string;
+    badge?: string;
+    badgeColor?: string;
+    children?: NavigationItem[];
+}
+interface PageFrontmatter {
+    title?: string;
+    description?: string;
+    icon?: string;
+    order?: number;
+}
+interface RouteEntry {
+    path: string;
+    filePath: string;
+    frontmatter: PageFrontmatter;
+    sectionId?: string;
+    componentPath?: string;
+}
+declare function defineConfig(config: Partial<ClearifyConfig>): Partial<ClearifyConfig>;
+export { type ClearifyConfig, type NavigationItem, type PageFrontmatter, type ResolvedSection, type RouteEntry, type SectionConfig, type SectionNavigation, defineConfig };

package/dist/node/types/index.js ADDED Viewed

@@ -0,0 +1,6 @@
+import {
+  defineConfig
+} from "../chunk-V7LLYIRO.js";
+export {
+  defineConfig
+};

package/dist/node/vite-plugin/index.d.ts ADDED Viewed

@@ -0,0 +1,13 @@
+import { Plugin } from 'vite';
+interface ClearifyPluginOptions {
+    root?: string;
+    mermaidSvgs?: Record<string, {
+        lightSvg: string;
+        darkSvg: string;
+    }>;
+    mermaidStrategy?: 'client' | 'build';
+}
+declare function clearifyPlugin(options?: ClearifyPluginOptions): Plugin[];
+export { clearifyPlugin };

package/dist/node/vite-plugin/index.js ADDED Viewed

@@ -0,0 +1,11 @@
+import {
+  clearifyPlugin
+} from "../chunk-NXQNNLGC.js";
+import "../chunk-B2Q23JW3.js";
+import "../chunk-IBK35HZR.js";
+import "../chunk-V7LLYIRO.js";
+import "../chunk-L24ILRSX.js";
+import "../chunk-5TD7NQIW.js";
+export {
+  clearifyPlugin
+};