@specverse/engines 4.1.0

package/libs/instance-factories/cli/README.md

@@ -0,0 +1,43 @@
+# CLI Factory
+
+Generates Commander.js CLI applications from spec command definitions.
+
+## Definition
+
+| File | Description |
+|------|-------------|
+| `commander-js.yaml` | Commander.js v12 CLI with argument parsing, help text, and command routing |
+
+## Generated Output
+
+| Generator | Output | Purpose |
+|-----------|--------|---------|
+| `cli-entry-generator` | `backend/src/cli/index.ts` | Main CLI entry point — registers all commands from spec |
+| `command-generator` | `backend/src/cli/commands/{command}.ts` | Individual command files (one per spec command) |
+
+The entry generator reads the spec's `commands` section and registers each as a
+Commander.js command with arguments, flags, and help text. Each command file
+delegates to its corresponding service for business logic.
+
+## Technology
+
+- **Framework**: Commander.js ^12.0.0
+- **Runtime**: Node.js with tsx for development
+- **Language**: TypeScript
+
+## Capabilities
+
+| Provides | Requires |
+|----------|----------|
+| `cli.commands` | `service.controller` |
+| `cli.parser` | |
+| `cli.help` | |
+
+## Spec Integration
+
+Commands are defined in the spec with:
+- `arguments` — positional parameters
+- `flags` — optional switches
+- `returns` — output format
+- `exitCodes` — process exit codes
+- `subcommands` — nested command trees

package/libs/instance-factories/cli/commander-js.yaml

@@ -0,0 +1,55 @@
+name: CommanderJS
+version: "1.0.0"
+category: cli
+description: "Node.js CLI generation using Commander.js"
+
+metadata:
+  author: "SpecVerse Team"
+  license: "MIT"
+  tags: [cli, commander, node, typescript]
+
+compatibility:
+  specverse: ">=3.3.0"
+  node: ">=18.0.0"
+
+capabilities:
+  provides:
+    - "cli.commands"
+    - "cli.parser"
+    - "cli.help"
+  requires:
+    - "service.controller"
+
+technology:
+  runtime: "node"
+  language: "typescript"
+  framework: "commander"
+  version: "^12.0.0"
+
+dependencies:
+  runtime:
+    - name: "commander"
+      version: "^12.0.0"
+
+  dev:
+    - name: "@types/node"
+      version: "^20.8.0"
+    - name: "typescript"
+      version: "^5.2.0"
+    - name: "tsx"
+      version: "^4.0.0"
+
+codeTemplates:
+  cli-entry:
+    engine: typescript
+    generator: "libs/instance-factories/cli/templates/commander/cli-entry-generator.ts"
+    outputPattern: "{backendDir}/src/cli/index.ts"
+
+  cli-commands:
+    engine: typescript
+    generator: "libs/instance-factories/cli/templates/commander/command-generator.ts"
+    outputPattern: "{backendDir}/src/cli/commands/{command}.ts"
+
+configuration:
+  outputStructure: "monorepo"
+  backendDir: "backend"

package/libs/instance-factories/cli/templates/commander/cli-bin-wrapper-generator.ts

@@ -0,0 +1,20 @@
+/**
+ * CLI Bin Wrapper Generator
+ *
+ * Generates bin/cli.mjs — a Node.js executable wrapper that loads
+ * tsx and runs the TypeScript CLI entry point.
+ *
+ * This allows `npm link` or `npx` to run the CLI without
+ * the user having tsx installed globally.
+ */
+
+import type { TemplateContext } from '@specverse/types';
+
+export default function generateCLIBinWrapper(context: TemplateContext): string {
+  return `#!/usr/bin/env node
+import { register } from 'tsx/esm/api';
+const unregister = register();
+await import('../src/cli/index.ts');
+unregister();
+`;
+}

package/libs/instance-factories/cli/templates/commander/cli-entry-generator.d.ts

@@ -0,0 +1,12 @@
+/**
+ * CLI Entry Point Generator
+ *
+ * Generates the main CLI entry point that registers all commands from the spec.
+ * Uses Commander.js for argument parsing, help text, and command routing.
+ */
+import type { TemplateContext } from '@specverse/types';
+/**
+ * Generate the CLI entry point from the commands spec.
+ */
+export default function generateCLIEntry(context: TemplateContext): string;
+//# sourceMappingURL=cli-entry-generator.d.ts.map

package/libs/instance-factories/cli/templates/commander/cli-entry-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-entry-generator.d.ts","sourceRoot":"","sources":["cli-entry-generator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2CAA2C,CAAC;AAYjF;;GAEG;AACH,MAAM,CAAC,OAAO,UAAU,gBAAgB,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,CAoDzE"}

package/libs/instance-factories/cli/templates/commander/cli-entry-generator.js

@@ -0,0 +1,115 @@
+/**
+ * CLI Entry Point Generator
+ *
+ * Generates the main CLI entry point that registers all commands from the spec.
+ * Uses Commander.js for argument parsing, help text, and command routing.
+ */
+/**
+ * Generate the CLI entry point from the commands spec.
+ */
+export default function generateCLIEntry(context) {
+    const { spec } = context;
+    // Extract commands from spec — could be in spec.commands or in a component's commands section
+    const commands = extractCommands(spec);
+    if (commands.length === 0) {
+        return generateMinimalCLI(spec);
+    }
+    // Find the root command (usually the app name)
+    const rootCommand = commands[0];
+    const subcommands = rootCommand.subcommands
+        ? Object.entries(rootCommand.subcommands)
+        : [];
+    const imports = subcommands.map(([name, _]) => `import { register${capitalize(name)}Command } from './commands/${name}.js';`).join('\n');
+    const registrations = subcommands.map(([name, _]) => `  register${capitalize(name)}Command(program);`).join('\n');
+    // Get version from spec
+    const version = spec.version || spec.components?.[0]?.version || '1.0.0';
+    return `#!/usr/bin/env node
+/**
+ * ${rootCommand.description || 'CLI Application'}
+ * Generated from SpecVerse specification
+ */
+
+import { Command } from 'commander';
+${imports}
+
+const program = new Command();
+
+program
+  .name('${rootCommand.name}')
+  .description('${rootCommand.description || ''}')
+  .version('${version}');
+
+// Register all commands
+${registrations}
+
+// Parse and execute
+program.parseAsync(process.argv).catch((error) => {
+  console.error('Error:', error.message);
+  process.exit(1);
+});
+`;
+}
+/**
+ * Extract commands from the spec.
+ * Checks spec.commands, then each component's commands section.
+ */
+function extractCommands(spec) {
+    // Direct commands on spec
+    if (spec.commands) {
+        if (Array.isArray(spec.commands))
+            return spec.commands;
+        return Object.entries(spec.commands).map(([name, def]) => ({
+            name,
+            ...def
+        }));
+    }
+    // Check components for commands sections
+    const components = spec.components || [];
+    const componentList = Array.isArray(components)
+        ? components
+        : Object.entries(components).map(([name, c]) => ({ name, ...c }));
+    for (const comp of componentList) {
+        if (comp.commands) {
+            if (Array.isArray(comp.commands))
+                return comp.commands;
+            return Object.entries(comp.commands).map(([name, def]) => ({
+                name,
+                ...def
+            }));
+        }
+    }
+    return [];
+}
+/**
+ * Generate a minimal CLI when no commands are found.
+ */
+function generateMinimalCLI(spec) {
+    return `#!/usr/bin/env node
+/**
+ * CLI Application
+ * Generated from SpecVerse specification
+ */
+
+import { Command } from 'commander';
+
+const program = new Command();
+
+program
+  .name('app')
+  .description('Generated CLI application')
+  .version('1.0.0');
+
+program
+  .command('status')
+  .description('Show application status')
+  .action(() => {
+    console.log('Application is running');
+  });
+
+program.parseAsync(process.argv);
+`;
+}
+function capitalize(str) {
+    return str.charAt(0).toUpperCase() + str.slice(1);
+}
+//# sourceMappingURL=cli-entry-generator.js.map

package/libs/instance-factories/cli/templates/commander/cli-entry-generator.js.map

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

package/libs/instance-factories/cli/templates/commander/cli-entry-generator.ts

@@ -0,0 +1,168 @@
+/**
+ * CLI Entry Point Generator
+ *
+ * Generates the main CLI entry point that registers all commands from the spec.
+ * Uses Commander.js for argument parsing, help text, and command routing.
+ */
+
+import type { TemplateContext } from '@specverse/types';
+
+interface CommandDef {
+  name: string;
+  description?: string;
+  arguments?: Record<string, any>;
+  flags?: Record<string, any>;
+  returns?: string;
+  exitCodes?: Record<string, string>;
+  subcommands?: Record<string, any>;
+}
+
+/**
+ * Generate the CLI entry point from the commands spec.
+ */
+export default function generateCLIEntry(context: TemplateContext): string {
+  const { spec } = context;
+
+
+  // Extract commands — check context.commands first (passed directly by CLI handler),
+  // then fall back to searching spec
+  const commands = context.commands
+    ? (Array.isArray(context.commands) ? context.commands : Object.entries(context.commands).map(([name, def]: [string, any]) => ({ name, ...def })))
+    : extractCommands(spec);
+
+  if (commands.length === 0) {
+    return generateMinimalCLI(spec);
+  }
+
+  // Find the root command (usually the app name)
+  const rootCommand = commands[0];
+  const subcommands = rootCommand.subcommands
+    ? Object.entries(rootCommand.subcommands)
+    : [];
+
+  const imports = subcommands.map(([name, _]) =>
+    `import { register${capitalize(name)}Command } from './commands/${name}.js';`
+  ).join('\n');
+
+  const registrations = subcommands.map(([name, _]) =>
+    `  register${capitalize(name)}Command(program);`
+  ).join('\n');
+
+  // Get version from spec — try multiple paths
+  const version = spec.version
+    || spec.metadata?.version
+    || context.componentVersion
+    || (Array.isArray(spec.components) ? spec.components[0]?.version : (Object.values(spec.components || {}) as any[])[0]?.version)
+    || '1.0.0';
+
+  return `#!/usr/bin/env node
+/**
+ * ${rootCommand.description || 'CLI Application'}
+ * Generated from SpecVerse specification
+ */
+
+import { Command } from 'commander';
+import { readFileSync } from 'fs';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+${imports}
+
+// Read version from package.json at runtime (not hardcoded)
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+let _version = '${version}';
+try {
+  // Walk up to find package.json
+  for (const rel of ['../../../package.json', '../../../../package.json', '../../../../../package.json']) {
+    try {
+      const pkg = JSON.parse(readFileSync(join(__dirname, rel), 'utf8'));
+      if (pkg.version) { _version = pkg.version; break; }
+    } catch { /* try next */ }
+  }
+} catch { /* use fallback */ }
+
+const program = new Command();
+
+program
+  .name('${rootCommand.name}')
+  .description('${rootCommand.description || ''}')
+  .version(_version);
+
+// Register all commands
+${registrations}
+
+// Parse and execute
+program.parseAsync(process.argv).catch((error) => {
+  console.error('Error:', error.message);
+  process.exit(1);
+});
+`;
+}
+
+/**
+ * Extract commands from the spec.
+ * Checks spec.commands, then each component's commands section.
+ */
+function extractCommands(spec: any): CommandDef[] {
+  // Direct commands on spec
+  if (spec.commands) {
+    if (Array.isArray(spec.commands)) return spec.commands;
+    return Object.entries(spec.commands).map(([name, def]: [string, any]) => ({
+      name,
+      ...def
+    }));
+  }
+
+  // Check components for commands sections
+  const components = spec.components || [];
+  const componentList = Array.isArray(components)
+    ? components
+    : Object.entries(components).map(([name, c]: [string, any]) => ({ name, ...c }));
+
+  for (const comp of componentList) {
+    if (comp.commands) {
+      if (Array.isArray(comp.commands)) return comp.commands;
+      return Object.entries(comp.commands).map(([name, def]: [string, any]) => ({
+        name,
+        ...def
+      }));
+    }
+  }
+
+  return [];
+}
+
+/**
+ * Generate a minimal CLI when no commands are found.
+ */
+function generateMinimalCLI(spec: any): string {
+  return `#!/usr/bin/env node
+/**
+ * CLI Application
+ * Generated from SpecVerse specification
+ */
+
+import { Command } from 'commander';
+
+const program = new Command();
+
+program
+  .name('app')
+  .description('Generated CLI application')
+  .version('1.0.0');
+
+program
+  .command('status')
+  .description('Show application status')
+  .action(() => {
+    console.log('Application is running');
+  });
+
+program.parseAsync(process.argv);
+`;
+}
+
+function capitalize(str: string): string {
+  // Convert hyphenated names to PascalCase: "validate-manifest" → "ValidateManifest"
+  return str.split('-').map(part => part.charAt(0).toUpperCase() + part.slice(1)).join('');
+}

package/libs/instance-factories/cli/templates/commander/command-generator.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Command Generator
+ *
+ * Generates individual command files from command specifications.
+ * Each command registers itself on a Commander program and wires
+ * to its corresponding service for business logic delegation.
+ */
+import type { TemplateContext } from '@specverse/types';
+/**
+ * Generate a single command file.
+ * Called once per command in the spec.
+ */
+export default function generateCommand(context: TemplateContext): string;
+//# sourceMappingURL=command-generator.d.ts.map

package/libs/instance-factories/cli/templates/commander/command-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-generator.d.ts","sourceRoot":"","sources":["command-generator.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2CAA2C,CAAC;AAEjF;;;GAGG;AACH,MAAM,CAAC,OAAO,UAAU,eAAe,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,CAkGxE"}

package/libs/instance-factories/cli/templates/commander/command-generator.js

@@ -0,0 +1,182 @@
+/**
+ * Command Generator
+ *
+ * Generates individual command files from command specifications.
+ * Each command registers itself on a Commander program and wires
+ * to its corresponding service for business logic delegation.
+ */
+/**
+ * Generate a single command file.
+ * Called once per command in the spec.
+ */
+export default function generateCommand(context) {
+    const { command } = context;
+    if (!command) {
+        throw new Error('Command is required in template context');
+    }
+    const name = command.name;
+    const description = command.description || '';
+    const args = command.arguments || {};
+    const flags = command.flags || {};
+    const exitCodes = command.exitCodes || {};
+    const subcommands = command.subcommands || {};
+    const serviceRef = command.serviceRef;
+    // Build positional argument string for Commander
+    const positionalArgs = Object.entries(args)
+        .filter(([_, arg]) => arg.positional)
+        .sort((a, b) => (a[1].position || 0) - (b[1].position || 0))
+        .map(([argName, arg]) => {
+        const required = arg.required;
+        return required ? `<${argName}>` : `[${argName}]`;
+    })
+        .join(' ');
+    const commandStr = positionalArgs ? `${name} ${positionalArgs}` : name;
+    // Build options
+    const optionDefs = Object.entries(flags).map(([flagName, flag]) => {
+        const alias = flag.alias ? `${flag.alias}, ` : '';
+        const flagType = flag.type?.toLowerCase();
+        const valuePart = flagType === 'boolean' ? '' : ` <${flagName.replace(/^--/, '')}>`;
+        const defaultVal = flag.default !== undefined ? `, ${JSON.stringify(flag.default)}` : '';
+        const desc = flag.description || `${flagName} option`;
+        return `    .option('${alias}${flagName}${valuePart}', '${desc}'${defaultVal})`;
+    });
+    // Build type interface for options
+    const optionTypes = Object.entries(flags).map(([flagName, flag]) => {
+        const tsType = mapFlagTypeToTS(flag.type);
+        const key = flagName.replace(/^--/, '').replace(/-([a-z])/g, (_, c) => c.toUpperCase());
+        return `  ${key}${flag.required ? '' : '?'}: ${tsType};`;
+    });
+    // Build positional arg types
+    const argTypes = Object.entries(args)
+        .filter(([_, arg]) => arg.positional)
+        .map(([argName, arg]) => {
+        const tsType = mapArgTypeToTS(arg.type);
+        return `${argName}: ${tsType}`;
+    });
+    // Generate action handler
+    const actionParams = argTypes.length > 0
+        ? argTypes.join(', ') + ', options: CommandOptions'
+        : 'options: CommandOptions';
+    // Generate exit code comments
+    const exitCodeComments = Object.entries(exitCodes).length > 0
+        ? Object.entries(exitCodes).map(([code, meaning]) => `  //   ${code}: ${meaning}`).join('\n')
+        : '';
+    // Handle subcommands
+    const hasSubcommands = Object.keys(subcommands).length > 0;
+    const subcommandRegistrations = hasSubcommands
+        ? generateSubcommandRegistrations(name, subcommands)
+        : '';
+    // Service import
+    const serviceImport = serviceRef
+        ? `import { ${serviceRef} } from '../services/${serviceRef}.js';`
+        : '';
+    return `/**
+ * ${name} command
+ * ${description}
+ * Generated from SpecVerse specification
+ */
+
+import { Command } from 'commander';
+${serviceImport}
+
+interface CommandOptions {
+${optionTypes.length > 0 ? optionTypes.join('\n') : '  [key: string]: any;'}
+}
+
+${exitCodeComments ? `/**\n * Exit codes:\n${exitCodeComments}\n */` : ''}
+
+/**
+ * Register the ${name} command on the program.
+ */
+export function register${capitalize(name)}Command(program: Command): void {
+  ${hasSubcommands ? generateCommandWithSubcommands(name, description, subcommands, optionDefs) : generateLeafCommand(name, description, commandStr, optionDefs, actionParams, serviceRef, exitCodes)}
+}
+${subcommandRegistrations}
+`;
+}
+function generateLeafCommand(name, description, commandStr, optionDefs, actionParams, serviceRef, exitCodes) {
+    const handler = serviceRef
+        ? `const service = new ${serviceRef}();
+      const result = await service.execute(${actionParams.includes(':') ? '{ ' + actionParams.split(',').map(p => p.trim().split(':')[0].trim()).join(', ') + ', ...options }' : 'options'});
+      console.log(result);`
+        : `console.log('Executing ${name}...');
+      // TODO: Wire to service`;
+    return `const cmd = program
+    .command('${commandStr}')
+    .description('${description}')
+${optionDefs.join('\n')}
+    .action(async (${actionParams}) => {
+      try {
+        ${handler}
+      } catch (error: any) {
+        console.error('Error:', error.message);
+        process.exit(${Object.keys(exitCodes).find(k => k !== '0') || '1'});
+      }
+    });`;
+}
+function generateCommandWithSubcommands(name, description, subcommands, optionDefs) {
+    const subcmdRegistrations = Object.entries(subcommands).map(([subName, subDef]) => {
+        const subDesc = subDef.description || '';
+        const subArgs = subDef.arguments || {};
+        const subFlags = subDef.flags || {};
+        const positionalStr = Object.entries(subArgs)
+            .filter(([_, a]) => a.positional)
+            .map(([n, a]) => a.required ? `<${n}>` : `[${n}]`)
+            .join(' ');
+        const subCmdStr = positionalStr ? `${subName} ${positionalStr}` : subName;
+        const subOptionDefs = Object.entries(subFlags).map(([flagName, flag]) => {
+            const alias = flag.alias ? `${flag.alias}, ` : '';
+            const flagType = flag.type?.toLowerCase();
+            const valuePart = flagType === 'boolean' ? '' : ` <${flagName.replace(/^--/, '')}>`;
+            const defaultVal = flag.default !== undefined ? `, ${JSON.stringify(flag.default)}` : '';
+            return `    .option('${alias}${flagName}${valuePart}', '${flag.description || flagName}'${defaultVal})`;
+        });
+        return `
+  cmd
+    .command('${subCmdStr}')
+    .description('${subDesc}')
+${subOptionDefs.join('\n')}
+    .action(async (...args: any[]) => {
+      try {
+        console.log('Executing ${name} ${subName}...');
+        // TODO: Wire to service
+      } catch (error: any) {
+        console.error('Error:', error.message);
+        process.exit(1);
+      }
+    });`;
+    });
+    return `const cmd = program
+    .command('${name}')
+    .description('${description}');
+${subcmdRegistrations.join('\n')}`;
+}
+function generateSubcommandRegistrations(_parentName, _subcommands) {
+    return ''; // Subcommands are registered inline
+}
+function mapFlagTypeToTS(type) {
+    if (!type)
+        return 'string';
+    const lower = type.toLowerCase();
+    if (lower === 'boolean')
+        return 'boolean';
+    if (lower === 'number' || lower === 'integer')
+        return 'number';
+    return 'string';
+}
+function mapArgTypeToTS(type) {
+    if (!type)
+        return 'string';
+    const lower = type.toLowerCase();
+    if (lower === 'filepath' || lower === 'string')
+        return 'string';
+    if (lower === 'number' || lower === 'integer')
+        return 'number';
+    if (lower === 'boolean')
+        return 'boolean';
+    return 'string';
+}
+function capitalize(str) {
+    return str.charAt(0).toUpperCase() + str.slice(1);
+}
+//# sourceMappingURL=command-generator.js.map

package/libs/instance-factories/cli/templates/commander/command-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-generator.js","sourceRoot":"","sources":["command-generator.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH;;;GAGG;AACH,MAAM,CAAC,OAAO,UAAU,eAAe,CAAC,OAAwB;IAC9D,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;IAE5B,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;IAC7D,CAAC;IAED,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAC1B,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,EAAE,CAAC;IAC9C,MAAM,IAAI,GAAG,OAAO,CAAC,SAAS,IAAI,EAAE,CAAC;IACrC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC;IAClC,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,EAAE,CAAC;IAC1C,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,EAAE,CAAC;IAC9C,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IAEtC,iDAAiD;IACjD,MAAM,cAAc,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC;SACxC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,CAAgB,EAAE,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC;SACnD,IAAI,CAAC,CAAC,CAAM,EAAE,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,CAAC;SACrE,GAAG,CAAC,CAAC,CAAC,OAAO,EAAE,GAAG,CAAgB,EAAE,EAAE;QACrC,MAAM,QAAQ,GAAG,GAAG,CAAC,QAAQ,CAAC;QAC9B,OAAO,QAAQ,CAAC,CAAC,CAAC,IAAI,OAAO,GAAG,CAAC,CAAC,CAAC,IAAI,OAAO,GAAG,CAAC;IACpD,CAAC,CAAC;SACD,IAAI,CAAC,GAAG,CAAC,CAAC;IAEb,MAAM,UAAU,GAAG,cAAc,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,cAAc,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IAEvE,gBAAgB;IAChB,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,IAAI,CAAgB,EAAE,EAAE;QAC/E,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QAClD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,EAAE,WAAW,EAAE,CAAC;QAC1C,MAAM,SAAS,GAAG,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,CAAC;QACpF,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzF,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,IAAI,GAAG,QAAQ,SAAS,CAAC;QACtD,OAAO,gBAAgB,KAAK,GAAG,QAAQ,GAAG,SAAS,OAAO,IAAI,IAAI,UAAU,GAAG,CAAC;IAClF,CAAC,CAAC,CAAC;IAEH,mCAAmC;IACnC,MAAM,WAAW,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,IAAI,CAAgB,EAAE,EAAE;QAChF,MAAM,MAAM,GAAG,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1C,MAAM,GAAG,GAAG,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC,EAAE,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;QAChG,OAAO,KAAK,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,MAAM,GAAG,CAAC;IAC3D,CAAC,CAAC,CAAC;IAEH,6BAA6B;IAC7B,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC;SAClC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,CAAgB,EAAE,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC;SACnD,GAAG,CAAC,CAAC,CAAC,OAAO,EAAE,GAAG,CAAgB,EAAE,EAAE;QACrC,MAAM,MAAM,GAAG,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACxC,OAAO,GAAG,OAAO,KAAK,MAAM,EAAE,CAAC;IACjC,CAAC,CAAC,CAAC;IAEL,0BAA0B;IAC1B,MAAM,YAAY,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC;QACtC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,2BAA2B;QACnD,CAAC,CAAC,yBAAyB,CAAC;IAE9B,8BAA8B;IAC9B,MAAM,gBAAgB,GAAG,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,MAAM,GAAG,CAAC;QAC3D,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,EAAE,CAChD,UAAU,IAAI,KAAK,OAAO,EAAE,CAC7B,CAAC,IAAI,CAAC,IAAI,CAAC;QACd,CAAC,CAAC,EAAE,CAAC;IAEP,qBAAqB;IACrB,MAAM,cAAc,GAAG,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;IAC3D,MAAM,uBAAuB,GAAG,cAAc;QAC5C,CAAC,CAAC,+BAA+B,CAAC,IAAI,EAAE,WAAW,CAAC;QACpD,CAAC,CAAC,EAAE,CAAC;IAEP,iBAAiB;IACjB,MAAM,aAAa,GAAG,UAAU;QAC9B,CAAC,CAAC,YAAY,UAAU,wBAAwB,UAAU,OAAO;QACjE,CAAC,CAAC,EAAE,CAAC;IAEP,OAAO;KACJ,IAAI;KACJ,WAAW;;;;;EAKd,aAAa;;;EAGb,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,uBAAuB;;;EAGzE,gBAAgB,CAAC,CAAC,CAAC,wBAAwB,gBAAgB,OAAO,CAAC,CAAC,CAAC,EAAE;;;kBAGvD,IAAI;;0BAEI,UAAU,CAAC,IAAI,CAAC;IACtC,cAAc,CAAC,CAAC,CAAC,8BAA8B,CAAC,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC,IAAI,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,YAAY,EAAE,UAAU,EAAE,SAAS,CAAC;;EAEnM,uBAAuB;CACxB,CAAC;AACF,CAAC;AAED,SAAS,mBAAmB,CAC1B,IAAY,EACZ,WAAmB,EACnB,UAAkB,EAClB,UAAoB,EACpB,YAAoB,EACpB,UAA8B,EAC9B,SAAiC;IAEjC,MAAM,OAAO,GAAG,UAAU;QACxB,CAAC,CAAC,uBAAuB,UAAU;6CACM,YAAY,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,YAAY,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,gBAAgB,CAAC,CAAC,CAAC,SAAS;2BAC/J;QACvB,CAAC,CAAC,0BAA0B,IAAI;+BACL,CAAC;IAE9B,OAAO;gBACO,UAAU;oBACN,WAAW;EAC7B,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC;qBACF,YAAY;;UAEvB,OAAO;;;uBAGM,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,GAAG,CAAC,IAAI,GAAG;;QAEjE,CAAC;AACT,CAAC;AAED,SAAS,8BAA8B,CACrC,IAAY,EACZ,WAAmB,EACnB,WAAgC,EAChC,UAAoB;IAEpB,MAAM,mBAAmB,GAAG,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC,EAAE,EAAE;QAChF,MAAM,OAAO,GAAG,MAAM,CAAC,WAAW,IAAI,EAAE,CAAC;QACzC,MAAM,OAAO,GAAG,MAAM,CAAC,SAAS,IAAI,EAAE,CAAC;QACvC,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC;QAEpC,MAAM,aAAa,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC;aAC1C,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAgB,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC;aAC/C,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAgB,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;aAChE,IAAI,CAAC,GAAG,CAAC,CAAC;QAEb,MAAM,SAAS,GAAG,aAAa,CAAC,CAAC,CAAC,GAAG,OAAO,IAAI,aAAa,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;QAE1E,MAAM,aAAa,GAAG,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,IAAI,CAAgB,EAAE,EAAE;YACrF,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;YAClD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,EAAE,WAAW,EAAE,CAAC;YAC1C,MAAM,SAAS,GAAG,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,CAAC;YACpF,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACzF,OAAO,gBAAgB,KAAK,GAAG,QAAQ,GAAG,SAAS,OAAO,IAAI,CAAC,WAAW,IAAI,QAAQ,IAAI,UAAU,GAAG,CAAC;QAC1G,CAAC,CAAC,CAAC;QAEH,OAAO;;gBAEK,SAAS;oBACL,OAAO;EACzB,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC;;;iCAGO,IAAI,IAAI,OAAO;;;;;;QAMxC,CAAC;IACP,CAAC,CAAC,CAAC;IAEH,OAAO;gBACO,IAAI;oBACA,WAAW;EAC7B,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;AACnC,CAAC;AAED,SAAS,+BAA+B,CACtC,WAAmB,EACnB,YAAiC;IAEjC,OAAO,EAAE,CAAC,CAAC,oCAAoC;AACjD,CAAC;AAED,SAAS,eAAe,CAAC,IAAY;IACnC,IAAI,CAAC,IAAI;QAAE,OAAO,QAAQ,CAAC;IAC3B,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IACjC,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC1C,IAAI,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,QAAQ,CAAC;IAC/D,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAS,cAAc,CAAC,IAAY;IAClC,IAAI,CAAC,IAAI;QAAE,OAAO,QAAQ,CAAC;IAC3B,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IACjC,IAAI,KAAK,KAAK,UAAU,IAAI,KAAK,KAAK,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAChE,IAAI,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,QAAQ,CAAC;IAC/D,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC1C,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAS,UAAU,CAAC,GAAW;IAC7B,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACpD,CAAC"}