specweave 0.11.0 → 0.12.0

package/dist/src/utils/docs-preview/config-generator.js

@@ -0,0 +1,377 @@
+/**
+ * Docusaurus configuration generator
+ * Generates docusaurus.config.js with sensible defaults
+ */
+import * as path from 'path';
+import * as fs from 'fs-extra';
+/**
+ * Generate docusaurus.config.js content
+ */
+export function generateDocusaurusConfig(config) {
+    const { title, tagline, url, baseUrl, docsPath, theme = 'default' } = config;
+    return `// @ts-check
+// This is a Docusaurus site configuration object.
+// Auto-generated by SpecWeave docs-preview plugin
+// Generated: ${new Date().toISOString()}
+
+import {themes as prismThemes} from 'prism-react-renderer';
+
+/** @type {import('@docusaurus/types').Config} */
+const config = {
+  title: '${title}',
+  tagline: '${tagline}',
+  favicon: 'img/favicon.ico',
+
+  // Production URL
+  url: '${url}',
+  baseUrl: '${baseUrl}',
+
+  // GitHub Pages deployment config
+  organizationName: 'your-org',
+  projectName: 'your-repo',
+
+  onBrokenLinks: 'warn',
+  onBrokenMarkdownLinks: 'warn',
+
+  // Internationalization
+  i18n: {
+    defaultLocale: 'en',
+    locales: ['en'],
+  },
+
+  presets: [
+    [
+      'classic',
+      /** @type {import('@docusaurus/preset-classic').Options} */
+      ({
+        docs: {
+          routeBasePath: '/',
+          path: '${docsPath}',
+          sidebarPath: './sidebars.js',
+          editUrl: undefined, // Disable "Edit this page" for internal docs
+        },
+        blog: false, // Disable blog
+        theme: {
+          customCss: './src/css/custom.css',
+        },
+      }),
+    ],
+  ],
+
+  themeConfig:
+    /** @type {import('@docusaurus/preset-classic').ThemeConfig} */
+    ({
+      // Social card image (optional)
+      image: 'img/docusaurus-social-card.jpg',
+
+      navbar: {
+        title: '${title}',
+        logo: {
+          alt: '${title} Logo',
+          src: 'img/logo.svg',
+        },
+        items: [
+          {
+            type: 'docSidebar',
+            sidebarId: 'docs',
+            position: 'left',
+            label: 'Documentation',
+          },
+        ],
+      },
+
+      footer: {
+        style: 'dark',
+        links: [
+          {
+            title: 'Documentation',
+            items: [
+              {
+                label: 'Strategy',
+                to: '/strategy',
+              },
+              {
+                label: 'Architecture',
+                to: '/architecture',
+              },
+            ],
+          },
+        ],
+        copyright: \`Copyright © \${new Date().getFullYear()} SpecWeave. Built with Docusaurus.\`,
+      },
+
+      prism: {
+        theme: prismThemes.github,
+        darkTheme: prismThemes.dracula,
+        additionalLanguages: ['bash', 'typescript', 'javascript', 'json', 'yaml'],
+      },
+    }),
+
+  // Mermaid diagrams support
+  markdown: {
+    mermaid: true,
+  },
+  themes: ['@docusaurus/theme-mermaid'],
+};
+
+export default config;
+`;
+}
+/**
+ * Write docusaurus.config.js to file
+ */
+export async function writeDocusaurusConfig(targetDir, config) {
+    const configPath = path.join(targetDir, 'docusaurus.config.js');
+    const content = generateDocusaurusConfig(config);
+    await fs.ensureDir(targetDir);
+    await fs.writeFile(configPath, content, 'utf-8');
+}
+/**
+ * Generate package.json for Docusaurus site
+ */
+export function generatePackageJSON(title) {
+    return JSON.stringify({
+        name: 'specweave-docs',
+        version: '1.0.0',
+        description: `${title} - Documentation Site`,
+        private: true,
+        scripts: {
+            docusaurus: 'docusaurus',
+            start: 'docusaurus start',
+            build: 'docusaurus build',
+            swizzle: 'docusaurus swizzle',
+            deploy: 'docusaurus deploy',
+            clear: 'docusaurus clear',
+            serve: 'docusaurus serve',
+            'write-translations': 'docusaurus write-translations',
+            'write-heading-ids': 'docusaurus write-heading-ids'
+        },
+        dependencies: {
+            '@docusaurus/core': '^3.0.0',
+            '@docusaurus/preset-classic': '^3.0.0',
+            '@docusaurus/theme-mermaid': '^3.0.0',
+            '@mdx-js/react': '^3.0.0',
+            clsx: '^2.0.0',
+            'prism-react-renderer': '^2.1.0',
+            react: '^18.0.0',
+            'react-dom': '^18.0.0'
+        },
+        devDependencies: {
+            '@docusaurus/module-type-aliases': '^3.0.0',
+            '@docusaurus/types': '^3.0.0'
+        },
+        engines: {
+            node: '>=18.0'
+        }
+    }, null, 2);
+}
+/**
+ * Write package.json to file
+ */
+export async function writePackageJSON(targetDir, title) {
+    const packagePath = path.join(targetDir, 'package.json');
+    const content = generatePackageJSON(title);
+    await fs.ensureDir(targetDir);
+    await fs.writeFile(packagePath, content, 'utf-8');
+}
+/**
+ * Generate custom CSS for theme customization
+ */
+export function generateCustomCSS(theme) {
+    const themes = {
+        default: `
+:root {
+  --ifm-color-primary: #2e8555;
+  --ifm-color-primary-dark: #29784c;
+  --ifm-color-primary-darker: #277148;
+  --ifm-color-primary-darkest: #205d3b;
+  --ifm-color-primary-light: #33925d;
+  --ifm-color-primary-lighter: #359962;
+  --ifm-color-primary-lightest: #3cad6e;
+  --ifm-code-font-size: 95%;
+  --docusaurus-highlighted-code-line-bg: rgba(0, 0, 0, 0.1);
+}
+
+[data-theme='dark'] {
+  --ifm-color-primary: #25c2a0;
+  --ifm-color-primary-dark: #21af90;
+  --ifm-color-primary-darker: #1fa588;
+  --ifm-color-primary-darkest: #1a8870;
+  --ifm-color-primary-light: #29d5b0;
+  --ifm-color-primary-lighter: #32d8b4;
+  --ifm-color-primary-lightest: #4fddbf;
+  --docusaurus-highlighted-code-line-bg: rgba(0, 0, 0, 0.3);
+}
+`,
+        classic: `
+:root {
+  --ifm-color-primary: #0066cc;
+  --ifm-color-primary-dark: #005cb8;
+  --ifm-color-primary-darker: #0056ad;
+  --ifm-color-primary-darkest: #00478f;
+  --ifm-color-primary-light: #0070e0;
+  --ifm-color-primary-lighter: #0076eb;
+  --ifm-color-primary-lightest: #1a85ff;
+  --ifm-code-font-size: 95%;
+}
+`,
+        dark: `
+:root {
+  --ifm-color-primary: #1e1e1e;
+  --ifm-background-color: #0d1117;
+  --ifm-code-font-size: 95%;
+}
+
+[data-theme='dark'] {
+  --ifm-color-primary: #58a6ff;
+  --ifm-background-color: #0d1117;
+}
+`
+    };
+    return `/**
+ * Custom CSS for SpecWeave documentation
+ * Theme: ${theme}
+ * Auto-generated by SpecWeave docs-preview plugin
+ */
+
+${themes[theme]}
+
+/* Custom styles */
+.markdown {
+  --ifm-h1-font-size: 2rem;
+  --ifm-h2-font-size: 1.5rem;
+  --ifm-h3-font-size: 1.25rem;
+}
+
+/* Code blocks */
+.prism-code {
+  font-size: 0.9rem;
+}
+
+/* Mermaid diagrams */
+.docusaurus-mermaid-container {
+  text-align: center;
+  margin: 2rem 0;
+}
+`;
+}
+/**
+ * Write custom CSS to file
+ */
+export async function writeCustomCSS(targetDir, theme) {
+    const cssPath = path.join(targetDir, 'src', 'css', 'custom.css');
+    const content = generateCustomCSS(theme);
+    await fs.ensureDir(path.dirname(cssPath));
+    await fs.writeFile(cssPath, content, 'utf-8');
+}
+/**
+ * Generate index page (landing page)
+ */
+export function generateIndexPage(title, tagline) {
+    return `import React from 'react';
+import clsx from 'clsx';
+import Link from '@docusaurus/Link';
+import useDocusaurusContext from '@docusaurus/useDocusaurusContext';
+import Layout from '@theme/Layout';
+import styles from './index.module.css';
+
+function HomepageHeader() {
+  const {siteConfig} = useDocusaurusContext();
+  return (
+    <header className={clsx('hero hero--primary', styles.heroBanner)}>
+      <div className="container">
+        <h1 className="hero__title">{siteConfig.title}</h1>
+        <p className="hero__subtitle">{siteConfig.tagline}</p>
+        <div className={styles.buttons}>
+          <Link
+            className="button button--secondary button--lg"
+            to="/strategy">
+            View Documentation
+          </Link>
+        </div>
+      </div>
+    </header>
+  );
+}
+
+export default function Home() {
+  const {siteConfig} = useDocusaurusContext();
+  return (
+    <Layout
+      title={\`\${siteConfig.title}\`}
+      description="${tagline}">
+      <HomepageHeader />
+      <main>
+        <div className="container" style={{marginTop: '2rem', marginBottom: '2rem'}}>
+          <div className="row">
+            <div className="col col--12">
+              <h2>Welcome to ${title}</h2>
+              <p>
+                This is your SpecWeave documentation site, automatically generated from your
+                <code>.specweave/docs/</code> folder.
+              </p>
+              <p>
+                Use the sidebar to navigate through your documentation:
+              </p>
+              <ul>
+                <li><strong>Strategy</strong>: Business rationale, PRDs, OKRs</li>
+                <li><strong>Specs</strong>: Feature specifications and user stories</li>
+                <li><strong>Architecture</strong>: Technical design, ADRs, diagrams</li>
+                <li><strong>Delivery</strong>: Build & release processes</li>
+                <li><strong>Operations</strong>: Runbooks, SLOs, incidents</li>
+                <li><strong>Governance</strong>: Policies, security, compliance</li>
+              </ul>
+            </div>
+          </div>
+        </div>
+      </main>
+    </Layout>
+  );
+}
+`;
+}
+/**
+ * Write index page to file
+ */
+export async function writeIndexPage(targetDir, title, tagline) {
+    const indexPath = path.join(targetDir, 'src', 'pages', 'index.js');
+    const content = generateIndexPage(title, tagline);
+    await fs.ensureDir(path.dirname(indexPath));
+    await fs.writeFile(indexPath, content, 'utf-8');
+}
+/**
+ * Generate index.module.css for landing page styles
+ */
+export function generateIndexModuleCSS() {
+    return `.heroBanner {
+  padding: 4rem 0;
+  text-align: center;
+  position: relative;
+  overflow: hidden;
+}
+
+@media screen and (max-width: 996px) {
+  .heroBanner {
+    padding: 2rem;
+  }
+}
+
+.buttons {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  gap: 1rem;
+  margin-top: 2rem;
+}
+`;
+}
+/**
+ * Write index.module.css to file
+ */
+export async function writeIndexModuleCSS(targetDir) {
+    const cssPath = path.join(targetDir, 'src', 'pages', 'index.module.css');
+    const content = generateIndexModuleCSS();
+    await fs.ensureDir(path.dirname(cssPath));
+    await fs.writeFile(cssPath, content, 'utf-8');
+}
+//# sourceMappingURL=config-generator.js.map

package/dist/src/utils/docs-preview/config-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-generator.js","sourceRoot":"","sources":["../../../../src/utils/docs-preview/config-generator.ts"],"names":[],"mappings":"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"}

package/dist/src/utils/docs-preview/docusaurus-setup.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Main orchestrator for Docusaurus setup
+ * Coordinates all setup steps: install, config, sidebar, server launch
+ */
+import { SetupOptions, ServerProcess } from './types';
+/**
+ * Full Docusaurus setup workflow
+ */
+export declare function setupDocusaurus(options: SetupOptions): Promise<void>;
+/**
+ * Quick setup with defaults
+ */
+export declare function quickSetup(projectRoot: string): Promise<void>;
+/**
+ * Launch preview (setup if needed, then start server)
+ */
+export declare function launchPreview(projectRoot: string, options?: {
+    port?: number;
+    openBrowser?: boolean;
+    force?: boolean;
+}): Promise<ServerProcess>;
+/**
+ * Build static site
+ */
+export declare function buildStaticSite(projectRoot: string): Promise<void>;
+/**
+ * Check if setup is needed
+ */
+export declare function isSetupNeeded(projectRoot: string): Promise<boolean>;
+/**
+ * Get docs site path
+ */
+export declare function getDocsSitePath(projectRoot: string): string;
+/**
+ * Get docs path
+ */
+export declare function getDocsPath(projectRoot: string): string;
+//# sourceMappingURL=docusaurus-setup.d.ts.map

package/dist/src/utils/docs-preview/docusaurus-setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docusaurus-setup.d.ts","sourceRoot":"","sources":["../../../../src/utils/docs-preview/docusaurus-setup.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH,OAAO,EAAE,YAAY,EAAoB,aAAa,EAAE,MAAM,SAAS,CAAC;AAExE;;GAEG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAwE1E;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA8BnE;AAED;;GAEG;AACH,wBAAsB,aAAa,CACjC,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAO,GACtE,OAAO,CAAC,aAAa,CAAC,CAwBxB;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAqCxE;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAGzE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAEvD"}

package/dist/src/utils/docs-preview/docusaurus-setup.js

@@ -0,0 +1,177 @@
+/**
+ * Main orchestrator for Docusaurus setup
+ * Coordinates all setup steps: install, config, sidebar, server launch
+ */
+import * as path from 'path';
+import * as fs from 'fs-extra';
+import { checkNodeVersion, installDocusaurus, isDocusaurusInstalled } from './package-installer';
+import { buildSidebar, writeSidebar, countDocuments, countCategories } from './sidebar-builder';
+import { writeDocusaurusConfig, writePackageJSON, writeCustomCSS, writeIndexPage, writeIndexModuleCSS } from './config-generator';
+import { startDevServer, findAvailablePort } from './server-manager';
+/**
+ * Full Docusaurus setup workflow
+ */
+export async function setupDocusaurus(options) {
+    const { projectRoot, targetDir, docsPath, config, force = false } = options;
+    console.log('📦 Setting up Docusaurus documentation preview...\n');
+    // Step 1: Check Node.js version
+    console.log('1. Checking Node.js version...');
+    const nodeVersion = await checkNodeVersion();
+    if (!nodeVersion.compatible) {
+        throw new Error(`Node.js 18+ required (found: ${nodeVersion.version})\n` +
+            'Install Node.js from: https://nodejs.org/');
+    }
+    console.log(`   ✅ Node.js ${nodeVersion.version}\n`);
+    // Step 2: Check if already installed
+    if (!force && await isDocusaurusInstalled(targetDir)) {
+        console.log('✅ Docusaurus already installed (use --force to reinstall)\n');
+        return;
+    }
+    // Step 3: Create target directory
+    console.log('2. Creating docs-site directory...');
+    await fs.ensureDir(targetDir);
+    console.log('   ✅ Directory created\n');
+    // Step 4: Generate package.json
+    console.log('3. Generating package.json...');
+    await writePackageJSON(targetDir, config.title);
+    console.log('   ✅ package.json created\n');
+    // Step 5: Install Docusaurus packages
+    console.log('4. Installing packages (this may take 30-60 seconds)...');
+    await installDocusaurus(targetDir);
+    console.log('   ✅ Installation complete\n');
+    // Step 6: Generate docusaurus.config.js
+    console.log('5. Generating docusaurus.config.js...');
+    await writeDocusaurusConfig(targetDir, config);
+    console.log('   ✅ Configuration generated\n');
+    // Step 7: Scan docs and generate sidebar
+    console.log('6. Scanning documentation folders...');
+    const sidebar = await buildSidebar({
+        docsPath,
+        excludeFolders: config.excludeFolders || ['legacy', 'node_modules'],
+        maxDepth: 5
+    });
+    const docCount = countDocuments(sidebar);
+    const catCount = countCategories(sidebar);
+    console.log(`   ✅ Found ${docCount} documents in ${catCount} categories\n`);
+    // Step 8: Write sidebar
+    console.log('7. Generating sidebars.js...');
+    const sidebarPath = path.join(targetDir, 'sidebars.js');
+    await writeSidebar(sidebarPath, sidebar);
+    console.log('   ✅ Sidebar generated\n');
+    // Step 9: Create landing page
+    console.log('8. Creating landing page...');
+    await writeIndexPage(targetDir, config.title, config.tagline);
+    await writeIndexModuleCSS(targetDir);
+    console.log('   ✅ Landing page created\n');
+    // Step 10: Create custom CSS
+    console.log('9. Creating custom theme...');
+    await writeCustomCSS(targetDir, config.theme || 'default');
+    console.log('   ✅ Theme configured\n');
+    console.log('✅ Setup complete!\n');
+}
+/**
+ * Quick setup with defaults
+ */
+export async function quickSetup(projectRoot) {
+    const targetDir = path.join(projectRoot, '.specweave', 'docs-site-internal');
+    const docsPath = path.join(projectRoot, '.specweave', 'docs', 'internal');
+    // Check if docs exist
+    if (!await fs.pathExists(docsPath)) {
+        throw new Error('No documentation found.\n' +
+            'Create documentation by completing your first increment:\n' +
+            '  /specweave:increment "your feature"');
+    }
+    const config = {
+        title: 'SpecWeave Documentation',
+        tagline: 'Spec-Driven Development Framework',
+        url: 'http://localhost',
+        baseUrl: '/',
+        docsPath: '../docs/internal',
+        port: 3000,
+        theme: 'default',
+        excludeFolders: ['legacy', 'node_modules']
+    };
+    await setupDocusaurus({
+        projectRoot,
+        targetDir,
+        docsPath,
+        config
+    });
+}
+/**
+ * Launch preview (setup if needed, then start server)
+ */
+export async function launchPreview(projectRoot, options = {}) {
+    const targetDir = path.join(projectRoot, '.specweave', 'docs-site-internal');
+    const docsPath = path.join(projectRoot, '.specweave', 'docs', 'internal');
+    // Setup if not installed or force flag
+    if (options.force || !await isDocusaurusInstalled(targetDir)) {
+        await quickSetup(projectRoot);
+    }
+    // Find available port
+    const port = options.port || await findAvailablePort(3000, 3010);
+    console.log(`Starting server on port ${port}...`);
+    // Start dev server
+    const server = await startDevServer(targetDir, {
+        port,
+        openBrowser: options.openBrowser !== false
+    });
+    console.log(`\n🌐 Documentation available at: ${server.url}`);
+    console.log('🔄 Hot reload enabled - edit docs and see changes instantly');
+    console.log('💡 Press Ctrl+C to stop the server\n');
+    return server;
+}
+/**
+ * Build static site
+ */
+export async function buildStaticSite(projectRoot) {
+    const targetDir = path.join(projectRoot, '.specweave', 'docs-site-internal');
+    // Check if installed
+    if (!await isDocusaurusInstalled(targetDir)) {
+        throw new Error('Docusaurus not installed.\n' +
+            'Run: /specweave:docs preview (this will install it)');
+    }
+    console.log('📦 Building static documentation site...\n');
+    const { spawn } = await import('child_process');
+    return new Promise((resolve, reject) => {
+        const buildProcess = spawn('npm', ['run', 'build'], {
+            cwd: targetDir,
+            stdio: 'inherit',
+            shell: true
+        });
+        buildProcess.on('close', (code) => {
+            if (code === 0) {
+                const buildPath = path.join(targetDir, 'build');
+                console.log('\n✅ Build complete!');
+                console.log(`📁 Output: ${buildPath}\n`);
+                resolve();
+            }
+            else {
+                reject(new Error(`Build failed with code ${code}`));
+            }
+        });
+        buildProcess.on('error', (error) => {
+            reject(new Error(`Failed to start build: ${error.message}`));
+        });
+    });
+}
+/**
+ * Check if setup is needed
+ */
+export async function isSetupNeeded(projectRoot) {
+    const targetDir = path.join(projectRoot, '.specweave', 'docs-site-internal');
+    return !(await isDocusaurusInstalled(targetDir));
+}
+/**
+ * Get docs site path
+ */
+export function getDocsSitePath(projectRoot) {
+    return path.join(projectRoot, '.specweave', 'docs-site-internal');
+}
+/**
+ * Get docs path
+ */
+export function getDocsPath(projectRoot) {
+    return path.join(projectRoot, '.specweave', 'docs', 'internal');
+}
+//# sourceMappingURL=docusaurus-setup.js.map

package/dist/src/utils/docs-preview/docusaurus-setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"docusaurus-setup.js","sourceRoot":"","sources":["../../../../src/utils/docs-preview/docusaurus-setup.ts"],"names":[],"mappings":"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"}

package/dist/src/utils/docs-preview/index.d.ts

@@ -0,0 +1,7 @@
+export { setupDocusaurus, quickSetup, launchPreview, buildStaticSite, isSetupNeeded, getDocsSitePath, getDocsPath } from './docusaurus-setup';
+export { buildSidebar, writeSidebar, generateSidebarsJS, countDocuments, countCategories } from './sidebar-builder';
+export { generateDocusaurusConfig, writeDocusaurusConfig, generatePackageJSON, writePackageJSON, generateCustomCSS, writeCustomCSS, generateIndexPage, writeIndexPage, generateIndexModuleCSS, writeIndexModuleCSS } from './config-generator';
+export { checkNodeVersion, checkNpmInstalled, installPackages, installDocusaurus, isDocusaurusInstalled, cleanNpmCache, getPackageVersion, estimateInstallSize, estimateInstallTime } from './package-installer';
+export { findAvailablePort, startDevServer, openBrowserUrl, killAllDocusaurusProcesses, isDocusaurusRunning, getServerUrl } from './server-manager';
+export * from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/utils/docs-preview/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/utils/docs-preview/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,UAAU,EACV,aAAa,EACb,eAAe,EACf,aAAa,EACb,eAAe,EACf,WAAW,EACZ,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,kBAAkB,EAClB,cAAc,EACd,eAAe,EAChB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,wBAAwB,EACxB,qBAAqB,EACrB,mBAAmB,EACnB,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,EACd,iBAAiB,EACjB,cAAc,EACd,sBAAsB,EACtB,mBAAmB,EACpB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EACjB,qBAAqB,EACrB,aAAa,EACb,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,EACpB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,cAAc,EACd,0BAA0B,EAC1B,mBAAmB,EACnB,YAAY,EACb,MAAM,kBAAkB,CAAC;AAE1B,cAAc,SAAS,CAAC"}

package/dist/src/utils/docs-preview/index.js

@@ -0,0 +1,7 @@
+export { setupDocusaurus, quickSetup, launchPreview, buildStaticSite, isSetupNeeded, getDocsSitePath, getDocsPath } from './docusaurus-setup';
+export { buildSidebar, writeSidebar, generateSidebarsJS, countDocuments, countCategories } from './sidebar-builder';
+export { generateDocusaurusConfig, writeDocusaurusConfig, generatePackageJSON, writePackageJSON, generateCustomCSS, writeCustomCSS, generateIndexPage, writeIndexPage, generateIndexModuleCSS, writeIndexModuleCSS } from './config-generator';
+export { checkNodeVersion, checkNpmInstalled, installPackages, installDocusaurus, isDocusaurusInstalled, cleanNpmCache, getPackageVersion, estimateInstallSize, estimateInstallTime } from './package-installer';
+export { findAvailablePort, startDevServer, openBrowserUrl, killAllDocusaurusProcesses, isDocusaurusRunning, getServerUrl } from './server-manager';
+export * from './types';
+//# sourceMappingURL=index.js.map

package/dist/src/utils/docs-preview/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/utils/docs-preview/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,UAAU,EACV,aAAa,EACb,eAAe,EACf,aAAa,EACb,eAAe,EACf,WAAW,EACZ,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,kBAAkB,EAClB,cAAc,EACd,eAAe,EAChB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,wBAAwB,EACxB,qBAAqB,EACrB,mBAAmB,EACnB,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,EACd,iBAAiB,EACjB,cAAc,EACd,sBAAsB,EACtB,mBAAmB,EACpB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EACjB,qBAAqB,EACrB,aAAa,EACb,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,EACpB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,cAAc,EACd,0BAA0B,EAC1B,mBAAmB,EACnB,YAAY,EACb,MAAM,kBAAkB,CAAC;AAE1B,cAAc,SAAS,CAAC"}