specweave 0.12.1 → 0.12.3

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

@@ -1,377 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

@@ -1,38 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

@@ -1,177 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

@@ -1,7 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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

@@ -1,7 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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"}