specforge-mcp 0.1.0

package/dist/engine/analytics-detector/events.d.ts

@@ -0,0 +1,29 @@
+import type { AnalyticsStack, AnalyticsEvent, AnalyticsFunnel, AnalyticsTaxonomy, AnalyticsPropertyGap } from '../../types/index.js';
+/**
+ * Generates a minimal set of analytics events for a feature.
+ */
+export declare function generateEvents(featureDescription: string, stack: AnalyticsStack): AnalyticsEvent[];
+/**
+ * Generates funnel step events with standard conversion properties.
+ */
+export declare function generateFunnelEvents(funnelDescription: string, stack: AnalyticsStack): AnalyticsFunnel;
+/**
+ * Identifies event properties required to answer each business goal
+ * that are currently missing from the event definitions.
+ */
+export declare function validateEventProperties(events: AnalyticsEvent[], businessGoals: string[]): AnalyticsPropertyGap[];
+/**
+ * Reads the event taxonomy from the given path.
+ * Returns an empty taxonomy if the file does not exist.
+ */
+export declare function readTaxonomy(taxonomyPath: string): Promise<AnalyticsTaxonomy>;
+/**
+ * Writes the updated taxonomy to the given path, creating parent directories
+ * if they do not exist.
+ */
+export declare function writeTaxonomy(taxonomyPath: string, taxonomy: AnalyticsTaxonomy): Promise<void>;
+/**
+ * Bumps the patch version of a semver string.
+ */
+export declare function bumpTaxonomyVersion(current: string): string;
+//# sourceMappingURL=events.d.ts.map

package/dist/engine/analytics-detector/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../../src/engine/analytics-detector/events.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAEV,cAAc,EACd,cAAc,EACd,eAAe,EACf,iBAAiB,EACjB,oBAAoB,EACrB,MAAM,sBAAsB,CAAC;AAsE9B;;GAEG;AACH,wBAAgB,cAAc,CAC5B,kBAAkB,EAAE,MAAM,EAC1B,KAAK,EAAE,cAAc,GACpB,cAAc,EAAE,CAgClB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,iBAAiB,EAAE,MAAM,EACzB,KAAK,EAAE,cAAc,GACpB,eAAe,CAsDjB;AAkBD;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,cAAc,EAAE,EACxB,aAAa,EAAE,MAAM,EAAE,GACtB,oBAAoB,EAAE,CAiCxB;AAaD;;;GAGG;AACH,wBAAsB,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAOnF;AAED;;;GAGG;AACH,wBAAsB,aAAa,CACjC,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,iBAAiB,GAC1B,OAAO,CAAC,IAAI,CAAC,CAGf;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAM3D"}

package/dist/engine/analytics-detector/events.js

@@ -0,0 +1,237 @@
+// engine/analytics-detector/events.ts — Event generation, property validation, taxonomy (SPEC-032)
+import { readFile, writeFile, mkdir } from 'node:fs/promises';
+import { dirname } from 'node:path';
+// ---------------------------------------------------------------------------
+// Event generation helpers
+// ---------------------------------------------------------------------------
+/**
+ * Converts a title to snake_case for use as an event segment.
+ */
+function toSnakeSegment(text) {
+    return text
+        .toLowerCase()
+        .normalize('NFD')
+        .replace(/[\u0300-\u036f]/g, '')
+        .replace(/[^a-z0-9]+/g, '_')
+        .replace(/^_+|_+$/g, '')
+        .slice(0, 30);
+}
+/**
+ * Infers an object_action event name from a feature description.
+ */
+function inferEventName(description, convention) {
+    const lower = description.toLowerCase();
+    const actionMap = [
+        ['sign up', 'user_signed_up'],
+        ['signup', 'user_signed_up'],
+        ['register', 'user_registered'],
+        ['login', 'user_logged_in'],
+        ['logout', 'user_logged_out'],
+        ['purchase', 'purchase_completed'],
+        ['checkout', 'checkout_started'],
+        ['payment', 'payment_completed'],
+        ['click', 'button_clicked'],
+        ['view', 'page_viewed'],
+        ['search', 'search_performed'],
+        ['upload', 'file_uploaded'],
+        ['download', 'file_downloaded'],
+        ['submit', 'form_submitted'],
+        ['delete', 'item_deleted'],
+        ['create', 'item_created'],
+        ['update', 'item_updated'],
+        ['share', 'content_shared'],
+        ['invite', 'user_invited'],
+        ['subscribe', 'user_subscribed'],
+    ];
+    for (const [keyword, eventName] of actionMap) {
+        if (lower.includes(keyword)) {
+            if (convention === 'camelCase') {
+                return eventName.replace(/_([a-z])/g, (_, c) => c.toUpperCase());
+            }
+            return eventName;
+        }
+    }
+    // Fallback: derive from description
+    const segment = toSnakeSegment(description.split(' ').slice(0, 3).join(' '));
+    const name = `feature_${segment}`;
+    if (convention === 'camelCase') {
+        return name.replace(/_([a-z])/g, (_, c) => c.toUpperCase());
+    }
+    return name;
+}
+// ---------------------------------------------------------------------------
+// Public event generators
+// ---------------------------------------------------------------------------
+/**
+ * Generates a minimal set of analytics events for a feature.
+ */
+export function generateEvents(featureDescription, stack) {
+    const eventName = inferEventName(featureDescription, stack.namingConvention);
+    const baseEvent = {
+        name: eventName,
+        trigger: `Fired when the user completes: ${featureDescription}`,
+        properties: [
+            {
+                name: 'user_id',
+                type: 'string',
+                description: 'Hashed user identifier — never raw email or PII',
+                required: true,
+            },
+            {
+                name: 'session_id',
+                type: 'string',
+                description: 'Current session identifier for funnel analysis',
+                required: true,
+            },
+            {
+                name: 'timestamp_ms',
+                type: 'number',
+                description: 'Unix timestamp in milliseconds when the event was fired',
+                required: true,
+            },
+        ],
+        businessGoal: `Measure usage and conversion of: ${featureDescription}`,
+        includesPII: false,
+        consentRequired: false,
+    };
+    return [baseEvent];
+}
+/**
+ * Generates funnel step events with standard conversion properties.
+ */
+export function generateFunnelEvents(funnelDescription, stack) {
+    const segment = toSnakeSegment(funnelDescription);
+    const steps = [];
+    const stepNames = ['started', 'step_completed', 'completed'];
+    for (let i = 0; i < stepNames.length; i++) {
+        /* v8 ignore next 1 */
+        const stepSuffix = stepNames[i] ?? `step_${i + 1}`;
+        const conv = stack.namingConvention;
+        let name = `${segment}_${stepSuffix}`;
+        if (conv === 'camelCase') {
+            name = name.replace(/_([a-z])/g, (_, c) => c.toUpperCase());
+        }
+        steps.push({
+            name,
+            trigger: `Fired when the user reaches step ${i + 1} of ${funnelDescription}`,
+            properties: [
+                {
+                    name: 'step_number',
+                    type: 'number',
+                    description: 'Ordinal position of this step in the funnel (1-based)',
+                    required: true,
+                },
+                {
+                    name: 'step_name',
+                    type: 'string',
+                    description: 'Descriptive name of the current funnel step',
+                    required: true,
+                },
+                {
+                    name: 'completed',
+                    type: 'boolean',
+                    description: 'Whether the user successfully completed this step',
+                    required: true,
+                },
+                {
+                    name: 'time_spent_ms',
+                    type: 'number',
+                    description: 'Milliseconds spent on this step before proceeding',
+                    required: false,
+                },
+            ],
+            businessGoal: `Track completion rate of step ${i + 1} in ${funnelDescription}`,
+            includesPII: false,
+            consentRequired: false,
+        });
+    }
+    return {
+        name: funnelDescription,
+        conversionGoal: `User completes all steps of: ${funnelDescription}`,
+        steps,
+    };
+}
+// ---------------------------------------------------------------------------
+// Property gap validation
+// ---------------------------------------------------------------------------
+// Keywords that imply certain properties must be present in related events
+const GOAL_PROPERTY_MAP = [
+    ['checkout', ['cart_value', 'item_count', 'payment_method']],
+    ['conversion', ['conversion_value', 'funnel_step']],
+    ['revenue', ['revenue', 'currency', 'amount']],
+    ['search', ['query', 'results_count']],
+    ['error', ['error_code', 'error_message']],
+    ['registration', ['registration_method', 'referral_source']],
+    ['payment', ['payment_method', 'amount', 'currency']],
+    ['onboarding', ['step_number', 'step_name', 'completed']],
+];
+/**
+ * Identifies event properties required to answer each business goal
+ * that are currently missing from the event definitions.
+ */
+export function validateEventProperties(events, businessGoals) {
+    const gaps = [];
+    for (const goal of businessGoals) {
+        const goalLower = goal.toLowerCase();
+        for (const [keyword, requiredProps] of GOAL_PROPERTY_MAP) {
+            if (!goalLower.includes(keyword)) {
+                continue;
+            }
+            // Find events related to this goal
+            const relatedEvents = events.filter((e) => e.businessGoal.toLowerCase().includes(keyword) || e.name.toLowerCase().includes(keyword));
+            for (const event of relatedEvents) {
+                const existingPropNames = new Set(event.properties.map((p) => p.name.toLowerCase()));
+                const missing = requiredProps.filter((p) => !existingPropNames.has(p));
+                if (missing.length > 0) {
+                    gaps.push({
+                        eventName: event.name,
+                        businessQuestion: goal,
+                        missingProperties: missing,
+                    });
+                }
+            }
+        }
+    }
+    return gaps;
+}
+// ---------------------------------------------------------------------------
+// Taxonomy persistence
+// ---------------------------------------------------------------------------
+const EMPTY_TAXONOMY = {
+    version: '0.0.0',
+    updatedAt: '',
+    events: {},
+    namingConvention: 'object_action',
+};
+/**
+ * Reads the event taxonomy from the given path.
+ * Returns an empty taxonomy if the file does not exist.
+ */
+export async function readTaxonomy(taxonomyPath) {
+    try {
+        const content = await readFile(taxonomyPath, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch {
+        return { ...EMPTY_TAXONOMY, updatedAt: new Date().toISOString() };
+    }
+}
+/**
+ * Writes the updated taxonomy to the given path, creating parent directories
+ * if they do not exist.
+ */
+export async function writeTaxonomy(taxonomyPath, taxonomy) {
+    await mkdir(dirname(taxonomyPath), { recursive: true });
+    await writeFile(taxonomyPath, JSON.stringify(taxonomy, null, 2), 'utf-8');
+}
+/**
+ * Bumps the patch version of a semver string.
+ */
+export function bumpTaxonomyVersion(current) {
+    const parts = current.split('.').map(Number);
+    const patch = (parts[2] ?? 0) + 1;
+    /* v8 ignore next 1 */
+    const version = `${parts[0] ?? 0}.${parts[1] ?? 0}.${patch}`;
+    return version;
+}
+//# sourceMappingURL=events.js.map

package/dist/engine/analytics-detector/events.js.map

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

package/dist/engine/analytics-detector.d.ts

@@ -0,0 +1,28 @@
+import type { NamingConvention, AnalyticsStack, EventProperty } from '../types/index.js';
+export { generateEvents, generateFunnelEvents, validateEventProperties, readTaxonomy, writeTaxonomy, bumpTaxonomyVersion, } from './analytics-detector/events.js';
+/**
+ * Returns true if any property of an event includes or derives from PII.
+ */
+export declare function hasPIIProperties(properties: EventProperty[]): boolean;
+/**
+ * Analyses existing event names and infers the naming convention used.
+ */
+export declare function detectNamingConvention(existingEvents: string[]): NamingConvention;
+/**
+ * Returns true if the feature involves direct user interaction.
+ */
+export declare function isUserInteractionFeature(specTitle: string, specDescription: string, criteria: string): boolean;
+/**
+ * Returns true if the feature creates a user funnel.
+ */
+export declare function isFunnelFeature(specTitle: string, specDescription: string, criteria: string): boolean;
+/**
+ * Returns true if the feature requires an A/B experiment.
+ */
+export declare function isABTestFeature(specTitle: string, specDescription: string, criteria: string): boolean;
+/**
+ * Detects the analytics stack in a project.
+ * Analyses package.json and codebase to return AnalyticsStack.
+ */
+export declare function detectStack(projectPath: string): Promise<AnalyticsStack>;
+//# sourceMappingURL=analytics-detector.d.ts.map

package/dist/engine/analytics-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics-detector.d.ts","sourceRoot":"","sources":["../../src/engine/analytics-detector.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAGV,gBAAgB,EAChB,cAAc,EACd,aAAa,EAGd,MAAM,mBAAmB,CAAC;AAO3B,OAAO,EACL,cAAc,EACd,oBAAoB,EACpB,uBAAuB,EACvB,YAAY,EACZ,aAAa,EACb,mBAAmB,GACpB,MAAM,gCAAgC,CAAC;AAwBxC;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,aAAa,EAAE,GAAG,OAAO,CAErE;AAMD;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,cAAc,EAAE,MAAM,EAAE,GAAG,gBAAgB,CA8BjF;AAMD;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,MAAM,EACjB,eAAe,EAAE,MAAM,EACvB,QAAQ,EAAE,MAAM,GACf,OAAO,CAGT;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,MAAM,EACjB,eAAe,EAAE,MAAM,EACvB,QAAQ,EAAE,MAAM,GACf,OAAO,CAGT;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,MAAM,EACjB,eAAe,EAAE,MAAM,EACvB,QAAQ,EAAE,MAAM,GACf,OAAO,CAGT;AA8HD;;;GAGG;AACH,wBAAsB,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CA8B9E"}

package/dist/engine/analytics-detector.js

@@ -0,0 +1,243 @@
+// engine/analytics-detector.ts — Product analytics detection facade (SPEC-032)
+// Detects analytics providers, naming conventions, and feature classification.
+// Event generation, taxonomy, and property validation are in analytics-detector/events.ts.
+import { createRequire } from 'node:module';
+import { readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+// Load config using require for JSON files (ESM NodeNext workaround)
+const require = createRequire(import.meta.url);
+const providersConfig = require('../config/analytics-providers.json');
+// Re-export event generation and taxonomy helpers from sub-module
+export { generateEvents, generateFunnelEvents, validateEventProperties, readTaxonomy, writeTaxonomy, bumpTaxonomyVersion, } from './analytics-detector/events.js';
+// ---------------------------------------------------------------------------
+// PII detection
+// ---------------------------------------------------------------------------
+const PII_FIELD_NAMES = new Set([
+    'email',
+    'mail',
+    'phone',
+    'telefono',
+    'nombre',
+    'name',
+    'lastname',
+    'apellido',
+    'firstname',
+    'fullname',
+    'address',
+    'direccion',
+    'ip',
+    'ip_address',
+    'user_ip',
+]);
+/**
+ * Returns true if any property of an event includes or derives from PII.
+ */
+export function hasPIIProperties(properties) {
+    return properties.some((p) => p.pii === true || PII_FIELD_NAMES.has(p.name.toLowerCase()));
+}
+// ---------------------------------------------------------------------------
+// Naming convention detection
+// ---------------------------------------------------------------------------
+/**
+ * Analyses existing event names and infers the naming convention used.
+ */
+export function detectNamingConvention(existingEvents) {
+    if (existingEvents.length === 0) {
+        return 'object_action';
+    }
+    let snakeCount = 0;
+    let camelCount = 0;
+    let prefixedCount = 0;
+    for (const name of existingEvents) {
+        if (name.includes(':')) {
+            prefixedCount++;
+        }
+        else if (/^[a-z][a-zA-Z0-9]*$/.test(name) && /[A-Z]/.test(name)) {
+            camelCount++;
+        }
+        else if (/^[a-z][a-z0-9]*(_[a-z0-9]+)+$/.test(name)) {
+            snakeCount++;
+        }
+    }
+    const total = existingEvents.length;
+    if (prefixedCount / total > 0.5) {
+        return 'module_prefixed';
+    }
+    if (camelCount / total > 0.5) {
+        return 'camelCase';
+    }
+    if (snakeCount / total > 0.3) {
+        return 'object_action';
+    }
+    return 'custom';
+}
+// ---------------------------------------------------------------------------
+// Vocabulary-based feature classification
+// ---------------------------------------------------------------------------
+/**
+ * Returns true if the feature involves direct user interaction.
+ */
+export function isUserInteractionFeature(specTitle, specDescription, criteria) {
+    const text = `${specTitle} ${specDescription} ${criteria}`.toLowerCase();
+    return providersConfig.userInteractionVocabulary.some((word) => text.includes(word));
+}
+/**
+ * Returns true if the feature creates a user funnel.
+ */
+export function isFunnelFeature(specTitle, specDescription, criteria) {
+    const text = `${specTitle} ${specDescription} ${criteria}`.toLowerCase();
+    return providersConfig.funnelVocabulary.some((word) => text.includes(word));
+}
+/**
+ * Returns true if the feature requires an A/B experiment.
+ */
+export function isABTestFeature(specTitle, specDescription, criteria) {
+    const text = `${specTitle} ${specDescription} ${criteria}`.toLowerCase();
+    return providersConfig.abTestVocabulary.some((word) => text.includes(word));
+}
+// ---------------------------------------------------------------------------
+// Provider detection
+// ---------------------------------------------------------------------------
+/**
+ * Detects if a given package name matches a provider's detection patterns.
+ */
+function matchesProvider(pkg, provider) {
+    const lower = pkg.toLowerCase();
+    return (provider.sdkPackages.some((sdkPkg) => lower === sdkPkg.toLowerCase()) ||
+        provider.detectionPatterns.some((pat) => lower.includes(pat.toLowerCase())));
+}
+/**
+ * Detects the integration method from package names.
+ */
+function detectIntegrationMethod(provider, deps) {
+    for (const dep of deps) {
+        if (provider.sdkPackages.some((pkg) => dep.toLowerCase() === pkg.toLowerCase())) {
+            return 'sdk';
+        }
+    }
+    const methods = provider.integrationMethods;
+    // Config always guarantees non-empty integrationMethods array, so methods[0] is never undefined
+    /* v8 ignore start */
+    return methods[0] ?? 'sdk';
+    /* v8 ignore stop */
+}
+/**
+ * Reads package.json dependencies (prod + dev) from a project path.
+ */
+async function readPackageDeps(projectPath) {
+    try {
+        const content = await readFile(join(projectPath, 'package.json'), 'utf-8');
+        const pkg = JSON.parse(content);
+        const deps = Object.keys(pkg.dependencies ?? {});
+        const devDeps = Object.keys(pkg.devDependencies ?? {});
+        return [...deps, ...devDeps];
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Searches source files for tracking function call signatures.
+ */
+async function findCustomEventCalls(projectPath) {
+    const TRACK_PATTERNS = [
+        'track(',
+        'logEvent(',
+        'capture(',
+        'analytics.track(',
+        'mixpanel.track(',
+        'amplitude.track(',
+        'posthog.capture(',
+    ];
+    const candidates = ['src', 'app', 'lib', 'pages', 'components'];
+    for (const dir of candidates) {
+        try {
+            const { glob } = await import('glob');
+            const files = await glob('**/*.{ts,tsx,js,jsx}', {
+                cwd: join(projectPath, dir),
+                nodir: true,
+                maxDepth: 4,
+                ignore: ['node_modules/**', 'dist/**', 'build/**'],
+            });
+            for (const file of files) {
+                const content = await readFile(join(projectPath, dir, file), 'utf-8');
+                if (TRACK_PATTERNS.some((pat) => content.includes(pat))) {
+                    return true;
+                }
+            }
+        }
+        catch {
+            // Directory doesn't exist or glob failed — skip
+        }
+    }
+    return false;
+}
+/**
+ * Checks if a dashboard config file exists in the project.
+ */
+async function hasDashboardConfig(projectPath) {
+    const DASHBOARD_FILES = [
+        'analytics.config.js',
+        'analytics.config.ts',
+        'analytics.config.json',
+        '.analytics.json',
+        'tracking-plan.json',
+    ];
+    for (const file of DASHBOARD_FILES) {
+        try {
+            await readFile(join(projectPath, file), 'utf-8');
+            return true;
+        }
+        catch {
+            // File not found
+        }
+    }
+    return false;
+}
+/**
+ * Detects the A/B testing provider from dependencies.
+ */
+function detectABTestingProvider(deps) {
+    for (const abProvider of providersConfig.abTestingProviders) {
+        for (const dep of deps) {
+            if (abProvider.detectionPatterns.some((pat) => dep.toLowerCase().includes(pat.toLowerCase()))) {
+                return abProvider.id;
+            }
+        }
+    }
+    return 'none';
+}
+/**
+ * Detects the analytics stack in a project.
+ * Analyses package.json and codebase to return AnalyticsStack.
+ */
+export async function detectStack(projectPath) {
+    const deps = await readPackageDeps(projectPath);
+    const hasCustomEvents = await findCustomEventCalls(projectPath);
+    const hasDashboards = await hasDashboardConfig(projectPath);
+    const abTestingProvider = detectABTestingProvider(deps);
+    for (const provider of providersConfig.providers) {
+        for (const dep of deps) {
+            if (matchesProvider(dep, provider)) {
+                const integrationMethod = detectIntegrationMethod(provider, deps);
+                return {
+                    provider: provider.id,
+                    integrationMethod,
+                    hasCustomEvents,
+                    hasDashboards,
+                    abTestingProvider,
+                    namingConvention: 'object_action',
+                };
+            }
+        }
+    }
+    return {
+        provider: 'unknown',
+        integrationMethod: 'sdk',
+        hasCustomEvents,
+        hasDashboards,
+        abTestingProvider,
+        namingConvention: 'object_action',
+    };
+}
+//# sourceMappingURL=analytics-detector.js.map

package/dist/engine/analytics-detector.js.map

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

package/dist/engine/analyzer-db.d.ts

@@ -0,0 +1,9 @@
+import type { DBEngine, DBEngineConfig, SQLSyntaxConfig } from '../types/tooling.js';
+/** Resets the in-memory cache — used in tests to force reload */
+export declare function resetDbRegistryCache(): void;
+export declare function detectDBEngine(projectPath: string): Promise<DBEngineConfig | null>;
+export declare function getSQLSyntaxForEngine(engine: DBEngine): SQLSyntaxConfig;
+export declare function generateFirestoreRules(collections: string[]): string;
+export declare function generateMongoSchema(collections: string[]): string;
+export declare function generateSupabaseRLS(tables: string[]): string;
+//# sourceMappingURL=analyzer-db.d.ts.map

package/dist/engine/analyzer-db.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyzer-db.d.ts","sourceRoot":"","sources":["../../src/engine/analyzer-db.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,QAAQ,EACR,cAAc,EAEd,eAAe,EAChB,MAAM,qBAAqB,CAAC;AAO7B,iEAAiE;AACjE,wBAAgB,oBAAoB,IAAI,IAAI,CAE3C;AAqBD,wBAAsB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAmBxF;AAID,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,QAAQ,GAAG,eAAe,CA4DvE;AAID,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,MAAM,CAkBpE;AAID,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,MAAM,CA0BjE;AAID,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAuB5D"}