@memberjunction/react-linter 0.0.1 → 5.38.0

package/dist/runtime-rules/child-component-prop-validation.js

@@ -0,0 +1,443 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { traverse, levenshteinDistance } from '../lint-utils.js';
+import * as t from '@babel/types';
+import { RegisterClass } from '@memberjunction/global';
+import { BaseLintRule } from '../lint-rule.js';
+/**
+ * Rule: child-component-prop-validation
+ *
+ * Validates props passed to child/embedded components in JSX against the
+ * dependency component specs. Detects:
+ *   - Nonexistent prop names (no matching property in child spec)
+ *   - Prop name typos (Levenshtein distance <= 2)
+ *   - Prop name case mismatches (case-insensitive match exists)
+ *   - Type mismatches (string passed where number expected, etc.)
+ *
+ * Child component specs are sourced from componentSpec.dependencies.
+ *
+ * Severity: high (nonexistent props, type mismatches), medium (case mismatches)
+ * Applies to: all components
+ */
+/** Props that are always valid on any child component and should be skipped */
+const STANDARD_CHILD_PROPS = new Set([
+    'utilities',
+    'styles',
+    'components',
+    'callbacks',
+    'savedUserSettings',
+    'onSaveUserSettings',
+    'key',
+    'ref',
+    'children',
+]);
+/**
+ * Build a set of event-derived prop names from a component's events array.
+ * Events like { name: 'rowClick' } produce 'onRowClick'.
+ */
+function buildEventPropNames(events) {
+    const result = new Set();
+    if (!events)
+        return result;
+    for (const event of events) {
+        if (event.name) {
+            result.add(event.name);
+            const onPrefixed = 'on' + event.name.charAt(0).toUpperCase() + event.name.slice(1);
+            result.add(onPrefixed);
+        }
+    }
+    return result;
+}
+/**
+ * Attempt to infer the runtime type of a JSX attribute value expression.
+ * Returns a simple type string: 'string', 'number', 'boolean', 'array',
+ * 'object', 'function', or null if unknown.
+ *
+ * For identifiers, traces back through the AST looking for useState
+ * initializers to determine the type.
+ */
+function inferExpressionType(expr, variableTypes) {
+    if (t.isStringLiteral(expr) || t.isTemplateLiteral(expr))
+        return 'string';
+    if (t.isNumericLiteral(expr))
+        return 'number';
+    if (t.isBooleanLiteral(expr))
+        return 'boolean';
+    if (t.isArrayExpression(expr))
+        return 'array';
+    if (t.isObjectExpression(expr))
+        return 'object';
+    if (t.isArrowFunctionExpression(expr) || t.isFunctionExpression(expr))
+        return 'function';
+    if (t.isNullLiteral(expr))
+        return null;
+    if (t.isIdentifier(expr)) {
+        return variableTypes.get(expr.name) ?? null;
+    }
+    return null;
+}
+/**
+ * Infer type from a value AST node (used for useState initial values).
+ */
+function inferValueType(node) {
+    if (t.isStringLiteral(node) || t.isTemplateLiteral(node))
+        return 'string';
+    if (t.isNumericLiteral(node))
+        return 'number';
+    if (t.isBooleanLiteral(node))
+        return 'boolean';
+    if (t.isArrayExpression(node))
+        return 'array';
+    if (t.isObjectExpression(node))
+        return 'object';
+    if (t.isArrowFunctionExpression(node) || t.isFunctionExpression(node))
+        return 'function';
+    return null;
+}
+/**
+ * Normalize a spec property type string to one of the simple types
+ * we use for comparison.
+ */
+function normalizeSpecType(specType) {
+    const lower = specType.toLowerCase().trim();
+    if (lower === 'string')
+        return 'string';
+    if (lower === 'number' || lower === 'integer' || lower === 'float')
+        return 'number';
+    if (lower === 'boolean' || lower === 'bool')
+        return 'boolean';
+    if (lower === 'array' || lower.startsWith('array<') || lower.endsWith('[]'))
+        return 'array';
+    if (lower === 'object')
+        return 'object';
+    if (lower === 'function')
+        return 'function';
+    if (lower === 'any')
+        return null; // 'any' matches everything
+    return null; // complex or unknown types - skip checking
+}
+/**
+ * Check if two types are compatible. Returns true if they match or if
+ * either side is unknown/any.
+ */
+function typesAreCompatible(actualType, expectedType) {
+    if (actualType === expectedType)
+        return true;
+    // Arrays are objects in JavaScript — allow object where array is expected and vice versa
+    if ((actualType === 'object' && expectedType === 'array') ||
+        (actualType === 'array' && expectedType === 'object'))
+        return true;
+    // JSX string attributes are common for numeric props (e.g., height="300")
+    if (actualType === 'string' && expectedType === 'number')
+        return true;
+    return false;
+}
+/**
+ * Find the closest matching property name from a list using Levenshtein distance.
+ */
+function findClosestPropName(attrName, validNames) {
+    let bestMatch = null;
+    for (const name of validNames) {
+        const dist = levenshteinDistance(attrName, name);
+        if (dist <= 2 && (!bestMatch || dist < bestMatch.distance)) {
+            bestMatch = { name, distance: dist };
+        }
+    }
+    return bestMatch;
+}
+/**
+ * Try to load component properties and events from the ComponentMetadataEngine registry.
+ * Returns the resolved properties and events, or undefined if the registry is not
+ * available or the component was not found.
+ */
+function tryRegistryLookup(dep, resolver) {
+    if (!resolver)
+        return undefined;
+    try {
+        const registrySpec = resolver(dep.name, dep.namespace, dep.registry);
+        if (registrySpec?.properties?.length) {
+            return {
+                properties: registrySpec.properties,
+                events: registrySpec.events,
+            };
+        }
+    }
+    catch {
+        // Resolver threw — degrade gracefully
+    }
+    return undefined;
+}
+/**
+ * Build a lookup map from dependency component name to its prop info.
+ * Uses a 3-tier fallback:
+ *   1. Primary: dep.properties/events from the spec's dependencies array
+ *   2. Fallback 1: Registry lookup via the caller-supplied componentResolver
+ *   3. Fallback 2: Skip with a low-severity warning
+ */
+function buildDependencyMap(dependencies, warnings, componentResolver) {
+    const result = new Map();
+    if (!dependencies)
+        return result;
+    for (const dep of dependencies) {
+        if (!dep.name)
+            continue;
+        let properties = dep.properties ?? [];
+        let events = dep.events;
+        // Fallback 1: If no properties from spec, ask the resolver
+        if (properties.length === 0) {
+            const registryResult = tryRegistryLookup(dep, componentResolver);
+            if (registryResult) {
+                properties = registryResult.properties;
+                events = registryResult.events;
+            }
+        }
+        // Fallback 2: Still no properties — emit a warning and skip this dependency
+        if (properties.length === 0) {
+            warnings.push({
+                rule: 'child-component-prop-validation',
+                severity: 'low',
+                line: 0,
+                column: 0,
+                message: `Unable to validate props for <${dep.name}> — no property metadata available ` +
+                    `from spec or registry. Ensure the component spec includes property definitions ` +
+                    `for accurate validation.`,
+            });
+            continue;
+        }
+        const propertyNames = new Set();
+        const propertyByNameLower = new Map();
+        for (const prop of properties) {
+            propertyNames.add(prop.name);
+            propertyByNameLower.set(prop.name.toLowerCase(), prop);
+        }
+        result.set(dep.name, {
+            properties,
+            events,
+            propertyNames,
+            eventPropNames: buildEventPropNames(events),
+            propertyByNameLower,
+        });
+    }
+    return result;
+}
+/**
+ * Collect variable type information from useState calls throughout the AST.
+ * Maps variable name -> inferred type string.
+ */
+function collectVariableTypes(ast) {
+    const variableTypes = new Map();
+    traverse(ast, {
+        VariableDeclarator(path) {
+            // Detect: const [foo, setFoo] = useState(initialValue)
+            if (t.isArrayPattern(path.node.id) &&
+                t.isCallExpression(path.node.init) &&
+                t.isIdentifier(path.node.init.callee) &&
+                path.node.init.callee.name === 'useState') {
+                const elements = path.node.id.elements;
+                if (elements.length >= 1 && t.isIdentifier(elements[0]) && path.node.init.arguments.length >= 1) {
+                    const varName = elements[0].name;
+                    const initArg = path.node.init.arguments[0];
+                    if (t.isExpression(initArg)) {
+                        const inferredType = inferValueType(initArg);
+                        if (inferredType) {
+                            variableTypes.set(varName, inferredType);
+                        }
+                    }
+                }
+            }
+        },
+    });
+    return variableTypes;
+}
+/**
+ * Validate the type of a prop value against the expected type from the child spec.
+ */
+function validatePropType(violations, tagName, attrName, attr, childInfo, variableTypes, line, column) {
+    // Find the property spec
+    const propSpec = childInfo.properties.find((p) => p.name === attrName);
+    if (!propSpec)
+        return;
+    const expectedType = normalizeSpecType(propSpec.type);
+    if (!expectedType)
+        return; // Can't determine expected type or it's 'any'
+    // Get the attribute value expression
+    const valueExpr = extractAttributeValueExpression(attr);
+    if (!valueExpr)
+        return;
+    const actualType = inferExpressionType(valueExpr, variableTypes);
+    if (!actualType)
+        return; // Can't determine actual type
+    if (!typesAreCompatible(actualType, expectedType)) {
+        violations.push({
+            rule: 'child-component-prop-validation',
+            severity: 'high',
+            line,
+            column,
+            message: `Type mismatch on prop "${attrName}" of <${tagName}>: ` +
+                `expected "${expectedType}" but got "${actualType}".`,
+            suggestion: {
+                text: `Ensure the value passed to "${attrName}" is of type "${expectedType}".`,
+                example: buildTypeFixExample(tagName, attrName, expectedType, actualType),
+            },
+        });
+    }
+}
+/**
+ * Extract the expression from a JSX attribute value.
+ */
+function extractAttributeValueExpression(attr) {
+    const value = attr.value;
+    if (!value)
+        return null; // Boolean shorthand like <Comp disabled />
+    if (t.isJSXExpressionContainer(value)) {
+        return value.expression;
+    }
+    if (t.isStringLiteral(value)) {
+        return value;
+    }
+    return null;
+}
+/**
+ * Build a helpful example showing how to fix a type mismatch.
+ */
+function buildTypeFixExample(tagName, propName, expectedType, actualType) {
+    const conversions = {
+        number: {
+            string: `// Convert string to number:\nconst parsed = Number(value);\n<${tagName} ${propName}={parsed} />`,
+        },
+        string: {
+            number: `// Convert number to string:\n<${tagName} ${propName}={String(value)} />`,
+            array: `// If you need a string, join the array:\n<${tagName} ${propName}={values.join(',')} />`,
+        },
+        boolean: {
+            number: `// Convert to boolean:\n<${tagName} ${propName}={value > 0} />`,
+            string: `// Convert to boolean:\n<${tagName} ${propName}={value === 'true'} />`,
+        },
+        array: {
+            string: `// Convert string to array:\n<${tagName} ${propName}={value.split(',')} />`,
+        },
+    };
+    return conversions[expectedType]?.[actualType]
+        ?? `<${tagName} ${propName}={/* provide a ${expectedType} value */} />`;
+}
+let ChildComponentPropValidationRule = class ChildComponentPropValidationRule extends BaseLintRule {
+    get Name() { return 'child-component-prop-validation'; }
+    get AppliesTo() { return 'all'; }
+    Test(ast, _componentName, componentSpec, options) {
+        const violations = [];
+        // If no dependencies, nothing to validate
+        if (!componentSpec?.dependencies || componentSpec.dependencies.length === 0) {
+            return violations;
+        }
+        const depMap = buildDependencyMap(componentSpec.dependencies, violations, options?.componentResolver);
+        if (depMap.size === 0)
+            return violations;
+        // Collect variable types from useState calls for type-checking
+        const variableTypes = collectVariableTypes(ast);
+        traverse(ast, {
+            JSXOpeningElement(path) {
+                // Only handle simple <ComponentName ... /> elements
+                if (!t.isJSXIdentifier(path.node.name))
+                    return;
+                const tagName = path.node.name.name;
+                const childInfo = depMap.get(tagName);
+                if (!childInfo)
+                    return; // Not a known dependency component
+                // Full list used for typo detection (accepts both raw event names and on-prefixed)
+                const allValidPropNames = [
+                    ...Array.from(childInfo.propertyNames),
+                    ...Array.from(childInfo.eventPropNames),
+                ];
+                // Display list for error messages: only show on-prefixed callback form of events
+                const displayPropNames = [
+                    ...Array.from(childInfo.propertyNames),
+                    ...Array.from(childInfo.eventPropNames).filter((n) => n.startsWith('on')),
+                ];
+                for (const attr of path.node.attributes) {
+                    // Skip spread attributes like {...props}
+                    if (t.isJSXSpreadAttribute(attr))
+                        continue;
+                    const attrName = attr.name && t.isJSXIdentifier(attr.name) ? attr.name.name : null;
+                    if (!attrName)
+                        continue;
+                    // Skip standard props that are always valid
+                    if (STANDARD_CHILD_PROPS.has(attrName))
+                        continue;
+                    // Skip event prop names
+                    if (childInfo.eventPropNames.has(attrName))
+                        continue;
+                    const line = attr.loc?.start.line ?? 0;
+                    const column = attr.loc?.start.column ?? 0;
+                    // Check if the prop exists exactly
+                    if (childInfo.propertyNames.has(attrName)) {
+                        // Prop exists -- check type compatibility
+                        validatePropType(violations, tagName, attrName, attr, childInfo, variableTypes, line, column);
+                        continue;
+                    }
+                    // Prop name not found -- check for case mismatch
+                    const lowerAttrName = attrName.toLowerCase();
+                    const caseMatch = childInfo.propertyByNameLower.get(lowerAttrName);
+                    if (caseMatch) {
+                        violations.push({
+                            rule: 'child-component-prop-validation',
+                            severity: 'medium',
+                            line,
+                            column,
+                            message: `Prop "${attrName}" on <${tagName}> has incorrect casing. ` +
+                                `The correct prop name is "${caseMatch.name}".`,
+                            suggestion: {
+                                text: `Change "${attrName}" to "${caseMatch.name}"`,
+                                example: `<${tagName} ${caseMatch.name}={...} />`,
+                            },
+                        });
+                        continue;
+                    }
+                    // Check for typo via Levenshtein distance
+                    const typoMatch = findClosestPropName(attrName, allValidPropNames);
+                    if (typoMatch) {
+                        violations.push({
+                            rule: 'child-component-prop-validation',
+                            severity: 'high',
+                            line,
+                            column,
+                            message: `Prop "${attrName}" does not exist on <${tagName}>. ` +
+                                `Did you mean "${typoMatch.name}"?`,
+                            suggestion: {
+                                text: `Change "${attrName}" to "${typoMatch.name}"`,
+                                example: `<${tagName} ${typoMatch.name}={...} />`,
+                            },
+                        });
+                        continue;
+                    }
+                    // No match at all -- nonexistent prop
+                    const availableProps = displayPropNames.length > 0
+                        ? ` Available props: ${displayPropNames.join(', ')}.`
+                        : '';
+                    violations.push({
+                        rule: 'child-component-prop-validation',
+                        severity: 'high',
+                        line,
+                        column,
+                        message: `Prop "${attrName}" does not exist on <${tagName}>.${availableProps}`,
+                        suggestion: {
+                            text: `Remove "${attrName}" or use one of the available props defined in the ${tagName} component spec.`,
+                            example: displayPropNames.length > 0
+                                ? `<${tagName} ${displayPropNames[0]}={...} />`
+                                : `<${tagName} />`,
+                        },
+                    });
+                }
+            },
+        });
+        return violations;
+    }
+};
+ChildComponentPropValidationRule = __decorate([
+    RegisterClass(BaseLintRule, 'child-component-prop-validation')
+], ChildComponentPropValidationRule);
+export { ChildComponentPropValidationRule };
+//# sourceMappingURL=child-component-prop-validation.js.map

package/dist/runtime-rules/child-component-prop-validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"child-component-prop-validation.js","sourceRoot":"","sources":["../../src/runtime-rules/child-component-prop-validation.ts"],"names":[],"mappings":"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"}

package/dist/runtime-rules/component-name-mismatch.d.ts

@@ -0,0 +1,19 @@
+import * as t from '@babel/types';
+import { BaseLintRule } from '../lint-rule.js';
+import { Violation } from '../component-linter.js';
+import { ComponentSpec } from '@memberjunction/interactive-component-types';
+/**
+ * Rule: component-name-mismatch
+ *
+ * Ensures that the component function name matches the name specified in the ComponentSpec.
+ * The function name must match exactly, including capitalization.
+ *
+ * Severity: critical
+ * Applies to: all components
+ */
+export declare class ComponentNameMismatchRule extends BaseLintRule {
+    get Name(): string;
+    get AppliesTo(): 'all' | 'child' | 'root';
+    Test(ast: t.File, componentName: string, componentSpec?: ComponentSpec): Violation[];
+}
+//# sourceMappingURL=component-name-mismatch.d.ts.map

package/dist/runtime-rules/component-name-mismatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-name-mismatch.d.ts","sourceRoot":"","sources":["../../src/runtime-rules/component-name-mismatch.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,CAAC,MAAM,cAAc,CAAC;AAElC,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,6CAA6C,CAAC;AAE5E;;;;;;;;GAQG;AACH,qBACa,yBAA0B,SAAQ,YAAY;IACzD,IAAI,IAAI,WAAwC;IAChD,IAAI,SAAS,IAAI,KAAK,GAAG,OAAO,GAAG,MAAM,CAAkB;IAE3D,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,EAAE,aAAa,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,aAAa,GAAG,SAAS,EAAE;CA+DrF"}

package/dist/runtime-rules/component-name-mismatch.js

@@ -0,0 +1,82 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { traverse } from '../lint-utils.js';
+import { RegisterClass } from '@memberjunction/global';
+import { BaseLintRule } from '../lint-rule.js';
+/**
+ * Rule: component-name-mismatch
+ *
+ * Ensures that the component function name matches the name specified in the ComponentSpec.
+ * The function name must match exactly, including capitalization.
+ *
+ * Severity: critical
+ * Applies to: all components
+ */
+let ComponentNameMismatchRule = class ComponentNameMismatchRule extends BaseLintRule {
+    get Name() { return 'component-name-mismatch'; }
+    get AppliesTo() { return 'all'; }
+    Test(ast, componentName, componentSpec) {
+        const violations = [];
+        // The expected component name from the spec
+        const expectedName = componentSpec?.name || componentName;
+        // Find the main function declaration
+        let foundMainFunction = false;
+        traverse(ast, {
+            FunctionDeclaration(path) {
+                // Only check top-level function declarations
+                if (path.parent === ast.program && path.node.id) {
+                    const funcName = path.node.id.name;
+                    // Check if this looks like the main component function
+                    // (starts with capital letter and has the typical props parameter)
+                    if (/^[A-Z]/.test(funcName)) {
+                        foundMainFunction = true;
+                        // Check if the function name matches the spec name
+                        if (funcName !== expectedName) {
+                            violations.push({
+                                rule: 'component-name-mismatch',
+                                severity: 'critical',
+                                line: path.node.loc?.start.line || 0,
+                                column: path.node.loc?.start.column || 0,
+                                message: `Component function name "${funcName}" does not match the spec name "${expectedName}". The function must be named exactly as specified in the component spec. Rename the function to: function ${expectedName}(...)`,
+                                code: `function ${funcName}(...)`,
+                            });
+                        }
+                        // Also check that the first letter case matches
+                        const expectedFirstChar = expectedName.charAt(0);
+                        const actualFirstChar = funcName.charAt(0);
+                        if (expectedFirstChar !== actualFirstChar && expectedName.toLowerCase() === funcName.toLowerCase()) {
+                            violations.push({
+                                rule: 'component-name-mismatch',
+                                severity: 'critical',
+                                line: path.node.loc?.start.line || 0,
+                                column: path.node.loc?.start.column || 0,
+                                message: `Component function name "${funcName}" has incorrect capitalization. Expected "${expectedName}" (note the case of the first letter). The function name must match exactly, including capitalization: function ${expectedName}(...)`,
+                                code: `function ${funcName}(...)`,
+                            });
+                        }
+                    }
+                }
+            },
+        });
+        // If we didn't find a main function with the expected name
+        if (!foundMainFunction && componentSpec?.name) {
+            violations.push({
+                rule: 'component-name-mismatch',
+                severity: 'critical',
+                line: 1,
+                column: 0,
+                message: `No function declaration found with the expected name "${expectedName}". The main component function must be named exactly as specified in the spec. Add a function declaration: function ${expectedName}({ utilities, styles, components, callbacks, savedUserSettings, onSaveUserSettings }) { ... }`,
+            });
+        }
+        return violations;
+    }
+};
+ComponentNameMismatchRule = __decorate([
+    RegisterClass(BaseLintRule, 'component-name-mismatch')
+], ComponentNameMismatchRule);
+export { ComponentNameMismatchRule };
+//# sourceMappingURL=component-name-mismatch.js.map

package/dist/runtime-rules/component-name-mismatch.js.map

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

package/dist/runtime-rules/component-not-in-dependencies.d.ts

@@ -0,0 +1,20 @@
+import * as t from '@babel/types';
+import { BaseLintRule } from '../lint-rule.js';
+import { Violation } from '../component-linter.js';
+import { ComponentSpec } from '@memberjunction/interactive-component-types';
+/**
+ * Rule: component-not-in-dependencies
+ *
+ * Ensures that all components accessed via components.X are defined in the
+ * component spec's dependencies array. Using undefined components will cause
+ * runtime errors.
+ *
+ * Severity: critical (causes runtime errors)
+ * Applies to: all components
+ */
+export declare class ComponentNotInDependenciesRule extends BaseLintRule {
+    get Name(): string;
+    get AppliesTo(): 'all' | 'child' | 'root';
+    Test(ast: t.File, componentName: string, componentSpec?: ComponentSpec): Violation[];
+}
+//# sourceMappingURL=component-not-in-dependencies.d.ts.map

package/dist/runtime-rules/component-not-in-dependencies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-not-in-dependencies.d.ts","sourceRoot":"","sources":["../../src/runtime-rules/component-not-in-dependencies.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,CAAC,MAAM,cAAc,CAAC;AAElC,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,6CAA6C,CAAC;AAE5E;;;;;;;;;GASG;AACH,qBACa,8BAA+B,SAAQ,YAAY;IAC9D,IAAI,IAAI,WAA8C;IACtD,IAAI,SAAS,IAAI,KAAK,GAAG,OAAO,GAAG,MAAM,CAAkB;IAE3D,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,EAAE,aAAa,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,aAAa,GAAG,SAAS,EAAE;CAyErF"}