@kosdev-code/kos-nx-plugin 2.0.32 → 2.0.34

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kosdev-code/kos-nx-plugin",
-  "version": "2.0.32",
+  "version": "2.0.34",
   "type": "commonjs",
   "generators": "./generators.json",
   "publishConfig": {
@@ -19,7 +19,7 @@
   "main": "./src/index.js",
   "kos": {
     "build": {
-      "gitHash": "ea8751ddd6a1c43f56f22bab3bf99a0e3bd3f824"
+      "gitHash": "abc125566178e7aa50012d17d649f46b4b511cc4"
     }
   }
 }

package/src/generators/kos-component/README.md

@@ -0,0 +1,453 @@
+# Adding New Plugin Component Types
+
+This guide explains how to extend the KOS component generator to support new plugin types for KOS UI applications.
+
+## Overview
+
+The KOS component generator uses a modular architecture where each plugin type is handled by a dedicated handler class. This makes it easy to add new plugin types without modifying the core generator logic.
+
+## Architecture
+
+```
+kos-component/
+├── generator.ts              # Main generator (orchestrates the process)
+├── types.ts                 # Type definitions and constants
+├── plugin-handlers/         # Plugin-specific logic
+│   ├── base.ts             # Base handler interface and common functionality
+│   ├── [type]-handler.ts   # Individual plugin handlers
+│   └── factory.ts          # Handler factory and registry
+└── utils/                   # Shared utilities
+    ├── file-generator.ts    # File generation logic
+    ├── localization.ts      # i18n updates
+    ├── kos-config-builder.ts # .kos.json configuration builder
+    └── validation.ts        # Input validation
+```
+
+## Step-by-Step Guide
+
+### 1. Define Plugin Type Constants
+
+Add your new plugin type to `types.ts`:
+
+```typescript
+// types.ts
+export const PLUGIN_TYPES = {
+  // ... existing types
+  MY_NEW_PLUGIN: 'myNewPlugin',
+} as const;
+
+export const CONTRIBUTION_TYPE_MAP: Record<string, string> = {
+  // ... existing mappings
+  [PLUGIN_TYPES.MY_NEW_PLUGIN]: 'my-new-contribution',
+};
+
+// Add to localized types if your plugin needs i18n
+export const LOCALIZED_PLUGIN_TYPES: ReadonlySet<string> = new Set([
+  // ... existing types
+  PLUGIN_TYPES.MY_NEW_PLUGIN, // if localization is needed
+]);
+```
+
+### 2. Create Plugin Handler
+
+Create a new handler file `plugin-handlers/my-new-plugin-handler.ts`:
+
+```typescript
+import { NormalizedOptions, PluginConfiguration, PLUGIN_TYPES } from '../types';
+import { BasePluginHandler } from './base';
+
+export class MyNewPluginHandler extends BasePluginHandler {
+  protected pluginType = PLUGIN_TYPES.MY_NEW_PLUGIN;
+  protected contributionKey = 'my-new-contribution';
+  protected requiresI18n = true; // or false if no localization needed
+  
+  createConfiguration(options: NormalizedOptions): PluginConfiguration {
+    const configPrefix = this.getConfigPrefix(options);
+    const experienceId = `${configPrefix}.myNewPlugin.experience`;
+    
+    const contribution = {
+      id: `${configPrefix}.myNewPlugin`,
+      title: `${configPrefix}.myNewPlugin.title`,
+      namespace: options.appProject,
+      // Add plugin-specific properties here
+      myCustomProperty: options.nameCamelCase,
+      experienceId,
+    };
+    
+    const experience = this.createExperience(options, experienceId);
+    
+    return {
+      contributions: {
+        myNewContributions: [contribution], // Use appropriate contribution key
+      },
+      experiences: {
+        [experienceId]: experience,
+      },
+    };
+  }
+}
+```
+
+#### Handler Customization Options
+
+**Override template path** if your plugin uses custom templates:
+```typescript
+getTemplatePath(): string {
+  return 'my-custom-template-folder';
+}
+```
+
+**Custom component path** if needed:
+```typescript
+protected getComponentPath(options: NormalizedOptions): string {
+  return `${options.appDirectory}/custom-path/${options.nameDashCase}/${options.nameDashCase}.tsx`;
+}
+```
+
+### 3. Register Handler in Factory
+
+Update `plugin-handlers/factory.ts`:
+
+```typescript
+// Add import
+import { MyNewPluginHandler } from './my-new-plugin-handler';
+
+// Add to handlers map
+private static handlers: Map<string, new () => PluginHandler> = new Map<
+  string,
+  new () => PluginHandler
+>([
+  // ... existing handlers
+  [PLUGIN_TYPES.MY_NEW_PLUGIN, MyNewPluginHandler],
+]);
+```
+
+### 4. Register CLI Command (Required for kosui plugin:* syntax)
+
+To make your plugin available via `kosui plugin:myNewPlugin`, update the CLI metadata in `/packages/sdk/kos-ui-cli/src/lib/generators/plugin/index.mjs`:
+
+```javascript
+export const metadata = [
+  // ... existing metadata
+  { 
+    key: "plugin:myNewPlugin", 
+    name: "KOS UI Plugin My New Plugin",
+    namedArguments: {
+      name: "componentName",
+      componentName: "componentName",
+      project: "componentProject",
+      componentProject: "componentProject",
+      // Add any plugin-specific arguments
+      customOption: "customOption"
+    }
+  },
+];
+
+// Add to pluginTypes array
+const pluginTypes = [
+  // ... existing types
+  { key: "plugin:myNewPlugin", name: "myNewPlugin" },
+];
+```
+
+**Important:** The `name` field in pluginTypes must match the `pluginType` value used in the NX generator!
+
+### 5. Create Template Files (Optional)
+
+If your plugin needs custom templates, create a template directory:
+
+```
+kos-component/
+└── my-new-contribution/           # Template folder (matches contributionKey)
+    ├── __nameDashCase__.tsx__template__
+    ├── __nameDashCase__.stories.tsx__template__
+    ├── index.ts__template__
+    └── __nameDashCase__.css__template__ (optional)
+```
+
+**Component Template** (`__nameDashCase__.tsx__template__`):
+```typescript
+import React from 'react';
+
+interface <%= namePascalCase %>Props {
+  // Add your plugin-specific props
+}
+
+export const <%= namePascalCase %>: React.FC<<%= namePascalCase %>Props> = (props) => {
+  return (
+    <div className="<%= nameDashCase %>">
+      <h2><%= namePascalCase %> Plugin</h2>
+      {/* Your plugin-specific UI */}
+    </div>
+  );
+};
+
+export default <%= namePascalCase %>;
+```
+
+**Storybook Template** (`__nameDashCase__.stories.tsx__template__`):
+```typescript
+/**
+ * Note: The plugin project Storybook configuration requires that the Studio
+ * Simulator is running in order to retrieve model data...
+ */
+import { MyNewPluginStoryContainer } from "@kosdev-code/kos-ui-plugin/dev";
+import type { Meta, StoryObj } from "@storybook/react";
+import { <%= namePascalCase %> } from "./<%= nameDashCase %>";
+
+const meta: Meta<typeof <%= namePascalCase %>> = {
+  args: {},
+  component: <%= namePascalCase %>,
+  decorators: [
+    (Story, context) => (
+      <MyNewPluginStoryContainer>
+        <Story args={{ ...context.args }} />
+      </MyNewPluginStoryContainer>
+    ),
+  ],
+  tags: ["!autodocs"],
+  title: "my-new-plugin/<%= namePascalCase %>",
+};
+
+export default meta;
+
+type Story = StoryObj<typeof <%= namePascalCase %>>;
+
+export const Default: Story = {
+  render: (props) => <<%= namePascalCase %> {...props} />,
+};
+```
+
+**Available Story Containers:**
+- `CUIStoryContainer` - For CUI plugins
+- `UtilityStoryContainer` - For utility plugins  
+- `SetupStoryContainer` - For setup plugins
+- `SettingStoryContainer` - For setting plugins
+- `NavStoryContainer` - For navigation plugins
+- `ControlPourStoryContainer` - For control pour plugins
+- `TroubleActionStoryContainer` - For trouble action plugins
+
+### 6. Add Schema Support (Optional)
+
+If your plugin needs additional CLI parameters, update `schema.json`:
+
+```json
+{
+  "properties": {
+    "myCustomOption": {
+      "type": "string",
+      "description": "Custom option for my new plugin type"
+    }
+  }
+}
+```
+
+And update `schema.d.ts`:
+```typescript
+export interface KosComponentGeneratorSchema {
+  // ... existing properties
+  myCustomOption?: string;
+}
+```
+
+### 7. Add Validation (Optional)
+
+If your plugin has specific validation requirements, update `utils/validation.ts`:
+
+```typescript
+export function validateOptions(
+  tree: Tree,
+  options: KosComponentGeneratorSchema
+): void {
+  // ... existing validation
+  
+  // Add custom validation for your plugin
+  if (options.pluginType === 'myNewPlugin' && !options.myCustomOption) {
+    throw new ValidationError(
+      'myCustomOption is required for myNewPlugin type'
+    );
+  }
+}
+```
+
+## Testing Your New Plugin Type
+
+### 1. Build the Plugin
+```bash
+nx build kos-nx-plugin
+```
+
+### 2. Test Generation
+```bash
+# Test your new plugin type using the specific plugin generator
+kosui plugin:myNewPlugin --name test-component --project my-test-project
+
+# Or use the generic pluginComponent generator
+kosui pluginComponent --name test-component --project my-test-project
+# (This will prompt you to select from existing plugin types)
+```
+
+### 3. Verify Output
+Check that the generated files include:
+- Component files in the correct location (`.tsx`)
+- Storybook stories (`.stories.tsx`) 
+- Index files (`index.ts`)
+- Updated .kos.json with your contribution
+- Localization entries (if applicable)
+- Proper template rendering with correct variable substitution
+
+## Best Practices
+
+### 1. **Naming Conventions**
+- Plugin type: `camelCase` (e.g., `myNewPlugin`)
+- Contribution key: `kebab-case` (e.g., `my-new-contribution`)
+- Handler class: `PascalCase` + `Handler` (e.g., `MyNewPluginHandler`)
+
+### 2. **Configuration Structure**
+Follow existing patterns for contribution objects:
+```typescript
+{
+  id: `${configPrefix}.${pluginType}`,
+  title: `${configPrefix}.${pluginType}.title`,
+  namespace: options.appProject,
+  experienceId, // if using experiences
+  // Plugin-specific properties
+}
+```
+
+### 3. **Template Organization**
+- Use meaningful template folder names
+- Include index.ts for clean imports
+- Follow existing template variable patterns
+
+### 4. **Documentation**
+- Update CLI help text if needed
+- Add examples to this README
+- Document any special requirements
+
+## Extending Base Functionality
+
+### Custom Experience Creation
+```typescript
+protected createExperience(
+  options: NormalizedOptions,
+  experienceId: string
+): ExperienceConfig {
+  const compPath = this.getCustomComponentPath(options);
+  
+  return {
+    id: experienceId,
+    component: options.namePascalCase,
+    location: `./src/${compPath}`,
+    // Add custom experience properties
+    customProperty: 'value',
+  };
+}
+```
+
+### Custom Contribution Logic
+```typescript
+createConfiguration(options: NormalizedOptions): PluginConfiguration {
+  // Create multiple contributions if needed
+  const contributions = this.createMultipleContributions(options);
+  
+  return {
+    contributions: {
+      contribution1: contributions.first,
+      contribution2: contributions.second,
+    },
+    experiences: { /* ... */ },
+  };
+}
+```
+
+## Example: Complete Plugin Implementation
+
+Here's a complete example for a "dashboard" plugin type:
+
+```typescript
+// plugin-handlers/dashboard-handler.ts
+export class DashboardPluginHandler extends BasePluginHandler {
+  protected pluginType = PLUGIN_TYPES.DASHBOARD;
+  protected contributionKey = 'dashboard';
+  protected requiresI18n = true;
+  
+  createConfiguration(options: NormalizedOptions): PluginConfiguration {
+    const configPrefix = this.getConfigPrefix(options);
+    const experienceId = `${configPrefix}.dashboard.experience`;
+    
+    const contribution = {
+      id: `${configPrefix}.dashboard`,
+      title: `${configPrefix}.dashboard.title`,
+      namespace: options.appProject,
+      dashboardType: options.nameCamelCase,
+      layout: 'grid', // Dashboard-specific property
+      experienceId,
+    };
+    
+    const experience = this.createExperience(options, experienceId);
+    
+    return {
+      contributions: {
+        dashboards: [contribution],
+      },
+      experiences: {
+        [experienceId]: experience,
+      },
+    };
+  }
+}
+```
+
+## CLI Usage
+
+Once implemented, your new plugin type will be available via the CLI:
+
+```bash
+# Generate utility plugin component using specific plugin generator
+kosui plugin:utility --name data-export --project admin-ui
+
+# Generate setting plugin with additional group option
+kosui plugin:setting --name user-preferences --project admin-ui --group appearance
+
+# Generate navigation plugin
+kosui plugin:nav --name system-status --project admin-ui
+
+# Alternative: Using generic plugin component generator
+kosui pluginComponent --name data-export --project admin-ui
+# (Will prompt to select from: cui, setup, utility, setting, nav, controlPour)
+```
+
+## Troubleshooting
+
+**Plugin not recognized:**
+- Verify handler is registered in factory.ts
+- Check PLUGIN_TYPES constant is exported
+- Ensure plugin type matches exactly
+
+**Template not found:**
+- Check template folder name matches contributionKey
+- Verify template files exist and have correct extensions
+- Use `getTemplatePath()` if using custom path
+
+**Configuration not applied:**
+- Check .kos.json structure matches expected format
+- Verify contribution keys are correct
+- Test KosConfigBuilder logic with debug output
+
+**Localization not working:**
+- Ensure plugin type is in LOCALIZED_PLUGIN_TYPES
+- Check locale file exists at expected path
+- Verify updateLocalization is called for your handler
+
+## Contributing
+
+When contributing new plugin types to the KOS framework:
+
+1. Follow this guide for implementation
+2. Add comprehensive tests
+3. Update documentation
+4. Submit PR with clear description of the plugin's purpose
+5. Include usage examples
+
+For questions or support, refer to the KOS development team or create an issue in the project repository.

package/src/generators/kos-component/generator_refactored.d.ts

@@ -0,0 +1,8 @@
+import { Tree } from "@nx/devkit";
+import { KosComponentGeneratorSchema } from "./schema";
+/**
+ * Refactored KOS Component Generator
+ */
+export declare function kosComponentGenerator(tree: Tree, options: KosComponentGeneratorSchema): Promise<void>;
+export default kosComponentGenerator;
+//# sourceMappingURL=generator_refactored.d.ts.map

package/src/generators/kos-component/generator_refactored.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator_refactored.d.ts","sourceRoot":"","sources":["../../../../../../../packages/plugins/kos-nx-plugin/src/generators/kos-component/generator_refactored.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyC,IAAI,EAAE,MAAM,YAAY,CAAC;AAIzE,OAAO,EAAE,2BAA2B,EAAE,MAAM,UAAU,CAAC;AAQvD;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,2BAA2B,iBAiCrC;AAuFD,eAAe,qBAAqB,CAAC"}

package/src/generators/kos-component/generator_refactored.js

@@ -0,0 +1,96 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.kosComponentGenerator = void 0;
+const devkit_1 = require("@nx/devkit");
+const path = require("path");
+const project_utils_1 = require("../../utils/project-utils");
+const normalize_options_1 = require("../kos-model/lib/normalize-options");
+const types_1 = require("./types");
+const factory_1 = require("./plugin-handlers/factory");
+const file_generator_1 = require("./utils/file-generator");
+const localization_1 = require("./utils/localization");
+const kos_config_builder_1 = require("./utils/kos-config-builder");
+const validation_1 = require("./utils/validation");
+/**
+ * Refactored KOS Component Generator
+ */
+async function kosComponentGenerator(tree, options) {
+    try {
+        // Step 1: Validate options
+        (0, validation_1.validateOptions)(tree, options);
+        // Step 2: Normalize options
+        const normalized = await prepareOptions(tree, options);
+        // Step 3: Get project configuration
+        const projectConfig = (0, devkit_1.readProjectConfiguration)(tree, normalized.appProject);
+        const projectRoot = projectConfig.sourceRoot;
+        if (!projectRoot) {
+            throw new Error(`No source root found for project ${normalized.appProject}`);
+        }
+        // Step 4: Generate component files
+        await generateFiles(tree, projectRoot, normalized);
+        // Step 5: Update plugin configuration if needed
+        if (options.pluginType) {
+            await updatePluginConfiguration(tree, projectConfig, normalized);
+        }
+        // Step 6: Format files
+        await (0, devkit_1.formatFiles)(tree);
+    }
+    catch (error) {
+        console.error("Error in kosComponentGenerator:", error);
+        throw error;
+    }
+}
+exports.kosComponentGenerator = kosComponentGenerator;
+/**
+ * Prepares and normalizes options
+ */
+async function prepareOptions(tree, options) {
+    const normalized = (0, normalize_options_1.normalizeOptions)(tree, {
+        ...options,
+        modelProject: "__NONE__",
+    });
+    // Get KOS configuration for component location
+    const projectConfig = (0, devkit_1.readProjectConfiguration)(tree, normalized.appProject);
+    const kosConfig = (0, project_utils_1.getKosProjectConfiguration)(tree, projectConfig.name);
+    const componentLocation = kosConfig?.generator?.defaults?.component?.folder || "";
+    // Set component directory and type
+    normalized.appDirectory = options.appDirectory || componentLocation;
+    normalized.type =
+        types_1.CONTRIBUTION_TYPE_MAP[options.pluginType || ""] || options.type;
+    return normalized;
+}
+/**
+ * Generates component files from templates
+ */
+async function generateFiles(tree, projectRoot, options) {
+    // Get appropriate handler
+    const handler = factory_1.PluginHandlerFactory.createHandler(options.pluginType);
+    const templatePath = handler.getTemplatePath();
+    // Determine target path
+    const targetPath = path.join(projectRoot, options.appDirectory, options.type, options.nameDashCase);
+    // Generate files
+    (0, file_generator_1.generateComponentFiles)(tree, templatePath, targetPath, options);
+}
+/**
+ * Updates plugin configuration in .kos.json
+ */
+async function updatePluginConfiguration(tree, projectConfig, options) {
+    const kosConfigPath = path.join(projectConfig.root, ".kos.json");
+    if (!tree.exists(kosConfigPath)) {
+        console.warn(`No .kos.json found at ${kosConfigPath}`);
+        return;
+    }
+    // Get handler and create configuration
+    const handler = factory_1.PluginHandlerFactory.createHandler(options.pluginType);
+    const pluginConfig = handler.createConfiguration(options);
+    // Update .kos.json using builder
+    const builder = kos_config_builder_1.KosConfigBuilder.create();
+    builder.addPluginConfiguration(pluginConfig);
+    builder.applyToFile(tree, kosConfigPath);
+    // Update localization if needed
+    if (handler.requiresLocalization() && projectConfig.sourceRoot) {
+        (0, localization_1.updateLocalization)(tree, projectConfig.sourceRoot, options, handler.getContributionKey());
+    }
+}
+exports.default = kosComponentGenerator;
+//# sourceMappingURL=generator_refactored.js.map

package/src/generators/kos-component/generator_refactored.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator_refactored.js","sourceRoot":"","sources":["../../../../../../../packages/plugins/kos-nx-plugin/src/generators/kos-component/generator_refactored.ts"],"names":[],"mappings":"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"}

package/src/generators/kos-component/index.d.ts

@@ -0,0 +1,5 @@
+export { kosComponentGenerator as default, kosComponentGenerator, } from "./generator_refactored";
+export { PluginHandler } from "./plugin-handlers/base";
+export { PluginHandlerFactory } from "./plugin-handlers/factory";
+export * from "./types";
+//# sourceMappingURL=index.d.ts.map

package/src/generators/kos-component/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../packages/plugins/kos-nx-plugin/src/generators/kos-component/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,qBAAqB,IAAI,OAAO,EAChC,qBAAqB,GACtB,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,cAAc,SAAS,CAAC"}

package/src/generators/kos-component/index.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PluginHandlerFactory = exports.kosComponentGenerator = exports.default = void 0;
+const tslib_1 = require("tslib");
+// Main export - use the refactored generator
+var generator_refactored_1 = require("./generator_refactored");
+Object.defineProperty(exports, "default", { enumerable: true, get: function () { return generator_refactored_1.kosComponentGenerator; } });
+Object.defineProperty(exports, "kosComponentGenerator", { enumerable: true, get: function () { return generator_refactored_1.kosComponentGenerator; } });
+var factory_1 = require("./plugin-handlers/factory");
+Object.defineProperty(exports, "PluginHandlerFactory", { enumerable: true, get: function () { return factory_1.PluginHandlerFactory; } });
+tslib_1.__exportStar(require("./types"), exports);
+//# sourceMappingURL=index.js.map

package/src/generators/kos-component/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../packages/plugins/kos-nx-plugin/src/generators/kos-component/index.ts"],"names":[],"mappings":";;;;AAAA,6CAA6C;AAC7C,+DAGgC;AAF9B,+GAAA,qBAAqB,OAAW;AAChC,6HAAA,qBAAqB,OAAA;AAKvB,qDAAiE;AAAxD,+GAAA,oBAAoB,OAAA;AAC7B,kDAAwB"}

package/src/generators/kos-component/plugin-handlers/base.d.ts

@@ -0,0 +1,47 @@
+import { ExperienceConfig, NormalizedOptions, PluginConfiguration } from "../types";
+/**
+ * Base interface for plugin-specific handlers
+ */
+export interface PluginHandler {
+    /**
+     * Creates the plugin-specific configuration
+     */
+    createConfiguration(options: NormalizedOptions): PluginConfiguration;
+    /**
+     * Returns the contribution key for this plugin type
+     */
+    getContributionKey(): string;
+    /**
+     * Checks if this plugin type requires localization
+     */
+    requiresLocalization(): boolean;
+    /**
+     * Gets the template source path for this plugin type
+     */
+    getTemplatePath(): string;
+}
+/**
+ * Base implementation with common functionality
+ */
+export declare abstract class BasePluginHandler implements PluginHandler {
+    protected abstract pluginType: string;
+    protected abstract contributionKey: string;
+    protected abstract requiresI18n: boolean;
+    abstract createConfiguration(options: NormalizedOptions): PluginConfiguration;
+    getContributionKey(): string;
+    requiresLocalization(): boolean;
+    getTemplatePath(): string;
+    /**
+     * Helper to create experience configuration
+     */
+    protected createExperience(options: NormalizedOptions, experienceId: string): ExperienceConfig;
+    /**
+     * Helper to get component path
+     */
+    protected getComponentPath(options: NormalizedOptions): string;
+    /**
+     * Helper to create config prefix
+     */
+    protected getConfigPrefix(options: NormalizedOptions): string;
+}
+//# sourceMappingURL=base.d.ts.map

package/src/generators/kos-component/plugin-handlers/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/plugins/kos-nx-plugin/src/generators/kos-component/plugin-handlers/base.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,EAEpB,MAAM,UAAU,CAAC;AAElB;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,mBAAmB,CAAC,OAAO,EAAE,iBAAiB,GAAG,mBAAmB,CAAC;IAErE;;OAEG;IACH,kBAAkB,IAAI,MAAM,CAAC;IAE7B;;OAEG;IACH,oBAAoB,IAAI,OAAO,CAAC;IAEhC;;OAEG;IACH,eAAe,IAAI,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,8BAAsB,iBAAkB,YAAW,aAAa;IAC9D,SAAS,CAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IACtC,SAAS,CAAC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IAC3C,SAAS,CAAC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAEzC,QAAQ,CAAC,mBAAmB,CAAC,OAAO,EAAE,iBAAiB,GAAG,mBAAmB;IAE7E,kBAAkB,IAAI,MAAM;IAI5B,oBAAoB,IAAI,OAAO;IAI/B,eAAe,IAAI,MAAM;IAIzB;;OAEG;IACH,SAAS,CAAC,gBAAgB,CACxB,OAAO,EAAE,iBAAiB,EAC1B,YAAY,EAAE,MAAM,GACnB,gBAAgB;IAUnB;;OAEG;IACH,SAAS,CAAC,gBAAgB,CAAC,OAAO,EAAE,iBAAiB,GAAG,MAAM;IAI9D;;OAEG;IACH,SAAS,CAAC,eAAe,CAAC,OAAO,EAAE,iBAAiB,GAAG,MAAM;CAG9D"}