timonel 2.2.0 → 2.4.0

package/dist/lib/helmChartWriter.js

@@ -0,0 +1,318 @@
+/**
+ * @fileoverview Helm chart writer for generating complete Helm chart structures
+ * @since 1.0.0
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import YAML from 'yaml';
+import { SecurityUtils } from './security.js';
+/**
+ * Helm chart writer for generating complete chart structures
+ *
+ * This class provides static methods to generate a complete Helm chart
+ * including Chart.yaml, values.yaml, templates, and auxiliary files.
+ *
+ * @class HelmChartWriter
+ * @since 1.0.0
+ *
+ * @example
+ * ```typescript
+ * HelmChartWriter.write({
+ *   outDir: './dist/my-chart',
+ *   meta: { name: 'my-app', version: '1.0.0' },
+ *   assets: []
+ * });
+ * ```
+ */
+export class HelmChartWriter {
+    /**
+     * Writes a complete Helm chart to the specified directory
+     *
+     * Creates the full directory structure and writes all necessary files
+     * for a valid Helm chart including Chart.yaml, values files, templates,
+     * and auxiliary files.
+     *
+     * @param {HelmChartWriteOptions} opts - Chart configuration options
+     * @throws {Error} If output directory path is invalid
+     * @throws {Error} If chart metadata is invalid
+     *
+     * @example
+     * ```typescript
+     * HelmChartWriter.write({
+     *   outDir: './charts/my-app',
+     *   meta: {
+     *     name: 'my-app',
+     *     version: '1.0.0',
+     *     description: 'My application'
+     *   },
+     *   defaultValues: { replicas: 3 },
+     *   assets: []
+     * });
+     * ```
+     *
+     * @since 1.0.0
+     */
+    static write(opts) {
+        const { outDir, meta, defaultValues = {}, envValues = {}, assets, helpersTpl, notesTpl, valuesSchema, } = opts;
+        // Validate output directory path
+        const validatedOutDir = SecurityUtils.validatePath(outDir, process.cwd());
+        // Create directory structure
+        this.createDirectories(validatedOutDir);
+        // Write chart files
+        this.writeChartYaml(validatedOutDir, meta);
+        this.writeValuesFiles(validatedOutDir, defaultValues, envValues);
+        this.writeAssets(validatedOutDir, assets);
+        this.writeHelpers(validatedOutDir, helpersTpl);
+        this.writeNotes(validatedOutDir, notesTpl);
+        this.writeSchema(validatedOutDir, valuesSchema);
+        this.writeHelmIgnore(validatedOutDir);
+    }
+    /**
+     * Creates the necessary directory structure for the chart
+     *
+     * @private
+     * @param {string} outDir - Output directory path
+     * @throws {Error} If directories cannot be created
+     * @since 1.0.0
+     */
+    static createDirectories(outDir) {
+        // eslint-disable-next-line security/detect-non-literal-fs-filename -- Chart writer needs dynamic paths
+        fs.mkdirSync(path.join(outDir, 'templates'), { recursive: true });
+        // Create crds directory only if needed later
+    }
+    /**
+     * Writes the Chart.yaml file with chart metadata
+     *
+     * @private
+     * @param {string} outDir - Output directory path
+     * @param {HelmChartMeta} meta - Chart metadata
+     * @throws {Error} If Chart.yaml cannot be written
+     * @since 1.0.0
+     */
+    static writeChartYaml(outDir, meta) {
+        const chartYaml = YAML.stringify({
+            apiVersion: 'v2',
+            name: meta.name,
+            version: meta.version,
+            description: meta.description,
+            type: meta.type ?? 'application',
+            appVersion: meta.appVersion,
+            kubeVersion: meta.kubeVersion,
+            keywords: meta.keywords,
+            home: meta.home,
+            sources: meta.sources,
+            maintainers: meta.maintainers,
+            icon: meta.icon,
+            dependencies: meta.dependencies,
+        });
+        // eslint-disable-next-line security/detect-non-literal-fs-filename -- Chart writer needs dynamic paths
+        fs.writeFileSync(path.join(outDir, 'Chart.yaml'), chartYaml);
+    }
+    /**
+     * Writes values.yaml and environment-specific values files
+     *
+     * @private
+     * @param {string} outDir - Output directory path
+     * @param {Record<string, unknown>} defaultValues - Default values
+     * @param {EnvValuesMap} envValues - Environment-specific values
+     * @throws {Error} If values files cannot be written
+     * @since 1.0.0
+     */
+    static writeValuesFiles(outDir, defaultValues, envValues) {
+        // eslint-disable-next-line security/detect-non-literal-fs-filename -- Chart writer needs dynamic paths
+        fs.writeFileSync(path.join(outDir, 'values.yaml'), YAML.stringify(defaultValues));
+        for (const [env, values] of Object.entries(envValues)) {
+            // Use centralized environment name sanitization
+            const sanitizedEnv = SecurityUtils.sanitizeEnvironmentName(env);
+            // eslint-disable-next-line security/detect-non-literal-fs-filename -- Chart writer needs dynamic paths
+            fs.writeFileSync(path.join(outDir, `values-${sanitizedEnv}.yaml`), YAML.stringify(values));
+        }
+    }
+    /**
+     * Writes Kubernetes manifest assets to templates directory
+     *
+     * @private
+     * @param {string} outDir - Output directory path
+     * @param {SynthAsset[]} assets - Kubernetes manifests to write
+     * @since 1.0.0
+     */
+    static writeAssets(outDir, assets) {
+        writeAssets(outDir, assets);
+    }
+    /**
+     * Writes Helm template helpers to _helpers.tpl file
+     *
+     * @private
+     * @param {string} outDir - Output directory path
+     * @param {string | HelperDefinition[]} [helpersTpl] - Helpers content
+     * @since 1.0.0
+     */
+    static writeHelpers(outDir, helpersTpl) {
+        if (!helpersTpl)
+            return;
+        let content = '';
+        if (typeof helpersTpl === 'string') {
+            content = helpersTpl.endsWith('\n') ? helpersTpl : helpersTpl + '\n';
+        }
+        else if (Array.isArray(helpersTpl)) {
+            content = helpersTpl
+                .map((h) => [`{{- define "${h.name}" -}}`, h.body.trimEnd(), '{{- end }}', ''].join('\n'))
+                .join('\n');
+        }
+        // eslint-disable-next-line security/detect-non-literal-fs-filename -- Chart writer needs dynamic paths
+        fs.writeFileSync(path.join(outDir, 'templates', '_helpers.tpl'), content);
+    }
+    /**
+     * Writes NOTES.txt file for post-install instructions
+     *
+     * @private
+     * @param {string} outDir - Output directory path
+     * @param {string} [notesTpl] - Notes content
+     * @since 1.0.0
+     */
+    static writeNotes(outDir, notesTpl) {
+        if (!notesTpl)
+            return;
+        // eslint-disable-next-line security/detect-non-literal-fs-filename -- Chart writer needs dynamic paths
+        fs.writeFileSync(path.join(outDir, 'templates', 'NOTES.txt'), notesTpl.endsWith('\n') ? notesTpl : notesTpl + '\n');
+    }
+    /**
+     * Writes values.schema.json for values validation
+     *
+     * @private
+     * @param {string} outDir - Output directory path
+     * @param {Record<string, unknown>} [valuesSchema] - JSON schema
+     * @since 1.0.0
+     */
+    static writeSchema(outDir, valuesSchema) {
+        if (!valuesSchema)
+            return;
+        // eslint-disable-next-line security/detect-non-literal-fs-filename -- Chart writer needs dynamic paths
+        fs.writeFileSync(path.join(outDir, 'values.schema.json'), JSON.stringify(valuesSchema, null, 2) + '\n');
+    }
+    /**
+     * Writes .helmignore file with common ignore patterns
+     *
+     * @private
+     * @param {string} outDir - Output directory path
+     * @since 1.0.0
+     */
+    static writeHelmIgnore(outDir) {
+        const helmIgnorePath = path.join(outDir, '.helmignore');
+        // eslint-disable-next-line security/detect-non-literal-fs-filename -- Chart writer needs dynamic paths
+        if (!fs.existsSync(helmIgnorePath)) {
+            const helmIgnore = [
+                '# VCS',
+                '.git/',
+                '.hg/',
+                '.svn/',
+                '',
+                '# OS/editor',
+                '.DS_Store',
+                '.idea/',
+                '.vscode/',
+                '',
+                '# Backups',
+                '*.swp',
+                '*.bak',
+                '*.tmp',
+                '*.orig',
+                '',
+                '# Chart dependencies and packages',
+                'charts/',
+                '*.tgz',
+                '',
+            ].join('\n');
+            // eslint-disable-next-line security/detect-non-literal-fs-filename -- Chart writer needs dynamic paths
+            fs.writeFileSync(helmIgnorePath, helmIgnore);
+        }
+    }
+}
+/**
+ * Splits YAML string into individual documents
+ *
+ * @private
+ * @param {string} yamlStr - YAML string with potential document separators
+ * @returns {string[]} Array of individual YAML documents
+ * @since 1.0.0
+ */
+function splitDocs(yamlStr) {
+    return yamlStr
+        .split(/^---\s*$/m)
+        .map((p) => p.trim())
+        .filter((p) => p.length);
+}
+/**
+ * Writes all synthesized assets to the chart directory
+ *
+ * @private
+ * @param {string} outDir - Output directory path
+ * @param {SynthAsset[]} assets - Assets to write
+ * @throws {Error} If asset ID contains invalid characters
+ * @since 1.0.0
+ */
+function writeAssets(outDir, assets) {
+    for (const asset of assets) {
+        // Sanitize asset ID to prevent path traversal
+        const sanitizedId = asset.id.replace(/[^a-zA-Z0-9-_]/g, '');
+        if (sanitizedId !== asset.id) {
+            throw new Error(`Invalid asset ID: ${SecurityUtils.sanitizeLogMessage(asset.id)}`);
+        }
+        const targetDir = getTargetDirectory(asset.target);
+        if (asset.singleFile) {
+            writeSingleAssetFile(outDir, targetDir, sanitizedId, asset.yaml);
+        }
+        else {
+            writeMultipleAssetFiles(outDir, targetDir, sanitizedId, asset.yaml);
+        }
+    }
+}
+/**
+ * Gets the target directory for an asset
+ *
+ * @private
+ * @param {('templates' | 'crds')} [target] - Target directory type
+ * @returns {string} Directory name
+ * @since 1.0.0
+ */
+function getTargetDirectory(target) {
+    return target === 'crds' ? 'crds' : 'templates';
+}
+/**
+ * Writes a single asset file without document splitting
+ *
+ * @private
+ * @param {string} outDir - Output directory path
+ * @param {string} targetDir - Target subdirectory
+ * @param {string} assetId - Asset identifier
+ * @param {string} yaml - YAML content
+ * @since 1.0.0
+ */
+function writeSingleAssetFile(outDir, targetDir, assetId, yaml) {
+    const filename = `${assetId}.yaml`;
+    // eslint-disable-next-line security/detect-non-literal-fs-filename -- Chart writer needs dynamic paths
+    fs.mkdirSync(path.join(outDir, targetDir), { recursive: true });
+    // eslint-disable-next-line security/detect-non-literal-fs-filename -- Chart writer needs dynamic paths
+    fs.writeFileSync(path.join(outDir, targetDir, filename), yaml + '\n');
+}
+/**
+ * Writes multiple asset files by splitting YAML documents
+ *
+ * @private
+ * @param {string} outDir - Output directory path
+ * @param {string} targetDir - Target subdirectory
+ * @param {string} assetId - Asset identifier
+ * @param {string} yaml - YAML content with potential multiple documents
+ * @since 1.0.0
+ */
+function writeMultipleAssetFiles(outDir, targetDir, assetId, yaml) {
+    const parts = splitDocs(yaml);
+    parts.forEach((doc, index) => {
+        const filename = `${assetId}${parts.length > 1 ? `-${index + 1}` : ''}.yaml`;
+        // eslint-disable-next-line security/detect-non-literal-fs-filename -- Chart writer needs dynamic paths
+        fs.mkdirSync(path.join(outDir, targetDir), { recursive: true });
+        // eslint-disable-next-line security/detect-non-literal-fs-filename -- Chart writer needs dynamic paths
+        fs.writeFileSync(path.join(outDir, targetDir, filename), doc + '\n');
+    });
+}
+//# sourceMappingURL=helmChartWriter.js.map

package/dist/lib/helmChartWriter.js.map

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

package/dist/lib/resources/autoscaling/autoscalingResources.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @fileoverview Autoscaling resources for Kubernetes workloads
+ * @since 2.3.0
+ */
+import { BaseResourceProvider } from '../baseResourceProvider.js';
+/**
+ * Autoscaling resources provider for HPA, VPA, and PodDisruptionBudget
+ *
+ * @extends BaseResourceProvider
+ * @since 2.3.0
+ */
+export declare class AutoscalingResources extends BaseResourceProvider {
+    /**
+     * Add Horizontal Pod Autoscaler (HPA)
+     */
+    addHPA(_spec: unknown): void;
+    /**
+     * Add Vertical Pod Autoscaler (VPA)
+     */
+    addVPA(_spec: unknown): void;
+    /**
+     * Add Pod Disruption Budget (PDB)
+     */
+    addPodDisruptionBudget(_spec: unknown): void;
+}
+//# sourceMappingURL=autoscalingResources.d.ts.map

package/dist/lib/resources/autoscaling/autoscalingResources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"autoscalingResources.d.ts","sourceRoot":"","sources":["../../../../src/lib/resources/autoscaling/autoscalingResources.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAElE;;;;;GAKG;AACH,qBAAa,oBAAqB,SAAQ,oBAAoB;IAC5D;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,OAAO;IAKrB;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,OAAO;IAKrB;;OAEG;IACH,sBAAsB,CAAC,KAAK,EAAE,OAAO;CAItC"}

package/dist/lib/resources/autoscaling/autoscalingResources.js

@@ -0,0 +1,35 @@
+/**
+ * @fileoverview Autoscaling resources for Kubernetes workloads
+ * @since 2.3.0
+ */
+import { BaseResourceProvider } from '../baseResourceProvider.js';
+/**
+ * Autoscaling resources provider for HPA, VPA, and PodDisruptionBudget
+ *
+ * @extends BaseResourceProvider
+ * @since 2.3.0
+ */
+export class AutoscalingResources extends BaseResourceProvider {
+    /**
+     * Add Horizontal Pod Autoscaler (HPA)
+     */
+    addHPA(_spec) {
+        // Implementation moved from CoreResources
+        // TODO: Move HPA implementation here
+    }
+    /**
+     * Add Vertical Pod Autoscaler (VPA)
+     */
+    addVPA(_spec) {
+        // Implementation moved from CoreResources
+        // TODO: Move VPA implementation here
+    }
+    /**
+     * Add Pod Disruption Budget (PDB)
+     */
+    addPodDisruptionBudget(_spec) {
+        // Implementation moved from CoreResources
+        // TODO: Move PDB implementation here
+    }
+}
+//# sourceMappingURL=autoscalingResources.js.map

package/dist/lib/resources/autoscaling/autoscalingResources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"autoscalingResources.js","sourceRoot":"","sources":["../../../../src/lib/resources/autoscaling/autoscalingResources.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAElE;;;;;GAKG;AACH,MAAM,OAAO,oBAAqB,SAAQ,oBAAoB;IAC5D;;OAEG;IACH,MAAM,CAAC,KAAc;QACnB,0CAA0C;QAC1C,qCAAqC;IACvC,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,KAAc;QACnB,0CAA0C;QAC1C,qCAAqC;IACvC,CAAC;IAED;;OAEG;IACH,sBAAsB,CAAC,KAAc;QACnC,0CAA0C;QAC1C,qCAAqC;IACvC,CAAC;CACF"}

package/dist/lib/resources/baseResourceProvider.d.ts

@@ -0,0 +1,47 @@
+import type { Chart } from 'cdk8s';
+import { ApiObject } from 'cdk8s';
+/**
+ * Base interface for all resource providers
+ * Provides common functionality and ensures consistent patterns across providers
+ *
+ * @since 2.4.0
+ */
+export interface IResourceProvider {
+    /** Reference to the CDK8s chart */
+    readonly chart: Chart;
+}
+/**
+ * Abstract base class for resource providers
+ * Implements common functionality and validation patterns
+ *
+ * @since 2.4.0
+ */
+export declare abstract class BaseResourceProvider implements IResourceProvider {
+    readonly chart: Chart;
+    constructor(chart: Chart);
+    /**
+     * Validates that a name follows Kubernetes naming conventions
+     * @param name - Resource name to validate
+     * @param resourceType - Type of resource for error messages
+     * @throws Error if name is invalid
+     */
+    protected validateKubernetesName(name: string, resourceType: string): void;
+    /**
+     * Validates that labels follow Kubernetes conventions
+     * @param labels - Labels to validate
+     * @param resourceType - Type of resource for error messages
+     */
+    protected validateLabels(labels: Record<string, string> | undefined, resourceType: string): void;
+    /**
+     * Creates a standardized ApiObject with common metadata
+     * @param name - Resource name
+     * @param apiVersion - Kubernetes API version
+     * @param kind - Kubernetes resource kind
+     * @param spec - Resource specification
+     * @param labels - Optional labels
+     * @param annotations - Optional annotations
+     * @returns Created ApiObject
+     */
+    protected createApiObject(name: string, apiVersion: string, kind: string, spec: Record<string, unknown>, labels?: Record<string, string>, annotations?: Record<string, string>): ApiObject;
+}
+//# sourceMappingURL=baseResourceProvider.d.ts.map

package/dist/lib/resources/baseResourceProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"baseResourceProvider.d.ts","sourceRoot":"","sources":["../../../src/lib/resources/baseResourceProvider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AACnC,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAElC;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,mCAAmC;IACnC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;CACvB;AAED;;;;;GAKG;AACH,8BAAsB,oBAAqB,YAAW,iBAAiB;aACzC,KAAK,EAAE,KAAK;gBAAZ,KAAK,EAAE,KAAK;IAExC;;;;;OAKG;IACH,SAAS,CAAC,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI;IAe1E;;;;OAIG;IACH,SAAS,CAAC,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI;IA4BhG;;;;;;;;;OASG;IACH,SAAS,CAAC,eAAe,CACvB,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACnC,SAAS;CAeb"}

package/dist/lib/resources/baseResourceProvider.js

@@ -0,0 +1,83 @@
+import { ApiObject } from 'cdk8s';
+/**
+ * Abstract base class for resource providers
+ * Implements common functionality and validation patterns
+ *
+ * @since 2.4.0
+ */
+export class BaseResourceProvider {
+    constructor(chart) {
+        this.chart = chart;
+    }
+    /**
+     * Validates that a name follows Kubernetes naming conventions
+     * @param name - Resource name to validate
+     * @param resourceType - Type of resource for error messages
+     * @throws Error if name is invalid
+     */
+    validateKubernetesName(name, resourceType) {
+        if (!name || typeof name !== 'string') {
+            throw new Error(`${resourceType} name must be a non-empty string`);
+        }
+        // Kubernetes name validation (RFC 1123 subdomain)
+        // eslint-disable-next-line security/detect-unsafe-regex -- Simple character class regex is safe
+        const nameRegex = /^[a-z0-9]([-a-z0-9]*[a-z0-9])?$/;
+        if (!nameRegex.test(name) || name.length > 63) {
+            throw new Error(`${resourceType} name '${name}' must be a valid Kubernetes name (lowercase alphanumeric and hyphens, max 63 chars)`);
+        }
+    }
+    /**
+     * Validates that labels follow Kubernetes conventions
+     * @param labels - Labels to validate
+     * @param resourceType - Type of resource for error messages
+     */
+    validateLabels(labels, resourceType) {
+        if (!labels)
+            return;
+        Object.entries(labels).forEach(([key, value]) => {
+            // Validate label key
+            if (key.length > 253) {
+                throw new Error(`${resourceType} label key '${key}' exceeds 253 characters`);
+            }
+            // Validate label value
+            if (value.length > 63) {
+                throw new Error(`${resourceType} label value '${value}' exceeds 63 characters`);
+            }
+            // Skip validation for Helm template values
+            if (value.includes('{{') && value.includes('}}')) {
+                return;
+            }
+            // Basic character validation
+            // eslint-disable-next-line security/detect-unsafe-regex -- Simple character class regex is safe
+            const labelRegex = /^[a-zA-Z0-9]([-a-zA-Z0-9_.]*[a-zA-Z0-9])?$/;
+            if (!labelRegex.test(value)) {
+                throw new Error(`${resourceType} label value '${value}' contains invalid characters`);
+            }
+        });
+    }
+    /**
+     * Creates a standardized ApiObject with common metadata
+     * @param name - Resource name
+     * @param apiVersion - Kubernetes API version
+     * @param kind - Kubernetes resource kind
+     * @param spec - Resource specification
+     * @param labels - Optional labels
+     * @param annotations - Optional annotations
+     * @returns Created ApiObject
+     */
+    createApiObject(name, apiVersion, kind, spec, labels, annotations) {
+        this.validateKubernetesName(name, kind);
+        this.validateLabels(labels, kind);
+        return new ApiObject(this.chart, name, {
+            apiVersion,
+            kind,
+            metadata: {
+                name,
+                ...(labels && Object.keys(labels).length > 0 ? { labels } : {}),
+                ...(annotations && Object.keys(annotations).length > 0 ? { annotations } : {}),
+            },
+            spec,
+        });
+    }
+}
+//# sourceMappingURL=baseResourceProvider.js.map

package/dist/lib/resources/baseResourceProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"baseResourceProvider.js","sourceRoot":"","sources":["../../../src/lib/resources/baseResourceProvider.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAalC;;;;;GAKG;AACH,MAAM,OAAgB,oBAAoB;IACxC,YAA4B,KAAY;QAAZ,UAAK,GAAL,KAAK,CAAO;IAAG,CAAC;IAE5C;;;;;OAKG;IACO,sBAAsB,CAAC,IAAY,EAAE,YAAoB;QACjE,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YACtC,MAAM,IAAI,KAAK,CAAC,GAAG,YAAY,kCAAkC,CAAC,CAAC;QACrE,CAAC;QAED,kDAAkD;QAClD,gGAAgG;QAChG,MAAM,SAAS,GAAG,iCAAiC,CAAC;QACpD,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;YAC9C,MAAM,IAAI,KAAK,CACb,GAAG,YAAY,UAAU,IAAI,sFAAsF,CACpH,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;;;OAIG;IACO,cAAc,CAAC,MAA0C,EAAE,YAAoB;QACvF,IAAI,CAAC,MAAM;YAAE,OAAO;QAEpB,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;YAC9C,qBAAqB;YACrB,IAAI,GAAG,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;gBACrB,MAAM,IAAI,KAAK,CAAC,GAAG,YAAY,eAAe,GAAG,0BAA0B,CAAC,CAAC;YAC/E,CAAC;YAED,uBAAuB;YACvB,IAAI,KAAK,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;gBACtB,MAAM,IAAI,KAAK,CAAC,GAAG,YAAY,iBAAiB,KAAK,yBAAyB,CAAC,CAAC;YAClF,CAAC;YAED,2CAA2C;YAC3C,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;gBACjD,OAAO;YACT,CAAC;YAED,6BAA6B;YAC7B,gGAAgG;YAChG,MAAM,UAAU,GAAG,4CAA4C,CAAC;YAChE,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC5B,MAAM,IAAI,KAAK,CAAC,GAAG,YAAY,iBAAiB,KAAK,+BAA+B,CAAC,CAAC;YACxF,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;OASG;IACO,eAAe,CACvB,IAAY,EACZ,UAAkB,EAClB,IAAY,EACZ,IAA6B,EAC7B,MAA+B,EAC/B,WAAoC;QAEpC,IAAI,CAAC,sBAAsB,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACxC,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAElC,OAAO,IAAI,SAAS,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE;YACrC,UAAU;YACV,IAAI;YACJ,QAAQ,EAAE;gBACR,IAAI;gBACJ,GAAG,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC/D,GAAG,CAAC,WAAW,IAAI,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC/E;YACD,IAAI;SACL,CAAC,CAAC;IACL,CAAC;CACF"}