@opensaas/stack-cli 0.4.0 → 0.6.0

package/README.md

@@ -143,6 +143,82 @@ pnpm db:push     # Create database
 pnpm dev         # Start dev server
 ```
 
+### `opensaas migrate`
+
+Migrate an existing Prisma, KeystoneJS, or Next.js project to OpenSaas Stack.
+
+```bash
+opensaas migrate [options]
+```
+
+**Options:**
+
+- `--with-ai` - Enable AI-guided migration with Claude Code
+- `--type <type>` - Force project type detection (prisma, nextjs, keystone)
+
+**What it does:**
+
+1. Detects project type (Prisma, KeystoneJS, Next.js)
+2. Analyzes schema and counts models
+3. With `--with-ai`: Sets up Claude Code integration
+4. Provides next steps for migration
+
+**Examples:**
+
+```bash
+# Basic migration analysis
+opensaas migrate
+
+# AI-guided migration (recommended)
+opensaas migrate --with-ai
+
+# Force project type
+opensaas migrate --type prisma --with-ai
+```
+
+**AI-Assisted Migration (with --with-ai):**
+
+```
+🚀 OpenSaas Stack Migration
+
+✔ Detected: prisma, nextjs
+✔ Found 8 models
+   ├─ User (6 fields)
+   ├─ Post (10 fields)
+   ├─ Comment (5 fields)
+   └─ ...
+✔ Claude Code ready
+   ├─ Created .claude directory
+   ├─ Generated migration assistant
+   └─ Registered MCP server
+
+✅ Analysis complete!
+
+🤖 Next Steps:
+
+   1. Open this project in Claude Code
+   2. Ask: "Help me migrate to OpenSaas Stack"
+   3. Follow the interactive wizard
+```
+
+**After running:**
+
+1. Open project in Claude Code
+2. Ask: "Help me migrate to OpenSaas Stack"
+3. Answer wizard questions about:
+   - Database configuration
+   - Authentication needs
+   - Access control patterns
+   - Admin UI preferences
+4. Claude generates `opensaas.config.ts`
+5. Install dependencies and run `opensaas generate`
+
+**Manual Migration:**
+
+Without `--with-ai`, the command provides project analysis and you create the config manually.
+
+**See also:** [Migration Guide](https://stack.opensaas.au/docs/guides/migration)
+
 ## Usage in Projects
 
 ### Quick Start (New Projects)

package/dist/commands/migrate.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Migration command - Helps migrate existing projects to OpenSaaS Stack
+ */
+import { Command } from 'commander';
+/**
+ * Create the migrate command for Commander
+ */
+export declare function createMigrateCommand(): Command;
+//# sourceMappingURL=migrate.d.ts.map

package/dist/commands/migrate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate.d.ts","sourceRoot":"","sources":["../../src/commands/migrate.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AA8UnC;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,OAAO,CAkB9C"}

package/dist/commands/migrate.js

@@ -0,0 +1,299 @@
+/**
+ * Migration command - Helps migrate existing projects to OpenSaaS Stack
+ */
+import { Command } from 'commander';
+import * as fs from 'fs';
+import * as path from 'path';
+import chalk from 'chalk';
+import ora from 'ora';
+/**
+ * Detect what type of project this is
+ */
+async function detectProjectType(cwd) {
+    const types = [];
+    // Check for Prisma
+    const prismaSchemaPath = path.join(cwd, 'prisma', 'schema.prisma');
+    if (fs.existsSync(prismaSchemaPath)) {
+        types.push('prisma');
+    }
+    // Check for KeystoneJS
+    const keystoneConfigPath = path.join(cwd, 'keystone.config.ts');
+    const keystoneAltPath = path.join(cwd, 'keystone.ts');
+    if (fs.existsSync(keystoneConfigPath) || fs.existsSync(keystoneAltPath)) {
+        types.push('keystone');
+    }
+    // Check for Next.js
+    const packageJsonPath = path.join(cwd, 'package.json');
+    if (fs.existsSync(packageJsonPath)) {
+        const pkg = JSON.parse(fs.readFileSync(packageJsonPath, 'utf-8'));
+        if (pkg.dependencies?.next || pkg.devDependencies?.next) {
+            types.push('nextjs');
+        }
+    }
+    return types;
+}
+/**
+ * Analyze a Prisma schema
+ */
+async function analyzePrismaSchema(cwd) {
+    const schemaPath = path.join(cwd, 'prisma', 'schema.prisma');
+    const schema = fs.readFileSync(schemaPath, 'utf-8');
+    // Extract models
+    const modelRegex = /model\s+(\w+)\s*\{([^}]+)\}/g;
+    const models = [];
+    let match;
+    while ((match = modelRegex.exec(schema)) !== null) {
+        const name = match[1];
+        const body = match[2];
+        const fieldCount = body
+            .split('\n')
+            .filter((line) => line.trim() && !line.trim().startsWith('@@') && !line.trim().startsWith('//')).length;
+        models.push({ name, fieldCount });
+    }
+    // Extract provider
+    const providerMatch = schema.match(/provider\s*=\s*"(\w+)"/);
+    const provider = providerMatch ? providerMatch[1] : 'unknown';
+    return { models, provider };
+}
+/**
+ * Ensure directory exists
+ */
+function ensureDir(dirPath) {
+    if (!fs.existsSync(dirPath)) {
+        fs.mkdirSync(dirPath, { recursive: true });
+    }
+}
+/**
+ * Get plugin source path (relative to CLI package)
+ */
+function getPluginSourcePath() {
+    // This will be the path to the plugin directory within the installed CLI package
+    const cliPackageDir = path.dirname(path.dirname(new URL(import.meta.url).pathname));
+    return path.join(cliPackageDir, 'plugin');
+}
+/**
+ * Setup Claude Code integration with plugin
+ */
+async function setupClaudeCode(cwd, analysis) {
+    const claudeDir = path.join(cwd, '.claude');
+    // Create .claude directory
+    ensureDir(claudeDir);
+    // Create .mcp.json at project root (project-scoped MCP configuration)
+    const mcpConfig = {
+        mcpServers: {
+            'opensaas-migration': {
+                type: 'stdio',
+                command: 'npx',
+                args: ['-y', '@opensaas/stack-cli', 'mcp', 'start'],
+                env: {},
+            },
+        },
+    };
+    fs.writeFileSync(path.join(cwd, '.mcp.json'), JSON.stringify(mcpConfig, null, 2));
+    // Write project metadata file for the plugin to read
+    const projectMetadata = {
+        projectTypes: analysis.projectTypes,
+        provider: analysis.provider || 'sqlite',
+        models: analysis.models || [],
+        hasAuth: analysis.hasAuth || false,
+        cwd: analysis.cwd,
+    };
+    fs.writeFileSync(path.join(claudeDir, 'opensaas-project.json'), JSON.stringify(projectMetadata, null, 2));
+    // Configure Claude Code plugin in settings.json
+    const settingsPath = path.join(claudeDir, 'settings.json');
+    let settings = {};
+    // Read existing settings if they exist
+    if (fs.existsSync(settingsPath)) {
+        try {
+            settings = JSON.parse(fs.readFileSync(settingsPath, 'utf-8'));
+        }
+        catch {
+            // If settings file is invalid, start fresh
+            settings = {};
+        }
+    }
+    // Get the plugin source path
+    const pluginSource = getPluginSourcePath();
+    // Add plugin configuration
+    if (!settings.plugins) {
+        settings.plugins = {};
+    }
+    if (!settings.plugins.installed) {
+        settings.plugins.installed = [];
+    }
+    // Check if plugin is already installed
+    const pluginId = 'opensaas-migration@local';
+    const isInstalled = settings.plugins.installed.some((p) => typeof p === 'string' ? p === pluginId : p.id === pluginId);
+    if (!isInstalled) {
+        settings.plugins.installed.push({
+            id: pluginId,
+            source: pluginSource,
+            enabled: true,
+        });
+    }
+    // Write settings back
+    fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2));
+    // Create a simple README explaining the setup
+    const readmeContent = `# OpenSaaS Stack Migration
+
+This project is set up for AI-assisted migration to OpenSaaS Stack.
+
+## Project Summary
+
+- **Project Types:** ${analysis.projectTypes.join(', ')}
+- **Database Provider:** ${analysis.provider || 'Not detected'}
+- **Models Detected:** ${analysis.models?.length || 0}
+
+${analysis.models && analysis.models.length > 0
+        ? `\n### Models\n\n${analysis.models.map((m) => `- ${m.name} (${m.fieldCount} fields)`).join('\n')}`
+        : ''}
+
+## Quick Start
+
+Ask Claude: **"Help me migrate to OpenSaaS Stack"**
+
+Claude will guide you through:
+1. Reviewing your current schema
+2. Configuring access control
+3. Setting up authentication (optional)
+4. Generating \`opensaas.config.ts\`
+
+## What's Configured
+
+### OpenSaaS Migration Plugin
+
+The migration assistant plugin provides:
+- **Migration Assistant Agent**: Contextual help throughout the migration
+- **Slash Commands**: \`/analyze-schema\`, \`/generate-config\`, \`/validate-migration\`
+- **Migration Skill**: Expert knowledge about migration patterns
+
+### MCP Server
+
+The \`.mcp.json\` file configures the OpenSaaS migration MCP server with tools for:
+- Schema analysis
+- Interactive migration wizard
+- Documentation search
+- Code generation
+
+When you open this project in Claude Code, you may be prompted to approve the MCP server.
+
+## Resources
+
+- [OpenSaaS Stack Documentation](https://stack.opensaas.au/)
+- [Migration Guide](https://stack.opensaas.au/guides/migration)
+- [GitHub Repository](https://github.com/OpenSaasAU/stack)
+
+---
+
+*Generated by \`npx @opensaas/stack-cli migrate --with-ai\`*
+`;
+    fs.writeFileSync(path.join(claudeDir, 'README.md'), readmeContent);
+}
+/**
+ * Main migrate command
+ */
+async function migrateCommand(options) {
+    const cwd = process.cwd();
+    console.log(chalk.bold.cyan('\n🚀 OpenSaaS Stack Migration\n'));
+    // Step 1: Detect project type
+    const spinner = ora('Detecting project type...').start();
+    let projectTypes;
+    if (options.type) {
+        projectTypes = [options.type];
+    }
+    else {
+        projectTypes = await detectProjectType(cwd);
+    }
+    if (projectTypes.length === 0) {
+        spinner.fail(chalk.red('No recognizable project found'));
+        console.log(chalk.dim('\nThis command works with:'));
+        console.log(chalk.dim('  - Prisma projects (prisma/schema.prisma)'));
+        console.log(chalk.dim('  - KeystoneJS projects (keystone.config.ts)'));
+        console.log(chalk.dim('  - Next.js projects (package.json with next)'));
+        console.log(chalk.dim('\nUse --type to force a project type.'));
+        process.exit(1);
+    }
+    spinner.succeed(chalk.green(`Detected: ${projectTypes.join(', ')}`));
+    // Step 2: Analyze schema
+    const analysisSpinner = ora('Analyzing schema...').start();
+    const analysis = {
+        projectTypes,
+        cwd,
+    };
+    if (projectTypes.includes('prisma')) {
+        try {
+            const prismaAnalysis = await analyzePrismaSchema(cwd);
+            analysis.models = prismaAnalysis.models;
+            analysis.provider = prismaAnalysis.provider;
+        }
+        catch {
+            // Prisma analysis failed, continue without it
+        }
+    }
+    if (analysis.models && analysis.models.length > 0) {
+        analysisSpinner.succeed(chalk.green(`Found ${analysis.models.length} models`));
+        // Display model tree
+        const lastIndex = analysis.models.length - 1;
+        analysis.models.forEach((model, index) => {
+            const prefix = index === lastIndex ? '└─' : '├─';
+            console.log(chalk.dim(`   ${prefix} ${model.name} (${model.fieldCount} fields)`));
+        });
+    }
+    else {
+        analysisSpinner.succeed(chalk.yellow('No models found (will create from scratch)'));
+    }
+    // Step 3: Setup Claude Code (if --with-ai)
+    if (options.withAi) {
+        const claudeSpinner = ora('Setting up Claude Code...').start();
+        try {
+            await setupClaudeCode(cwd, analysis);
+            claudeSpinner.succeed(chalk.green('Claude Code ready'));
+            console.log(chalk.dim('   ├─ Created .claude directory'));
+            console.log(chalk.dim('   ├─ Installed opensaas-migration plugin'));
+            console.log(chalk.dim('   ├─ Configured .claude/settings.json'));
+            console.log(chalk.dim('   ├─ Wrote opensaas-project.json (project metadata)'));
+            console.log(chalk.dim('   └─ Created .mcp.json (MCP server config)'));
+        }
+        catch (error) {
+            claudeSpinner.fail(chalk.red('Failed to setup Claude Code'));
+            console.error(error);
+        }
+    }
+    // Step 4: Display next steps
+    console.log(chalk.green('\n✅ Analysis complete!\n'));
+    if (options.withAi) {
+        console.log(chalk.bold('🤖 Next Steps:\n'));
+        console.log(chalk.cyan('   1. Open this project in Claude Code'));
+        console.log(chalk.cyan('   2. Ask: "Help me migrate to OpenSaaS Stack"'));
+        console.log(chalk.cyan('   3. Follow the interactive wizard'));
+    }
+    else {
+        console.log(chalk.bold('📝 Next Steps:\n'));
+        console.log(chalk.cyan('   1. Run with --with-ai for AI-guided migration'));
+        console.log(chalk.cyan('   2. Or manually create opensaas.config.ts'));
+        console.log(chalk.dim('\n   See: https://stack.opensaas.au/guides/migration'));
+    }
+    console.log(chalk.dim(`\n📚 Documentation: https://stack.opensaas.au/guides/migration\n`));
+}
+/**
+ * Create the migrate command for Commander
+ */
+export function createMigrateCommand() {
+    const migrate = new Command('migrate');
+    migrate.description('Migrate an existing project to OpenSaaS Stack');
+    migrate
+        .option('--with-ai', 'Enable AI-guided migration with Claude Code')
+        .option('--type <type>', 'Force project type (prisma, nextjs, keystone)')
+        .action(async (options) => {
+        try {
+            await migrateCommand(options);
+            process.exit(0);
+        }
+        catch (error) {
+            console.error(chalk.red('\n❌ Migration failed:'), error);
+            process.exit(1);
+        }
+    });
+    return migrate;
+}
+//# sourceMappingURL=migrate.js.map

package/dist/commands/migrate.js.map

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

package/dist/index.js

@@ -4,6 +4,7 @@ import { generateCommand } from './commands/generate.js';
 import { initCommand } from './commands/init.js';
 import { devCommand } from './commands/dev.js';
 import { createMCPCommand } from './commands/mcp.js';
+import { createMigrateCommand } from './commands/migrate.js';
 const program = new Command();
 program.name('opensaas').description('OpenSaas Stack CLI').version('0.1.0');
 program
@@ -33,5 +34,7 @@ program
 });
 // Add MCP command group
 program.addCommand(createMCPCommand());
+// Add migrate command
+program.addCommand(createMigrateCommand());
 program.parse();
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AAEpD,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAA;AAE7B,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,WAAW,CAAC,oBAAoB,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;AAE3E,OAAO;KACJ,OAAO,CAAC,UAAU,CAAC;KACnB,WAAW,CAAC,qEAAqE,CAAC;KAClF,MAAM,CAAC,KAAK,IAAI,EAAE;IACjB,MAAM,eAAe,EAAE,CAAA;AACzB,CAAC,CAAC,CAAA;AAEJ,OAAO;KACJ,OAAO,CAAC,qBAAqB,CAAC;KAC9B,WAAW,CAAC,kEAAkE,CAAC;KAC/E,MAAM,CAAC,aAAa,EAAE,sCAAsC,CAAC;KAC7D,kBAAkB,EAAE,CAAC,sCAAsC;KAC3D,MAAM,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,EAAE;IACrC,MAAM,IAAI,GAAG,EAAE,CAAA;IACf,IAAI,WAAW;QAAE,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAA;IACvC,IAAI,OAAO,CAAC,QAAQ;QAAE,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,CAAA;IAC9C,MAAM,WAAW,CAAC,IAAI,CAAC,CAAA;AACzB,CAAC,CAAC,CAAA;AAEJ,OAAO;KACJ,OAAO,CAAC,KAAK,CAAC;KACd,WAAW,CAAC,oDAAoD,CAAC;KACjE,MAAM,CAAC,KAAK,IAAI,EAAE;IACjB,MAAM,UAAU,EAAE,CAAA;AACpB,CAAC,CAAC,CAAA;AAEJ,wBAAwB;AACxB,OAAO,CAAC,UAAU,CAAC,gBAAgB,EAAE,CAAC,CAAA;AAEtC,OAAO,CAAC,KAAK,EAAE,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AACpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAA;AAE5D,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAA;AAE7B,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,WAAW,CAAC,oBAAoB,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;AAE3E,OAAO;KACJ,OAAO,CAAC,UAAU,CAAC;KACnB,WAAW,CAAC,qEAAqE,CAAC;KAClF,MAAM,CAAC,KAAK,IAAI,EAAE;IACjB,MAAM,eAAe,EAAE,CAAA;AACzB,CAAC,CAAC,CAAA;AAEJ,OAAO;KACJ,OAAO,CAAC,qBAAqB,CAAC;KAC9B,WAAW,CAAC,kEAAkE,CAAC;KAC/E,MAAM,CAAC,aAAa,EAAE,sCAAsC,CAAC;KAC7D,kBAAkB,EAAE,CAAC,sCAAsC;KAC3D,MAAM,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,EAAE;IACrC,MAAM,IAAI,GAAG,EAAE,CAAA;IACf,IAAI,WAAW;QAAE,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAA;IACvC,IAAI,OAAO,CAAC,QAAQ;QAAE,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,CAAA;IAC9C,MAAM,WAAW,CAAC,IAAI,CAAC,CAAA;AACzB,CAAC,CAAC,CAAA;AAEJ,OAAO;KACJ,OAAO,CAAC,KAAK,CAAC;KACd,WAAW,CAAC,oDAAoD,CAAC;KACjE,MAAM,CAAC,KAAK,IAAI,EAAE;IACjB,MAAM,UAAU,EAAE,CAAA;AACpB,CAAC,CAAC,CAAA;AAEJ,wBAAwB;AACxB,OAAO,CAAC,UAAU,CAAC,gBAAgB,EAAE,CAAC,CAAA;AAEtC,sBAAsB;AACtB,OAAO,CAAC,UAAU,CAAC,oBAAoB,EAAE,CAAC,CAAA;AAE1C,OAAO,CAAC,KAAK,EAAE,CAAA"}

package/dist/mcp/lib/documentation-provider.d.ts

@@ -2,6 +2,16 @@
  * Documentation provider - Fetches documentation from the hosted docs site
  */
 import type { DocumentationLookup } from './types.js';
+interface LocalDocResult {
+    content: string;
+    files: string[];
+}
+interface ExampleConfig {
+    description: string;
+    code: string;
+    notes?: string;
+    sourcePath: string;
+}
 export declare class OpenSaasDocumentationProvider {
     private readonly DOCS_API;
     private cache;
@@ -31,6 +41,18 @@ export declare class OpenSaasDocumentationProvider {
      * Fallback documentation when API is unavailable
      */
     private getFallbackDocs;
+    /**
+     * Search local CLAUDE.md files in the monorepo
+     */
+    searchLocalDocs(query: string): Promise<LocalDocResult>;
+    /**
+     * Get example config code for a feature
+     */
+    getExampleConfig(feature: string): Promise<ExampleConfig | null>;
+    /**
+     * Get migration-specific documentation for a project type
+     */
+    findMigrationGuide(projectType: string): Promise<string>;
     /**
      * Clear expired cache entries
      */
@@ -40,4 +62,5 @@ export declare class OpenSaasDocumentationProvider {
      */
     clearCache(): void;
 }
+export {};
 //# sourceMappingURL=documentation-provider.d.ts.map

package/dist/mcp/lib/documentation-provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"documentation-provider.d.ts","sourceRoot":"","sources":["../../../src/mcp/lib/documentation-provider.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAA;AAkBrD,qBAAa,6BAA6B;IACxC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAyC;IAClE,OAAO,CAAC,KAAK,CAAsE;IACnF,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAiB;IAG3C,OAAO,CAAC,aAAa,CA4BpB;IAED;;OAEG;IACG,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAI,EAAE,QAAQ,SAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IA0CxF;;OAEG;IACG,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAO/D;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAgB3B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAc3B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAY5B;;OAEG;IACH,OAAO,CAAC,eAAe;IAiBvB;;OAEG;IACH,iBAAiB,IAAI,IAAI;IASzB;;OAEG;IACH,UAAU,IAAI,IAAI;CAGnB"}
+{"version":3,"file":"documentation-provider.d.ts","sourceRoot":"","sources":["../../../src/mcp/lib/documentation-provider.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAA;AAkBrD,UAAU,cAAc;IACtB,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,EAAE,CAAA;CAChB;AAED,UAAU,aAAa;IACrB,WAAW,EAAE,MAAM,CAAA;IACnB,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,qBAAa,6BAA6B;IACxC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAyC;IAClE,OAAO,CAAC,KAAK,CAAsE;IACnF,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAiB;IAG3C,OAAO,CAAC,aAAa,CA4BpB;IAED;;OAEG;IACG,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAI,EAAE,QAAQ,SAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IA0CxF;;OAEG;IACG,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAO/D;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAgB3B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAc3B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAY5B;;OAEG;IACH,OAAO,CAAC,eAAe;IAiBvB;;OAEG;IACG,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAsF7D;;OAEG;IACG,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IA0OtE;;OAEG;IACG,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAmK9D;;OAEG;IACH,iBAAiB,IAAI,IAAI;IASzB;;OAEG;IACH,UAAU,IAAI,IAAI;CAGnB"}