specweave 0.16.7 → 0.16.11

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

@@ -0,0 +1,42 @@
+/**
+ * Package installer for Docusaurus dependencies
+ * Handles npm install with progress tracking
+ */
+import { NodeVersion, InstallOptions } from './types';
+/**
+ * Check Node.js version
+ */
+export declare function checkNodeVersion(): Promise<NodeVersion>;
+/**
+ * Check if npm is installed
+ */
+export declare function checkNpmInstalled(): Promise<boolean>;
+/**
+ * Install npm packages
+ */
+export declare function installPackages(options: InstallOptions): Promise<void>;
+/**
+ * Install Docusaurus packages
+ */
+export declare function installDocusaurus(targetDir: string): Promise<void>;
+/**
+ * Check if Docusaurus is installed
+ */
+export declare function isDocusaurusInstalled(targetDir: string): Promise<boolean>;
+/**
+ * Clean npm cache
+ */
+export declare function cleanNpmCache(): Promise<void>;
+/**
+ * Get installed npm package version
+ */
+export declare function getPackageVersion(targetDir: string, packageName: string): Promise<string | null>;
+/**
+ * Estimate install size (rough estimate)
+ */
+export declare function estimateInstallSize(): string;
+/**
+ * Estimate install time (rough estimate)
+ */
+export declare function estimateInstallTime(): string;
+//# sourceMappingURL=package-installer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"package-installer.d.ts","sourceRoot":"","sources":["../../../../src/utils/docs-preview/package-installer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAEtD;;GAEG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,WAAW,CAAC,CAqB7D;AAED;;GAEG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,OAAO,CAAC,CAO1D;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAgD5E;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA8BxE;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAyB/E;AAED;;GAEG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAEnD;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAatG;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAG5C;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAG5C"}

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

@@ -0,0 +1,182 @@
+/**
+ * Package installer for Docusaurus dependencies
+ * Handles npm install with progress tracking
+ */
+import * as path from 'path';
+import * as fs from 'fs-extra';
+import { spawn } from 'child_process';
+import { execFileNoThrow } from '../execFileNoThrow';
+/**
+ * Check Node.js version
+ */
+export async function checkNodeVersion() {
+    try {
+        const result = await execFileNoThrow('node', ['--version']);
+        if (!result.success) {
+            throw new Error('Node.js not found');
+        }
+        const versionString = result.stdout.trim().replace('v', '');
+        const [major, minor, patch] = versionString.split('.').map(Number);
+        return {
+            version: versionString,
+            major,
+            minor,
+            patch,
+            compatible: major >= 18
+        };
+    }
+    catch (error) {
+        throw new Error('Node.js not found. Please install Node.js 18+ from https://nodejs.org/');
+    }
+}
+/**
+ * Check if npm is installed
+ */
+export async function checkNpmInstalled() {
+    try {
+        const result = await execFileNoThrow('npm', ['--version']);
+        return result.success;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Install npm packages
+ */
+export async function installPackages(options) {
+    const { targetDir, packages, dev = false } = options;
+    // Ensure target directory exists
+    await fs.ensureDir(targetDir);
+    // Build npm install command
+    const args = ['install'];
+    if (dev) {
+        args.push('--save-dev');
+    }
+    args.push(...packages);
+    // Spawn npm install process
+    return new Promise((resolve, reject) => {
+        const npmProcess = spawn('npm', args, {
+            cwd: targetDir,
+            stdio: ['ignore', 'pipe', 'pipe'],
+            shell: true
+        });
+        let stdout = '';
+        let stderr = '';
+        npmProcess.stdout.on('data', (data) => {
+            stdout += data.toString();
+            // Show progress to console
+            process.stdout.write('.');
+        });
+        npmProcess.stderr.on('data', (data) => {
+            stderr += data.toString();
+        });
+        npmProcess.on('close', (code) => {
+            if (code === 0) {
+                console.log(' ✅');
+                resolve();
+            }
+            else {
+                console.log(' ❌');
+                reject(new Error(`npm install failed with code ${code}\n${stderr}`));
+            }
+        });
+        npmProcess.on('error', (error) => {
+            reject(new Error(`Failed to start npm install: ${error.message}`));
+        });
+    });
+}
+/**
+ * Install Docusaurus packages
+ */
+export async function installDocusaurus(targetDir) {
+    const packages = [
+        '@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'
+    ];
+    const devPackages = [
+        '@docusaurus/module-type-aliases@^3.0.0',
+        '@docusaurus/types@^3.0.0'
+    ];
+    console.log('   Installing Docusaurus packages...');
+    await installPackages({
+        targetDir,
+        packages,
+        dev: false
+    });
+    console.log('   Installing dev dependencies...');
+    await installPackages({
+        targetDir,
+        packages: devPackages,
+        dev: true
+    });
+}
+/**
+ * Check if Docusaurus is installed
+ */
+export async function isDocusaurusInstalled(targetDir) {
+    try {
+        const packageJsonPath = path.join(targetDir, 'package.json');
+        const nodeModulesPath = path.join(targetDir, 'node_modules');
+        // Check if package.json exists
+        if (!await fs.pathExists(packageJsonPath)) {
+            return false;
+        }
+        // Check if node_modules exists
+        if (!await fs.pathExists(nodeModulesPath)) {
+            return false;
+        }
+        // Check if @docusaurus/core is installed
+        const docusaurusCorePath = path.join(nodeModulesPath, '@docusaurus', 'core');
+        if (!await fs.pathExists(docusaurusCorePath)) {
+            return false;
+        }
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Clean npm cache
+ */
+export async function cleanNpmCache() {
+    await execFileNoThrow('npm', ['cache', 'clean', '--force']);
+}
+/**
+ * Get installed npm package version
+ */
+export async function getPackageVersion(targetDir, packageName) {
+    try {
+        const packageJsonPath = path.join(targetDir, 'node_modules', packageName, 'package.json');
+        if (!await fs.pathExists(packageJsonPath)) {
+            return null;
+        }
+        const packageJson = await fs.readJSON(packageJsonPath);
+        return packageJson.version || null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Estimate install size (rough estimate)
+ */
+export function estimateInstallSize() {
+    // Docusaurus + React + dependencies ≈ 150-200 MB
+    return '~150 MB';
+}
+/**
+ * Estimate install time (rough estimate)
+ */
+export function estimateInstallTime() {
+    // Typically 20-40 seconds depending on network and CPU
+    return '~30 seconds';
+}
+//# sourceMappingURL=package-installer.js.map

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

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

package/dist/src/utils/docs-preview/server-manager.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Server manager for Docusaurus dev server
+ * Handles port finding, server start/stop, browser opening
+ */
+import { ServerOptions, ServerProcess } from './types';
+/**
+ * Find an available port in the given range
+ */
+export declare function findAvailablePort(startPort?: number, endPort?: number): Promise<number>;
+/**
+ * Start Docusaurus dev server
+ */
+export declare function startDevServer(targetDir: string, options: ServerOptions): Promise<ServerProcess>;
+/**
+ * Open URL in default browser
+ */
+export declare function openBrowserUrl(url: string): Promise<void>;
+/**
+ * Kill all Docusaurus processes (SAFE - uses execFileNoThrow)
+ */
+export declare function killAllDocusaurusProcesses(): Promise<number>;
+/**
+ * Check if Docusaurus server is running
+ */
+export declare function isDocusaurusRunning(port: number): Promise<boolean>;
+/**
+ * Get server URL
+ */
+export declare function getServerUrl(port: number, host?: string): string;
+//# sourceMappingURL=server-manager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"server-manager.d.ts","sourceRoot":"","sources":["../../../../src/utils/docs-preview/server-manager.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAEvD;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,SAAS,GAAE,MAAa,EAAE,OAAO,GAAE,MAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CAQzG;AAsBD;;GAEG;AACH,wBAAsB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,CAiCtG;AAiFD;;GAEG;AACH,wBAAsB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAO/D;AAED;;GAEG;AACH,wBAAsB,0BAA0B,IAAI,OAAO,CAAC,MAAM,CAAC,CAwDlE;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAExE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,MAAoB,GAAG,MAAM,CAE7E"}

package/dist/src/utils/docs-preview/server-manager.js

@@ -0,0 +1,212 @@
+/**
+ * Server manager for Docusaurus dev server
+ * Handles port finding, server start/stop, browser opening
+ */
+import { spawn } from 'child_process';
+import * as net from 'net';
+import { execFileNoThrow } from '../execFileNoThrow';
+/**
+ * Find an available port in the given range
+ */
+export async function findAvailablePort(startPort = 3000, endPort = 3010) {
+    for (let port = startPort; port <= endPort; port++) {
+        if (await isPortAvailable(port)) {
+            return port;
+        }
+    }
+    throw new Error(`No available ports found in range ${startPort}-${endPort}`);
+}
+/**
+ * Check if a port is available
+ */
+function isPortAvailable(port) {
+    return new Promise((resolve) => {
+        const server = net.createServer();
+        server.once('error', () => {
+            resolve(false);
+        });
+        server.once('listening', () => {
+            server.close();
+            resolve(true);
+        });
+        server.listen(port);
+    });
+}
+/**
+ * Start Docusaurus dev server
+ */
+export async function startDevServer(targetDir, options) {
+    const { port, openBrowser, host = 'localhost' } = options;
+    // Check if port is available
+    if (!await isPortAvailable(port)) {
+        throw new Error(`Port ${port} is already in use`);
+    }
+    // Start Docusaurus dev server
+    const process = spawn('npm', ['run', 'start', '--', '--port', port.toString(), '--host', host], {
+        cwd: targetDir,
+        stdio: ['ignore', 'pipe', 'pipe'],
+        shell: true
+    });
+    const url = `http://${host}:${port}`;
+    // Wait for server to be ready
+    await waitForServer(url, 30000); // 30 second timeout
+    // Open browser if requested
+    if (openBrowser) {
+        await openBrowserUrl(url);
+    }
+    return {
+        pid: process.pid,
+        port,
+        url,
+        stop: async () => {
+            await stopServer(process);
+        }
+    };
+}
+/**
+ * Wait for server to be ready
+ */
+function waitForServer(url, timeout) {
+    return new Promise((resolve, reject) => {
+        const startTime = Date.now();
+        const check = async () => {
+            try {
+                const http = await import('http');
+                const urlObj = new URL(url);
+                const req = http.get({
+                    hostname: urlObj.hostname,
+                    port: urlObj.port,
+                    path: urlObj.pathname,
+                    timeout: 2000
+                }, (res) => {
+                    if (res.statusCode === 200 || res.statusCode === 304) {
+                        resolve();
+                    }
+                    else {
+                        scheduleNextCheck();
+                    }
+                });
+                req.on('error', () => {
+                    scheduleNextCheck();
+                });
+                req.on('timeout', () => {
+                    req.destroy();
+                    scheduleNextCheck();
+                });
+            }
+            catch {
+                scheduleNextCheck();
+            }
+        };
+        const scheduleNextCheck = () => {
+            if (Date.now() - startTime > timeout) {
+                reject(new Error(`Server failed to start within ${timeout}ms`));
+            }
+            else {
+                setTimeout(check, 1000);
+            }
+        };
+        check();
+    });
+}
+/**
+ * Stop server process
+ */
+function stopServer(process) {
+    return new Promise((resolve) => {
+        if (!process.pid) {
+            resolve();
+            return;
+        }
+        process.once('exit', () => {
+            resolve();
+        });
+        // Try graceful shutdown first
+        process.kill('SIGTERM');
+        // Force kill after 5 seconds if still running
+        setTimeout(() => {
+            if (process.pid) {
+                process.kill('SIGKILL');
+            }
+        }, 5000);
+    });
+}
+/**
+ * Open URL in default browser
+ */
+export async function openBrowserUrl(url) {
+    try {
+        const open = (await import('open')).default;
+        await open(url);
+    }
+    catch (error) {
+        console.warn('Could not open browser automatically. Please open manually:', url);
+    }
+}
+/**
+ * Kill all Docusaurus processes (SAFE - uses execFileNoThrow)
+ */
+export async function killAllDocusaurusProcesses() {
+    const platform = process.platform;
+    try {
+        if (platform === 'win32') {
+            // Windows: Use tasklist and taskkill
+            const listResult = await execFileNoThrow('tasklist', ['/FI', 'IMAGENAME eq node.exe', '/FO', 'CSV']);
+            if (!listResult.success) {
+                return 0;
+            }
+            const processes = listResult.stdout
+                .split('\n')
+                .filter(line => line.includes('docusaurus'))
+                .map(line => {
+                const match = line.match(/"([^"]+)","\d+"/);
+                return match ? match[1] : null;
+            })
+                .filter(Boolean);
+            for (const pid of processes) {
+                await execFileNoThrow('taskkill', ['/F', '/PID', pid]);
+            }
+            return processes.length;
+        }
+        else {
+            // Unix-like (macOS, Linux): Use ps and kill
+            const psResult = await execFileNoThrow('ps', ['aux']);
+            if (!psResult.success) {
+                return 0;
+            }
+            const processes = psResult.stdout
+                .split('\n')
+                .filter(line => line.includes('docusaurus') && !line.includes('grep'))
+                .map(line => {
+                const parts = line.trim().split(/\s+/);
+                return parts[1]; // PID is second column
+            });
+            for (const pid of processes) {
+                try {
+                    await execFileNoThrow('kill', [pid]);
+                }
+                catch {
+                    // Ignore errors (process may have already exited)
+                }
+            }
+            return processes.length;
+        }
+    }
+    catch (error) {
+        // No processes found or error occurred
+        return 0;
+    }
+}
+/**
+ * Check if Docusaurus server is running
+ */
+export async function isDocusaurusRunning(port) {
+    return !(await isPortAvailable(port));
+}
+/**
+ * Get server URL
+ */
+export function getServerUrl(port, host = 'localhost') {
+    return `http://${host}:${port}`;
+}
+//# sourceMappingURL=server-manager.js.map

package/dist/src/utils/docs-preview/server-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-manager.js","sourceRoot":"","sources":["../../../../src/utils/docs-preview/server-manager.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,KAAK,EAAgB,MAAM,eAAe,CAAC;AACpD,OAAO,KAAK,GAAG,MAAM,KAAK,CAAC;AAC3B,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAGrD;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,YAAoB,IAAI,EAAE,UAAkB,IAAI;IACtF,KAAK,IAAI,IAAI,GAAG,SAAS,EAAE,IAAI,IAAI,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC;QACnD,IAAI,MAAM,eAAe,CAAC,IAAI,CAAC,EAAE,CAAC;YAChC,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,qCAAqC,SAAS,IAAI,OAAO,EAAE,CAAC,CAAC;AAC/E,CAAC;AAED;;GAEG;AACH,SAAS,eAAe,CAAC,IAAY;IACnC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,MAAM,MAAM,GAAG,GAAG,CAAC,YAAY,EAAE,CAAC;QAElC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE;YACxB,OAAO,CAAC,KAAK,CAAC,CAAC;QACjB,CAAC,CAAC,CAAC;QAEH,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG,EAAE;YAC5B,MAAM,CAAC,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,IAAI,CAAC,CAAC;QAChB,CAAC,CAAC,CAAC;QAEH,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACtB,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,SAAiB,EAAE,OAAsB;IAC5E,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,GAAG,WAAW,EAAE,GAAG,OAAO,CAAC;IAE1D,6BAA6B;IAC7B,IAAI,CAAC,MAAM,eAAe,CAAC,IAAI,CAAC,EAAE,CAAC;QACjC,MAAM,IAAI,KAAK,CAAC,QAAQ,IAAI,oBAAoB,CAAC,CAAC;IACpD,CAAC;IAED,8BAA8B;IAC9B,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,EAAE,QAAQ,EAAE,IAAI,CAAC,EAAE;QAC9F,GAAG,EAAE,SAAS;QACd,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;QACjC,KAAK,EAAE,IAAI;KACZ,CAAC,CAAC;IAEH,MAAM,GAAG,GAAG,UAAU,IAAI,IAAI,IAAI,EAAE,CAAC;IAErC,8BAA8B;IAC9B,MAAM,aAAa,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,oBAAoB;IAErD,4BAA4B;IAC5B,IAAI,WAAW,EAAE,CAAC;QAChB,MAAM,cAAc,CAAC,GAAG,CAAC,CAAC;IAC5B,CAAC;IAED,OAAO;QACL,GAAG,EAAE,OAAO,CAAC,GAAI;QACjB,IAAI;QACJ,GAAG;QACH,IAAI,EAAE,KAAK,IAAI,EAAE;YACf,MAAM,UAAU,CAAC,OAAO,CAAC,CAAC;QAC5B,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAS,aAAa,CAAC,GAAW,EAAE,OAAe;IACjD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAE7B,MAAM,KAAK,GAAG,KAAK,IAAI,EAAE;YACvB,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,CAAC;gBAClC,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;gBAE5B,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAClB;oBACE,QAAQ,EAAE,MAAM,CAAC,QAAQ;oBACzB,IAAI,EAAE,MAAM,CAAC,IAAI;oBACjB,IAAI,EAAE,MAAM,CAAC,QAAQ;oBACrB,OAAO,EAAE,IAAI;iBACd,EACD,CAAC,GAAG,EAAE,EAAE;oBACN,IAAI,GAAG,CAAC,UAAU,KAAK,GAAG,IAAI,GAAG,CAAC,UAAU,KAAK,GAAG,EAAE,CAAC;wBACrD,OAAO,EAAE,CAAC;oBACZ,CAAC;yBAAM,CAAC;wBACN,iBAAiB,EAAE,CAAC;oBACtB,CAAC;gBACH,CAAC,CACF,CAAC;gBAEF,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;oBACnB,iBAAiB,EAAE,CAAC;gBACtB,CAAC,CAAC,CAAC;gBAEH,GAAG,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE;oBACrB,GAAG,CAAC,OAAO,EAAE,CAAC;oBACd,iBAAiB,EAAE,CAAC;gBACtB,CAAC,CAAC,CAAC;YACL,CAAC;YAAC,MAAM,CAAC;gBACP,iBAAiB,EAAE,CAAC;YACtB,CAAC;QACH,CAAC,CAAC;QAEF,MAAM,iBAAiB,GAAG,GAAG,EAAE;YAC7B,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,GAAG,OAAO,EAAE,CAAC;gBACrC,MAAM,CAAC,IAAI,KAAK,CAAC,iCAAiC,OAAO,IAAI,CAAC,CAAC,CAAC;YAClE,CAAC;iBAAM,CAAC;gBACN,UAAU,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;YAC1B,CAAC;QACH,CAAC,CAAC;QAEF,KAAK,EAAE,CAAC;IACV,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,SAAS,UAAU,CAAC,OAAqB;IACvC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;YACjB,OAAO,EAAE,CAAC;YACV,OAAO;QACT,CAAC;QAED,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE;YACxB,OAAO,EAAE,CAAC;QACZ,CAAC,CAAC,CAAC;QAEH,8BAA8B;QAC9B,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAExB,8CAA8C;QAC9C,UAAU,CAAC,GAAG,EAAE;YACd,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;gBAChB,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAC1B,CAAC;QACH,CAAC,EAAE,IAAI,CAAC,CAAC;IACX,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,GAAW;IAC9C,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,CAAC,MAAM,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC;QAC5C,MAAM,IAAI,CAAC,GAAG,CAAC,CAAC;IAClB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,IAAI,CAAC,6DAA6D,EAAE,GAAG,CAAC,CAAC;IACnF,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,0BAA0B;IAC9C,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;IAElC,IAAI,CAAC;QACH,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;YACzB,qCAAqC;YACrC,MAAM,UAAU,GAAG,MAAM,eAAe,CAAC,UAAU,EAAE,CAAC,KAAK,EAAE,uBAAuB,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;YAErG,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;gBACxB,OAAO,CAAC,CAAC;YACX,CAAC;YAED,MAAM,SAAS,GAAG,UAAU,CAAC,MAAM;iBAChC,KAAK,CAAC,IAAI,CAAC;iBACX,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;iBAC3C,GAAG,CAAC,IAAI,CAAC,EAAE;gBACV,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;gBAC5C,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;YACjC,CAAC,CAAC;iBACD,MAAM,CAAC,OAAO,CAAa,CAAC;YAE/B,KAAK,MAAM,GAAG,IAAI,SAAS,EAAE,CAAC;gBAC5B,MAAM,eAAe,CAAC,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC;YACzD,CAAC;YAED,OAAO,SAAS,CAAC,MAAM,CAAC;QAC1B,CAAC;aAAM,CAAC;YACN,4CAA4C;YAC5C,MAAM,QAAQ,GAAG,MAAM,eAAe,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;YAEtD,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;gBACtB,OAAO,CAAC,CAAC;YACX,CAAC;YAED,MAAM,SAAS,GAAG,QAAQ,CAAC,MAAM;iBAC9B,KAAK,CAAC,IAAI,CAAC;iBACX,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;iBACrE,GAAG,CAAC,IAAI,CAAC,EAAE;gBACV,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;gBACvC,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,uBAAuB;YAC1C,CAAC,CAAC,CAAC;YAEL,KAAK,MAAM,GAAG,IAAI,SAAS,EAAE,CAAC;gBAC5B,IAAI,CAAC;oBACH,MAAM,eAAe,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;gBACvC,CAAC;gBAAC,MAAM,CAAC;oBACP,kDAAkD;gBACpD,CAAC;YACH,CAAC;YAED,OAAO,SAAS,CAAC,MAAM,CAAC;QAC1B,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,uCAAuC;QACvC,OAAO,CAAC,CAAC;IACX,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,IAAY;IACpD,OAAO,CAAC,CAAC,MAAM,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC;AACxC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,IAAY,EAAE,OAAe,WAAW;IACnE,OAAO,UAAU,IAAI,IAAI,IAAI,EAAE,CAAC;AAClC,CAAC"}

package/dist/src/utils/docs-preview/sidebar-builder.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Sidebar builder for Docusaurus
+ * Automatically generates sidebar.js from .specweave/docs/ folder structure
+ */
+import { Sidebar } from './types';
+interface BuildSidebarOptions {
+    docsPath: string;
+    excludeFolders?: string[];
+    maxDepth?: number;
+}
+/**
+ * Build sidebar from folder structure
+ */
+export declare function buildSidebar(options: BuildSidebarOptions): Promise<Sidebar>;
+/**
+ * Generate sidebars.js content as string
+ */
+export declare function generateSidebarsJS(sidebar: Sidebar): string;
+/**
+ * Write sidebar to file
+ */
+export declare function writeSidebar(filePath: string, sidebar: Sidebar): Promise<void>;
+/**
+ * Count total documents in sidebar
+ */
+export declare function countDocuments(sidebar: Sidebar): number;
+/**
+ * Count total categories in sidebar
+ */
+export declare function countCategories(sidebar: Sidebar): number;
+export {};
+//# sourceMappingURL=sidebar-builder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sidebar-builder.d.ts","sourceRoot":"","sources":["../../../../src/utils/docs-preview/sidebar-builder.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EAAe,OAAO,EAAE,MAAM,SAAS,CAAC;AA0B/C,UAAU,mBAAmB;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,OAAO,CAAC,CAiBjF;AAwHD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAW3D;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAIpF;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAevD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAgBxD"}