@tachui/cli 0.8.1-alpha → 0.8.5-alpha

package/dist/devtools/src/import-guide.js

@@ -0,0 +1,257 @@
+/**
+ * Developer Guidance Tools for Optimal TachUI Imports
+ *
+ * Provides interactive guidance and documentation for optimal import patterns
+ */
+export class ImportGuidanceSystem {
+    guides = new Map();
+    constructor() {
+        this.initializeGuides();
+    }
+    initializeGuides() {
+        // Core Package Guidance
+        this.guides.set('core', {
+            title: 'TachUI Core Import Guide',
+            description: 'Optimize core framework imports for minimal bundle size',
+            rules: [
+                {
+                    pattern: /^@tachui\/core$/,
+                    recommendation: 'Use specific subpaths instead of main export',
+                    example: '@tachui/core/reactive instead of @tachui/core',
+                    bundleImpact: 'Can save 20-35KB by avoiding unused code',
+                    category: 'reactive',
+                },
+                {
+                    pattern: /createSignal|createEffect|createComputed/,
+                    recommendation: 'Import reactive functions from @tachui/core/reactive',
+                    example: "import { createSignal } from '@tachui/core/reactive'",
+                    bundleImpact: 'Saves ~33KB vs full core import',
+                    category: 'reactive',
+                },
+            ],
+            examples: {
+                good: [
+                    "import { createSignal, createEffect } from '@tachui/core/reactive'",
+                    "import { withComponentContext } from '@tachui/core/runtime'",
+                    "import { Assets } from '@tachui/core/assets'",
+                ],
+                avoid: [
+                    "import { createSignal, VStack, Button } from '@tachui/core'",
+                    "import * as TachUI from '@tachui/core'",
+                ],
+            },
+        });
+        // Primitives Package Guidance
+        this.guides.set('primitives', {
+            title: 'TachUI Primitives Import Guide',
+            description: 'Import UI components with optimal granularity',
+            rules: [
+                {
+                    pattern: /VStack|HStack|Spacer/,
+                    recommendation: 'Import layout components from @tachui/primitives/layout',
+                    example: "import { VStack, HStack } from '@tachui/primitives/layout'",
+                    bundleImpact: 'Saves ~27KB by avoiding display/control components',
+                    category: 'layout',
+                },
+                {
+                    pattern: /Text|Image|ScrollView/,
+                    recommendation: 'Import display components from @tachui/primitives/display',
+                    example: "import { Text, Image } from '@tachui/primitives/display'",
+                    bundleImpact: 'Saves ~23KB by avoiding layout/control components',
+                    category: 'display',
+                },
+                {
+                    pattern: /Button|TextField|Toggle/,
+                    recommendation: 'Import form controls from @tachui/primitives/controls',
+                    example: "import { Button } from '@tachui/primitives/controls'",
+                    bundleImpact: 'Saves ~20KB by avoiding layout/display components',
+                    category: 'forms',
+                },
+            ],
+            examples: {
+                good: [
+                    "import { VStack, HStack } from '@tachui/primitives/layout'",
+                    "import { Text } from '@tachui/primitives/display'",
+                    "import { Button } from '@tachui/primitives/controls'",
+                ],
+                avoid: [
+                    "import { VStack, Text, Button } from '@tachui/primitives'",
+                    "import * from '@tachui/primitives'",
+                ],
+            },
+        });
+        // Bundle Size Guidance
+        this.guides.set('bundle-optimization', {
+            title: 'Bundle Size Optimization Guide',
+            description: 'Minimize your bundle size with smart import strategies',
+            rules: [
+                {
+                    pattern: /minimal|essential/,
+                    recommendation: 'Use bundle variants for production builds',
+                    example: "import { createSignal } from '@tachui/core/minimal'",
+                    bundleImpact: '45KB → 15KB for basic reactive apps',
+                    category: 'reactive',
+                },
+            ],
+            examples: {
+                good: [
+                    '// Production calculator app',
+                    "import { createSignal } from '@tachui/core/minimal'",
+                    "import { VStack } from '@tachui/primitives/layout'",
+                    '',
+                    '// Complex dashboard app',
+                    "import { createSignal } from '@tachui/core/reactive'",
+                    "import '@tachui/modifiers/effects' // Only if animations needed",
+                ],
+                avoid: [
+                    '// Avoid importing everything',
+                    "import '@tachui/core'",
+                    "import '@tachui/primitives'",
+                    "import '@tachui/modifiers/effects' // Unless you need animations",
+                ],
+            },
+        });
+    }
+    /**
+     * Get import guidance for specific imports
+     */
+    getGuidance(importPath, namedImports = []) {
+        const matchingRules = [];
+        for (const guide of this.guides.values()) {
+            for (const rule of guide.rules) {
+                if (rule.pattern.test(importPath) ||
+                    namedImports.some(imp => rule.pattern.test(imp))) {
+                    matchingRules.push(rule);
+                }
+            }
+        }
+        return matchingRules;
+    }
+    /**
+     * Generate import documentation for a specific package
+     */
+    generatePackageGuide(packageName) {
+        const guide = this.guides.get(packageName);
+        if (!guide)
+            return `No guidance available for package: ${packageName}`;
+        let docs = `# ${guide.title}\n\n${guide.description}\n\n`;
+        docs += `## ✅ Recommended Imports\n\n`;
+        for (const good of guide.examples.good) {
+            docs += `\`\`\`typescript\n${good}\n\`\`\`\n\n`;
+        }
+        docs += `## ❌ Avoid These Patterns\n\n`;
+        for (const avoid of guide.examples.avoid) {
+            docs += `\`\`\`typescript\n${avoid}\n\`\`\`\n\n`;
+        }
+        docs += `## 📦 Bundle Impact\n\n`;
+        for (const rule of guide.rules) {
+            docs += `- **${rule.recommendation}**: ${rule.bundleImpact}\n`;
+        }
+        return docs;
+    }
+    /**
+     * Interactive import helper for CLI
+     */
+    async getInteractiveRecommendations(imports) {
+        const recommendations = [];
+        let totalSavings = 0;
+        for (const importPath of imports) {
+            const guidance = this.getGuidance(importPath);
+            for (const rule of guidance) {
+                recommendations.push(`${rule.recommendation} (${rule.bundleImpact})`);
+                // Extract KB savings from impact string
+                const match = rule.bundleImpact.match(/(\d+)KB/);
+                if (match)
+                    totalSavings += parseInt(match[1]);
+            }
+        }
+        return {
+            recommendations: [...new Set(recommendations)], // Dedupe
+            potentialSavings: `~${totalSavings}KB`,
+        };
+    }
+    /**
+     * Generate import cheat sheet
+     */
+    generateCheatSheet() {
+        return `# TachUI Import Cheat Sheet 📚
+
+## 🏗️ Layout Components (8KB)
+\`\`\`typescript
+import { VStack, HStack, Spacer } from '@tachui/primitives/layout'
+\`\`\`
+
+## 🎨 Display Components (12KB)  
+\`\`\`typescript
+import { Text, Image, ScrollView } from '@tachui/primitives/display'
+\`\`\`
+
+## 🎛️ Control Components (15KB)
+\`\`\`typescript
+import { Button, TextField, Toggle } from '@tachui/primitives/controls'
+\`\`\`
+
+## ⚡ Reactive System (12KB)
+\`\`\`typescript
+import { createSignal, createEffect } from '@tachui/core/reactive'
+\`\`\`
+
+## 🎭 Effects & Animations (Only if needed!)
+\`\`\`typescript
+import '@tachui/modifiers/effects' // Adds 25KB
+\`\`\`
+
+## 📱 Mobile UI Patterns
+\`\`\`typescript
+import { ActionSheet, Alert } from '@tachui/mobile'
+\`\`\`
+
+## 🧩 Flow Control
+\`\`\`typescript  
+import { Show, ForEach } from '@tachui/flow-control'
+\`\`\`
+
+## 📊 Bundle Variants for Production
+
+### Calculator/Simple Apps (15KB total)
+\`\`\`typescript
+import { createSignal } from '@tachui/core/minimal'
+import { VStack } from '@tachui/primitives/layout'  
+\`\`\`
+
+### Complex Apps (45KB total)
+\`\`\`typescript
+import { createSignal } from '@tachui/core/reactive'
+import '@tachui/modifiers/effects'
+\`\`\`
+
+## 🚫 Anti-Patterns to Avoid
+
+❌ \`import { everything } from '@tachui/core'\` (45KB)  
+✅ \`import { createSignal } from '@tachui/core/reactive'\` (12KB)
+
+❌ \`import * from '@tachui/primitives'\` (35KB)  
+✅ \`import { VStack } from '@tachui/primitives/layout'\` (8KB)
+`;
+    }
+}
+/**
+ * Console utility for development guidance
+ */
+export function logImportGuidance(importPath, namedImports = []) {
+    const system = new ImportGuidanceSystem();
+    const guidance = system.getGuidance(importPath, namedImports);
+    if (guidance.length === 0) {
+        console.log(`✅ Import path "${importPath}" looks optimal`);
+        return;
+    }
+    console.group(`💡 TachUI Import Suggestions for "${importPath}"`);
+    for (const rule of guidance) {
+        console.log(`📦 ${rule.recommendation}`);
+        console.log(`💰 ${rule.bundleImpact}`);
+        console.log(`📝 Example: ${rule.example}`);
+        console.log('---');
+    }
+    console.groupEnd();
+}
+//# sourceMappingURL=import-guide.js.map

package/dist/devtools/src/import-guide.js.map

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

package/dist/devtools/src/index.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @tachui/devtools - Development & Debugging Tools
+ *
+ * A comprehensive suite of development tools for tachUI applications.
+ * Provides runtime inspection, performance profiling, component debugging,
+ * and development-only features that enhance the developer experience.
+ */
+export * from './debug';
+export * from './inspector';
+export * from './profiler';
+export * from './testing';
+export * from './build-time';
+export * from './import-guide';
+export * from './modifier-parameter-system';
+export * from './runtime/error-boundary';
+export * from './runtime/error-recovery';
+export * from './runtime/error-reporting';
+export * from './runtime/error-utils';
+export * from './runtime/performance';
+export * from './validation/error-reporting';
+export * from './validation/enhanced-runtime';
+export * from './plugins/simplified-error-handler';
+export declare const VERSION = "0.1.0";
+//# sourceMappingURL=index.d.ts.map

package/dist/devtools/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../devtools/src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,cAAc,SAAS,CAAA;AAGvB,cAAc,aAAa,CAAA;AAG3B,cAAc,YAAY,CAAA;AAG1B,cAAc,WAAW,CAAA;AAGzB,cAAc,cAAc,CAAA;AAG5B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,6BAA6B,CAAA;AAG3C,cAAc,0BAA0B,CAAA;AACxC,cAAc,0BAA0B,CAAA;AACxC,cAAc,2BAA2B,CAAA;AACzC,cAAc,uBAAuB,CAAA;AACrC,cAAc,uBAAuB,CAAA;AACrC,cAAc,8BAA8B,CAAA;AAC5C,cAAc,+BAA+B,CAAA;AAC7C,cAAc,oCAAoC,CAAA;AAGlD,eAAO,MAAM,OAAO,UAAU,CAAA"}

package/dist/devtools/src/index.js

@@ -0,0 +1,32 @@
+/**
+ * @tachui/devtools - Development & Debugging Tools
+ *
+ * A comprehensive suite of development tools for tachUI applications.
+ * Provides runtime inspection, performance profiling, component debugging,
+ * and development-only features that enhance the developer experience.
+ */
+// Core debugging system
+export * from './debug';
+// Component inspection system
+export * from './inspector';
+// Re-export profiler
+export * from './profiler';
+// Re-export testing
+export * from './testing';
+// Re-export build-time validation tools
+export * from './build-time';
+// CLI tooling exports
+export * from './import-guide';
+export * from './modifier-parameter-system';
+// Error handling system (moved from @tachui/core)
+export * from './runtime/error-boundary';
+export * from './runtime/error-recovery';
+export * from './runtime/error-reporting';
+export * from './runtime/error-utils';
+export * from './runtime/performance';
+export * from './validation/error-reporting';
+export * from './validation/enhanced-runtime';
+export * from './plugins/simplified-error-handler';
+// Version
+export const VERSION = '0.1.0';
+//# sourceMappingURL=index.js.map

package/dist/devtools/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../devtools/src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,wBAAwB;AACxB,cAAc,SAAS,CAAA;AAEvB,8BAA8B;AAC9B,cAAc,aAAa,CAAA;AAE3B,qBAAqB;AACrB,cAAc,YAAY,CAAA;AAE1B,oBAAoB;AACpB,cAAc,WAAW,CAAA;AAEzB,wCAAwC;AACxC,cAAc,cAAc,CAAA;AAE5B,sBAAsB;AACtB,cAAc,gBAAgB,CAAA;AAC9B,cAAc,6BAA6B,CAAA;AAE3C,kDAAkD;AAClD,cAAc,0BAA0B,CAAA;AACxC,cAAc,0BAA0B,CAAA;AACxC,cAAc,2BAA2B,CAAA;AACzC,cAAc,uBAAuB,CAAA;AACrC,cAAc,uBAAuB,CAAA;AACrC,cAAc,8BAA8B,CAAA;AAC5C,cAAc,+BAA+B,CAAA;AAC7C,cAAc,oCAAoC,CAAA;AAElD,UAAU;AACV,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAA"}

package/dist/devtools/src/inspector/index.d.ts

@@ -0,0 +1,232 @@
+/**
+ * Development Tools System
+ *
+ * Comprehensive debugging and development tools for TachUI.
+ * Provides component tree inspection, performance analysis,
+ * and runtime debugging capabilities.
+ */
+import type { ComponentInstance } from '@tachui/core';
+/**
+ * Component tree node for debugging
+ */
+export interface ComponentTreeNode {
+    id: string;
+    name: string;
+    type: 'component' | 'element' | 'text' | 'fragment';
+    props: Record<string, any>;
+    children: ComponentTreeNode[];
+    parent: ComponentTreeNode | null;
+    depth: number;
+    renderCount: number;
+    lastRenderTime: number;
+    memoryUsage: number;
+    warnings: string[];
+    errors: string[];
+}
+/**
+ * Development environment state
+ */
+export interface DevState {
+    enabled: boolean;
+    performanceTracking: boolean;
+    componentInspection: boolean;
+    reactiveDebugging: boolean;
+    memoryTracking: boolean;
+    warningsEnabled: boolean;
+    logLevel: 'error' | 'warn' | 'info' | 'debug';
+}
+/**
+ * Development tools configuration
+ */
+export interface DevToolsConfig {
+    autoEnable: boolean;
+    trackAllComponents: boolean;
+    trackMemoryUsage: boolean;
+    enableWarnings: boolean;
+    enableErrors: boolean;
+    maxTreeDepth: number;
+    updateInterval: number;
+}
+/**
+ * Runtime debugging event
+ */
+export interface DebugEvent {
+    type: 'component_mount' | 'component_unmount' | 'component_update' | 'reactive_create' | 'reactive_update' | 'context_change' | 'performance_warning' | 'error';
+    timestamp: number;
+    componentId?: string;
+    componentName?: string;
+    data: any;
+    stack?: string;
+}
+/**
+ * Development tools manager
+ */
+export declare class DevTools {
+    private static instance;
+    private config;
+    private state;
+    private componentTree;
+    private componentRegistry;
+    private debugEvents;
+    private activeComponents;
+    private treeSignal;
+    private setTree;
+    private eventsSignal;
+    private setEvents;
+    private stateSignal;
+    private setState;
+    private updateTimer;
+    constructor();
+    static getInstance(): DevTools;
+    /**
+     * Configure development tools
+     */
+    configure(config: Partial<DevToolsConfig>): void;
+    /**
+     * Enable development tools
+     */
+    enable(): void;
+    /**
+     * Disable development tools
+     */
+    disable(): void;
+    /**
+     * Check if dev tools are enabled
+     */
+    isEnabled(): boolean;
+    /**
+     * Register a component instance
+     */
+    registerComponent(componentId: string, instance: ComponentInstance, parentId?: string): void;
+    /**
+     * Unregister a component instance
+     */
+    unregisterComponent(componentId: string): void;
+    /**
+     * Update component data
+     */
+    updateComponent(componentId: string, updates: Partial<ComponentTreeNode>): void;
+    /**
+     * Track reactive operation
+     */
+    trackReactiveOperation(type: string, operation: string, componentId?: string): void;
+    /**
+     * Track context changes
+     */
+    trackContextChange(contextName: string, newValue: any, componentId?: string): void;
+    /**
+     * Add warning to component
+     */
+    addWarning(componentId: string, message: string): void;
+    /**
+     * Add error to component
+     */
+    addError(componentId: string, error: Error | string): void;
+    /**
+     * Get component tree
+     */
+    getComponentTree(): Map<string, ComponentTreeNode>;
+    /**
+     * Get component tree signal
+     */
+    getComponentTreeSignal(): () => Map<string, ComponentTreeNode>;
+    /**
+     * Get root components
+     */
+    getRootComponents(): ComponentTreeNode[];
+    /**
+     * Get component by ID
+     */
+    getComponent(componentId: string): ComponentTreeNode | undefined;
+    /**
+     * Find components by name
+     */
+    findComponentsByName(name: string): ComponentTreeNode[];
+    /**
+     * Get debug events
+     */
+    getDebugEvents(): DebugEvent[];
+    /**
+     * Get debug events signal
+     */
+    getDebugEventsSignal(): () => DebugEvent[];
+    /**
+     * Get development state
+     */
+    getDevState(): DevState;
+    /**
+     * Get development state signal
+     */
+    getDevStateSignal(): () => DevState;
+    /**
+     * Get performance summary
+     */
+    getPerformanceSummary(): {
+        componentCount: number;
+        averageRenderTime: number;
+        memoryUsage: number;
+        warningCount: number;
+        errorCount: number;
+        slowComponents: {
+            id: string;
+            name: string;
+            renderTime: number;
+        }[];
+    };
+    /**
+     * Export debug data
+     */
+    exportDebugData(): string;
+    /**
+     * Clear debug data
+     */
+    clear(): void;
+    private getComponentName;
+    private removeNodeAndDescendants;
+    private addDebugEvent;
+    private startUpdateTimer;
+    private stopUpdateTimer;
+    private updateComponentMetrics;
+}
+/**
+ * Global dev tools instance
+ */
+export declare const globalDevTools: DevTools;
+/**
+ * Enable performance tracking
+ */
+export declare function enablePerformanceTracking(): void;
+/**
+ * Get component tree
+ */
+export declare function getComponentTree(): Map<string, ComponentTreeNode>;
+/**
+ * Enable development mode with full debugging
+ */
+export declare function enableDevelopmentMode(config?: Partial<DevToolsConfig>): void;
+/**
+ * Get development tools instance
+ */
+export declare function getDevTools(): DevTools;
+/**
+ * Development utilities
+ */
+export declare const devUtils: {
+    /**
+     * Log component tree to console
+     */
+    logComponentTree(): void;
+    /**
+     * Log performance summary
+     */
+    logPerformanceSummary(): void;
+    /**
+     * Find component by name
+     */
+    findComponent(name: string): ComponentTreeNode[];
+    /**
+     * Inspect component
+     */
+    inspectComponent(componentId: string): ComponentTreeNode | undefined;
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/devtools/src/inspector/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../devtools/src/inspector/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAA;AAErD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,WAAW,GAAG,SAAS,GAAG,MAAM,GAAG,UAAU,CAAA;IACnD,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IAC1B,QAAQ,EAAE,iBAAiB,EAAE,CAAA;IAC7B,MAAM,EAAE,iBAAiB,GAAG,IAAI,CAAA;IAChC,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,EAAE,MAAM,CAAA;IACnB,cAAc,EAAE,MAAM,CAAA;IACtB,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,MAAM,EAAE,MAAM,EAAE,CAAA;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,OAAO,CAAA;IAChB,mBAAmB,EAAE,OAAO,CAAA;IAC5B,mBAAmB,EAAE,OAAO,CAAA;IAC5B,iBAAiB,EAAE,OAAO,CAAA;IAC1B,cAAc,EAAE,OAAO,CAAA;IACvB,eAAe,EAAE,OAAO,CAAA;IACxB,QAAQ,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAA;CAC9C;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,OAAO,CAAA;IACnB,kBAAkB,EAAE,OAAO,CAAA;IAC3B,gBAAgB,EAAE,OAAO,CAAA;IACzB,cAAc,EAAE,OAAO,CAAA;IACvB,YAAY,EAAE,OAAO,CAAA;IACrB,YAAY,EAAE,MAAM,CAAA;IACpB,cAAc,EAAE,MAAM,CAAA;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EACA,iBAAiB,GACjB,mBAAmB,GACnB,kBAAkB,GAClB,iBAAiB,GACjB,iBAAiB,GACjB,gBAAgB,GAChB,qBAAqB,GACrB,OAAO,CAAA;IACX,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,IAAI,EAAE,GAAG,CAAA;IACT,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED;;GAEG;AACH,qBAAa,QAAQ;IACnB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAU;IAEjC,OAAO,CAAC,MAAM,CAQb;IAED,OAAO,CAAC,KAAK,CAQZ;IAED,OAAO,CAAC,aAAa,CAAuC;IAC5D,OAAO,CAAC,iBAAiB,CAAuC;IAChE,OAAO,CAAC,WAAW,CAAmB;IACtC,OAAO,CAAC,gBAAgB,CAAoB;IAG5C,OAAO,CAAC,UAAU,CAAsC;IACxD,OAAO,CAAC,OAAO,CAAiD;IAChE,OAAO,CAAC,YAAY,CAAoB;IACxC,OAAO,CAAC,SAAS,CAA+B;IAChD,OAAO,CAAC,WAAW,CAAgB;IACnC,OAAO,CAAC,QAAQ,CAA2B;IAG3C,OAAO,CAAC,WAAW,CAAsB;;IAkBzC,MAAM,CAAC,WAAW,IAAI,QAAQ;IAO9B;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,IAAI;IAQhD;;OAEG;IACH,MAAM,IAAI,IAAI;IAoBd;;OAEG;IACH,OAAO,IAAI,IAAI;IASf;;OAEG;IACH,SAAS,IAAI,OAAO;IAIpB;;OAEG;IACH,iBAAiB,CACf,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,iBAAiB,EAC3B,QAAQ,CAAC,EAAE,MAAM,GAChB,IAAI;IA2CP;;OAEG;IACH,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAkC9C;;OAEG;IACH,eAAe,CACb,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,OAAO,CAAC,iBAAiB,CAAC,GAClC,IAAI;IAkBP;;OAEG;IACH,sBAAsB,CACpB,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,WAAW,CAAC,EAAE,MAAM,GACnB,IAAI;IAWP;;OAEG;IACH,kBAAkB,CAChB,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,GAAG,EACb,WAAW,CAAC,EAAE,MAAM,GACnB,IAAI;IAWP;;OAEG;IACH,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAsBtD;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,MAAM,GAAG,IAAI;IAwB1D;;OAEG;IACH,gBAAgB,IAAI,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC;IAIlD;;OAEG;IACH,sBAAsB,IAAI,MAAM,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC;IAI9D;;OAEG;IACH,iBAAiB,IAAI,iBAAiB,EAAE;IAMxC;;OAEG;IACH,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS;IAIhE;;OAEG;IACH,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,EAAE;IAMvD;;OAEG;IACH,cAAc,IAAI,UAAU,EAAE;IAI9B;;OAEG;IACH,oBAAoB,IAAI,MAAM,UAAU,EAAE;IAI1C;;OAEG;IACH,WAAW,IAAI,QAAQ;IAIvB;;OAEG;IACH,iBAAiB,IAAI,MAAM,QAAQ;IAInC;;OAEG;IACH,qBAAqB,IAAI;QACvB,cAAc,EAAE,MAAM,CAAA;QACtB,iBAAiB,EAAE,MAAM,CAAA;QACzB,WAAW,EAAE,MAAM,CAAA;QACnB,YAAY,EAAE,MAAM,CAAA;QACpB,UAAU,EAAE,MAAM,CAAA;QAClB,cAAc,EAAE;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAC;YAAC,UAAU,EAAE,MAAM,CAAA;SAAE,EAAE,CAAA;KACnE;IAgCD;;OAEG;IACH,eAAe,IAAI,MAAM;IAYzB;;OAEG;IACH,KAAK,IAAI,IAAI;IAYb,OAAO,CAAC,gBAAgB;IA8BxB,OAAO,CAAC,wBAAwB;IAUhC,OAAO,CAAC,aAAa;IAgBrB,OAAO,CAAC,gBAAgB;IAQxB,OAAO,CAAC,eAAe;IAOvB,OAAO,CAAC,sBAAsB;CA2B/B;AAED;;GAEG;AACH,eAAO,MAAM,cAAc,UAAyB,CAAA;AAEpD;;GAEG;AACH,wBAAgB,yBAAyB,IAAI,IAAI,CAEhD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAEjE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,IAAI,CAW5E;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,QAAQ,CAEtC;AAED;;GAEG;AACH,eAAO,MAAM,QAAQ;IACnB;;OAEG;wBACiB,IAAI;IA2BxB;;OAEG;6BACsB,IAAI;IAyB7B;;OAEG;wBACiB,MAAM,GAAG,iBAAiB,EAAE;IAIhD;;OAEG;kCAC2B,MAAM,GAAG,iBAAiB,GAAG,SAAS;CAYrE,CAAA"}