specweave 0.8.2 → 0.8.4

package/dist/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.js';
+import { buildSidebar, writeSidebar, countDocuments, countCategories } from './sidebar-builder.js';
+import { writeDocusaurusConfig, writePackageJSON, writeCustomCSS, writeIndexPage, writeIndexModuleCSS } from './config-generator.js';
+import { startDevServer, findAvailablePort } from './server-manager.js';
+/**
+ * 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');
+    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');
+    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');
+    // 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');
+    return !(await isDocusaurusInstalled(targetDir));
+}
+/**
+ * Get docs site path
+ */
+export function getDocsSitePath(projectRoot) {
+    return path.join(projectRoot, '.specweave', 'docs-site');
+}
+/**
+ * Get docs path
+ */
+export function getDocsPath(projectRoot) {
+    return path.join(projectRoot, '.specweave', 'docs', 'internal');
+}
+//# sourceMappingURL=docusaurus-setup.js.map

package/dist/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/utils/docs-preview/index.d.ts

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

package/dist/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;;;GAGG;AAGH,OAAO,EACL,eAAe,EACf,UAAU,EACV,aAAa,EACb,eAAe,EACf,aAAa,EACb,eAAe,EACf,WAAW,EACZ,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,kBAAkB,EAClB,cAAc,EACd,eAAe,EAChB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,wBAAwB,EACxB,qBAAqB,EACrB,mBAAmB,EACnB,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,EACd,iBAAiB,EACjB,cAAc,EACd,sBAAsB,EACtB,mBAAmB,EACpB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EACjB,qBAAqB,EACrB,aAAa,EACb,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,EACpB,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,cAAc,EACd,0BAA0B,EAC1B,mBAAmB,EACnB,YAAY,EACb,MAAM,qBAAqB,CAAC;AAG7B,cAAc,YAAY,CAAC"}

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

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

package/dist/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;;;GAGG;AAEH,oBAAoB;AACpB,OAAO,EACL,eAAe,EACf,UAAU,EACV,aAAa,EACb,eAAe,EACf,aAAa,EACb,eAAe,EACf,WAAW,EACZ,MAAM,uBAAuB,CAAC;AAE/B,kBAAkB;AAClB,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,kBAAkB,EAClB,cAAc,EACd,eAAe,EAChB,MAAM,sBAAsB,CAAC;AAE9B,mBAAmB;AACnB,OAAO,EACL,wBAAwB,EACxB,qBAAqB,EACrB,mBAAmB,EACnB,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,EACd,iBAAiB,EACjB,cAAc,EACd,sBAAsB,EACtB,mBAAmB,EACpB,MAAM,uBAAuB,CAAC;AAE/B,oBAAoB;AACpB,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EACjB,qBAAqB,EACrB,aAAa,EACb,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,EACpB,MAAM,wBAAwB,CAAC;AAEhC,iBAAiB;AACjB,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,cAAc,EACd,0BAA0B,EAC1B,mBAAmB,EACnB,YAAY,EACb,MAAM,qBAAqB,CAAC;AAE7B,QAAQ;AACR,cAAc,YAAY,CAAC"}

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

@@ -0,0 +1,42 @@
+/**
+ * Package installer for Docusaurus dependencies
+ * Handles npm install with progress tracking
+ */
+import { InstallOptions, NodeVersion } from './types.js';
+/**
+ * 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/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;AAKH,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAGzD;;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,CAkD5E;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/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.js';
+/**
+ * Check Node.js version
+ */
+export async function checkNodeVersion() {
+    try {
+        const result = await execFileNoThrow('node', ['--version']);
+        if (result.status !== 0) {
+            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.status === 0;
+    }
+    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/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/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.js';
+/**
+ * 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/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,YAAY,CAAC;AAG1D;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,SAAS,GAAE,MAAa,EAAE,OAAO,GAAE,MAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CAQzG;AAsBD;;GAEG;AACH,wBAAsB,cAAc,CAClC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,aAAa,CAAC,CAiCxB;AA8ED;;GAEG;AACH,wBAAsB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAG/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"}