boltdocs 1.0.1 → 1.0.4

package/dist/{CodeBlock-37XMKCYY.mjs → CodeBlock-V3Z5EKGR.mjs}

@@ -1,7 +1,6 @@
 import {
   CodeBlock
 } from "./chunk-2YRDWM6O.mjs";
-import "./chunk-X6BYQHVC.mjs";
 export {
   CodeBlock
 };

package/dist/{PackageManagerTabs-4NWXLXQO.mjs → PackageManagerTabs-XEKI3L7P.mjs}

@@ -1,5 +1,3 @@
-import "./chunk-X6BYQHVC.mjs";
-
 // src/client/theme/components/PackageManagerTabs/PackageManagerTabs.tsx
 import { useState, useCallback } from "react";
 import { Copy, Check } from "lucide-react";

package/dist/Playground-B2FA34BC.mjs

@@ -0,0 +1,6 @@
+import {
+  Playground
+} from "./chunk-WPT4MWTQ.mjs";
+export {
+  Playground
+};

package/dist/{SearchDialog-ZAZXYIFX.css → SearchDialog-PYF3QMYG.css}

@@ -1142,11 +1142,11 @@ a {
   background-color: transparent !important;
 }
 .code-block-wrapper pre > code {
-  padding: 1.25rem !important;
-  display: block !important;
+  display: grid !important;
+  padding: 1.25rem 1rem !important;
 }
 .code-block-wrapper pre > code .line {
-  padding: 0;
+  padding: 0 1.25rem;
 }
 .boltdocs-page pre {
   margin: 1.5rem 0;

package/dist/{SearchDialog-FTOQZ763.mjs → SearchDialog-R36WKAQ7.mjs}

@@ -1,7 +1,6 @@
 import {
   Link
-} from "./chunk-ZFCOLEXN.mjs";
-import "./chunk-X6BYQHVC.mjs";
+} from "./chunk-TWSRXUFF.mjs";
 
 // src/client/theme/ui/SearchDialog/SearchDialog.tsx
 import React, { useState, useEffect, useRef } from "react";

package/dist/{Video-I6QY4X7J.mjs → Video-KNTY5BNO.mjs}

@@ -1,7 +1,6 @@
 import {
   Video
 } from "./chunk-Z7JHYNAS.mjs";
-import "./chunk-X6BYQHVC.mjs";
 export {
   Video
 };

package/dist/{chunk-ZFCOLEXN.mjs → chunk-TWSRXUFF.mjs}

@@ -897,20 +897,20 @@ function useConfig() {
   return useContext2(ConfigContext);
 }
 var CodeBlock = lazy(
-  () => import("./CodeBlock-37XMKCYY.mjs").then((m) => ({
+  () => import("./CodeBlock-V3Z5EKGR.mjs").then((m) => ({
     default: m.CodeBlock
   }))
 );
 var Video = lazy(
-  () => import("./Video-I6QY4X7J.mjs").then((m) => ({ default: m.Video }))
+  () => import("./Video-KNTY5BNO.mjs").then((m) => ({ default: m.Video }))
 );
 var PackageManagerTabs = lazy(
-  () => import("./PackageManagerTabs-4NWXLXQO.mjs").then((m) => ({
+  () => import("./PackageManagerTabs-XEKI3L7P.mjs").then((m) => ({
     default: m.PackageManagerTabs
   }))
 );
 var Playground = lazy(
-  () => import("./Playground-OE2OE6B6.mjs").then((m) => ({
+  () => import("./Playground-B2FA34BC.mjs").then((m) => ({
     default: m.Playground
   }))
 );
@@ -1105,11 +1105,8 @@ function createBoltdocsApp(options) {
       components: options.components
     }
   ) }) });
-  if (import.meta.env.PROD && container.innerHTML.trim() !== "") {
-    ReactDOM.hydrateRoot(container, app);
-  } else {
-    ReactDOM.createRoot(container).render(app);
-  }
+  container.innerHTML = "";
+  ReactDOM.createRoot(container).render(app);
 }
 
 // src/client/theme/ui/Link/Link.tsx
@@ -1525,7 +1522,7 @@ var XformerlyTwitter = (props) => /* @__PURE__ */ jsx24("svg", { ...props, fill:
 // src/client/theme/ui/Navbar/Navbar.tsx
 import { jsx as jsx25, jsxs as jsxs17 } from "react/jsx-runtime";
 var SearchDialog = React11.lazy(
-  () => import("./SearchDialog-FTOQZ763.mjs").then((m) => ({ default: m.SearchDialog }))
+  () => import("./SearchDialog-R36WKAQ7.mjs").then((m) => ({ default: m.SearchDialog }))
 );
 var ICON_MAP3 = {
   discord: Discord,

package/dist/{chunk-PN4GCTYG.mjs → chunk-WPT4MWTQ.mjs}

@@ -3,18 +3,40 @@ import React, { useState } from "react";
 import { LiveProvider, LiveEditor, LiveError, LivePreview } from "react-live";
 import { Copy, Check, Terminal, Play } from "lucide-react";
 import { jsx, jsxs } from "react/jsx-runtime";
+function prepareCode(raw) {
+  const trimmed = raw.trim();
+  const fnMatch = trimmed.match(/export\s+default\s+function\s+(\w+)/);
+  if (fnMatch) {
+    const name = fnMatch[1];
+    const code = trimmed.replace(/export\s+default\s+/, "") + `
+
+render(<${name} />);`;
+    return { code, noInline: true };
+  }
+  const varMatch = trimmed.match(/export\s+default\s+(\w+)\s*;?\s*$/);
+  if (varMatch) {
+    const name = varMatch[1];
+    const code = trimmed.replace(/export\s+default\s+\w+\s*;?\s*$/, "") + `
+render(<${name} />);`;
+    return { code, noInline: true };
+  }
+  return { code: trimmed, noInline: false };
+}
 function Playground({
   code,
   children,
   scope = {},
-  readonly = false
+  readonly = false,
+  noInline: forceNoInline
 }) {
   let initialCode = code || "";
   if (!initialCode && typeof children === "string") {
     initialCode = children;
   }
+  const prepared = prepareCode(initialCode);
+  const useNoInline = forceNoInline ?? prepared.noInline;
   const [copied, setCopied] = useState(false);
-  const [activeCode, setActiveCode] = useState(initialCode.trim());
+  const [activeCode, setActiveCode] = useState(prepared.code);
   const handleCopy = () => {
     navigator.clipboard.writeText(activeCode);
     setCopied(true);
@@ -27,7 +49,7 @@ function Playground({
       code: activeCode,
       scope: extendedScope,
       theme: void 0,
-      noInline: false,
+      noInline: useNoInline,
       children: /* @__PURE__ */ jsxs("div", { className: "playground-split-container", children: [
         /* @__PURE__ */ jsxs("div", { className: "playground-panel playground-editor-panel", children: [
           /* @__PURE__ */ jsxs("div", { className: "playground-panel-header", children: [

package/dist/client/index.css

@@ -1142,11 +1142,11 @@ a {
   background-color: transparent !important;
 }
 .code-block-wrapper pre > code {
-  padding: 1.25rem !important;
-  display: block !important;
+  display: grid !important;
+  padding: 1.25rem 1rem !important;
 }
 .code-block-wrapper pre > code .line {
-  padding: 0;
+  padding: 0 1.25rem;
 }
 .boltdocs-page pre {
   margin: 1.5rem 0;

package/dist/client/index.d.mts

@@ -1,11 +1,38 @@
 import { B as BoltdocsConfig } from '../config-D2XmHJYe.mjs';
 export { a as BoltdocsThemeConfig } from '../config-D2XmHJYe.mjs';
-import { C as ComponentRoute } from '../index-CRQKWAeo.mjs';
-export { a as CreateBoltdocsAppOptions, c as createBoltdocsApp } from '../index-CRQKWAeo.mjs';
+import { C as CreateBoltdocsAppOptions, a as ComponentRoute } from '../types-CvrzTbEX.mjs';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import React from 'react';
 import 'vite';
 
+declare global {
+    interface ImportMeta {
+        env: Record<string, any>;
+    }
+}
+/**
+ * Creates and mounts the Boltdocs documentation app.
+ *
+ * Usage:
+ * ```tsx
+ * import { createBoltdocsApp } from 'boltdocs/client'
+ * import routes from 'virtual:boltdocs-routes'
+ * import config from 'virtual:boltdocs-config'
+ * import 'boltdocs/style.css'
+ * import HomePage from './HomePage'
+ *
+ * createBoltdocsApp({
+ *   target: '#root',
+ *   routes,
+ *   config,
+ *   modules: import.meta.glob('/docs/**\/*.{md,mdx}'),
+ *   hot: import.meta.hot,
+ *   homePage: HomePage,
+ * })
+ * ```
+ */
+declare function createBoltdocsApp(options: CreateBoltdocsAppOptions): void;
+
 /**
  * The top navigation bar of the documentation site.
  */
@@ -109,12 +136,15 @@ interface PlaygroundProps {
     children?: string | React.ReactNode;
     scope?: Record<string, any>;
     readonly?: boolean;
+    noInline?: boolean;
 }
 /**
  * A live React playground component.
  * Features a split layout with a live editor and a preview section.
+ *
+ * Supports `export default function App()` style code out of the box.
  */
-declare function Playground({ code, children, scope, readonly, }: PlaygroundProps): react_jsx_runtime.JSX.Element;
+declare function Playground({ code, children, scope, readonly, noInline: forceNoInline, }: PlaygroundProps): react_jsx_runtime.JSX.Element;
 
 declare function NotFound(): react_jsx_runtime.JSX.Element;
 
@@ -295,4 +325,4 @@ interface ListProps extends React.HTMLAttributes<HTMLUListElement> {
  */
 declare function List({ variant, children, className, ...rest }: ListProps): react_jsx_runtime.JSX.Element;
 
-export { Admonition, type AdmonitionProps, BackgroundGradient, Badge, type BadgeProps, BoltdocsConfig, Breadcrumbs, Button, type ButtonProps, Card, type CardProps, Cards, type CardsProps, CodeBlock, ComponentRoute, Danger, Head, InfoBox, List, type ListProps, Loading, Navbar, NotFound, Note, OnThisPage, Playground, Sidebar, Tab, type TabProps, Tabs, type TabsProps, ThemeLayout, Tip, Video, Warning };
+export { Admonition, type AdmonitionProps, BackgroundGradient, Badge, type BadgeProps, BoltdocsConfig, Breadcrumbs, Button, type ButtonProps, Card, type CardProps, Cards, type CardsProps, CodeBlock, ComponentRoute, CreateBoltdocsAppOptions, Danger, Head, InfoBox, List, type ListProps, Loading, Navbar, NotFound, Note, OnThisPage, Playground, Sidebar, Tab, type TabProps, Tabs, type TabsProps, ThemeLayout, Tip, Video, Warning, createBoltdocsApp };

package/dist/client/index.d.ts

@@ -1,11 +1,38 @@
 import { B as BoltdocsConfig } from '../config-D2XmHJYe.js';
 export { a as BoltdocsThemeConfig } from '../config-D2XmHJYe.js';
-import { C as ComponentRoute } from '../index-CRQKWAeo.js';
-export { a as CreateBoltdocsAppOptions, c as createBoltdocsApp } from '../index-CRQKWAeo.js';
+import { C as CreateBoltdocsAppOptions, a as ComponentRoute } from '../types-CvrzTbEX.js';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import React from 'react';
 import 'vite';
 
+declare global {
+    interface ImportMeta {
+        env: Record<string, any>;
+    }
+}
+/**
+ * Creates and mounts the Boltdocs documentation app.
+ *
+ * Usage:
+ * ```tsx
+ * import { createBoltdocsApp } from 'boltdocs/client'
+ * import routes from 'virtual:boltdocs-routes'
+ * import config from 'virtual:boltdocs-config'
+ * import 'boltdocs/style.css'
+ * import HomePage from './HomePage'
+ *
+ * createBoltdocsApp({
+ *   target: '#root',
+ *   routes,
+ *   config,
+ *   modules: import.meta.glob('/docs/**\/*.{md,mdx}'),
+ *   hot: import.meta.hot,
+ *   homePage: HomePage,
+ * })
+ * ```
+ */
+declare function createBoltdocsApp(options: CreateBoltdocsAppOptions): void;
+
 /**
  * The top navigation bar of the documentation site.
  */
@@ -109,12 +136,15 @@ interface PlaygroundProps {
     children?: string | React.ReactNode;
     scope?: Record<string, any>;
     readonly?: boolean;
+    noInline?: boolean;
 }
 /**
  * A live React playground component.
  * Features a split layout with a live editor and a preview section.
+ *
+ * Supports `export default function App()` style code out of the box.
  */
-declare function Playground({ code, children, scope, readonly, }: PlaygroundProps): react_jsx_runtime.JSX.Element;
+declare function Playground({ code, children, scope, readonly, noInline: forceNoInline, }: PlaygroundProps): react_jsx_runtime.JSX.Element;
 
 declare function NotFound(): react_jsx_runtime.JSX.Element;
 
@@ -295,4 +325,4 @@ interface ListProps extends React.HTMLAttributes<HTMLUListElement> {
  */
 declare function List({ variant, children, className, ...rest }: ListProps): react_jsx_runtime.JSX.Element;
 
-export { Admonition, type AdmonitionProps, BackgroundGradient, Badge, type BadgeProps, BoltdocsConfig, Breadcrumbs, Button, type ButtonProps, Card, type CardProps, Cards, type CardsProps, CodeBlock, ComponentRoute, Danger, Head, InfoBox, List, type ListProps, Loading, Navbar, NotFound, Note, OnThisPage, Playground, Sidebar, Tab, type TabProps, Tabs, type TabsProps, ThemeLayout, Tip, Video, Warning };
+export { Admonition, type AdmonitionProps, BackgroundGradient, Badge, type BadgeProps, BoltdocsConfig, Breadcrumbs, Button, type ButtonProps, Card, type CardProps, Cards, type CardsProps, CodeBlock, ComponentRoute, CreateBoltdocsAppOptions, Danger, Head, InfoBox, List, type ListProps, Loading, Navbar, NotFound, Note, OnThisPage, Playground, Sidebar, Tab, type TabProps, Tabs, type TabsProps, ThemeLayout, Tip, Video, Warning, createBoltdocsApp };

package/dist/client/index.js

@@ -2396,18 +2396,40 @@ var init_PackageManagerTabs2 = __esm({
 });
 
 // src/client/theme/components/Playground/Playground.tsx
+function prepareCode(raw) {
+  const trimmed = raw.trim();
+  const fnMatch = trimmed.match(/export\s+default\s+function\s+(\w+)/);
+  if (fnMatch) {
+    const name = fnMatch[1];
+    const code = trimmed.replace(/export\s+default\s+/, "") + `
+
+render(<${name} />);`;
+    return { code, noInline: true };
+  }
+  const varMatch = trimmed.match(/export\s+default\s+(\w+)\s*;?\s*$/);
+  if (varMatch) {
+    const name = varMatch[1];
+    const code = trimmed.replace(/export\s+default\s+\w+\s*;?\s*$/, "") + `
+render(<${name} />);`;
+    return { code, noInline: true };
+  }
+  return { code: trimmed, noInline: false };
+}
 function Playground({
   code,
   children,
   scope = {},
-  readonly = false
+  readonly = false,
+  noInline: forceNoInline
 }) {
   let initialCode = code || "";
   if (!initialCode && typeof children === "string") {
     initialCode = children;
   }
+  const prepared = prepareCode(initialCode);
+  const useNoInline = forceNoInline ?? prepared.noInline;
   const [copied, setCopied] = (0, import_react18.useState)(false);
-  const [activeCode, setActiveCode] = (0, import_react18.useState)(initialCode.trim());
+  const [activeCode, setActiveCode] = (0, import_react18.useState)(prepared.code);
   const handleCopy = () => {
     navigator.clipboard.writeText(activeCode);
     setCopied(true);
@@ -2420,7 +2442,7 @@ function Playground({
       code: activeCode,
       scope: extendedScope,
       theme: void 0,
-      noInline: false,
+      noInline: useNoInline,
       children: /* @__PURE__ */ (0, import_jsx_runtime33.jsxs)("div", { className: "playground-split-container", children: [
         /* @__PURE__ */ (0, import_jsx_runtime33.jsxs)("div", { className: "playground-panel playground-editor-panel", children: [
           /* @__PURE__ */ (0, import_jsx_runtime33.jsxs)("div", { className: "playground-panel-header", children: [
@@ -2634,13 +2656,10 @@ function createBoltdocsApp(options) {
       components: options.components
     }
   ) }) });
-  if (import_meta.env.PROD && container.innerHTML.trim() !== "") {
-    import_client.default.hydrateRoot(container, app);
-  } else {
-    import_client.default.createRoot(container).render(app);
-  }
+  container.innerHTML = "";
+  import_client.default.createRoot(container).render(app);
 }
-var import_react19, import_client, import_react_router_dom9, import_react20, import_react21, import_lucide_react17, import_jsx_runtime34, import_meta, ConfigContext, CodeBlock2, Video2, PackageManagerTabs2, Playground2, Heading, mdxComponents;
+var import_react19, import_client, import_react_router_dom9, import_react20, import_react21, import_lucide_react17, import_jsx_runtime34, ConfigContext, CodeBlock2, Video2, PackageManagerTabs2, Playground2, Heading, mdxComponents;
 var init_app = __esm({
   "src/client/app/index.tsx"() {
     "use strict";
@@ -2656,7 +2675,6 @@ var init_app = __esm({
     init_mdx();
     init_preload();
     import_jsx_runtime34 = require("react/jsx-runtime");
-    import_meta = {};
     ConfigContext = (0, import_react21.createContext)(null);
     CodeBlock2 = (0, import_react21.lazy)(
       () => Promise.resolve().then(() => (init_CodeBlock2(), CodeBlock_exports)).then((m) => ({

package/dist/client/index.mjs

@@ -1,6 +1,3 @@
-import {
-  Playground
-} from "../chunk-PN4GCTYG.mjs";
 import {
   Admonition,
   BackgroundGradient,
@@ -25,14 +22,16 @@ import {
   Tip,
   Warning,
   createBoltdocsApp
-} from "../chunk-ZFCOLEXN.mjs";
+} from "../chunk-TWSRXUFF.mjs";
 import {
   CodeBlock
 } from "../chunk-2YRDWM6O.mjs";
 import {
   Video
 } from "../chunk-Z7JHYNAS.mjs";
-import "../chunk-X6BYQHVC.mjs";
+import {
+  Playground
+} from "../chunk-WPT4MWTQ.mjs";
 export {
   Admonition,
   BackgroundGradient,

package/dist/client/ssr.css

@@ -1142,11 +1142,11 @@ a {
   background-color: transparent !important;
 }
 .code-block-wrapper pre > code {
-  padding: 1.25rem !important;
-  display: block !important;
+  display: grid !important;
+  padding: 1.25rem 1rem !important;
 }
 .code-block-wrapper pre > code .line {
-  padding: 0;
+  padding: 0 1.25rem;
 }
 .boltdocs-page pre {
   margin: 1.5rem 0;

package/dist/client/ssr.d.mts

@@ -1,5 +1,5 @@
 import React from 'react';
-import { C as ComponentRoute } from '../index-CRQKWAeo.mjs';
+import { a as ComponentRoute } from '../types-CvrzTbEX.mjs';
 
 /**
  * Options for rendering the Boltdocs application on the server (SSG).

package/dist/client/ssr.d.ts

@@ -1,5 +1,5 @@
 import React from 'react';
-import { C as ComponentRoute } from '../index-CRQKWAeo.js';
+import { a as ComponentRoute } from '../types-CvrzTbEX.js';
 
 /**
  * Options for rendering the Boltdocs application on the server (SSG).

package/dist/client/ssr.js

@@ -2396,18 +2396,40 @@ var init_PackageManagerTabs2 = __esm({
 });
 
 // src/client/theme/components/Playground/Playground.tsx
+function prepareCode(raw) {
+  const trimmed = raw.trim();
+  const fnMatch = trimmed.match(/export\s+default\s+function\s+(\w+)/);
+  if (fnMatch) {
+    const name = fnMatch[1];
+    const code = trimmed.replace(/export\s+default\s+/, "") + `
+
+render(<${name} />);`;
+    return { code, noInline: true };
+  }
+  const varMatch = trimmed.match(/export\s+default\s+(\w+)\s*;?\s*$/);
+  if (varMatch) {
+    const name = varMatch[1];
+    const code = trimmed.replace(/export\s+default\s+\w+\s*;?\s*$/, "") + `
+render(<${name} />);`;
+    return { code, noInline: true };
+  }
+  return { code: trimmed, noInline: false };
+}
 function Playground({
   code,
   children,
   scope = {},
-  readonly = false
+  readonly = false,
+  noInline: forceNoInline
 }) {
   let initialCode = code || "";
   if (!initialCode && typeof children === "string") {
     initialCode = children;
   }
+  const prepared = prepareCode(initialCode);
+  const useNoInline = forceNoInline ?? prepared.noInline;
   const [copied, setCopied] = (0, import_react18.useState)(false);
-  const [activeCode, setActiveCode] = (0, import_react18.useState)(initialCode.trim());
+  const [activeCode, setActiveCode] = (0, import_react18.useState)(prepared.code);
   const handleCopy = () => {
     navigator.clipboard.writeText(activeCode);
     setCopied(true);
@@ -2420,7 +2442,7 @@ function Playground({
       code: activeCode,
       scope: extendedScope,
       theme: void 0,
-      noInline: false,
+      noInline: useNoInline,
       children: /* @__PURE__ */ (0, import_jsx_runtime33.jsxs)("div", { className: "playground-split-container", children: [
         /* @__PURE__ */ (0, import_jsx_runtime33.jsxs)("div", { className: "playground-panel playground-editor-panel", children: [
           /* @__PURE__ */ (0, import_jsx_runtime33.jsxs)("div", { className: "playground-panel-header", children: [

package/dist/client/ssr.mjs

@@ -1,7 +1,6 @@
 import {
   AppShell
-} from "../chunk-ZFCOLEXN.mjs";
-import "../chunk-X6BYQHVC.mjs";
+} from "../chunk-TWSRXUFF.mjs";
 
 // src/client/ssr.tsx
 import React from "react";