npm - @docubook/flame - Versions diffs - 1.4.4 → 1.5.1 - Mend

@docubook/flame 1.4.4 → 1.5.1

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 (53) hide show

package/.docu/lib/build.deno.js +11 -0
package/.docu/lib/build.impl-7KJ4ZTAJ.js +12 -0
package/.docu/lib/build.node.js +10 -0
package/.docu/lib/chunk-7ZEUL6PR.js +383 -0
package/.docu/lib/chunk-AI7QAMMZ.js +2410 -0
package/.docu/lib/chunk-E4OIJWCU.js +368 -0
package/.docu/lib/chunk-IR5TVJOV.js +79 -0
package/.docu/lib/chunk-J5NMYSBJ.js +59 -0
package/.docu/lib/chunk-PTRZ2S2C.js +298 -0
package/.docu/lib/chunk-RE4NGTMT.js +185 -0
package/.docu/lib/chunk-TE52TIEW.js +92 -0
package/.docu/lib/clean.js +32 -0
package/.docu/lib/deploy.deno.js +13 -0
package/.docu/lib/deploy.node.js +10 -0
package/.docu/lib/preview.deno.js +10 -0
package/.docu/lib/preview.node.js +10 -0
package/.docu/lib/server.deno.js +11 -0
package/.docu/lib/server.node.js +11 -0
package/.docu/node/build.deno.ts +7 -0
package/.docu/node/build.impl.ts +416 -0
package/.docu/node/build.node.ts +3 -0
package/.docu/node/deploy.deno.ts +11 -0
package/.docu/node/deploy.node.ts +6 -0
package/.docu/node/deploy.shared.ts +85 -0
package/.docu/node/deploy.ts +11 -0
package/.docu/node/escapeHtml.ts +18 -0
package/.docu/node/git.ts +79 -0
package/.docu/node/html.shared.ts +110 -0
package/.docu/node/hydrate.node.ts +276 -0
package/.docu/node/hydrate.ts +17 -31
package/.docu/node/mdx.ts +1 -1
package/.docu/node/paths.ts +24 -0
package/.docu/node/plugin-builder.ts +6 -2
package/.docu/node/plugin.ts +11 -2
package/.docu/node/preview.deno.ts +4 -0
package/.docu/node/preview.impl.ts +96 -0
package/.docu/node/preview.node.ts +4 -0
package/.docu/node/security.ts +5 -0
package/.docu/node/server-routes.ts +4 -4
package/.docu/node/server.deno.ts +4 -0
package/.docu/node/server.impl.ts +184 -0
package/.docu/node/server.node.ts +4 -0
package/.docu/styles/globals.css +20 -5
package/README.md +57 -506
package/bin/cli.js +99 -14
package/bin/compile-lib.mjs +67 -0
package/package.json +9 -7
package/template/docs/getting-started/configuration.mdx +18 -0
package/template/docs/getting-started/overview.mdx +50 -0
package/template/docs/guide/deployment.mdx +27 -0
package/template/docs/guide/routing.mdx +25 -0
package/template/docs/index.mdx +8 -205
package/template/docu.json +32 -1

package/.docu/lib/chunk-AI7QAMMZ.js ADDED Viewed

@@ -0,0 +1,2410 @@
+import {
+  cn,
+  docsHtmlHref,
+  formatDate2,
+  isExternalUrl,
+  normalizeImporterPath,
+  scanMdxFiles
+} from "./chunk-RE4NGTMT.js";
+import {
+  ASSETS_DIR,
+  DOCS_DIR,
+  FRAMEWORK_ROOT,
+  LIB_DIR,
+  PROJECT_ROOT,
+  STYLES_DIR,
+  cleanOldBundles,
+  loadDocuConfig
+} from "./chunk-J5NMYSBJ.js";
+// .docu/node/plugin-loader.ts
+import { resolve } from "node:path";
+var NPM_PACKAGE_RE = /^(?:@[a-z0-9-~][a-z0-9-._~]*\/)?[a-z0-9-~][a-z0-9-._~]*$/;
+function resolveSpecifier(specifier) {
+  let resolved;
+  if (specifier.startsWith(".")) {
+    resolved = resolve(PROJECT_ROOT, specifier);
+  } else if (specifier.startsWith("/")) {
+    resolved = specifier;
+  } else {
+    if (!NPM_PACKAGE_RE.test(specifier)) {
+      throw new Error(
+        `[plugin-loader] Invalid plugin specifier "${specifier}": must be a valid npm package name, relative path, or absolute path`
+      );
+    }
+    return specifier;
+  }
+  const root = PROJECT_ROOT.endsWith("/") ? PROJECT_ROOT : PROJECT_ROOT + "/";
+  if (!resolved.startsWith(root)) {
+    throw new Error(
+      `[plugin-loader] Path traversal blocked: "${specifier}" resolves outside project root`
+    );
+  }
+  return resolved;
+}
+async function loadPlugins(entries = []) {
+  const plugins = [];
+  for (const entry of entries) {
+    const [specifier, options] = Array.isArray(entry) ? entry : [entry, void 0];
+    const resolved = resolveSpecifier(specifier);
+    let mod;
+    try {
+      mod = await import(resolved);
+    } catch (err) {
+      const message = err instanceof Error ? err.message : String(err);
+      throw new Error(`[plugin-loader] Failed to import plugin "${specifier}": ${message}`, {
+        cause: err
+      });
+    }
+    const exported = mod.default;
+    let plugin;
+    if (typeof exported === "function") {
+      try {
+        plugin = exported(options);
+      } catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        throw new Error(
+          `[plugin-loader] Plugin factory "${specifier}" threw during initialization: ${message}`,
+          { cause: err }
+        );
+      }
+    } else if (exported && typeof exported === "object") {
+      plugin = exported;
+    } else {
+      throw new Error(
+        `[plugin-loader] Plugin "${specifier}" must export a default function or object. Got: ${typeof exported}`
+      );
+    }
+    if (!plugin.name || typeof plugin.name !== "string") {
+      throw new Error(
+        `[plugin-loader] Plugin "${specifier}" must have a valid 'name' property (string). Got: ${typeof plugin.name}`
+      );
+    }
+    if (typeof plugin.setup !== "function") {
+      throw new Error(
+        `[plugin-loader] Plugin "${specifier}" (name: "${plugin.name}") must have a 'setup(build)' function.`
+      );
+    }
+    plugins.push(plugin);
+  }
+  return plugins;
+}
+// .docu/node/plugin-builder.ts
+var BuildPluginBuilder = class {
+  config;
+  _handleRequest = [];
+  _injectBody = [];
+  _injectHead = [];
+  _onEnd = [];
+  _onLoad = [];
+  _onStart = [];
+  _rehypePlugins = [];
+  _remarkPlugins = [];
+  _transformFrontmatter = [];
+  _transformHtml = [];
+  constructor(config3) {
+    this.config = config3;
+  }
+  /**
+   * Collect and deduplicate all `<body>` injection snippets from registered plugins.
+   * Each callback is executed in registration order; plugin errors are wrapped
+   * with a descriptive message.
+   *
+   * @param context - Current page context passed to each injectBody callback.
+   * @returns Deduplicated array of HTML strings to inject before `</body>`.
+   * @throws Error if any injectBody callback throws — wraps original error as cause.
+   */
+  collectBody(context) {
+    const items = [];
+    for (const cb of this._injectBody) {
+      try {
+        const result = cb(context);
+        if (result) {
+          this.collectItems(items, result, "injectBody");
+        }
+      } catch (err) {
+        throw new Error(
+          `[plugin] injectBody callback failed: ${err instanceof Error ? err.message : String(err)}`,
+          { cause: err }
+        );
+      }
+    }
+    return [...new Set(items)];
+  }
+  /**
+   * Collect and deduplicate all `<head>` injection snippets from registered plugins.
+   * Each callback is executed in registration order; plugin errors are wrapped
+   * with a descriptive message.
+   *
+   * @param context - Current page context passed to each injectHead callback.
+   * @returns Deduplicated array of HTML strings to inject before `</head>`.
+   * @throws Error if any injectHead callback throws — wraps original error as cause.
+   */
+  collectHead(context) {
+    const items = [];
+    for (const cb of this._injectHead) {
+      try {
+        const result = cb(context);
+        if (result) {
+          this.collectItems(items, result, "injectHead");
+        }
+      } catch (err) {
+        throw new Error(
+          `[plugin] injectHead callback failed: ${err instanceof Error ? err.message : String(err)}`,
+          { cause: err }
+        );
+      }
+    }
+    return [...new Set(items)];
+  }
+  /**
+   * Collect all rehype plugin arrays from registered rehypePlugins callbacks.
+   * Results from all plugins are flattened into a single array.
+   *
+   * @returns Flattened array of rehype plugin instances applied after default set.
+   * @throws Error if any rehypePlugins callback throws — wraps original error as cause.
+   */
+  collectRehypePlugins() {
+    const plugins = [];
+    for (const cb of this._rehypePlugins) {
+      try {
+        plugins.push(...cb());
+      } catch (err) {
+        throw new Error(
+          `[plugin] rehypePlugins callback failed: ${err instanceof Error ? err.message : String(err)}`,
+          { cause: err }
+        );
+      }
+    }
+    return plugins;
+  }
+  /**
+   * Collect all remark plugin arrays from registered remarkPlugins callbacks.
+   * Results from all plugins are flattened into a single array.
+   *
+   * @returns Flattened array of remark plugin instances applied after default set.
+   * @throws Error if any remarkPlugins callback throws — wraps original error as cause.
+   */
+  collectRemarkPlugins() {
+    const plugins = [];
+    for (const cb of this._remarkPlugins) {
+      try {
+        plugins.push(...cb());
+      } catch (err) {
+        throw new Error(
+          `[plugin] remarkPlugins callback failed: ${err instanceof Error ? err.message : String(err)}`,
+          { cause: err }
+        );
+      }
+    }
+    return plugins;
+  }
+  /**
+   * Register a callback to intercept incoming requests during development.
+   * The **first** callback to return a `Response` short-circuits all subsequent handlers.
+   * Errors inside callbacks are caught and logged — execution continues to next handler.
+   *
+   * @param callback - Receives the Request and dev server context. Return Response or void.
+   *
+   * @example
+   * build.handleRequest((req, ctx) => {
+   *   if (new URL(req.url).pathname === "/api/status") {
+   *     return new Response(JSON.stringify({ ok: true }), {
+   *       headers: { "Content-Type": "application/json" },
+   *     });
+   *   }
+   * });
+   */
+  handleRequest(callback) {
+    this._handleRequest.push(callback);
+  }
+  /**
+   * Register a callback that returns HTML strings to inject before `</body>`.
+   * Results from all plugins are merged, deduplicated, and served via `collectBody()`.
+   *
+   * @param callback - Returns a single HTML string or an array. Called once per page.
+   *
+   * @example
+   * build.injectBody(() => `<div id="chat-widget"></div>`);
+   */
+  injectBody(callback) {
+    this._injectBody.push(callback);
+  }
+  /**
+   * Register a callback that returns HTML strings to inject inside `<head>`.
+   * Results from all plugins are merged, deduplicated, and served via `collectHead()`.
+   *
+   * @param callback - Returns a single HTML string or an array. Called once per page.
+   *
+   * @example
+   * build.injectHead(() => `<script async src="https://cdn.example.com/analytics.js"></script>`);
+   */
+  injectHead(callback) {
+    this._injectHead.push(callback);
+  }
+  /**
+   * Register a callback to run once after all pages are built.
+   * Receives the resolved config and aggregated page metadata.
+   * Errors thrown by the callback propagate to the caller via `runOnEnd()`.
+   *
+   * @param callback - Receives config and page metadata array. May return a Promise.
+   *
+   * @example
+   * build.onEnd(async (config, pages) => {
+   *   const xml = generateSitemap(pages, config.meta.baseURL);
+   *   const out = ".docu/dist/sitemap.xml";
+   *   // Bun.write on Bun for speed, writeFile on Node/Deno
+   *   await (typeof Bun !== "undefined"
+   *     ? Bun.write(out, xml)
+   *     : writeFile(out, xml));
+   * });
+   */
+  onEnd(callback) {
+    this._onEnd.push(callback);
+  }
+  /**
+   * Register a callback to transform raw file content before MDX compilation.
+   * Filtered by regex against the file's relative path — only the **first** matching
+   * handler's result is used.
+   * Errors thrown by the callback propagate to the caller via `runOnLoad()`.
+   *
+   * @param args.filter - RegExp matched against the file's relative path.
+   * @param args.namespace - Optional namespace prefix (reserved for future use).
+   * @param callback - Receives file path and raw content. Return new contents or void.
+   *
+   * @example
+   * build.onLoad({ filter: /\.md$/ }, ({ path, content }) => {
+   *   return { contents: `<!-- preprocessed -->\n${content}`, loader: "mdx" };
+   * });
+   */
+  onLoad(args, callback) {
+    this._onLoad.push({ ...args, fn: callback });
+  }
+  /**
+   * Register a callback to run once before the build starts.
+   * Receives the resolved DocuConfig for validation or resource initialization.
+   * Errors thrown by the callback propagate to the caller via `runOnStart()`.
+   *
+   * @param callback - Receives the resolved config. May return a Promise.
+   *
+   * @example
+   * build.onStart((config) => {
+   *   if (!config.meta.baseURL) throw new Error("baseURL required");
+   * });
+   */
+  onStart(callback) {
+    this._onStart.push(callback);
+  }
+  /**
+   * Register additional rehype (HTML) plugins for the MDX compilation pipeline.
+   * Results from all plugins are merged and applied **after** the default set.
+   *
+   * @param callback - Returns an array of rehype plugins.
+   *
+   * @example
+   * build.rehypePlugins(() => [require("rehype-autolink-headings")]);
+   */
+  rehypePlugins(callback) {
+    this._rehypePlugins.push(callback);
+  }
+  /**
+   * Register additional remark (Markdown) plugins for the MDX compilation pipeline.
+   * Results from all plugins are merged and applied **after** the default set.
+   *
+   * @param callback - Returns an array of remark plugins.
+   *
+   * @example
+   * build.remarkPlugins(() => [require("remark-custom-heading-id")]);
+   */
+  remarkPlugins(callback) {
+    this._remarkPlugins.push(callback);
+  }
+  /**
+   * Execute all registered handleRequest callbacks sequentially.
+   * Stops and returns the **first** `Response` returned by any callback.
+   * Errors inside individual callbacks are caught and logged — execution
+   * continues to the next callback without throwing.
+   *
+   * @param req - The incoming HTTP Request.
+   * @param context - Dev server context (port, hostname).
+   * @returns A Response if a callback intercepted the request, or null if none did.
+   */
+  async runHandleRequest(req, context) {
+    for (let i = 0; i < this._handleRequest.length; i++) {
+      try {
+        const result = await this._handleRequest[i](req, context);
+        if (result instanceof Response) {
+          return result;
+        }
+      } catch (err) {
+        console.error(
+          `[plugin] handleRequest callback #${i + 1} error: ${err instanceof Error ? err.message : String(err)}`
+        );
+      }
+    }
+    return null;
+  }
+  /**
+   * Execute all registered onEnd callbacks sequentially with the resolved
+   * config and aggregated page metadata.
+   * Errors inside individual callbacks are caught and logged — execution
+   * continues to the next callback without throwing.
+   *
+   * @param pages - Array of metadata for every built page.
+   */
+  async runOnEnd(pages) {
+    for (let i = 0; i < this._onEnd.length; i++) {
+      try {
+        await this._onEnd[i](this.config, pages);
+      } catch (err) {
+        console.error(
+          `[plugin] onEnd callback #${i + 1} error: ${err instanceof Error ? err.message : String(err)}`
+        );
+      }
+    }
+  }
+  /**
+   * Execute registered onLoad handlers in registration order against a file.
+   * Only the **first** handler whose `filter` regex matches the path and returns
+   * a result is applied. If a matching handler throws, the error is logged and
+   * subsequent handlers are tried.
+   *
+   * @param path - Relative path of the file being loaded.
+   * @param content - Raw file content.
+   * @returns Transformed content if a matching handler returned it, or null.
+   */
+  async runOnLoad(path, content) {
+    for (const handler of this._onLoad) {
+      if (handler.filter.test(path)) {
+        try {
+          const result = await handler.fn({ path, content });
+          if (result) return result;
+        } catch (err) {
+          console.error(
+            `[plugin] onLoad handler for filter ${handler.filter} error: ${err instanceof Error ? err.message : String(err)}`
+          );
+        }
+      }
+    }
+    return null;
+  }
+  /**
+   * Execute all registered onStart callbacks sequentially.
+   * Each callback receives the resolved DocuConfig.
+   * Errors inside individual callbacks are caught and logged — execution
+   * continues to the next callback without throwing.
+   */
+  async runOnStart() {
+    for (let i = 0; i < this._onStart.length; i++) {
+      try {
+        await this._onStart[i](this.config);
+      } catch (err) {
+        console.error(
+          `[plugin] onStart callback #${i + 1} error: ${err instanceof Error ? err.message : String(err)}`
+        );
+      }
+    }
+  }
+  /**
+   * Execute the transformFrontmatter chain in waterfall pattern.
+   * Each callback receives the **previous** callback's return value (or the
+   * original frontmatter for the first). Callbacks that return `undefined` or
+   * `null` pass the current value through unchanged.
+   * Callbacks that return a non-object (string, number, array) are skipped
+   * with a console warning — only plain objects are accepted.
+   * Errors inside individual callbacks are caught and logged — the current
+   * frontmatter passes through unchanged for that step.
+   *
+   * @param frontmatter - Initial frontmatter object parsed from MDX.
+   * @param context - Page context with slug, filePath, and raw content.
+   * @returns The final transformed frontmatter object.
+   */
+  async runTransformFrontmatterChain(frontmatter, context) {
+    let result = frontmatter;
+    for (let i = 0; i < this._transformFrontmatter.length; i++) {
+      try {
+        const next = await this._transformFrontmatter[i](result, context);
+        if (next !== void 0 && next !== null) {
+          if (typeof next === "object" && !Array.isArray(next)) {
+            result = next;
+          } else {
+            console.warn(
+              `[plugin] transformFrontmatter callback #${i + 1} returned invalid type (expected a plain object), skipping`
+            );
+          }
+        }
+      } catch (err) {
+        console.error(
+          `[plugin] transformFrontmatter callback #${i + 1} error: ${err instanceof Error ? err.message : String(err)}`
+        );
+      }
+    }
+    return result;
+  }
+  /**
+   * Execute the transformHtml chain in pipeline pattern.
+   * Each callback receives the **previous** callback's return value (or the
+   * original HTML for the first). Every callback **must** return a string.
+   * Errors inside individual callbacks are caught and logged — the current
+   * HTML passes through unchanged for that step.
+   *
+   * @param html - The initial HTML string.
+   * @param context - Full page context (slug, filePath, frontmatter, content, config).
+   * @returns The final transformed HTML string.
+   */
+  async runTransformHtmlChain(html, context) {
+    let result = html;
+    for (let i = 0; i < this._transformHtml.length; i++) {
+      try {
+        result = await this._transformHtml[i](result, context);
+      } catch (err) {
+        console.error(
+          `[plugin] transformHtml callback #${i + 1} error: ${err instanceof Error ? err.message : String(err)}`
+        );
+      }
+    }
+    return result;
+  }
+  /**
+   * Register a callback to mutate frontmatter before MDX compilation.
+   * Callbacks are chained in a waterfall: the return value of one is passed
+   * as input to the next. Return `undefined` to pass through unchanged.
+   *
+   * **Note:** Only plain objects are accepted as return values. Returning
+   * a string, number, or array will be silently skipped with a warning.
+   * Plugin authors should validate their return values before returning.
+   *
+   * @param callback - Receives frontmatter object and page context.
+   *
+   * @example
+   * build.transformFrontmatter((fm, ctx) => {
+   *   const wordCount = ctx.content!.split(/\s+/).length;
+   *   return { ...fm, readingTime: `${Math.ceil(wordCount / 200)} min read` };
+   * });
+   */
+  transformFrontmatter(callback) {
+    this._transformFrontmatter.push(callback);
+  }
+  /**
+   * Register a callback to transform the final HTML string per page.
+   * This is the **last** hook before the HTML is written to disk.
+   * Callbacks are chained in a pipeline: each receives the previous callback's output.
+   *
+   * @param callback - Receives HTML string and full page context. Must return HTML.
+   *
+   * @example
+   * build.transformHtml((html, ctx) => {
+   *   return html.replace(/https?:\/\/old-domain\.com\//g, "/");
+   * });
+   */
+  transformHtml(callback) {
+    this._transformHtml.push(callback);
+  }
+  /**
+   * Collect items from a callback result, filtering only valid strings.
+   * Non-string items and unexpected types are logged as warnings.
+   */
+  collectItems(items, result, hookName) {
+    if (Array.isArray(result)) {
+      for (const item of result) {
+        if (typeof item === "string") {
+          items.push(item);
+        } else {
+          console.warn(
+            `[plugin] ${hookName} callback returned non-string item (got ${typeof item}), skipping`
+          );
+        }
+      }
+    } else if (typeof result === "string") {
+      items.push(result);
+    } else {
+      console.warn(
+        `[plugin] ${hookName} callback returned unexpected type (got ${typeof result}), expected string or string[], skipping`
+      );
+    }
+  }
+};
+// .docu/node/hydrate.ts
+import { resolveTheme, generateThemeCss, presetRegistry } from "@docubook/themes-colors";
+// .docu/node/fs-scanner.ts
+import { readdirSync, statSync } from "node:fs";
+import { join, relative, extname, sep } from "node:path";
+function toTitleCase(str) {
+  return str.replace(/-/g, " ").replace(/_/g, " ").replace(/([a-z])([A-Z])/g, "$1 $2").split(" ").map((word) => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase()).join(" ");
+}
+function isDocFile(filename) {
+  const ext = extname(filename).toLowerCase();
+  return [".mdx", ".md"].includes(ext);
+}
+function normalizePath(path) {
+  return path.split(sep).join("/");
+}
+function scanDir(dirPath, docsRoot) {
+  const nodes = [];
+  let entries;
+  try {
+    entries = readdirSync(dirPath).sort();
+  } catch (err) {
+    if (err.code !== "ENOENT") throw err;
+    return nodes;
+  }
+  for (const entry of entries) {
+    if (entry.startsWith(".") || entry === "assets") continue;
+    const absPath = join(dirPath, entry);
+    try {
+      const stat = statSync(absPath);
+      if (stat.isDirectory()) {
+        const children = scanDir(absPath, docsRoot);
+        if (children.length > 0) {
+          nodes.push({
+            name: entry,
+            relPath: normalizePath(relative(docsRoot, absPath)),
+            absPath,
+            isDirectory: true,
+            children
+          });
+        }
+      } else if (stat.isFile() && isDocFile(entry)) {
+        nodes.push({
+          name: entry,
+          relPath: normalizePath(relative(docsRoot, absPath).replace(/\.(mdx|md)$/, "")),
+          absPath,
+          isDirectory: false
+        });
+      }
+    } catch (err) {
+      if (err.code !== "ENOENT") throw err;
+      continue;
+    }
+  }
+  return nodes;
+}
+function fileNodesToRoutes(nodes, parentHref = "") {
+  const routes3 = [];
+  for (const node of nodes) {
+    if (!node.isDirectory) {
+      const baseName = node.name.replace(/\.(mdx|md)$/, "");
+      const isIndexFile = /^(index|readme)$/i.test(baseName);
+      if (isIndexFile) continue;
+      const segment = node.relPath.split("/").pop();
+      const href = `/${segment}`;
+      routes3.push({
+        title: toTitleCase(baseName),
+        href
+      });
+    } else {
+      const dirTitle = toTitleCase(node.name);
+      const segment = node.relPath.split("/").pop();
+      const dirHref = `/${segment}`;
+      const children = fileNodesToRoutes(node.children || [], dirHref);
+      if (children.length === 0) continue;
+      const hasIndexFile = (node.children || []).some(
+        (c) => !c.isDirectory && /^(index|readme)\.(mdx|md)$/i.test(c.name)
+      );
+      if (hasIndexFile) {
+        routes3.push({
+          title: dirTitle,
+          href: dirHref,
+          ...parentHref === "" && {
+            context: { title: dirTitle, icon: "CircleHelp", description: dirTitle }
+          },
+          items: children
+        });
+      } else {
+        routes3.push({
+          title: dirTitle,
+          href: dirHref,
+          noLink: true,
+          ...parentHref === "" && {
+            context: { title: dirTitle, icon: "CircleHelp", description: dirTitle }
+          },
+          items: children
+        });
+      }
+    }
+  }
+  return routes3;
+}
+function scanDocsFolder(docsPath = "./docs") {
+  const absDocsPath = join(process.cwd(), docsPath);
+  const nodes = scanDir(absDocsPath, absDocsPath);
+  return fileNodesToRoutes(nodes);
+}
+function resolveRoutes(docuJsonRoutes) {
+  if (docuJsonRoutes && docuJsonRoutes.length > 0) {
+    return docuJsonRoutes;
+  }
+  return scanDocsFolder();
+}
+// .docu/node/hydrate.ts
+var themeRegistry = presetRegistry;
+function getThemeConfig() {
+  if (process.env.FLAME_THEME) {
+    return process.env.FLAME_THEME;
+  }
+  const config3 = loadDocuConfig();
+  return config3.themes?.colors;
+}
+function buildThemeCss(baseCss, themeConfig) {
+  try {
+    const resolved = resolveTheme(themeConfig, themeRegistry);
+    return baseCss + "\n" + generateThemeCss(resolved);
+  } catch (err) {
+    console.warn(
+      `[flame] Failed to resolve theme CSS: ${err instanceof Error ? err.message : String(err)}`
+    );
+    return baseCss;
+  }
+}
+function computeInlineThemeCss() {
+  try {
+    const themeColors = getThemeConfig();
+    if (themeColors) {
+      const resolved = resolveTheme(themeColors, themeRegistry);
+      return generateThemeCss(resolved);
+    }
+  } catch (err) {
+    console.warn(
+      `[flame] Failed to compute inline theme CSS: ${err instanceof Error ? err.message : String(err)}`
+    );
+  }
+  return void 0;
+}
+// .docu/node/hydrate.node.ts
+import { execFile } from "node:child_process";
+import { builtinModules, createRequire } from "node:module";
+import { basename, dirname, join as join2, resolve as resolve2 } from "node:path";
+import { existsSync, readFileSync, readdirSync as readdirSync2 } from "node:fs";
+import { promisify } from "node:util";
+import { mkdir, readFile, unlink, writeFile } from "node:fs/promises";
+import { createHash } from "node:crypto";
+function extractConfigIcons(config3) {
+  const icons = [];
+  const pushIf = (s) => {
+    if (s) icons.push(s);
+  };
+  config3.home?.hero?.actions?.forEach((a) => pushIf(a.icon));
+  config3.home?.features?.forEach((f) => pushIf(f.icon));
+  (function walk(routes3) {
+    for (const r of routes3) {
+      pushIf(r.context?.icon);
+      if (r.items) walk(r.items);
+    }
+  })(config3.routes ?? []);
+  return [...new Set(icons.filter((n) => /^[A-Z]/.test(n)))];
+}
+var execFileAsync = promisify(execFile);
+function resolveTailwindBin() {
+  const require2 = createRequire(import.meta.url);
+  const pkgPath = require2.resolve("@tailwindcss/cli/package.json");
+  const pkg = require2(pkgPath);
+  const binRel = typeof pkg.bin === "string" ? pkg.bin : pkg.bin.tailwindcss;
+  return join2(dirname(pkgPath), binRel);
+}
+async function runTailwind(outputCss) {
+  const bin = resolveTailwindBin();
+  const twArgs = ["-i", join2(STYLES_DIR, "globals.css"), "-o", outputCss, "--minify"];
+  const isDeno = "Deno" in globalThis;
+  const args = isDeno ? ["run", "-A", bin, ...twArgs] : [bin, ...twArgs];
+  try {
+    await execFileAsync(process.execPath, args, { maxBuffer: 16 * 1024 * 1024 });
+  } catch (err) {
+    const stderr = err.stderr ?? String(err);
+    throw new Error(`Tailwind CSS build failed:
+${stderr}`, { cause: err });
+  }
+}
+var NODE_BUILTINS_RE = new RegExp(
+  `^(node:.*|${builtinModules.map((m) => m.replace(/\//g, "\\/")).join("|")})$`
+);
+var lucideRealEntry;
+function getLucideRealEntry() {
+  if (!lucideRealEntry) {
+    lucideRealEntry = createRequire(import.meta.url).resolve("lucide-react");
+  }
+  return lucideRealEntry;
+}
+var LUCIDE_IMPORT_RE = /import\s*\{([^}]+)\}\s*from\s*["']lucide-react["']/g;
+var LUCIDE_ICON_RE = /^[A-Z]/;
+function scanDirLucideIcons(dir, set) {
+  if (!existsSync(dir)) return;
+  try {
+    const entries = readdirSync2(dir, { withFileTypes: true });
+    for (const e of entries) {
+      const full = join2(dir, e.name);
+      if (e.isDirectory()) {
+        if (e.name !== "node_modules") scanDirLucideIcons(full, set);
+      } else if (/\.(js|ts|tsx)$/.test(e.name)) {
+        const content = readFileSync(full, "utf-8");
+        for (const m of content.matchAll(LUCIDE_IMPORT_RE)) {
+          for (const s of m[1].split(",")) {
+            const name = s.trim().split(/\s+as\s+/)[0].trim();
+            if (LUCIDE_ICON_RE.test(name)) set.add(name);
+          }
+        }
+      }
+    }
+  } catch {
+  }
+}
+function collectAllLucideIcons() {
+  const icons = /* @__PURE__ */ new Set();
+  scanDirLucideIcons(join2(FRAMEWORK_ROOT, ".docu/components"), icons);
+  scanDirLucideIcons(join2(FRAMEWORK_ROOT, ".docu/pages"), icons);
+  const depDirs = [
+    join2(FRAMEWORK_ROOT, "..", "mdx-content", "dist"),
+    join2(FRAMEWORK_ROOT, "..", "ui-react", "dist"),
+    join2(FRAMEWORK_ROOT, "..", "core", "dist"),
+    join2(FRAMEWORK_ROOT, "..", "runt", "dist"),
+    join2(FRAMEWORK_ROOT, "..", "themes-colors", "dist")
+  ];
+  for (const d of depDirs) scanDirLucideIcons(resolve2(d), icons);
+  return [...icons];
+}
+async function buildClientBundle() {
+  await mkdir(ASSETS_DIR, { recursive: true });
+  await cleanOldBundles();
+  const nodeEnv = process.env.NODE_ENV || "development";
+  const esbuild = await import("esbuild");
+  const { build } = esbuild;
+  const entryPath = join2(LIB_DIR, "client.ts");
+  const workingDir = process.cwd();
+  let result;
+  try {
+    result = await build({
+      entryPoints: [entryPath],
+      bundle: true,
+      outdir: ASSETS_DIR,
+      entryNames: "client-[hash]",
+      chunkNames: "chunks/[name]-[hash]",
+      platform: "browser",
+      format: "esm",
+      splitting: true,
+      minify: nodeEnv === "production",
+      define: { "process.env.NODE_ENV": JSON.stringify(nodeEnv) },
+      jsx: "automatic",
+      jsxDev: nodeEnv !== "production",
+      metafile: true,
+      logLevel: "silent",
+      plugins: [
+        {
+          name: "node-builtin-stub",
+          setup(build2) {
+            build2.onResolve({ filter: NODE_BUILTINS_RE }, (args) => ({
+              path: args.path,
+              namespace: "node-stub"
+            }));
+            build2.onLoad({ filter: /.*/, namespace: "node-stub" }, () => ({
+              contents: "module.exports = {};",
+              loader: "js"
+            }));
+          }
+        },
+        {
+          name: "lucide-optimize",
+          setup(build2) {
+            build2.onResolve({ filter: /^lucide-react$/ }, (args) => {
+              if (args.namespace === "lucide-virt") {
+                return { path: getLucideRealEntry(), namespace: "file" };
+              }
+              if (args.importer) {
+                const normalized = normalizeImporterPath(args.importer);
+                if (normalized.endsWith("/.docu/components/Lucide.tsx") || normalized.includes("/mdx-content/dist/")) {
+                  return { path: getLucideRealEntry(), namespace: "file" };
+                }
+              }
+              return { path: args.path, namespace: "lucide-virt" };
+            });
+            build2.onLoad({ filter: /.*/, namespace: "lucide-virt" }, () => {
+              const scanned = collectAllLucideIcons();
+              const configured = extractConfigIcons(loadDocuConfig());
+              const allIcons = [.../* @__PURE__ */ new Set([...scanned, ...configured])];
+              return {
+                contents: `export { ${allIcons.join(", ")} } from "lucide-react";`,
+                loader: "js"
+              };
+            });
+          }
+        },
+        {
+          name: "docu-config",
+          setup(build2) {
+            build2.onResolve({ filter: /docu\.json$/ }, (args) => ({
+              path: args.path,
+              namespace: "docu-config"
+            }));
+            build2.onLoad({ filter: /.*/, namespace: "docu-config" }, () => {
+              const config3 = loadDocuConfig();
+              const resolved = {
+                ...config3,
+                routes: resolveRoutes(config3.routes)
+              };
+              return { contents: JSON.stringify(resolved), loader: "json" };
+            });
+          }
+        }
+      ]
+    });
+  } finally {
+    await esbuild.stop();
+  }
+  const { outputs } = result.metafile;
+  const jsOutput = Object.keys(outputs).find((p) => {
+    const o = outputs[p];
+    return o.entryPoint && resolve2(workingDir, o.entryPoint) === entryPath;
+  });
+  if (!jsOutput) {
+    throw new Error("Client bundle produced no output files");
+  }
+  const jsFile = basename(jsOutput);
+  const tmpCss = join2(ASSETS_DIR, "_tmp.css");
+  await runTailwind(tmpCss);
+  let cssContent = await readFile(tmpCss, "utf-8");
+  try {
+    const themeColors = getThemeConfig();
+    if (themeColors) {
+      cssContent = buildThemeCss(cssContent, themeColors);
+    }
+  } catch (err) {
+    console.warn(
+      `[flame] Failed to resolve theme config, falling back to globals.css only: ${err instanceof Error ? err.message : String(err)}`
+    );
+  }
+  const cssHash = createHash("md5").update(cssContent).digest("hex").slice(0, 8);
+  const cssFile = `client-${cssHash}.css`;
+  await writeFile(join2(ASSETS_DIR, cssFile), cssContent);
+  await unlink(tmpCss);
+  await writeFile(join2(ASSETS_DIR, "manifest.json"), JSON.stringify({ js: jsFile, css: cssFile }));
+  return { js: jsFile, css: cssFile };
+}
+// .docu/node/search-indexer.ts
+import { readFile as readFile2, writeFile as writeFile2, mkdir as mkdir2 } from "node:fs/promises";
+import { resolve as resolve3, join as join3 } from "node:path";
+import { extractFrontmatterWithContent } from "@docubook/core";
+var docuConfig = loadDocuConfig();
+function getSectionTitle(filePath) {
+  const parts = filePath.split("/");
+  if (parts.length > 1) {
+    const section = docuConfig.routes?.find(
+      (r) => r.href === `/${parts[0]}` || r.href === parts[0]
+    );
+    if (section) return section.title;
+  }
+  return docuConfig.meta?.title || "Docs";
+}
+function slugify(text) {
+  return text.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
+}
+function stripJsx(content) {
+  let result = content;
+  let prev = "";
+  while (result !== prev) {
+    prev = result;
+    result = result.replace(/<[A-Z][\w.]*[\s\S]*?\/>/g, "").replace(/<[A-Z][\w.]*[\s\S]*?>([\s\S]*?)<\/[A-Z][\w.]*>/g, "$1");
+  }
+  return result;
+}
+function extractRecords(filePath, raw) {
+  const { frontmatter, strippedContent: content } = extractFrontmatterWithContent(raw);
+  const records = [];
+  const url = docsHtmlHref(`/docs/${filePath}`);
+  const lvl0 = getSectionTitle(filePath);
+  const lvl1 = frontmatter.title || null;
+  const hierarchy = {
+    lvl0,
+    lvl1,
+    lvl2: null,
+    lvl3: null,
+    lvl4: null,
+    lvl5: null,
+    lvl6: null
+  };
+  if (lvl1) {
+    records.push({
+      url,
+      hierarchy: { ...hierarchy },
+      content: frontmatter.description || null,
+      type: "lvl1"
+    });
+  }
+  const plainContent = stripJsx(content);
+  const lines = plainContent.split("\n");
+  let currentParagraph = [];
+  let inCodeBlock = false;
+  const flushParagraph = () => {
+    if (currentParagraph.length > 0) {
+      const text = currentParagraph.join(" ").trim();
+      if (text) {
+        records.push({
+          url: buildAnchorUrl(),
+          hierarchy: { ...hierarchy },
+          content: text,
+          type: "content"
+        });
+      }
+      currentParagraph = [];
+    }
+  };
+  const buildAnchorUrl = () => {
+    for (let i = 6; i >= 2; i--) {
+      const key = `lvl${i}`;
+      if (hierarchy[key]) return `${url}#${slugify(hierarchy[key])}`;
+    }
+    return url;
+  };
+  for (const line of lines) {
+    const trimmed = line.trim();
+    if (trimmed.startsWith("```")) {
+      inCodeBlock = !inCodeBlock;
+      continue;
+    }
+    if (inCodeBlock) continue;
+    if (/^import\s+[\w{*]/.test(trimmed) || /^export\s+[\w{*]/.test(trimmed)) continue;
+    const headingMatch = trimmed.match(/^(#{1,6})\s+(.+)$/);
+    if (headingMatch) {
+      flushParagraph();
+      const level = headingMatch[1].length;
+      const title = headingMatch[2].replace(/[*`[\]]/g, "").trim();
+      for (let i = level; i <= 6; i++) {
+        hierarchy[`lvl${i}`] = null;
+      }
+      hierarchy[`lvl${level}`] = title;
+      if (level === 1 && !hierarchy.lvl1) {
+        hierarchy.lvl1 = title;
+      }
+      if (level >= 2) {
+        records.push({
+          url: `${url}#${slugify(title)}`,
+          hierarchy: { ...hierarchy },
+          content: null,
+          type: `lvl${level}`
+        });
+      }
+      continue;
+    }
+    if (trimmed === "" || trimmed === "---") {
+      flushParagraph();
+      continue;
+    }
+    if (/^\|.+\|/.test(trimmed)) continue;
+    const cleaned = trimmed.replace(/^[-*+]\s+/, "").replace(/^\d+\.\s+/, "").replace(/^>\s+/, "").replace(/\*\*([^*]+)\*\*/g, "$1").replace(/\*([^*]+)\*/g, "$1").replace(/`([^`]+)`/g, "$1").replace(/\[([^\]]+)\]\([^)]+\)/g, "$1").trim();
+    if (cleaned) currentParagraph.push(cleaned);
+  }
+  flushParagraph();
+  return records;
+}
+async function generateSearchIndex(docsDir, outputDir) {
+  const docs = resolve3(docsDir || DOCS_DIR);
+  const dist = resolve3(outputDir || ASSETS_DIR);
+  await mkdir2(dist, { recursive: true });
+  const mdxFiles = await scanMdxFiles(docs);
+  const results = await Promise.all(
+    mdxFiles.map(async (file) => {
+      const raw = await readFile2(file.absPath, "utf-8");
+      return extractRecords(file.path, raw);
+    })
+  );
+  const allRecords = results.flat();
+  await writeFile2(join3(dist, "search-index.json"), JSON.stringify(allRecords));
+  return allRecords.length;
+}
+// .docu/node/sentry.ts
+var sentry = null;
+var initialized = false;
+async function initSentry() {
+  const dsn = process.env.SENTRY_DSN;
+  if (!dsn) return;
+  try {
+    sentry = await import("@sentry/bun");
+    sentry.init({
+      dsn,
+      environment: process.env.NODE_ENV || "development",
+      release: process.env.SENTRY_RELEASE || void 0
+    });
+    initialized = true;
+  } catch {
+    sentry = null;
+  }
+}
+function captureException(err, context) {
+  if (!initialized || !sentry) return;
+  sentry.captureException(err, context ? { extra: context } : void 0);
+}
+// .docu/node/git.ts
+import { execFile as execFile2 } from "node:child_process";
+function runGit(args) {
+  return new Promise((resolve4, reject) => {
+    execFile2("git", args, { maxBuffer: 16 * 1024 * 1024 }, (err, stdout) => {
+      if (err) reject(err);
+      else resolve4(stdout);
+    });
+  });
+}
+function sanitizePath(filePath) {
+  const cleanPath = filePath.replace(/^\//, "");
+  if (!cleanPath || !/^[a-zA-Z0-9\-_/.\s]+$/.test(cleanPath) || /(^|\/)\.\.($|\/)/.test(cleanPath))
+    return null;
+  return cleanPath;
+}
+async function getGitLastModified(filePath) {
+  const cleanPath = sanitizePath(filePath);
+  if (!cleanPath) return null;
+  try {
+    const text = await runGit(["log", "-1", "--format=%cI", "--", cleanPath]);
+    const date = text.trim();
+    return date || null;
+  } catch {
+    return null;
+  }
+}
+async function getGitLastModifiedBatch(filePaths) {
+  const result = /* @__PURE__ */ new Map();
+  if (filePaths.length === 0) return result;
+  const safePaths = [];
+  for (const fp of filePaths) {
+    const cleanPath = sanitizePath(fp);
+    if (!cleanPath) {
+      console.warn(`[git] getGitLastModifiedBatch: skipping invalid path "${fp}"`);
+      continue;
+    }
+    safePaths.push(cleanPath);
+  }
+  if (safePaths.length === 0) return result;
+  try {
+    const text = await runGit([
+      "log",
+      "--format=%cI",
+      "--name-only",
+      "--diff-filter=ACMR",
+      ...safePaths
+    ]);
+    let currentDate = "";
+    for (const line of text.split("\n")) {
+      const trimmed = line.trim();
+      if (!trimmed) continue;
+      if (/^\d{4}-\d{2}-\d{2}T/.test(trimmed)) {
+        currentDate = trimmed;
+      } else if (currentDate && !result.has(trimmed)) {
+        result.set(trimmed, currentDate);
+      }
+    }
+  } catch (err) {
+    console.error("Failed to get git last modified batch for", filePaths, err);
+  }
+  return result;
+}
+// .docu/node/mdx.ts
+import React from "react";
+import {
+  serialize,
+  extractTocsFromRawMdx,
+  extractFrontmatterWithContent as extractFrontmatterWithContent2,
+  createDefaultRehypePlugins,
+  createDefaultRemarkPlugins,
+  MDXRemote
+} from "@docubook/core";
+import { createMdxComponents } from "@docubook/mdx-content";
+function appendHtml(value) {
+  if (typeof value !== "string") return null;
+  if (/^https?:\/\//.test(value)) return null;
+  if (!value.startsWith("/docs/")) return null;
+  if (value.includes("#")) return null;
+  if (value.endsWith(".html")) return null;
+  return `${value}.html`;
+}
+function rehypeDocsHtmlLinks() {
+  return (tree) => {
+    function walk(node) {
+      if (node.type === "element" && node.tagName === "a") {
+        const fixed = appendHtml(node.properties?.href);
+        if (fixed) node.properties.href = fixed;
+      }
+      if (node.children) {
+        for (const child of node.children) walk(child);
+      }
+    }
+    walk(tree);
+    return tree;
+  };
+}
+function remarkMdxJsxDocsHtmlLinks() {
+  return (tree) => {
+    function walk(node) {
+      if ((node.type === "mdxJsxFlowElement" || node.type === "mdxJsxTextElement") && node.attributes) {
+        for (const attr of node.attributes) {
+          if (attr.type === "mdxJsxAttribute" && attr.name === "href") {
+            const fixed = appendHtml(attr.value);
+            if (fixed) attr.value = fixed;
+          }
+        }
+      }
+      if (node.children) {
+        for (const child of node.children) walk(child);
+      }
+    }
+    walk(tree);
+    return tree;
+  };
+}
+async function compileMdx(rawMdx, filePath, gitDates, remarkPlugins, rehypePlugins) {
+  const tocs = extractTocsFromRawMdx(rawMdx);
+  const { frontmatter, strippedContent } = extractFrontmatterWithContent2(rawMdx);
+  const defaultRemark = createDefaultRemarkPlugins();
+  const defaultRehype = createDefaultRehypePlugins();
+  const finalRemark = [...defaultRemark, remarkMdxJsxDocsHtmlLinks, ...remarkPlugins ?? []];
+  const finalRehype = [...defaultRehype, rehypeDocsHtmlLinks, ...rehypePlugins ?? []];
+  const serialized = await serialize(strippedContent, {
+    mdxOptions: {
+      rehypePlugins: finalRehype,
+      remarkPlugins: finalRemark
+    }
+  });
+  const components = createMdxComponents();
+  const content = React.createElement(MDXRemote, {
+    compiledSource: serialized.compiledSource,
+    scope: {},
+    frontmatter: {},
+    components
+  });
+  const date = frontmatter.date || gitDates?.get(filePath) || await getGitLastModified(filePath) || void 0;
+  return {
+    content,
+    compiledSource: serialized.compiledSource,
+    frontmatter: { ...frontmatter, date },
+    tocs
+  };
+}
+// .docu/pages/docs/[[...slug]].tsx
+import { ChevronLeft, ChevronRight } from "lucide-react";
+// .docu/components/Breadcrumb.tsx
+import {
+  Breadcrumb,
+  BreadcrumbItem,
+  BreadcrumbList,
+  BreadcrumbPage
+} from "@docubook/ui-react/breadcrumbs";
+import { jsx, jsxs } from "react/jsx-runtime";
+function toTitleCase2(input) {
+  return input.split("-").map((word) => word.charAt(0).toUpperCase() + word.slice(1)).join(" ");
+}
+function DocsBreadcrumb({ paths }) {
+  return /* @__PURE__ */ jsx(Breadcrumb, { className: "py-4", children: /* @__PURE__ */ jsxs(BreadcrumbList, { children: [
+    /* @__PURE__ */ jsx(BreadcrumbItem, { children: /* @__PURE__ */ jsx("span", { className: "text-muted-foreground", children: "Docs" }) }),
+    paths.map((path, index) => /* @__PURE__ */ jsx(BreadcrumbItem, { children: index < paths.length - 1 ? /* @__PURE__ */ jsx("span", { className: "text-muted-foreground", children: toTitleCase2(path) }) : /* @__PURE__ */ jsx(BreadcrumbPage, { className: "text-base-content", children: toTitleCase2(path) }) }, `${path}-${index}`))
+  ] }) });
+}
+// .docu/node/route.ts
+var docuConfig2 = loadDocuConfig();
+var routes = resolveRoutes(docuConfig2.routes);
+function flattenRoutes() {
+  const paths = [];
+  function traverse(route, section = "") {
+    const fullPath = route.href.startsWith(section) ? route.href : `${section}${route.href}`.replace(/\/+/g, "/");
+    if (route.href && !route.noLink) {
+      paths.push(fullPath);
+    }
+    if (route.items) {
+      route.items.forEach((item) => traverse(item, fullPath));
+    }
+  }
+  routes.forEach((route) => traverse(route));
+  return paths;
+}
+function getRouteMap() {
+  const map = /* @__PURE__ */ new Map();
+  function traverse(route, section = "") {
+    const fullPath = route.href.startsWith(section) ? route.href : `${section}${route.href}`.replace(/\/+/g, "/");
+    map.set(fullPath, route.title);
+    if (route.items) {
+      route.items.forEach((item) => traverse(item, fullPath));
+    }
+  }
+  routes.forEach((route) => traverse(route));
+  return map;
+}
+function getPreviousNext(pathname) {
+  const normalizedPath = pathname.replace(/^\/|$/g, "");
+  const paths = flattenRoutes();
+  const index = paths.findIndex((href) => href === `/${normalizedPath}` || href === normalizedPath);
+  if (index === -1) {
+    return { prev: null, next: null };
+  }
+  const routeMap = getRouteMap();
+  const prevHref = index > 0 ? paths[index - 1] : null;
+  const nextHref = index < paths.length - 1 ? paths[index + 1] : null;
+  return {
+    prev: prevHref ? { href: prevHref, title: routeMap.get(prevHref) || "" } : null,
+    next: nextHref ? { href: nextHref, title: routeMap.get(nextHref) || "" } : null
+  };
+}
+// .docu/components/Pagination.tsx
+import { PaginationDocs } from "@docubook/ui-react/pagination";
+import { jsx as jsx2 } from "react/jsx-runtime";
+function Pagination({
+  pathname,
+  className,
+  prevIcon,
+  nextIcon,
+  linkClassName
+}) {
+  const { prev, next } = getPreviousNext(pathname);
+  if (!prev && !next) {
+    return null;
+  }
+  return /* @__PURE__ */ jsx2(
+    PaginationDocs,
+    {
+      prev: prev ? { href: docsHtmlHref(`/docs${prev.href}`), title: prev.title } : void 0,
+      next: next ? { href: docsHtmlHref(`/docs${next.href}`), title: next.title } : void 0,
+      className,
+      prevIcon,
+      nextIcon,
+      linkClassName
+    }
+  );
+}
+// .docu/components/Typography.tsx
+import { jsx as jsx3 } from "react/jsx-runtime";
+function Typography({ children }) {
+  return /* @__PURE__ */ jsx3("div", { className: "prose prose-zinc dark:prose-invert prose-code:font-code dark:prose-code:bg-stone-900/25 prose-code:bg-stone-50 prose-pre:bg-background max-lg:prose-headings:scroll-mt-54 prose-headings:scroll-mt-4 prose-code:text-sm prose-code:leading-6 dark:prose-code:text-white prose-code:text-stone-800 prose-code:p-1 prose-code:rounded-md prose-code:border prose-img:rounded-md prose-img:border prose-code:before:content-none prose-code:after:content-none prose-code:px-1.5 prose-code:overflow-x-auto prose-img:my-3 prose-h2:my-4 prose-h2:mt-8 w-[85vw] max-w-[500px]! min-w-full! pt-2 sm:mx-auto sm:w-full", children });
+}
+// .docu/components/EditWith.tsx
+import { SquarePen } from "lucide-react";
+// .docu/node/helpers.ts
+var docuConfig3 = loadDocuConfig();
+function getEditLink(url, filePath) {
+  const configPath = docuConfig3?.repo?.path || detectPlatformPath(url);
+  const encodedPath = filePath.replace(/^\//, "").split("/").map(encodeURIComponent).join("/");
+  return `${url}/${configPath}`.replace("{filePath}", encodedPath);
+}
+function detectPlatformPath(url) {
+  try {
+    const host = new URL(url).hostname;
+    if (host === "github.com") return "blob/main/{filePath}";
+    if (host === "gitlab.com") return "-/blob/main/{filePath}";
+    if (host === "bitbucket.org") return "src/main/{filePath}";
+    if (host === "gitea.com") return "src/branch/main/{filePath}";
+    if (host === "codeberg.org") return "src/branch/main/{filePath}";
+    return "src/branch/main/{filePath}";
+  } catch {
+    return "blob/main/{filePath}";
+  }
+}
+function isEditEnabled() {
+  return docuConfig3?.repo?.edit ?? false;
+}
+function getRepoUrl() {
+  return docuConfig3?.repo?.url || "";
+}
+function getSocialLinks() {
+  return docuConfig3?.footer?.social || [];
+}
+// .docu/components/EditWith.tsx
+import { jsx as jsx4, jsxs as jsxs2 } from "react/jsx-runtime";
+function EditWith({
+  filePath,
+  text = "Edit this page",
+  className = ""
+}) {
+  if (!isEditEnabled()) return null;
+  const repoUrl = getRepoUrl();
+  if (!repoUrl) return null;
+  const editUrl = getEditLink(repoUrl, filePath);
+  return /* @__PURE__ */ jsx4("div", { className: `text-right text-sm ${className}`, children: /* @__PURE__ */ jsxs2(
+    "a",
+    {
+      href: editUrl,
+      target: "_blank",
+      rel: "noopener noreferrer",
+      "aria-label": "Edit this page",
+      className: "flex items-center gap-1 no-underline",
+      children: [
+        /* @__PURE__ */ jsx4(SquarePen, { className: "h-4 w-4" }),
+        text
+      ]
+    }
+  ) });
+}
+// .docu/components/Social.tsx
+import { jsx as jsx5 } from "react/jsx-runtime";
+function createIcon(pathData) {
+  return function Icon({ className = "", size = 20 }) {
+    return /* @__PURE__ */ jsx5(
+      "svg",
+      {
+        className,
+        width: size,
+        height: size,
+        viewBox: "0 0 24 24",
+        xmlns: "http://www.w3.org/2000/svg",
+        fill: "currentColor",
+        children: /* @__PURE__ */ jsx5("path", { d: pathData })
+      }
+    );
+  };
+}
+var GithubIcon = createIcon(
+  "M12 .297c-6.63 0-12 5.373-12 12 0 5.303 3.438 9.8 8.205 11.385.6.113.82-.258.82-.577 0-.285-.01-1.04-.015-2.04-3.338.724-4.042-1.61-4.042-1.61C4.422 18.07 3.633 17.7 3.633 17.7c-1.087-.744.084-.729.084-.729 1.205.084 1.838 1.236 1.838 1.236 1.07 1.835 2.809 1.305 3.495.998.108-.776.417-1.305.76-1.605-2.665-.3-5.466-1.332-5.466-5.93 0-1.31.465-2.38 1.235-3.22-.135-.303-.54-1.523.105-3.176 0 0 1.005-.322 3.3 1.23.96-.267 1.98-.399 3-.405 1.02.006 2.04.138 3 .405 2.28-1.552 3.285-1.23 3.285-1.23.645 1.653.24 2.873.12 3.176.765.84 1.23 1.91 1.23 3.22 0 4.61-2.805 5.625-5.475 5.92.42.36.81 1.096.81 2.22 0 1.606-.015 2.896-.015 3.286 0 .315.21.69.825.57C20.565 22.092 24 17.592 24 12.297c0-6.627-5.373-12-12-12"
+);
+var BitbucketIcon = createIcon(
+  "M.778 1.213a.768.768 0 00-.768.892l3.263 19.81c.084.5.515.868 1.022.873H19.95a.772.772 0 00.77-.646l3.27-20.03a.768.768 0 00-.768-.891zM14.52 15.53H9.522L8.17 8.466h7.561z"
+);
+var GitlabIcon = createIcon(
+  "m23.6004 9.5927-.0337-.0862L20.3.9814a.851.851 0 0 0-.3362-.405.8748.8748 0 0 0-.9997.0539.8748.8748 0 0 0-.29.4399l-2.2055 6.748H7.5375l-2.2057-6.748a.8573.8573 0 0 0-.29-.4412.8748.8748 0 0 0-.9997-.0537.8585.8585 0 0 0-.3362.4049L.4332 9.5015l-.0325.0862a6.0657 6.0657 0 0 0 2.0119 7.0105l.0113.0087.03.0213 4.976 3.7264 2.462 1.8633 1.4995 1.1321a1.0085 1.0085 0 0 0 1.2197 0l1.4995-1.1321 2.4619-1.8633 5.006-3.7489.0125-.01a6.0682 6.0682 0 0 0 2.0094-7.003z"
+);
+var NpmIcon = createIcon(
+  "M1.763 0C.786 0 0 .786 0 1.763v20.474C0 23.214.786 24 1.763 24h20.474c.977 0 1.763-.786 1.763-1.763V1.763C24 .786 23.214 0 22.237 0zM5.13 5.323l13.837.019-.009 13.836h-3.464l.01-10.382h-3.456L12.04 19.17H5.113z"
+);
+var YoutubeIcon = createIcon(
+  "M23.498 6.186a3.016 3.016 0 0 0-2.122-2.136C19.505 3.545 12 3.545 12 3.545s-7.505 0-9.377.505A3.017 3.017 0 0 0 .502 6.186C0 8.07 0 12 0 12s0 3.93.502 5.814a3.016 3.016 0 0 0 2.122 2.136c1.871.505 9.376.505 9.376.505s7.505 0 9.377-.505a3.015 3.015 0 0 0 2.122-2.136C24 15.93 24 12 24 12s0-3.93-.502-5.814zM9.545 15.568V8.432L15.818 12l-6.273 3.568z"
+);
+var TwitterIcon = createIcon(
+  "M14.234 10.162 22.977 0h-2.072l-7.591 8.824L7.251 0H.258l9.168 13.343L.258 24H2.33l8.016-9.318L16.749 24h6.993zm-2.837 3.299-.929-1.329L3.076 1.56h3.182l5.965 8.532.929 1.329 7.754 11.09h-3.182z"
+);
+var InstagramIcon = createIcon(
+  "M7.0301.084c-1.2768.0602-2.1487.264-2.911.5634-.7888.3075-1.4575.72-2.1228 1.3877-.6652.6677-1.075 1.3368-1.3802 2.127-.2954.7638-.4956 1.6365-.552 2.914-.0564 1.2775-.0689 1.6882-.0626 4.947.0062 3.2586.0206 3.6671.0825 4.9473.061 1.2765.264 2.1482.5635 2.9107.308.7889.72 1.4573 1.388 2.1228.6679.6655 1.3365 1.0743 2.1285 1.38.7632.295 1.6361.4961 2.9134.552 1.2773.056 1.6884.069 4.9462.0627 3.2578-.0062 3.668-.0207 4.9478-.0814 1.28-.0607 2.147-.2652 2.9098-.5633.7889-.3086 1.4578-.72 2.1228-1.3881.665-.6682 1.0745-1.3378 1.3795-2.1284.2957-.7632.4966-1.636.552-2.9124.056-1.2809.0692-1.6898.063-4.948-.0063-3.2583-.021-3.6668-.0817-4.9465-.0607-1.2797-.264-2.1487-.5633-2.9117-.3084-.7889-.72-1.4568-1.3876-2.1228C21.2982 1.33 20.628.9208 19.8378.6165 19.074.321 18.2017.1197 16.9244.0645 15.6471.0093 15.236-.005 11.977.0014 8.718.0076 8.31.0215 7.0301.0839m.1402 21.6932c-1.17-.0509-1.8053-.2453-2.2287-.408-.5606-.216-.96-.4771-1.3819-.895-.422-.4178-.6811-.8186-.9-1.378-.1644-.4234-.3624-1.058-.4171-2.228-.0595-1.2645-.072-1.6442-.079-4.848-.007-3.2037.0053-3.583.0607-4.848.05-1.169.2456-1.805.408-2.2282.216-.5613.4762-.96.895-1.3816.4188-.4217.8184-.6814 1.3783-.9003.423-.1651 1.0575-.3614 2.227-.4171 1.2655-.06 1.6447-.072 4.848-.079 3.2033-.007 3.5835.005 4.8495.0608 1.169.0508 1.8053.2445 2.228.408.5608.216.96.4754 1.3816.895.4217.4194.6816.8176.9005 1.3787.1653.4217.3617 1.056.4169 2.2263.0602 1.2655.0739 1.645.0796 4.848.0058 3.203-.0055 3.5834-.061 4.848-.051 1.17-.245 1.8055-.408 2.2294-.216.5604-.4763.96-.8954 1.3814-.419.4215-.8181.6811-1.3783.9-.4224.1649-1.0577.3617-2.2262.4174-1.2656.0595-1.6448.072-4.8493.079-3.2045.007-3.5825-.006-4.848-.0608M16.953 5.5864A1.44 1.44 0 1 0 18.39 4.144a1.44 1.44 0 0 0-1.437 1.4424M5.8385 12.012c.0067 3.4032 2.7706 6.1557 6.173 6.1493 3.4026-.0065 6.157-2.7701 6.1506-6.1733-.0065-3.4032-2.771-6.1565-6.174-6.1498-3.403.0067-6.156 2.771-6.1496 6.1738M8 12.0077a4 4 0 1 1 4.008 3.9921A3.9996 3.9996 0 0 1 8 12.0077"
+);
+var LinkedinIcon = createIcon(
+  "M20.447 20.452h-3.554v-5.569c0-1.328-.027-3.037-1.852-3.037-1.853 0-2.136 1.445-2.136 2.939v5.667H9.351V9h3.414v1.561h.046c.477-.9 1.637-1.85 3.37-1.85 3.601 0 4.267 2.37 4.267 5.455v6.528zM5.337 7.433c-1.144 0-2.063-.926-2.063-2.065 0-1.138.92-2.063 2.063-2.063 1.14 0 2.064.925 2.064 2.063 0 1.139-.925 2.065-2.064 2.065zm1.782 13.019H3.555V9h3.564v11.452zM22.225 0H1.771C.792 0 0 .774 0 1.729v20.542C0 23.226.792 24 1.771 24h20.451C23.2 24 24 23.226 24 22.271V1.729C24 .774 23.2 0 22.222 0h.003z"
+);
+var FacebookIcon = createIcon(
+  "M9.101 23.691v-7.98H6.627v-3.667h2.474v-1.58c0-4.085 1.848-5.978 5.858-5.978.401 0 .955.042 1.468.103a8.68 8.68 0 0 1 1.141.195v3.325a8.623 8.623 0 0 0-.653-.036 26.805 26.805 0 0 0-.733-.009c-.707 0-1.259.096-1.675.309a1.686 1.686 0 0 0-.679.622c-.258.42-.374.995-.374 1.752v1.297h3.919l-.386 2.103-.287 1.564h-3.246v8.245C19.396 23.238 24 18.179 24 12.044c0-6.627-5.373-12-12-12s-12 5.373-12 12c0 5.628 3.874 10.35 9.101 11.647Z"
+);
+var TelegramIcon = createIcon(
+  "M11.944 0A12 12 0 0 0 0 12a12 12 0 0 0 12 12 12 12 0 0 0 12-12A12 12 0 0 0 12 0a12 12 0 0 0-.056 0zm4.962 7.224c.1-.002.321.023.465.14a.506.506 0 0 1 .171.325c.016.093.036.306.02.472-.18 1.898-.962 6.502-1.36 8.627-.168.9-.499 1.201-.82 1.23-.696.065-1.225-.46-1.9-.902-1.056-.693-1.653-1.124-2.678-1.8-1.185-.78-.417-1.21.258-1.91.177-.184 3.247-2.977 3.307-3.23.007-.032.014-.15-.056-.212s-.174-.041-.249-.024c-.106.024-1.793 1.14-5.061 3.345-.48.33-.913.49-1.302.48-.428-.008-1.252-.241-1.865-.44-.752-.245-1.349-.374-1.297-.789.027-.216.325-.437.893-.663 3.498-1.524 5.83-2.529 6.998-3.014 3.332-1.386 4.025-1.627 4.476-1.635z"
+);
+var DiscordIcon = createIcon(
+  "M20.317 4.3698a19.7913 19.7913 0 00-4.8851-1.5152.0741.0741 0 00-.0785.0371c-.211.3753-.4447.8648-.6083 1.2495-1.8447-.2762-3.68-.2762-5.4868 0-.1636-.3933-.4058-.8742-.6177-1.2495a.077.077 0 00-.0785-.037 19.7363 0 00-4.8852 1.515.0699.0699 0 00-.0321.0277C.5334 9.0458-.319 13.5799.0992 18.0578a.0824.0824 0 00.0312.0561c2.0528 1.5076 4.0413 2.4228 5.9929 3.0294a.0777.0777 0 00.0842-.0276c.4616-.6304.8731-1.2952 1.226-1.9942a.076.076 0 00-.0416-.1057c-.6528-.2476-1.2743-.5495-1.8722-.8923a.077.077 0 01-.0076-.1277c.1258-.0943.2517-.1923.3718-.2914a.0743.0743 0 01.0776-.0105c3.9278 1.7933 8.18 1.7933 12.0614 0a.0739.0739 0 01.0785.0095c.1202.099.246.1981.3728.2924a.077.077 0 01-.0066.1276 12.2986 12.2986 0 01-1.873.8914.0766.0766 0 00-.0407.1067c.3604.698.7719 1.3628 1.225 1.9932a.076.076 0 00.0842.0286c1.961-.6067 3.9495-1.5219 6.0023-3.0294a.077.077 0 00.0313-.0552c.5004-5.177-.8382-9.6739-3.5485-13.6604a.061.061 0 00-.0312-.0286zM8.02 15.3312c-1.1825 0-2.1569-1.0857-2.1569-2.419 0-1.3332.9555-2.4189 2.157-2.4189 1.2108 0 2.1757 1.0952 2.1568 2.419 0 1.3332-.9555 2.4189-2.1569 2.4189zm7.9748 0c-1.1825 0-2.1569-1.0857-2.1569-2.419 0-1.3332.9554-2.4189 2.1569-2.4189 1.2108 0 2.1757 1.0952 2.1568 2.419 0 1.3332-.946 2.4189-2.1568 2.4189Z"
+);
+var ThreadsIcon = createIcon(
+  "M12.186 24h-.007c-3.581-.024-6.334-1.205-8.184-3.509C2.35 18.44 1.5 15.586 1.472 12.01v-.017c.03-3.579.879-6.43 2.525-8.482C5.845 1.205 8.6.024 12.18 0h.014c2.746.02 5.043.725 6.826 2.098 1.677 1.29 2.858 3.13 3.509 5.467l-2.04.569c-1.104-3.96-3.898-5.984-8.304-6.015-2.91.022-5.11.936-6.54 2.717C4.307 6.504 3.616 8.914 3.589 12c.027 3.086.718 5.496 2.057 7.164 1.43 1.783 3.631 2.698 6.54 2.717 2.623-.02 4.358-.631 5.8-2.045 1.647-1.613 1.618-3.593 1.09-4.798-.31-.71-.873-1.3-1.634-1.75-.192 1.352-.622 2.446-1.284 3.272-.886 1.102-2.14 1.704-3.73 1.79-1.202.065-2.361-.218-3.259-.801-1.063-.689-1.685-1.74-1.752-2.964-.065-1.19.408-2.285 1.33-3.082.88-.76 2.119-1.207 3.583-1.291a13.853 13.853 0 0 1 3.02.142c-.126-.742-.375-1.332-.75-1.757-.513-.586-1.308-.883-2.359-.89h-.029c-.844 0-1.992.232-2.721 1.32L7.734 7.847c.98-1.454 2.568-2.256 4.478-2.256h.044c3.194.02 5.097 1.975 5.287 5.388.108.046.216.094.321.142 1.49.7 2.58 1.761 3.154 3.07.797 1.82.871 4.79-1.548 7.158-1.85 1.81-4.094 2.628-7.277 2.65Zm1.003-11.69c-.242 0-.487.007-.739.021-1.836.103-2.98.946-2.916 2.143.067 1.256 1.452 1.839 2.784 1.767 1.224-.065 2.818-.543 3.086-3.71a10.5 10.5 0 0 0-2.215-.221z"
+);
+var MastodonIcon = createIcon(
+  "M23.268 5.313c-.35-2.578-2.617-4.61-5.304-5.004C17.51.242 15.792 0 11.813 0h-.03c-3.98 0-4.835.242-5.288.309C3.882.692 1.496 2.518.917 5.127.64 6.412.61 7.837.661 9.143c.074 1.874.088 3.745.26 5.611.118 1.24.325 2.47.62 3.68.55 2.237 2.777 4.098 4.96 4.857 2.336.792 4.849.923 7.256.38.265-.061.527-.132.786-.213.585-.184 1.27-.39 1.774-.753a.057.057 0 0 0 .023-.043v-1.809a.052.052 0 0 0-.02-.041.053.053 0 0 0-.046-.01 20.282 20.282 0 0 1-4.709.545c-2.73 0-3.463-1.284-3.674-1.818a5.593 5.593 0 0 1-.319-1.433.053.053 0 0 1 .066-.054c1.517.363 3.072.546 4.632.546.376 0 .75 0 1.125-.01 1.57-.044 3.224-.124 4.768-.422.038-.008.077-.015.11-.024 2.435-.464 4.753-1.92 4.989-5.604.008-.145.03-1.52.03-1.67.002-.512.167-3.63-.024-5.545zm-3.748 9.195h-2.561V8.29c0-1.309-.55-1.976-1.67-1.976-1.23 0-1.846.79-1.846 2.35v3.403h-2.546V8.663c0-1.56-.617-2.35-1.848-2.35-1.112 0-1.668.668-1.67 1.977v6.218H4.822V8.102c0-1.31.337-2.35 1.011-3.12.696-.77 1.608-1.164 2.74-1.164 1.311 0 2.302.5 2.962 1.498l.638 1.06.638-1.06c.66-.999 1.65-1.498 2.96-1.498 1.13 0 2.043.395 2.74 1.164.675.77 1.012 1.81 1.012 3.12z"
+);
+var iconMap = {
+  github: GithubIcon,
+  gitlab: GitlabIcon,
+  bitbucket: BitbucketIcon,
+  npm: NpmIcon,
+  youtube: YoutubeIcon,
+  twitter: TwitterIcon,
+  x: TwitterIcon,
+  instagram: InstagramIcon,
+  linkedin: LinkedinIcon,
+  facebook: FacebookIcon,
+  telegram: TelegramIcon,
+  discord: DiscordIcon,
+  threads: ThreadsIcon,
+  mastodon: MastodonIcon
+};
+function getSocialIcon(name) {
+  const key = name.toLowerCase().replace(/\s+/g, "");
+  return iconMap[key] || null;
+}
+function Social({ className = "", size = 16 }) {
+  const socialLinks = getSocialLinks();
+  if (!socialLinks?.length) return null;
+  return /* @__PURE__ */ jsx5("div", { className: `flex gap-1 ${className}`, children: socialLinks.map((link) => {
+    const Icon = getSocialIcon(link.name);
+    return /* @__PURE__ */ jsx5(
+      "a",
+      {
+        href: link.url,
+        target: "_blank",
+        rel: "noopener noreferrer",
+        "aria-label": link.name,
+        className: "btn-xs btn-circle btn-ghost text-muted-foreground",
+        children: Icon && /* @__PURE__ */ jsx5(Icon, { size })
+      },
+      link.name
+    );
+  }) });
+}
+// .docu/components/Footer.tsx
+import { jsx as jsx6, jsxs as jsxs3 } from "react/jsx-runtime";
+function Footer() {
+  return /* @__PURE__ */ jsxs3("footer", { className: "text-muted-foreground mt-auto flex w-full flex-col items-start gap-4 py-6 sm:flex-row sm:items-center sm:justify-between", children: [
+    /* @__PURE__ */ jsx6(Social, {}),
+    /* @__PURE__ */ jsx6("aside", { className: "sm:ml-auto", children: /* @__PURE__ */ jsxs3("p", { className: "text-xs", children: [
+      "Made with",
+      " ",
+      /* @__PURE__ */ jsx6(
+        "a",
+        {
+          href: "https://docubook.pro",
+          target: "_blank",
+          rel: "noopener noreferrer",
+          className: "link link-hover text-muted-foreground font-medium",
+          children: "DocuBook"
+        }
+      )
+    ] }) })
+  ] });
+}
+// .docu/components/Toc.tsx
+import { useState as useState2, useCallback as useCallback2, useEffect as useEffect2, useRef } from "react";
+import { ListIcon } from "lucide-react";
+// .docu/components/ScrollTo.tsx
+import { ArrowUpIcon } from "lucide-react";
+import { useEffect, useState, useCallback } from "react";
+import { jsx as jsx7, jsxs as jsxs4 } from "react/jsx-runtime";
+function ScrollTo({ className, showIcon = true }) {
+  const [isVisible, setIsVisible] = useState(false);
+  const checkScroll = useCallback(() => {
+    const container = document.getElementById("scroll-container");
+    const scrollY = container ? container.scrollTop : window.scrollY;
+    const scrollHeight = container ? container.scrollHeight : document.documentElement.scrollHeight;
+    const threshold = scrollHeight * 0.3;
+    const shouldShow = scrollY > threshold;
+    if (shouldShow !== isVisible) {
+      setIsVisible(shouldShow);
+    }
+  }, [isVisible]);
+  useEffect(() => {
+    let timeoutId;
+    const handleScroll = () => {
+      if (timeoutId) clearTimeout(timeoutId);
+      timeoutId = setTimeout(checkScroll, 100);
+    };
+    const container = document.getElementById("scroll-container") || window;
+    container.addEventListener("scroll", handleScroll, { passive: true });
+    return () => {
+      container.removeEventListener("scroll", handleScroll);
+      if (timeoutId) clearTimeout(timeoutId);
+    };
+  }, [checkScroll]);
+  const scrollToTop = useCallback((e) => {
+    e.preventDefault();
+    const container = document.getElementById("scroll-container");
+    if (container) {
+      container.scrollTo({ top: 0, behavior: "smooth" });
+    } else {
+      window.scrollTo({ top: 0, behavior: "smooth" });
+    }
+  }, []);
+  return /* @__PURE__ */ jsx7(
+    "div",
+    {
+      className: cn(
+        "border-base-300 mt-4 border-t pt-4",
+        "transition-opacity duration-300",
+        isVisible ? "opacity-100" : "pointer-events-none opacity-0",
+        className
+      ),
+      children: /* @__PURE__ */ jsxs4(
+        "a",
+        {
+          href: "#",
+          onClick: scrollToTop,
+          className: cn(
+            "inline-flex items-center text-sm",
+            "link link-hover text-base-content/60 hover:text-base-content",
+            "transition-all duration-200 hover:translate-y-px"
+          ),
+          "aria-label": "Scroll to top",
+          children: [
+            showIcon && /* @__PURE__ */ jsx7(ArrowUpIcon, { className: "mr-1 h-3.5 w-3.5 shrink-0" }),
+            /* @__PURE__ */ jsx7("span", { children: "Scroll to Top" })
+          ]
+        }
+      )
+    }
+  );
+}
+// .docu/components/Toc.tsx
+import { jsx as jsx8, jsxs as jsxs5 } from "react/jsx-runtime";
+function Toc({ tocs }) {
+  const [activeId, setActiveId] = useState2(null);
+  const clickedIdRef = useRef(null);
+  const clickTimerRef = useRef(null);
+  const activeIdRef = useRef(null);
+  useEffect2(() => {
+    activeIdRef.current = activeId;
+  }, [activeId]);
+  useEffect2(() => {
+    if (typeof document === "undefined" || !tocs.length) return;
+    const isDesktop = window.innerWidth >= 1024;
+    const container = isDesktop ? document.getElementById("scroll-container") : null;
+    const scrollTarget = container || window;
+    const offset = isDesktop ? 80 : 100;
+    const handleScroll = () => {
+      if (clickedIdRef.current) return;
+      let currentId = null;
+      for (const toc of tocs) {
+        const id = toc.href.slice(1);
+        const el = document.getElementById(id);
+        if (!el) continue;
+        const top = container ? el.offsetTop - container.scrollTop : el.getBoundingClientRect().top;
+        if (top <= offset) {
+          currentId = id;
+        } else {
+          break;
+        }
+      }
+      if (currentId && currentId !== activeIdRef.current) {
+        setActiveId(currentId);
+        history.replaceState(null, "", `#${currentId}`);
+      }
+    };
+    handleScroll();
+    let throttleTimer = null;
+    const listener = tocs.length > 30 ? () => {
+      if (throttleTimer) return;
+      throttleTimer = setTimeout(() => {
+        throttleTimer = null;
+        handleScroll();
+      }, 50);
+    } : handleScroll;
+    scrollTarget.addEventListener("scroll", listener, { passive: true });
+    return () => {
+      scrollTarget.removeEventListener("scroll", listener);
+      if (throttleTimer) clearTimeout(throttleTimer);
+    };
+  }, [tocs]);
+  const handleLinkClick = useCallback2((id) => {
+    clickedIdRef.current = id;
+    setActiveId(id);
+    history.replaceState(null, "", `#${id}`);
+    if (clickTimerRef.current) clearTimeout(clickTimerRef.current);
+    clickTimerRef.current = setTimeout(() => {
+      clickedIdRef.current = null;
+    }, 1e3);
+  }, []);
+  useEffect2(() => {
+    return () => {
+      if (clickTimerRef.current) clearTimeout(clickTimerRef.current);
+    };
+  }, []);
+  if (!tocs.length) return null;
+  return /* @__PURE__ */ jsxs5("div", { className: "flex w-full flex-col gap-2", children: [
+    /* @__PURE__ */ jsxs5("div", { className: "flex items-center gap-2", children: [
+      /* @__PURE__ */ jsx8(ListIcon, { className: "h-4 w-4" }),
+      /* @__PURE__ */ jsx8("h3", { className: "text-sm font-medium", children: "On this page" })
+    ] }),
+    /* @__PURE__ */ jsx8("div", { className: "relative", children: /* @__PURE__ */ jsxs5("div", { className: "relative text-sm", children: [
+      /* @__PURE__ */ jsx8("div", { className: "bg-base-300 absolute left-0 top-0 h-full w-px" }),
+      /* @__PURE__ */ jsx8("div", { className: "flex flex-col", children: tocs.map(({ href, level, text }) => {
+        const id = href.slice(1);
+        const isActive = activeId === id;
+        const levelPadding = (level - 2) * 16;
+        return /* @__PURE__ */ jsxs5(
+          "div",
+          {
+            className: cn(
+              "relative flex items-center transition-all duration-200",
+              isActive && "bg-primary/5"
+            ),
+            children: [
+              /* @__PURE__ */ jsxs5(
+                "div",
+                {
+                  className: cn(
+                    "flex shrink-0 items-center px-1 py-2 transition-all duration-200",
+                    isActive && "border-primary -ml-px border-l-[3px]"
+                  ),
+                  children: [
+                    /* @__PURE__ */ jsx8(
+                      "div",
+                      {
+                        className: cn(
+                          "h-px transition-colors duration-200",
+                          isActive ? "bg-primary w-3" : "bg-base-300 w-2"
+                        )
+                      }
+                    ),
+                    /* @__PURE__ */ jsx8(
+                      "div",
+                      {
+                        className: cn(
+                          "h-1.5 w-1.5 shrink-0 rounded-full transition-colors duration-300",
+                          isActive ? "bg-primary" : "bg-base-300"
+                        )
+                      }
+                    )
+                  ]
+                }
+              ),
+              /* @__PURE__ */ jsx8(
+                "a",
+                {
+                  href,
+                  onClick: (e) => {
+                    e.preventDefault();
+                    handleLinkClick(id);
+                    const el = document.getElementById(id);
+                    if (el) el.scrollIntoView({ behavior: "smooth" });
+                  },
+                  className: cn(
+                    "flex flex-1 items-center py-2 transition-all duration-200",
+                    isActive ? "text-primary font-medium" : "text-base-content/60 hover:text-base-content"
+                  ),
+                  style: { paddingLeft: `${levelPadding + 6}px` },
+                  children: /* @__PURE__ */ jsx8("span", { className: "line-clamp-2 break-words text-sm", children: text })
+                }
+              )
+            ]
+          },
+          href
+        );
+      }) })
+    ] }) }),
+    /* @__PURE__ */ jsx8(ScrollTo, { className: "mt-2" })
+  ] });
+}
+// .docu/pages/docs/[[...slug]].tsx
+import { jsx as jsx9, jsxs as jsxs6 } from "react/jsx-runtime";
+function DocsPage({
+  slug,
+  title,
+  description,
+  date,
+  content,
+  tocs,
+  filePath,
+  repoUrl,
+  compiledSource
+}) {
+  const pathname = slug.join("/");
+  const tocsJson = JSON.stringify(tocs);
+  return /* @__PURE__ */ jsx9("div", { className: "flex w-full flex-1 px-0 pb-4 lg:h-[calc(100vh-4rem)] lg:px-8 lg:pb-8", children: /* @__PURE__ */ jsxs6(
+    "div",
+    {
+      id: "scroll-container",
+      className: "bg-base-100 border-base-300 max-lg:scroll-p-54 relative flex w-full flex-col items-start rounded-b-3xl border shadow-md lg:h-full lg:flex-row lg:overflow-y-auto lg:rounded-xl",
+      children: [
+        /* @__PURE__ */ jsx9(
+          "div",
+          {
+            id: "mobile-bar-island",
+            className: "sticky top-0 z-50 w-full lg:hidden",
+            "data-tocs": tocsJson,
+            "data-title": title,
+            "data-repo": repoUrl || ""
+          }
+        ),
+        /* @__PURE__ */ jsxs6("div", { className: "w-full min-w-0 flex-[7] px-4 py-4 lg:px-8 lg:py-8", children: [
+          /* @__PURE__ */ jsx9(DocsBreadcrumb, { paths: slug }),
+          /* @__PURE__ */ jsxs6(Typography, { children: [
+            /* @__PURE__ */ jsx9("h1", { className: "-mt-0.5 text-3xl", children: title }),
+            description && /* @__PURE__ */ jsx9("p", { className: "text-muted-foreground -mt-4 text-[16.5px]", children: description }),
+            /* @__PURE__ */ jsx9("div", { id: "mdx-content-island", children: content }),
+            compiledSource && /* @__PURE__ */ jsx9(
+              "script",
+              {
+                id: "mdx-compiled-source",
+                type: "application/json",
+                dangerouslySetInnerHTML: {
+                  __html: JSON.stringify(compiledSource).replace(/<\//g, "\\u003C/")
+                }
+              }
+            ),
+            /* @__PURE__ */ jsxs6("div", { className: "border-base-300 my-8 flex items-center border-b-2 border-dashed", children: [
+              /* @__PURE__ */ jsx9(EditWith, { className: "text-muted-foreground", filePath }),
+              date && /* @__PURE__ */ jsxs6("p", { className: "text-muted-foreground ml-auto text-[13px]", children: [
+                "Last updated ",
+                formatDate2(date)
+              ] })
+            ] }),
+            /* @__PURE__ */ jsx9(
+              Pagination,
+              {
+                pathname,
+                prevIcon: /* @__PURE__ */ jsx9(ChevronLeft, { className: "h-3 w-3" }),
+                nextIcon: /* @__PURE__ */ jsx9(ChevronRight, { className: "h-3 w-3" })
+              }
+            ),
+            /* @__PURE__ */ jsx9(Footer, {})
+          ] })
+        ] }),
+        tocs.length > 0 && /* @__PURE__ */ jsx9(
+          "div",
+          {
+            id: "toc-island",
+            "data-tocs": tocsJson,
+            className: "sticky top-4 hidden h-[calc(100vh-8rem)] min-w-[240px] flex-[3] self-start lg:flex lg:px-4 lg:py-6",
+            children: /* @__PURE__ */ jsx9(Toc, { tocs })
+          }
+        )
+      ]
+    }
+  ) });
+}
+// .docu/pages/404.tsx
+import { jsx as jsx10, jsxs as jsxs7 } from "react/jsx-runtime";
+function NotFoundPage() {
+  return /* @__PURE__ */ jsx10("div", { className: "flex w-full flex-1 px-4 py-8 lg:h-[calc(100vh-4rem)] lg:px-8 lg:py-4", children: /* @__PURE__ */ jsxs7("div", { className: "bg-base-100 border-base-300 flex min-h-[50vh] w-full flex-col items-center justify-center rounded-xl border shadow-md lg:min-h-0 lg:flex-1", children: [
+    /* @__PURE__ */ jsx10("h1", { className: "text-6xl font-bold", children: "404" }),
+    /* @__PURE__ */ jsx10("p", { className: "text-base-content/60 py-4 text-xl", children: "Page not found" }),
+    /* @__PURE__ */ jsx10("a", { href: "/docs/", className: "btn btn-primary mt-2", children: "Go to Docs" })
+  ] }) });
+}
+// .docu/components/Lucide.tsx
+import * as LucideIcons from "lucide-react";
+import { jsx as jsx11 } from "react/jsx-runtime";
+function getLucideIcon(name) {
+  if (!name) return null;
+  const icon = LucideIcons[name];
+  return icon || null;
+}
+function renderLucideIcon(name, className) {
+  const Icon = getLucideIcon(name);
+  return Icon ? /* @__PURE__ */ jsx11(Icon, { className }) : null;
+}
+// .docu/components/home/Hero.tsx
+import { jsx as jsx12, jsxs as jsxs8 } from "react/jsx-runtime";
+function isExternalLink(link) {
+  return /^https?:\/\//.test(link);
+}
+function renderActionButtonIcon(iconName, className) {
+  if (!iconName) return null;
+  const lucideIcon = renderLucideIcon(iconName, className);
+  if (lucideIcon) return lucideIcon;
+  const SocialIcon = getSocialIcon(iconName);
+  if (SocialIcon) return /* @__PURE__ */ jsx12(SocialIcon, { className });
+  return null;
+}
+function ActionButton({ action }) {
+  const themeClasses = {
+    primary: "bg-primary text-primary-content hover:bg-primary/90",
+    secondary: "bg-secondary text-secondary-content hover:bg-secondary/90",
+    ghost: "bg-transparent text-muted-foreground border border-base-300 hover:bg-base-200"
+  };
+  const isExternal = isExternalLink(action.link);
+  return /* @__PURE__ */ jsxs8(
+    "a",
+    {
+      href: action.link,
+      target: isExternal ? "_blank" : void 0,
+      rel: isExternal ? "noopener noreferrer" : void 0,
+      className: cn(
+        "inline-flex items-center gap-2 rounded-lg px-6 py-3 text-sm font-medium transition-colors",
+        themeClasses[action.theme || "primary"]
+      ),
+      children: [
+        renderActionButtonIcon(action.icon, "h-4 w-4"),
+        action.text
+      ]
+    }
+  );
+}
+function Hero({ hero, className }) {
+  const { tagline, headline, description, actions } = hero;
+  return /* @__PURE__ */ jsx12("div", { className: cn("mx-auto max-w-4xl px-6 py-32 sm:py-44", className), children: /* @__PURE__ */ jsxs8("div", { className: "text-center", children: [
+    tagline && /* @__PURE__ */ jsx12("p", { className: "text-primary mb-4 text-lg font-semibold", children: tagline }),
+    /* @__PURE__ */ jsx12("h1", { className: "text-balance text-5xl font-semibold tracking-tight sm:text-7xl", children: headline }),
+    description && /* @__PURE__ */ jsx12("p", { className: "text-muted-foreground mt-8 text-pretty text-lg sm:text-xl", children: description }),
+    actions && actions.length > 0 && /* @__PURE__ */ jsx12("div", { className: "mt-10 flex flex-wrap items-center justify-center gap-4", children: actions.map((action, index) => /* @__PURE__ */ jsx12(ActionButton, { action }, index)) })
+  ] }) });
+}
+// .docu/components/home/Features.tsx
+import { jsx as jsx13, jsxs as jsxs9 } from "react/jsx-runtime";
+function FeatureCard({ feature, index }) {
+  const Wrapper = feature.link ? "a" : "div";
+  const wrapperProps = feature.link ? { href: feature.link } : {};
+  const patternId = `grid-${index}`;
+  return /* @__PURE__ */ jsxs9(
+    Wrapper,
+    {
+      ...wrapperProps,
+      className: cn(
+        "border-base-200 bg-base-100 hover:border-primary/40 group relative overflow-hidden rounded-2xl border p-6 transition-all hover:shadow-lg",
+        feature.link && "cursor-pointer"
+      ),
+      children: [
+        /* @__PURE__ */ jsxs9(
+          "svg",
+          {
+            className: "absolute inset-0 h-full w-full",
+            xmlns: "http://www.w3.org/2000/svg",
+            style: { color: "var(--color-primary)" },
+            "aria-hidden": "true",
+            children: [
+              /* @__PURE__ */ jsx13("defs", { children: /* @__PURE__ */ jsx13("pattern", { id: patternId, width: "40", height: "40", patternUnits: "userSpaceOnUse", children: /* @__PURE__ */ jsx13(
+                "path",
+                {
+                  d: "M 40 0 L 0 0 0 40",
+                  fill: "none",
+                  stroke: "currentColor",
+                  strokeWidth: "0.5",
+                  opacity: "0.15"
+                }
+              ) }) }),
+              /* @__PURE__ */ jsx13("rect", { width: "100%", height: "100%", fill: `url(#${patternId})` })
+            ]
+          }
+        ),
+        /* @__PURE__ */ jsxs9("div", { className: "relative z-10", children: [
+          feature.icon && /* @__PURE__ */ jsx13("div", { className: "bg-primary/10 mb-4 inline-flex h-12 w-12 items-center justify-center rounded-lg", children: renderLucideIcon(feature.icon, "h-6 w-6 text-primary") }),
+          /* @__PURE__ */ jsx13("h3", { className: "mb-2 text-lg font-semibold", children: feature.title }),
+          /* @__PURE__ */ jsx13("p", { className: "text-muted-foreground text-sm", children: feature.description })
+        ] })
+      ]
+    }
+  );
+}
+function Features({ features, className }) {
+  if (!features || features.length === 0) return null;
+  return /* @__PURE__ */ jsx13("div", { className: cn("mx-auto max-w-5xl px-6 pb-24", className), children: /* @__PURE__ */ jsx13("div", { className: "grid grid-cols-1 gap-6 sm:grid-cols-2 lg:grid-cols-3", children: features.map((feature, index) => /* @__PURE__ */ jsx13(FeatureCard, { feature, index }, index)) }) });
+}
+// .docu/pages/index.tsx
+import { jsx as jsx14, jsxs as jsxs10 } from "react/jsx-runtime";
+var docuConfig4 = loadDocuConfig();
+function IndexPage() {
+  const { meta, home } = docuConfig4;
+  const routes3 = docuConfig4.routes || [];
+  const linkWithHtml = (link) => {
+    if (isExternalUrl(link)) return link;
+    if (link.startsWith("/docs/")) return `${link}.html`;
+    return link;
+  };
+  const features = home?.features?.map((f) => ({
+    ...f,
+    link: f.link ? linkWithHtml(f.link) : void 0
+  })) || routes3.filter((r) => r.context).map((route) => ({
+    icon: route.context?.icon,
+    title: route.context?.title || route.title,
+    description: route.context?.description || "",
+    link: docsHtmlHref(`/docs${route.href}${route.items?.[0]?.href || ""}`)
+  }));
+  const hero = home?.hero ? {
+    ...home.hero,
+    actions: home.hero.actions?.map((a) => ({
+      ...a,
+      link: linkWithHtml(a.link)
+    }))
+  } : {
+    headline: meta.title,
+    description: meta.description
+  };
+  return /* @__PURE__ */ jsxs10("div", { className: "bg-base-100 relative isolate min-h-screen overflow-hidden", children: [
+    /* @__PURE__ */ jsx14("div", { className: "absolute right-4 top-4 z-10", id: "theme-island" }),
+    /* @__PURE__ */ jsx14(
+      "div",
+      {
+        "aria-hidden": "true",
+        className: "pointer-events-none absolute -top-40 left-1/2 -z-10 -translate-x-1/2 blur-3xl sm:-top-80",
+        children: /* @__PURE__ */ jsx14(
+          "div",
+          {
+            style: {
+              clipPath: "polygon(74.1% 44.1%, 100% 61.6%, 97.5% 26.9%, 85.5% 0.1%, 80.7% 2%, 72.5% 32.5%, 60.2% 62.4%, 52.4% 68.1%, 47.5% 58.3%, 45.2% 34.5%, 27.5% 76.7%, 0.1% 64.9%, 17.9% 100%, 27.6% 76.8%, 76.1% 97.7%, 74.1% 44.1%)"
+            },
+            className: "from-primary to-accent h-[40rem] w-[80rem] bg-gradient-to-tr opacity-20"
+          }
+        )
+      }
+    ),
+    /* @__PURE__ */ jsx14(Hero, { hero }),
+    /* @__PURE__ */ jsx14(Features, { features }),
+    /* @__PURE__ */ jsx14(
+      "div",
+      {
+        "aria-hidden": "true",
+        className: "pointer-events-none absolute bottom-0 left-1/2 -z-10 translate-x-1/4 blur-3xl",
+        children: /* @__PURE__ */ jsx14(
+          "div",
+          {
+            style: {
+              clipPath: "polygon(74.1% 44.1%, 100% 61.6%, 97.5% 26.9%, 85.5% 0.1%, 80.7% 2%, 72.5% 32.5%, 60.2% 62.4%, 52.4% 68.1%, 47.5% 58.3%, 45.2% 34.5%, 27.5% 76.7%, 0.1% 64.9%, 17.9% 100%, 27.6% 76.8%, 76.1% 97.7%, 74.1% 44.1%)"
+            },
+            className: "from-accent to-primary h-[30rem] w-[70rem] bg-gradient-to-tr opacity-20"
+          }
+        )
+      }
+    )
+  ] });
+}
+// .docu/components/DocsLayout.tsx
+import React2 from "react";
+// .docu/components/Menu.tsx
+import { useState as useState4 } from "react";
+// .docu/components/Sublink.tsx
+import { useState as useState3, useRef as useRef2, useEffect as useEffect3 } from "react";
+import { ChevronDown } from "lucide-react";
+// .docu/components/Anchor.tsx
+import { ArrowUpRight } from "lucide-react";
+import { jsx as jsx15, jsxs as jsxs11 } from "react/jsx-runtime";
+function Anchor({
+  href = "",
+  className = "",
+  activeClassName = "",
+  activeWhen,
+  disabled = false,
+  children,
+  ...props
+}) {
+  const isActive = (() => {
+    if (!activeWhen || typeof window === "undefined") return false;
+    const pathname = window.location.pathname;
+    if (typeof activeWhen === "string")
+      return pathname === activeWhen || pathname.endsWith(activeWhen);
+    if (activeWhen instanceof RegExp) return activeWhen.test(pathname);
+    if (typeof activeWhen === "function") return activeWhen(pathname);
+    return false;
+  })();
+  const isExternal = isExternalUrl(href);
+  const activeClass = isActive ? activeClassName : "";
+  const baseClasses = cn(
+    "hover:underline transition-colors",
+    className,
+    activeClass,
+    disabled && "cursor-not-allowed opacity-50"
+  );
+  if (disabled) {
+    return /* @__PURE__ */ jsx15("span", { className: baseClasses, children });
+  }
+  if (isExternal) {
+    return /* @__PURE__ */ jsxs11("a", { href, className: baseClasses, target: "_blank", rel: "noopener noreferrer", ...props, children: [
+      children,
+      /* @__PURE__ */ jsx15(ArrowUpRight, { className: "ml-0.5 inline-block h-3.5 w-3.5" })
+    ] });
+  }
+  return /* @__PURE__ */ jsx15("a", { href, className: baseClasses, ...props, children });
+}
+// .docu/components/Sublink.tsx
+import { jsx as jsx16, jsxs as jsxs12 } from "react/jsx-runtime";
+function Sublink({
+  title,
+  href,
+  items,
+  noLink,
+  level,
+  onNavigate,
+  parentHref = "",
+  pathname: pathnameProp
+}) {
+  const fullHref = parentHref ? `${parentHref}${href}` : `/docs${href}`;
+  const currentPathname = pathnameProp || (typeof window !== "undefined" ? window.location.pathname : "/docs");
+  const [isOpen, setIsOpen] = useState3(() => {
+    if (level === 0) return true;
+    if (!items) return false;
+    return currentPathname.startsWith(fullHref) && currentPathname !== fullHref;
+  });
+  const levelPadding = cn(level === 1 && "pl-2", level === 2 && "pl-4", level >= 3 && "pl-6");
+  const isActive = currentPathname === fullHref || currentPathname === `${fullHref}.html`;
+  const activeRef = useRef2(null);
+  useEffect3(() => {
+    if (isActive && activeRef.current) {
+      activeRef.current.scrollIntoView({ block: "nearest" });
+    }
+  }, [isActive]);
+  if (!items) {
+    const link = /* @__PURE__ */ jsx16(
+      Anchor,
+      {
+        href: docsHtmlHref(fullHref),
+        className: "text-foreground hover:text-foreground/80 text-sm transition-colors",
+        activeClassName: "text-primary font-medium",
+        activeWhen: (path) => path === fullHref || path === `${fullHref}.html`,
+        onClick: onNavigate,
+        children: title
+      }
+    );
+    return /* @__PURE__ */ jsx16(
+      "div",
+      {
+        ref: activeRef,
+        className: cn(
+          "py-1",
+          levelPadding,
+          level >= 2 && "border-l-2",
+          level >= 2 && (isActive ? "border-primary" : "border-base-300")
+        ),
+        children: link
+      }
+    );
+  }
+  return /* @__PURE__ */ jsxs12("div", { ref: isActive ? activeRef : void 0, className: cn("flex flex-col", levelPadding), children: [
+    /* @__PURE__ */ jsxs12(
+      "button",
+      {
+        type: "button",
+        onClick: () => setIsOpen(!isOpen),
+        className: cn(
+          "flex w-full cursor-pointer items-center justify-between py-1 text-left text-sm transition-colors",
+          noLink ? "text-base-content font-semibold" : "text-base-content/80 hover:text-base-content font-medium"
+        ),
+        children: [
+          noLink ? /* @__PURE__ */ jsx16("span", { children: title }) : /* @__PURE__ */ jsx16(
+            Anchor,
+            {
+              href: docsHtmlHref(fullHref),
+              className: "text-foreground hover:text-foreground/80 transition-colors",
+              activeClassName: "text-primary",
+              activeWhen: (path) => path === fullHref || path === `${fullHref}.html`,
+              onClick: onNavigate,
+              children: title
+            }
+          ),
+          /* @__PURE__ */ jsx16(
+            ChevronDown,
+            {
+              className: cn(
+                "text-base-content/40 h-4 w-4 shrink-0 transition-transform duration-200",
+                isOpen && "rotate-180"
+              )
+            }
+          )
+        ]
+      }
+    ),
+    isOpen && /* @__PURE__ */ jsx16("div", { className: "flex flex-col py-1", children: items.map((item) => /* @__PURE__ */ jsx16(
+      Sublink,
+      {
+        ...item,
+        href: item.href,
+        level: level + 1,
+        onNavigate,
+        parentHref: fullHref,
+        pathname: pathnameProp
+      },
+      `${fullHref}${item.href}`
+    )) })
+  ] });
+}
+// .docu/components/SidebarGroupHeader.tsx
+import { jsx as jsx17, jsxs as jsxs13 } from "react/jsx-runtime";
+function SidebarGroupHeader({ icon, title }) {
+  return /* @__PURE__ */ jsxs13("div", { className: "sidebar-group-header mb-1.5 flex items-center gap-2.5 font-medium text-gray-900 dark:text-gray-200", children: [
+    icon && /* @__PURE__ */ jsx17("span", { className: "flex h-4 w-4 shrink-0 items-center justify-center", children: renderLucideIcon(icon, "h-3.5 w-3.5") }),
+    /* @__PURE__ */ jsx17("h3", { className: "sidebar-title font-[inherit] text-[length:inherit] leading-[inherit]", children: /* @__PURE__ */ jsx17("span", { children: title }) })
+  ] });
+}
+// docu-config-runtime:../../docu.json
+import { readFileSync as readFileSync2 } from "node:fs";
+import { join as join4 } from "node:path";
+var config = JSON.parse(readFileSync2(join4(process.cwd(), "docu.json"), "utf-8"));
+var docu_default = config;
+// .docu/node/client-routes.ts
+var routes2 = docu_default.routes || [];
+var config2 = docu_default;
+// .docu/components/Menu.tsx
+import { jsx as jsx18, jsxs as jsxs14 } from "react/jsx-runtime";
+function getCurrentContext(path) {
+  if (!path.startsWith("/docs")) return void 0;
+  const match = path.match(/^\/docs\/([^/]+)/);
+  return match ? match[1] : void 0;
+}
+function getContextRoute(contextPath, routeList) {
+  return routeList.find((route) => {
+    const normalizedHref = route.href.replace(/^\/+|\/+$/, "");
+    return normalizedHref === contextPath;
+  });
+}
+function Menu({ onNavigate, className = "", pathname, routes: routes3 = [] }) {
+  const menuRoutes = routes3;
+  const [currentPath] = useState4(
+    () => pathname || (typeof window !== "undefined" ? window.location.pathname : "/docs")
+  );
+  if (!currentPath.startsWith("/docs")) return null;
+  const mode = config2.sidebar?.context || "dropdown";
+  const isItemActive = (itemHref, parentRouteHref) => {
+    const fullHref = `/docs${parentRouteHref}${itemHref}`;
+    return currentPath === fullHref || currentPath === `${fullHref}.html`;
+  };
+  if (mode === "separator") {
+    const contextRoutes = menuRoutes.filter((r) => r.context);
+    if (contextRoutes.length === 0) {
+      return /* @__PURE__ */ jsx18(
+        "nav",
+        {
+          "aria-label": "Documentation navigation",
+          className: cn("transition-all duration-200", className),
+          children: /* @__PURE__ */ jsx18("ul", { className: "flex flex-col gap-0.5 py-4", children: menuRoutes.map((route) => /* @__PURE__ */ jsx18("li", { children: /* @__PURE__ */ jsx18(
+            Sublink,
+            {
+              ...route,
+              href: route.href,
+              level: 0,
+              onNavigate,
+              parentHref: "/docs"
+            }
+          ) }, route.href)) })
+        }
+      );
+    }
+    return /* @__PURE__ */ jsx18(
+      "nav",
+      {
+        "aria-label": "Documentation navigation",
+        className: cn("transition-all duration-200", className),
+        children: contextRoutes.map((route, i) => /* @__PURE__ */ jsxs14("div", { className: i > 0 ? "mt-6 lg:mt-8" : "", children: [
+          /* @__PURE__ */ jsx18(
+            SidebarGroupHeader,
+            {
+              icon: route.context?.icon,
+              title: route.context?.title || route.title
+            }
+          ),
+          /* @__PURE__ */ jsx18("ul", { className: "border-base-300 flex flex-col gap-0.5 border-l-2 pb-0.5 pl-3 pt-0.5", children: route.items?.map((item) => {
+            const isActive = isItemActive(item.href, route.href);
+            return /* @__PURE__ */ jsx18("li", { children: /* @__PURE__ */ jsx18(
+              "div",
+              {
+                className: cn(
+                  "-ml-[14px] border-l-2",
+                  isActive ? "border-primary" : "border-transparent"
+                ),
+                children: /* @__PURE__ */ jsx18("div", { className: "pl-3", children: /* @__PURE__ */ jsx18(
+                  Sublink,
+                  {
+                    ...item,
+                    href: item.href,
+                    level: 0,
+                    onNavigate,
+                    parentHref: `/docs${route.href}`
+                  }
+                ) })
+              }
+            ) }, item.href);
+          }) })
+        ] }, route.href))
+      }
+    );
+  }
+  const isDocsRoot = currentPath === "/docs" || currentPath === "/docs/";
+  const currentContext = isDocsRoot ? menuRoutes[0]?.href.replace(/^\/+|\/+$/, "") : getCurrentContext(currentPath);
+  const contextRoute = isDocsRoot && menuRoutes[0] ? currentContext ? getContextRoute(currentContext, menuRoutes) : menuRoutes[0] : currentContext ? getContextRoute(currentContext, menuRoutes) : void 0;
+  if (!contextRoute) return null;
+  return /* @__PURE__ */ jsx18(
+    "nav",
+    {
+      "aria-label": "Documentation navigation",
+      className: cn("transition-all duration-200", className),
+      children: /* @__PURE__ */ jsx18("ul", { className: "flex flex-col gap-0.5 py-4", children: /* @__PURE__ */ jsx18("li", { children: /* @__PURE__ */ jsx18(
+        Sublink,
+        {
+          ...contextRoute,
+          href: contextRoute.href,
+          level: 0,
+          onNavigate,
+          parentHref: "/docs"
+        }
+      ) }, contextRoute.title) })
+    }
+  );
+}
+// .docu/components/DocsLayout.tsx
+var docuConfig5 = loadDocuConfig();
+function DocsLayout({ children, repoUrl, pathname = "/docs" }) {
+  return React2.createElement(
+    "div",
+    { className: "docs-layout flex flex-col min-h-screen w-full" },
+    React2.createElement(
+      "div",
+      { className: "flex flex-1 items-start w-full" },
+      React2.createElement(
+        "aside",
+        {
+          id: "sidebar-island",
+          className: "sticky top-0 hidden h-screen w-[280px] shrink-0 flex-col lg:flex border-r border-base-200 bg-base-100",
+          "data-tocs": "[]",
+          "data-title": "",
+          "data-repo": repoUrl || ""
+        },
+        // SSR sidebar content — Menu rendered server-side
+        React2.createElement(
+          "div",
+          { className: "flex h-full flex-col overflow-y-auto px-4" },
+          React2.createElement(Menu, { pathname, routes: docuConfig5.routes || [] })
+        )
+      ),
+      React2.createElement(
+        "main",
+        { className: "flex-1 min-w-0 min-h-screen flex flex-col" },
+        React2.createElement(
+          "div",
+          { className: "hidden lg:flex items-center justify-end gap-6 h-14 px-8" },
+          React2.createElement(
+            "nav",
+            { className: "flex items-center gap-6 text-sm font-medium text-base-content/80" },
+            ...(docuConfig5.navbar?.menu || []).map((item) => {
+              const isExternal = /^https?:\/\//.test(item.href);
+              const isDocsActive = item.href === "/docs";
+              return React2.createElement(
+                "a",
+                {
+                  key: item.title,
+                  href: item.href,
+                  className: `flex items-center gap-1 hover:text-base-content transition-colors${isDocsActive ? " text-primary font-semibold" : ""}`,
+                  ...isExternal ? { target: "_blank", rel: "noopener noreferrer" } : {}
+                },
+                item.title,
+                isExternal ? React2.createElement(
+                  "svg",
+                  {
+                    xmlns: "http://www.w3.org/2000/svg",
+                    width: "14",
+                    height: "14",
+                    viewBox: "0 0 24 24",
+                    fill: "none",
+                    stroke: "currentColor",
+                    strokeWidth: "2",
+                    strokeLinecap: "round",
+                    strokeLinejoin: "round"
+                  },
+                  React2.createElement("path", { d: "M7 7h10v10" }),
+                  React2.createElement("path", { d: "M7 17 17 7" })
+                ) : null
+              );
+            })
+          )
+        ),
+        React2.createElement("div", { className: "flex-1 w-full" }, children)
+      )
+    )
+  );
+}
+// .docu/node/escapeHtml.ts
+var ESCAPE_RE = /[&<>"']/g;
+var ESCAPE_MAP = {
+  "&": "&amp;",
+  "<": "&lt;",
+  ">": "&gt;",
+  '"': "&quot;",
+  "'": "&#x27;"
+};
+function escapeHtml(input) {
+  return input.replace(ESCAPE_RE, (ch) => ESCAPE_MAP[ch]);
+}
+// .docu/node/html.shared.ts
+function htmlShell(opts) {
+  const {
+    title,
+    description,
+    body,
+    favicon,
+    css,
+    js,
+    nonce,
+    csp,
+    extraScripts,
+    themeCss,
+    depth = 0,
+    headExtra,
+    bodyExtra
+  } = opts;
+  const nonceAttr = nonce ? ` nonce="${escapeHtml(nonce)}"` : "";
+  const themeStyle = themeCss ? `
+  <style${nonceAttr}>${escapeHtml(themeCss)}</style>` : "";
+  const headInjection = headExtra?.length ? `
+  ${headExtra.join("\n  ")}` : "";
+  const bodyInjection = bodyExtra?.length ? `
+  ${bodyExtra.join("\n  ")}` : "";
+  const depthPrefix = depth === 0 ? "" : "../".repeat(depth);
+  const assetPrefix = depthPrefix + "assets/";
+  const resolvePath = (path) => path.startsWith("/") ? depthPrefix + path.slice(1) : path;
+  return `<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>${escapeHtml(title)}</title>
+  <meta name="description" content="${escapeHtml(description)}">
+  ${favicon ? `<link rel="icon" type="image/x-icon" href="${escapeHtml(resolvePath(favicon))}">` : ""}${themeStyle}
+  <link rel="stylesheet" href="${escapeHtml(assetPrefix + css)}">
+  ${csp ? `<meta http-equiv="Content-Security-Policy" content="${escapeHtml(csp)}">` : ""}
+  <script${nonceAttr}>try{if(localStorage.getItem("theme")==="dark")document.documentElement.classList.add("dark")}catch(e){}</script>${headInjection}
+</head>
+<body>
+  <div id="root">${body}</div>
+  <script type="module"${nonceAttr} src="${escapeHtml(assetPrefix + js)}"></script>${extraScripts ? `
+  ${extraScripts}` : ""}${bodyInjection}
+</body>
+</html>`;
+}
+function errorHtml(message, stack) {
+  const msg = escapeHtml(message || "Unknown error");
+  const st = escapeHtml(stack || "");
+  return `<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="utf-8">
+  <title>Server Error</title>
+  <style>
+    *{margin:0;padding:0;box-sizing:border-box}
+    body{padding:2rem;font-family:ui-monospace,monospace;background:#1a1a2e;color:#e0e0e0}
+    h1{color:#ff6b6b;font-size:1.5rem;margin-bottom:1rem}
+    pre{background:#0d0d1a;border:1px solid #333;border-radius:8px;padding:1.5rem;overflow-x:auto;font-size:14px;line-height:1.6;white-space:pre-wrap;word-break:break-word}
+    .msg{color:#ff6b6b;font-weight:bold}
+  </style>
+</head>
+  <body>
+  <h1>\u{1F525} Server Error</h1>
+    <pre><span class="msg">${msg}</span>${st ? `
+${st}` : ""}</pre>
+  </body>
+</html>`;
+}
+function hmrScript(nonce) {
+  return `<script nonce="${escapeHtml(nonce)}">
+(function(){
+  const es = new EventSource("/__hmr");
+  es.onmessage = function(e) {
+    if (e.data === "reload") window.location.reload();
+  };
+  es.onerror = function() { es.close(); setTimeout(() => { window.location.reload(); }, 2000); };
+})();
+</script>`;
+}
+export {
+  loadPlugins,
+  BuildPluginBuilder,
+  computeInlineThemeCss,
+  buildClientBundle,
+  generateSearchIndex,
+  initSentry,
+  captureException,
+  getGitLastModifiedBatch,
+  compileMdx,
+  DocsPage,
+  NotFoundPage,
+  IndexPage,
+  DocsLayout,
+  htmlShell,
+  errorHtml,
+  hmrScript
+};