@auto-engineer/narrative 0.11.11

package/DEBUG.md

@@ -0,0 +1,136 @@
+# Debug Logging - Flow
+
+This package uses the [debug](https://www.npmjs.com/package/debug) library for conditional logging.
+
+## Available Debug Namespaces
+
+### Core Flow Operations
+
+- `flow:flow` - Flow creation and management
+- `flow:context` - Flow context operations
+- `flow:slice` - Slice operations
+- `flow:registry` - Registry operations (flow, message, integration)
+
+### Fluent Builder Operations
+
+- `flow:fluent-builder` - General builder operations
+- `flow:fluent-builder:command` - Command slice building
+- `flow:fluent-builder:query` - Query slice building
+- `flow:fluent-builder:react` - Reaction slice building
+
+## Enabling Debug Output
+
+Set the `DEBUG` environment variable to enable logging:
+
+```bash
+# Enable all flow logging
+DEBUG=flow:* pnpm dev
+
+# Enable specific namespace
+DEBUG=flow:flow pnpm dev
+
+# Enable all builder operations
+DEBUG=flow:fluent-builder:* pnpm dev
+
+# Enable multiple specific namespaces
+DEBUG=flow:flow,flow:context pnpm dev
+```
+
+## Examples
+
+### Debug Flow Creation
+
+```bash
+DEBUG=flow:flow pnpm test
+```
+
+Output example:
+
+```
+flow:flow Creating new flow: ShoppingAssistant
+flow:flow Flow created with 0 slices
+flow:flow Registering flow: ShoppingAssistant
+flow:flow Flow registered successfully
+```
+
+### Debug Slice Building
+
+```bash
+DEBUG=flow:fluent-builder:* pnpm dev
+```
+
+Output example:
+
+```
+flow:fluent-builder Creating command slice via factory: CreateOrder
+flow:fluent-builder:command Creating command slice: CreateOrder
+flow:fluent-builder:command Command slice added to flow: CreateOrder
+flow:fluent-builder:command Adding client block to slice CreateOrder, description: "Order form"
+flow:fluent-builder:command Starting client block execution
+flow:fluent-builder:command Client block execution completed
+flow:fluent-builder:command Setting request for slice CreateOrder
+flow:fluent-builder:command Request is GraphQL AST Document, converting to SDL
+flow:fluent-builder:command Converted SDL length: 245
+```
+
+### Debug Context Operations
+
+```bash
+DEBUG=flow:context pnpm dev
+```
+
+Output example:
+
+```
+flow:context Starting new flow: ShoppingAssistant
+flow:context Current flow set: ShoppingAssistant
+flow:context Adding slice to current flow: CreateOrder (type: command)
+flow:context Slice added, total slices in flow: 1
+flow:context Starting client block for slice: CreateOrder
+flow:context   Description: Order form interface
+flow:context Client block ended for slice: CreateOrder
+```
+
+### Debug Registry Operations
+
+```bash
+DEBUG=flow:registry pnpm dev
+```
+
+Output example:
+
+```
+flow:registry Registering flow: ShoppingAssistant
+flow:registry Total registered flows: 1
+flow:registry Registering message: CreateOrderCommand
+flow:registry Message registered with schema: { name, items, total }
+flow:registry Registering integration: ProductCatalog
+flow:registry Integration registered successfully
+```
+
+## Common Use Cases
+
+### Debugging Flow Export
+
+```bash
+DEBUG=flow:flow,flow:context pnpm export:schema
+```
+
+### Debugging Slice Processing
+
+```bash
+DEBUG=flow:slice,flow:fluent-builder:* pnpm build
+```
+
+### Full Flow Creation Trace
+
+```bash
+DEBUG=flow:* pnpm dev
+```
+
+## Tips
+
+- Use wildcards to see related logs: `DEBUG=flow:fluent-builder:*`
+- Combine with other packages: `DEBUG=flow:*,emmett:*`
+- Filter by operation type: `DEBUG=*:command` (all command-related logs)
+- Save to file: `DEBUG=flow:* pnpm dev 2> flow-debug.log`

package/LICENSE

@@ -0,0 +1,10 @@
+Elastic License 2.0
+
+Copyright 2024 Sam Hatoum
+
+This software and associated documentation files (the "Software") are licensed under the Elastic License 2.0 (the "License"). You may not use this file except in compliance with the License.
+
+You may obtain a copy of the License at:
+https://www.elastic.co/licensing/elastic-license
+
+Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. 

package/README.md

@@ -0,0 +1,141 @@
+# @auto-engineer/flow
+
+Domain-specific language for building event-driven applications with type-safe schemas and GraphQL API generation. Plugin for the Auto Engineer CLI that enables defining business flows, data transformations, and integrations using TypeScript-based syntax.
+
+## Installation
+
+This is a plugin for the Auto Engineer CLI. Install both the CLI and this plugin:
+
+```bash
+npm install -g @auto-engineer/cli
+npm install @auto-engineer/flow
+```
+
+## Configuration
+
+Add this plugin to your `auto.config.ts`:
+
+```typescript
+export default {
+  plugins: [
+    '@auto-engineer/flow',
+    // ... other plugins
+  ],
+};
+```
+
+## Commands
+
+This plugin provides the following commands:
+
+- `create:example` - Create an example project with Flow
+- `export:schema` - Export flow schema to JSON
+
+## What is Flow?
+
+Flow is a declarative language for describing business processes, data flows, and system integrations. It combines:
+
+- Type Safety: Full TypeScript integration with compile-time validation
+- Event-Driven Architecture: Built on top of the Emmett event sourcing framework
+- GraphQL Integration: Schema generation and resolver creation
+- Message Bus Support: Support for inter-service communication
+- Flow Orchestration: Define workflows with branching logic and error handling
+
+## Key Features
+
+### Fluent API Design
+
+Define business flows using chainable API:
+
+```typescript
+import { flow } from '@auto-engineer/flow';
+
+const orderFlow = flow('place-order')
+  .input<PlaceOrderCommand>()
+  .validate(command => /* validation logic */)
+  .process(async (command, ctx) => {
+    // Business logic here
+    return { orderId: generateId(), status: 'confirmed' };
+  })
+  .emit<OrderPlaced>()
+  .build();
+```
+
+### Schema Generation
+
+Generate GraphQL schemas from flow definitions:
+
+```typescript
+// Flows are converted to GraphQL mutations and queries
+// Input types become GraphQL input types
+// Output events become GraphQL object types
+```
+
+### Integration Support
+
+Support for external service integrations:
+
+```typescript
+const flow = flow('payment-processing')
+  .integration('stripe', StripePaymentGateway)
+  .integration('email', EmailService)
+  .process(async (command, ctx) => {
+    const payment = await ctx.integrations.stripe.charge(command.amount);
+    await ctx.integrations.email.sendReceipt(command.email, payment);
+    return payment;
+  });
+```
+
+### Testing Support
+
+Testing utilities for flow validation:
+
+```typescript
+import { testFlow } from '@auto-engineer/flow/testing';
+
+describe('order flow', () => {
+  it('should process valid orders', async () => {
+    const result = await testFlow(orderFlow)
+      .withInput({ productId: '123', quantity: 2 })
+      .expectEvent<OrderPlaced>()
+      .run();
+
+    expect(result.orderId).toBeDefined();
+  });
+});
+```
+
+## Architecture
+
+Flow builds on several core concepts:
+
+- Flows: The main building blocks that define business processes
+- Messages: Strongly-typed data structures for communication
+- Integrations: External service connectors with retry and error handling
+- Context: Runtime environment providing access to integrations and utilities
+- Registry: Central repository for flow definitions and metadata
+
+## Getting Started
+
+1. Install the plugin (see Installation above)
+2. Create your first flow project:
+   ```bash
+   auto create:example
+   ```
+3. Explore the generated example flows in the `flows/` directory
+4. Define your own business flows using the Flow API
+5. Export your schema for GraphQL integration:
+   ```bash
+   auto export:schema
+   ```
+
+## Integration with Auto Engineer
+
+Flow works with other Auto Engineer plugins:
+
+- **@auto-engineer/server-generator-apollo-emmett**: Generates server infrastructure from Flow schemas
+- **@auto-engineer/frontend-generator-react-graphql**: Creates React components from flow-generated GraphQL schemas
+- **@auto-engineer/server-implementer**: Implements flow handlers with AI assistance
+- **@auto-engineer/information-architect**: Generates information architecture from flow definitions
+
+This plugin-based approach allows building applications from high-level flow definitions to production code.

package/dist/scripts/build.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env tsx
+export {};
+//# sourceMappingURL=build.d.ts.map

package/dist/scripts/build.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../scripts/build.ts"],"names":[],"mappings":""}

package/dist/scripts/build.js

@@ -0,0 +1,71 @@
+#!/usr/bin/env tsx
+import { execSync } from 'node:child_process';
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { fileURLToPath } from 'node:url';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const packageRoot = path.resolve(__dirname, '..');
+function run(command) {
+    console.log(`Running: ${command}`);
+    execSync(command, { stdio: 'inherit', cwd: packageRoot });
+}
+function copyRecursive(src, dest) {
+    const srcPath = path.resolve(packageRoot, src);
+    const destPath = path.resolve(packageRoot, dest);
+    if (!fs.existsSync(srcPath)) {
+        console.log(`Source path does not exist: ${srcPath}`);
+        return;
+    }
+    // Create destination directory if it doesn't exist
+    fs.mkdirSync(destPath, { recursive: true });
+    // Copy recursively
+    const entries = fs.readdirSync(srcPath, { withFileTypes: true });
+    for (const entry of entries) {
+        const srcFile = path.join(srcPath, entry.name);
+        const destFile = path.join(destPath, entry.name);
+        if (entry.isDirectory()) {
+            copyRecursive(path.relative(packageRoot, srcFile), path.relative(packageRoot, destFile));
+        }
+        else {
+            fs.copyFileSync(srcFile, destFile);
+        }
+    }
+}
+function removeDir(dir) {
+    const dirPath = path.resolve(packageRoot, dir);
+    if (fs.existsSync(dirPath)) {
+        fs.rmSync(dirPath, { recursive: true, force: true });
+        console.log(`Removed: ${dir}`);
+    }
+}
+async function main() {
+    try {
+        // Step 1: Run TypeScript compiler
+        run('tsc');
+        // Step 2: Fix ESM imports
+        run('tsx ../../scripts/fix-esm-imports.ts');
+        // Step 3: Remove existing dist/templates if it exists
+        removeDir('dist/templates');
+        // Step 4: Copy src/templates to dist/templates
+        if (fs.existsSync(path.resolve(packageRoot, 'src/templates'))) {
+            console.log('Copying src/templates to dist/templates');
+            copyRecursive('src/templates', 'dist/templates');
+            // Step 5: Create dist/src/templates directory
+            fs.mkdirSync(path.resolve(packageRoot, 'dist/src/templates'), { recursive: true });
+            // Step 6: Copy dist/templates/* to dist/src/templates/
+            console.log('Copying dist/templates to dist/src/templates');
+            copyRecursive('dist/templates', 'dist/src/templates');
+        }
+        else {
+            console.log('No templates directory found, skipping template copying');
+        }
+        console.log('Build completed successfully');
+    }
+    catch (error) {
+        console.error('Build failed:', error);
+        process.exit(1);
+    }
+}
+void main();
+//# sourceMappingURL=build.js.map

package/dist/scripts/build.js.map

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

package/dist/scripts/convert-flow-exec.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=convert-flow-exec.d.ts.map

package/dist/scripts/convert-flow-exec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"convert-flow-exec.d.ts","sourceRoot":"","sources":["../../scripts/convert-flow-exec.ts"],"names":[],"mappings":""}

package/dist/scripts/convert-flow-exec.js

@@ -0,0 +1,17 @@
+#!/usr/bin/env node
+import { getNarratives } from '../src/index.js';
+import { NodeFileStore } from '@auto-engineer/file-store';
+import path from 'path';
+const main = async () => {
+    try {
+        const result = await getNarratives({ vfs: new NodeFileStore(), root: path.resolve(__dirname) });
+        const schema = result.toModel();
+        console.log(JSON.stringify(schema, null, 2));
+    }
+    catch (error) {
+        console.error('Error:', error);
+        process.exit(1);
+    }
+};
+main().catch(console.error);
+//# sourceMappingURL=convert-flow-exec.js.map

package/dist/scripts/convert-flow-exec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"convert-flow-exec.js","sourceRoot":"","sources":["../../scripts/convert-flow-exec.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,MAAM,IAAI,GAAG,KAAK,IAAI,EAAE;IACtB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,EAAE,GAAG,EAAE,IAAI,aAAa,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;QAChG,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC;QAChC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAC/C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QAC/B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC,CAAC;AAEF,IAAI,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC"}

package/dist/scripts/convert-flow-helper.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=convert-flow-helper.d.ts.map

package/dist/scripts/convert-flow-helper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"convert-flow-helper.d.ts","sourceRoot":"","sources":["../../scripts/convert-flow-helper.ts"],"names":[],"mappings":""}

package/dist/scripts/convert-flow-helper.js

@@ -0,0 +1,85 @@
+#!/usr/bin/env node
+import { spawn } from 'child_process';
+import { resolve, dirname } from 'path';
+import { writeFileSync, unlinkSync } from 'fs';
+import { join } from 'path';
+const main = async () => {
+    const flowPath = process.argv[2];
+    if (!flowPath) {
+        console.error('Usage: tsx convert-flow-helper.ts <flow-file>');
+        process.exit(1);
+    }
+    try {
+        const absolutePath = resolve(flowPath);
+        const flowDir = dirname(absolutePath);
+        // Create a temporary wrapper script file in the same directory as the flow file
+        const tempScript = join(flowDir, `.convert-flow-wrapper-${Date.now()}.mjs`);
+        const wrapperScript = `
+import { convertFlowToJson } from '@auto-engineer/narrative';
+
+const run = async () => {
+  try {
+    const json = await convertFlowToJson('${absolutePath}');
+    console.log('__JSON_START__');
+    console.log(json);
+    console.log('__JSON_END__');
+  } catch (error) {
+    console.error('Error in wrapper:', error);
+    process.exit(1);
+  }
+};
+
+run();
+`;
+        writeFileSync(tempScript, wrapperScript);
+        return new Promise((resolve, reject) => {
+            const child = spawn('npx', ['tsx', tempScript], {
+                stdio: ['inherit', 'pipe', 'pipe'],
+                cwd: flowDir, // Set working directory to the flow file's directory
+            });
+            let stdout = '';
+            let stderr = '';
+            child.stdout.on('data', (data) => {
+                stdout += data.toString();
+            });
+            child.stderr.on('data', (data) => {
+                stderr += data.toString();
+            });
+            child.on('close', (code) => {
+                // Clean up temp file
+                try {
+                    unlinkSync(tempScript);
+                }
+                catch {
+                    // Ignore cleanup errors
+                }
+                if (stderr) {
+                    console.error(stderr.trim());
+                }
+                if (code === 0) {
+                    // Extract JSON between markers
+                    const jsonStart = stdout.indexOf('__JSON_START__');
+                    const jsonEnd = stdout.indexOf('__JSON_END__');
+                    if (jsonStart !== -1 && jsonEnd !== -1) {
+                        const jsonContent = stdout.substring(jsonStart + '__JSON_START__\n'.length, jsonEnd).trim();
+                        console.log(jsonContent);
+                    }
+                    else {
+                        console.error('Error: Could not find JSON markers in output');
+                        console.log(stdout.trim());
+                    }
+                    resolve(undefined);
+                }
+                else {
+                    reject(new Error(`Process failed with code ${code}`));
+                }
+            });
+        });
+    }
+    catch (error) {
+        console.error('Error:', error);
+        process.exit(1);
+    }
+};
+void main();
+//# sourceMappingURL=convert-flow-helper.js.map

package/dist/scripts/convert-flow-helper.js.map

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

package/dist/scripts/convert-flow.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=convert-flow.d.ts.map

package/dist/scripts/convert-flow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"convert-flow.d.ts","sourceRoot":"","sources":["../../scripts/convert-flow.ts"],"names":[],"mappings":""}

package/dist/scripts/convert-flow.js

@@ -0,0 +1,108 @@
+#!/usr/bin/env node
+import { resolve, dirname, relative, join } from 'path';
+import { existsSync, writeFileSync, statSync } from 'fs';
+import { spawn } from 'child_process';
+import { fileURLToPath } from 'url';
+const runInContext = (flowPath, projectRoot) => {
+    return new Promise((resolve, reject) => {
+        const __dirname = dirname(fileURLToPath(import.meta.url));
+        const helperScript = join(__dirname, 'convert-flow-helper.ts');
+        const child = spawn('npx', ['tsx', helperScript, flowPath], {
+            cwd: projectRoot,
+            stdio: ['inherit', 'pipe', 'pipe'],
+        });
+        let stdout = '';
+        let stderr = '';
+        child.stdout.on('data', (data) => {
+            stdout += data.toString();
+        });
+        child.stderr.on('data', (data) => {
+            stderr += data.toString();
+        });
+        child.on('close', (code) => {
+            if (code === 0) {
+                resolve(stdout.trim());
+            }
+            else {
+                reject(new Error(`Process failed with code ${code}: ${stderr}`));
+            }
+        });
+    });
+};
+const validateArgs = (args) => {
+    if (args.length === 0) {
+        console.error('Usage: pnpm convert-flow <input-file.flow.ts> [output-file-or-dir]');
+        process.exit(1);
+    }
+};
+const validateInputFile = (inputFile) => {
+    if (!inputFile.endsWith('.flow.ts') && !inputFile.endsWith('.flow.js')) {
+        console.error('Error: Input file must be a .flow.ts or .flow.js file');
+        process.exit(1);
+    }
+};
+const validateInputPath = (inputPath) => {
+    if (!existsSync(inputPath)) {
+        console.error(`Error: File not found: ${inputPath}`);
+        process.exit(1);
+    }
+};
+const resolveOutputPath = (outputFile) => {
+    if (outputFile === undefined || outputFile === '') {
+        return undefined;
+    }
+    const resolved = resolve(outputFile);
+    if (existsSync(resolved) && statSync(resolved).isDirectory()) {
+        return join(resolved, 'schema.json');
+    }
+    return resolved;
+};
+const findProjectRoot = (startDir) => {
+    let projectRoot = startDir;
+    while (projectRoot !== '/' && !existsSync(`${projectRoot}/package.json`)) {
+        projectRoot = dirname(projectRoot);
+    }
+    if (!existsSync(`${projectRoot}/package.json`)) {
+        console.error('Error: Could not find package.json in flow directory or its parents');
+        process.exit(1);
+    }
+    return projectRoot;
+};
+const writeOutput = (outputPath, json) => {
+    if (outputPath !== undefined && outputPath !== '') {
+        writeFileSync(outputPath, json);
+        console.log(`✓ Flow converted successfully to: ${outputPath}`);
+        console.log('📋 Schema validation performed during conversion');
+    }
+    else {
+        console.log(json);
+    }
+};
+const main = async () => {
+    const args = process.argv.slice(2);
+    validateArgs(args);
+    const inputFile = args[0];
+    const outputFile = args[1];
+    validateInputFile(inputFile);
+    try {
+        const inputPath = resolve(inputFile);
+        validateInputPath(inputPath);
+        const outputPath = resolveOutputPath(outputFile);
+        console.log(`Converting flow: ${inputPath}`);
+        const flowDir = dirname(inputPath);
+        const projectRoot = findProjectRoot(flowDir);
+        const relativeFlowPath = relative(projectRoot, inputPath);
+        const json = await runInContext(relativeFlowPath, projectRoot);
+        writeOutput(outputPath, json);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        console.error(`Error converting flow: ${message}`);
+        process.exit(1);
+    }
+};
+main().catch((error) => {
+    console.error('Fatal error:', error);
+    process.exit(1);
+});
+//# sourceMappingURL=convert-flow.js.map

package/dist/scripts/convert-flow.js.map

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

package/dist/scripts/print-schema.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=print-schema.d.ts.map

package/dist/scripts/print-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"print-schema.d.ts","sourceRoot":"","sources":["../../scripts/print-schema.ts"],"names":[],"mappings":""}

package/dist/scripts/print-schema.js

@@ -0,0 +1,20 @@
+import { CommandSliceSchema, NarrativeSchema, IntegrationSchema, MessageSchema, QuerySliceSchema, ReactSliceSchema, } from '../src/index.js';
+import { zodToJsonSchema } from 'zod-to-json-schema';
+const schemas = Object.fromEntries(Object.entries({
+    narrative: NarrativeSchema,
+    message: MessageSchema,
+    integration: IntegrationSchema,
+    commandSlice: CommandSliceSchema,
+    querySlice: QuerySliceSchema,
+    reactSlice: ReactSliceSchema,
+}).map(([k, v]) => [
+    k,
+    zodToJsonSchema(v, {
+        $refStrategy: 'root',
+        target: 'jsonSchema7',
+        definitionPath: 'definitions',
+        name: k[0].toUpperCase() + k.slice(1),
+    }),
+]));
+console.log(JSON.stringify(schemas, null, 2));
+//# sourceMappingURL=print-schema.js.map

package/dist/scripts/print-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"print-schema.js","sourceRoot":"","sources":["../../scripts/print-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,iBAAiB,EACjB,aAAa,EACb,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,QAAQ,CAAC;AAEhB,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,MAAM,OAAO,GAAG,MAAM,CAAC,WAAW,CAChC,MAAM,CAAC,OAAO,CAAC;IACb,SAAS,EAAE,eAAe;IAC1B,OAAO,EAAE,aAAa;IACtB,WAAW,EAAE,iBAAiB;IAC9B,YAAY,EAAE,kBAAkB;IAChC,UAAU,EAAE,gBAAgB;IAC5B,UAAU,EAAE,gBAAgB;CAC7B,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC;IACjB,CAAC;IACD,eAAe,CAAC,CAAC,EAAE;QACjB,YAAY,EAAE,MAAM;QACpB,MAAM,EAAE,aAAa;QACrB,cAAc,EAAE,aAAa;QAC7B,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;KACtC,CAAC;CACH,CAAC,CACH,CAAC;AAEF,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC"}