@tachui/cli 0.8.1-alpha → 0.8.5-alpha

package/dist/core/src/reactive/cleanup.js

@@ -0,0 +1,187 @@
+/**
+ * Cleanup and disposal utilities for reactive system
+ *
+ * Provides memory management, cleanup functions, and disposal
+ * utilities to prevent memory leaks in reactive computations.
+ */
+import { getCurrentOwner } from './context';
+/**
+ * Add a cleanup function to the current reactive context
+ *
+ * @param fn Cleanup function to run when the context is disposed
+ *
+ * @example
+ * ```typescript
+ * createEffect(() => {
+ *   const interval = setInterval(() => {
+ *     console.log('tick')
+ *   }, 1000)
+ *
+ *   onCleanup(() => {
+ *     clearInterval(interval)
+ *   })
+ * })
+ * ```
+ */
+export function onCleanup(fn) {
+    const owner = getCurrentOwner();
+    if (owner && !owner.disposed) {
+        owner.cleanups.push(fn);
+    }
+    else if (__DEV__) {
+        console.warn('onCleanup called outside of reactive context');
+    }
+}
+/**
+ * Dispose a reactive owner and all its children
+ *
+ * @param owner The owner to dispose
+ */
+export function dispose(owner) {
+    if ('dispose' in owner && typeof owner.dispose === 'function') {
+        owner.dispose();
+    }
+}
+/**
+ * Create a disposable resource with automatic cleanup
+ *
+ * @param fn Function that creates and returns a resource and its cleanup
+ * @returns The created resource
+ *
+ * @example
+ * ```typescript
+ * const timer = createResource(() => {
+ *   const id = setInterval(() => console.log('tick'), 1000)
+ *   return [id, () => clearInterval(id)]
+ * })
+ * ```
+ */
+export function createResource(fn) {
+    const [resource, cleanup] = fn();
+    onCleanup(cleanup);
+    return resource;
+}
+/**
+ * Create a cleanup group that can be disposed manually
+ *
+ * @returns Cleanup group with dispose function
+ *
+ * @example
+ * ```typescript
+ * const group = createCleanupGroup()
+ *
+ * group.add(() => console.log('cleanup 1'))
+ * group.add(() => console.log('cleanup 2'))
+ *
+ * // Later...
+ * group.dispose() // Runs both cleanup functions
+ * ```
+ */
+export function createCleanupGroup() {
+    const cleanups = [];
+    let disposed = false;
+    return {
+        add(fn) {
+            if (disposed) {
+                if (__DEV__) {
+                    console.warn('Adding cleanup to disposed group');
+                }
+                return;
+            }
+            cleanups.push(fn);
+        },
+        dispose() {
+            if (disposed)
+                return;
+            disposed = true;
+            for (const cleanup of cleanups) {
+                try {
+                    cleanup();
+                }
+                catch (error) {
+                    console.error('Error in cleanup function:', error);
+                }
+            }
+            cleanups.length = 0;
+        },
+        get disposed() {
+            return disposed;
+        },
+    };
+}
+/**
+ * Create a weak disposal tracker using WeakRef and FinalizationRegistry
+ * for automatic cleanup of unreferenced objects
+ */
+export function createWeakDisposal(target, cleanup) {
+    const weakRef = new WeakRef(target);
+    if (typeof FinalizationRegistry !== 'undefined') {
+        const registry = new FinalizationRegistry(cleanup);
+        registry.register(target, cleanup);
+    }
+    return weakRef;
+}
+/**
+ * Defer a cleanup function to run after the current reactive cycle
+ *
+ * @param fn Cleanup function to defer
+ */
+export function deferCleanup(fn) {
+    queueMicrotask(() => {
+        try {
+            fn();
+        }
+        catch (error) {
+            console.error('Error in deferred cleanup:', error);
+        }
+    });
+}
+/**
+ * Create a cleanup function that only runs once
+ *
+ * @param fn Cleanup function
+ * @returns Cleanup function that only runs once
+ */
+export function createOnceCleanup(fn) {
+    let hasRun = false;
+    return () => {
+        if (hasRun)
+            return;
+        hasRun = true;
+        fn();
+    };
+}
+/**
+ * Create a timeout with automatic cleanup
+ *
+ * @param fn Function to run after timeout
+ * @param delay Delay in milliseconds
+ * @returns Timeout ID
+ */
+export function createTimeout(fn, delay) {
+    const id = setTimeout(fn, delay);
+    onCleanup(() => clearTimeout(id));
+    return id;
+}
+/**
+ * Create an interval with automatic cleanup
+ *
+ * @param fn Function to run on interval
+ * @param delay Delay in milliseconds
+ * @returns Interval ID
+ */
+export function createInterval(fn, delay) {
+    const id = setInterval(fn, delay);
+    onCleanup(() => clearInterval(id));
+    return id;
+}
+export function createEventListener(target, event, handler, options) {
+    target.addEventListener(event, handler, options);
+    onCleanup(() => target.removeEventListener(event, handler, options));
+}
+// Development mode flag - simplified approach
+if (typeof globalThis.__DEV__ === 'undefined') {
+    ;
+    globalThis.__DEV__ = process.env.NODE_ENV !== 'production';
+}
+//# sourceMappingURL=cleanup.js.map

package/dist/core/src/reactive/cleanup.js.map

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

package/dist/core/src/reactive/computed.d.ts

@@ -0,0 +1,115 @@
+/**
+ * Computed values implementation
+ *
+ * Computed values are derived reactive values that automatically
+ * update when their dependencies change, with memoization.
+ */
+import { ComputationImpl } from './context';
+import { type EqualityFunction } from './equality';
+import type { Computation, Signal } from './types';
+import { type ReactiveNode, UpdatePriority } from './unified-scheduler';
+export interface ComputedOptions<T> {
+    equals?: EqualityFunction<T>;
+    priority?: UpdatePriority;
+    debugName?: string;
+    onError?: (error: Error) => T;
+}
+/**
+ * Robust computed value implementation with error recovery
+ */
+declare class ComputedImpl<T> extends ComputationImpl implements ReactiveNode {
+    readonly type: "computed";
+    readonly priority: UpdatePriority;
+    private _hasValue;
+    private _error;
+    private equalsFn;
+    private options;
+    constructor(fn: () => T, options?: ComputedOptions<T>, owner?: import("@tachui/types/reactive").Owner | null);
+    /**
+     * Get the computed value, tracking dependency and lazily computing
+     */
+    getValue(): T;
+    /**
+     * Get the current value without tracking dependency
+     */
+    peek(): T;
+    /**
+     * Remove an observer (cleanup)
+     */
+    removeObserver(computation: Computation): void;
+    /**
+     * Execute the computation and notify observers
+     */
+    execute(): T;
+    /**
+     * Notify method for ReactiveNode compatibility
+     */
+    notify(): void;
+    /**
+     * Complete cleanup for memory management
+     */
+    cleanup(): void;
+    /**
+     * Dispose the computed value
+     */
+    dispose(): void;
+    toString(): string;
+}
+/**
+ * Create a computed value that automatically updates when dependencies change
+ *
+ * @param fn The computation function
+ * @param options Configuration options for the computed value
+ * @returns An accessor function for the computed value
+ *
+ * @example
+ * ```typescript
+ * const [count, setCount] = createSignal(0)
+ * const doubleCount = createComputed(() => count() * 2, {
+ *   debugName: 'doubleCounter',
+ *   onError: (error) => {
+ *     console.error('Computation failed:', error)
+ *     return 0 // fallback value
+ *   }
+ * })
+ *
+ * console.log(doubleCount()) // 0
+ * setCount(5)
+ * console.log(doubleCount()) // 10
+ * ```
+ */
+export declare function createComputed<T>(fn: () => T, options?: ComputedOptions<T>): Signal<T>;
+/**
+ * Create a memo (alias for createComputed for SolidJS compatibility)
+ */
+export declare function createMemo<T>(fn: () => T, options?: ComputedOptions<T>): Signal<T>;
+/**
+ * Type guard to check if a value is a computed
+ */
+export declare function isComputed<T = any>(value: any): value is Signal<T>;
+/**
+ * Get the underlying computed implementation for debugging
+ */
+export declare function getComputedImpl<T>(computed: Signal<T>): ComputedImpl<T> | null;
+/**
+ * Create a computed value with explicit dependency tracking
+ *
+ * @param fn The computation function
+ * @param deps Explicit dependencies (optional)
+ * @returns An accessor function for the computed value
+ */
+export declare function createDerivedSignal<T>(fn: () => T, deps?: (() => any)[]): Signal<T>;
+/**
+ * Create a computed value that only updates when a condition is met
+ *
+ * @param fn The computation function
+ * @param when Condition function that must return true for updates
+ * @returns An accessor function for the computed value
+ */
+export declare function createConditionalComputed<T>(fn: () => T, when: () => boolean): Signal<T>;
+/**
+ * Public Computed type export
+ */
+export type Computed<T> = Signal<T>;
+export {};
+//# sourceMappingURL=computed.d.ts.map

package/dist/core/src/reactive/computed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"computed.d.ts","sourceRoot":"","sources":["../../../../../core/src/reactive/computed.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,eAAe,EAA0C,MAAM,WAAW,CAAA;AACnF,OAAO,EAAiB,KAAK,gBAAgB,EAAE,MAAM,YAAY,CAAA;AACjE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AAElD,OAAO,EAAE,KAAK,YAAY,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAEvE,MAAM,WAAW,eAAe,CAAC,CAAC;IAChC,MAAM,CAAC,EAAE,gBAAgB,CAAC,CAAC,CAAC,CAAA;IAC5B,QAAQ,CAAC,EAAE,cAAc,CAAA;IACzB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,CAAC,CAAA;CAC9B;AAED;;GAEG;AACH,cAAM,YAAY,CAAC,CAAC,CAAE,SAAQ,eAAgB,YAAW,YAAY;IACnE,QAAQ,CAAC,IAAI,EAAG,UAAU,CAAS;IACnC,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAA;IAEjC,OAAO,CAAC,SAAS,CAAQ;IACzB,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,QAAQ,CAAqB;IACrC,OAAO,CAAC,OAAO,CAAoB;gBAEvB,EAAE,EAAE,MAAM,CAAC,EAAE,OAAO,GAAE,eAAe,CAAC,CAAC,CAAM,EAAE,KAAK,gDAAoB;IAOpF;;OAEG;IACH,QAAQ,IAAI,CAAC;IAiBb;;OAEG;IACH,IAAI,IAAI,CAAC;IAQT;;OAEG;IACH,cAAc,CAAC,WAAW,EAAE,WAAW,GAAG,IAAI;IAI9C;;OAEG;IACH,OAAO,IAAI,CAAC;IAyBZ;;OAEG;IACH,MAAM,IAAI,IAAI;IAKd;;OAEG;IACH,OAAO,IAAI,IAAI;IAmBf;;OAEG;IACH,OAAO,IAAI,IAAI;IAwBf,QAAQ,IAAI,MAAM;CAGnB;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CActF;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAElF;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,CAAC,GAAG,GAAG,EAAE,KAAK,EAAE,GAAG,GAAG,KAAK,IAAI,MAAM,CAAC,CAAC,CAAC,CAElE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,GAAG,IAAI,CAE9E;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,IAAI,CAAC,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC,CAenF;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,IAAI,EAAE,MAAM,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC,CAiBxF;AAED;;GAEG;AACH,MAAM,MAAM,QAAQ,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,CAAA"}

package/dist/core/src/reactive/computed.js

@@ -0,0 +1,237 @@
+/**
+ * Computed values implementation
+ *
+ * Computed values are derived reactive values that automatically
+ * update when their dependencies change, with memoization.
+ */
+import { ComputationImpl, getCurrentComputation, getCurrentOwner } from './context';
+import { defaultEquals } from './equality';
+import { ComputationState } from './types';
+import { UpdatePriority } from './unified-scheduler';
+/**
+ * Robust computed value implementation with error recovery
+ */
+class ComputedImpl extends ComputationImpl {
+    type = 'computed';
+    priority;
+    _hasValue = false;
+    _error = null;
+    equalsFn;
+    options;
+    constructor(fn, options = {}, owner = getCurrentOwner()) {
+        super(fn, owner);
+        this.priority = options.priority ?? UpdatePriority.Normal;
+        this.equalsFn = options.equals ?? defaultEquals;
+        this.options = options;
+    }
+    /**
+     * Get the computed value, tracking dependency and lazily computing
+     */
+    getValue() {
+        // Track this computed as a dependency if we're in a reactive context
+        const computation = getCurrentComputation();
+        if (computation && computation.state !== ComputationState.Disposed) {
+            this.observers.add(computation);
+            computation.sources.add(this);
+        }
+        // Compute value if needed
+        if (this.state === ComputationState.Dirty || !this._hasValue) {
+            this.execute();
+            this._hasValue = true;
+        }
+        return this.value;
+    }
+    /**
+     * Get the current value without tracking dependency
+     */
+    peek() {
+        if (this.state === ComputationState.Dirty || !this._hasValue) {
+            this.execute();
+            this._hasValue = true;
+        }
+        return this.value;
+    }
+    /**
+     * Remove an observer (cleanup)
+     */
+    removeObserver(computation) {
+        this.observers.delete(computation);
+    }
+    /**
+     * Execute the computation and notify observers
+     */
+    execute() {
+        const previousValue = this._hasValue ? this.value : undefined;
+        const result = super.execute();
+        // Only notify observers if the value actually changed
+        if (!this._hasValue || !this.equalsFn(previousValue, result)) {
+            // Notify dependent computations
+            for (const observer of this.observers) {
+                if (observer.state !== ComputationState.Disposed) {
+                    observer.state = ComputationState.Dirty;
+                    // Use the signal's scheduling mechanism for consistency
+                    if ('execute' in observer && typeof observer.execute === 'function') {
+                        queueMicrotask(() => {
+                            if (observer.state === ComputationState.Dirty) {
+                                observer.execute();
+                            }
+                        });
+                    }
+                }
+            }
+        }
+        return result;
+    }
+    /**
+     * Notify method for ReactiveNode compatibility
+     */
+    notify() {
+        // For computations, notify means execute
+        this.execute();
+    }
+    /**
+     * Complete cleanup for memory management
+     */
+    cleanup() {
+        // Complete bidirectional cleanup
+        for (const source of this.sources) {
+            if ('removeObserver' in source) {
+                ;
+                source.removeObserver(this);
+            }
+        }
+        this.sources.clear();
+        for (const observer of this.observers) {
+            observer.sources.delete(this);
+        }
+        this.observers.clear();
+        this._hasValue = false;
+        this._error = null;
+        this.state = ComputationState.Disposed;
+    }
+    /**
+     * Dispose the computed value
+     */
+    dispose() {
+        this.cleanup();
+        super.dispose();
+    }
+    /**
+     * Debug information
+     */
+    [Symbol.for('tachui.debug')]() {
+        return {
+            id: this.id,
+            type: this.type,
+            value: this._hasValue ? this.value : undefined,
+            hasValue: this._hasValue,
+            error: this._error?.message,
+            state: this.state,
+            sourceCount: this.sources.size,
+            observerCount: this.observers.size,
+            priority: UpdatePriority[this.priority],
+            debugName: this.options.debugName,
+            equalsFn: this.equalsFn.name || 'anonymous',
+        };
+    }
+    toString() {
+        return `Computed(${this.options.debugName || this.id}): ${this._hasValue ? this.value : 'no value'}`;
+    }
+}
+/**
+ * Create a computed value that automatically updates when dependencies change
+ *
+ * @param fn The computation function
+ * @param options Configuration options for the computed value
+ * @returns An accessor function for the computed value
+ *
+ * @example
+ * ```typescript
+ * const [count, setCount] = createSignal(0)
+ * const doubleCount = createComputed(() => count() * 2, {
+ *   debugName: 'doubleCounter',
+ *   onError: (error) => {
+ *     console.error('Computation failed:', error)
+ *     return 0 // fallback value
+ *   }
+ * })
+ *
+ * console.log(doubleCount()) // 0
+ * setCount(5)
+ * console.log(doubleCount()) // 10
+ * ```
+ */
+export function createComputed(fn, options) {
+    const computed = new ComputedImpl(fn, options);
+    // Create bound accessor with peek method - this is already a Signal<T>
+    const accessor = computed.getValue.bind(computed);
+    accessor.peek = computed.peek.bind(computed);
+    // Add debug information
+    Object.defineProperty(accessor, Symbol.for('tachui.computed'), {
+        value: computed,
+        enumerable: false,
+    });
+    return accessor;
+}
+/**
+ * Create a memo (alias for createComputed for SolidJS compatibility)
+ */
+export function createMemo(fn, options) {
+    return createComputed(fn, options);
+}
+/**
+ * Type guard to check if a value is a computed
+ */
+export function isComputed(value) {
+    return typeof value === 'function' && Symbol.for('tachui.computed') in value;
+}
+/**
+ * Get the underlying computed implementation for debugging
+ */
+export function getComputedImpl(computed) {
+    return computed[Symbol.for('tachui.computed')] || null;
+}
+/**
+ * Create a computed value with explicit dependency tracking
+ *
+ * @param fn The computation function
+ * @param deps Explicit dependencies (optional)
+ * @returns An accessor function for the computed value
+ */
+export function createDerivedSignal(fn, deps) {
+    if (!deps) {
+        return createComputed(fn);
+    }
+    // Wrap function to explicitly track dependencies
+    const wrappedFn = () => {
+        // Read all dependencies to track them
+        for (const dep of deps) {
+            dep();
+        }
+        return fn();
+    };
+    return createComputed(wrappedFn);
+}
+/**
+ * Create a computed value that only updates when a condition is met
+ *
+ * @param fn The computation function
+ * @param when Condition function that must return true for updates
+ * @returns An accessor function for the computed value
+ */
+export function createConditionalComputed(fn, when) {
+    let lastValue;
+    let hasValue = false;
+    return createComputed(() => {
+        if (when()) {
+            lastValue = fn();
+            hasValue = true;
+        }
+        if (!hasValue) {
+            lastValue = fn();
+            hasValue = true;
+        }
+        return lastValue;
+    });
+}
+//# sourceMappingURL=computed.js.map

package/dist/core/src/reactive/computed.js.map

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

package/dist/core/src/reactive/context.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Reactive context and computation management
+ *
+ * Manages the reactive execution context, dependency tracking,
+ * and computation lifecycle.
+ */
+import type { CleanupFunction, Computation, ComputationStateValue, Owner, ReactiveContext } from './types';
+/**
+ * Get the current computation context
+ */
+export declare function getCurrentComputation(): Computation | null;
+/**
+ * Get the current owner context
+ */
+export declare function getCurrentOwner(): Owner | null;
+/**
+ * Check if we're currently batching updates
+ */
+export declare function isBatchingUpdates(): boolean;
+/**
+ * Computation implementation
+ */
+export declare class ComputationImpl implements Computation {
+    readonly id: number;
+    readonly owner: Owner | null;
+    readonly fn: () => any;
+    readonly sources: Set<any>;
+    readonly observers: Set<Computation>;
+    state: ComputationStateValue;
+    value: any;
+    constructor(fn: () => any, owner?: Owner | null);
+    execute(): any;
+    dispose(): void;
+}
+/**
+ * Create a new reactive computation root
+ */
+export declare function createRoot<T>(fn: (dispose: () => void) => T): T;
+/**
+ * Run a function with a specific owner context
+ */
+export declare function runWithOwner<T>(owner: Owner | null, fn: () => T): T;
+/**
+ * Get the current owner context
+ */
+export declare function getOwner(): Owner | null;
+/**
+ * Set the flush function (called by signal module)
+ */
+export declare function setFlushFunction(fn: () => void): void;
+/**
+ * Batch multiple updates together
+ */
+export declare function batch<T>(fn: () => T): T;
+/**
+ * Read a signal without tracking dependency
+ */
+export declare function untrack<T>(fn: () => T): T;
+/**
+ * Add cleanup function to current owner
+ */
+export declare function onCleanup(fn: CleanupFunction): void;
+/**
+ * Create a computation that runs immediately and tracks dependencies
+ */
+export declare function createComputation<T>(fn: () => T, owner?: Owner): ComputationImpl;
+/**
+ * Get reactive context information
+ */
+export declare function getReactiveContext(): ReactiveContext;
+/**
+ * Debug utilities
+ */
+export declare const DEBUG: {
+    getCurrentComputation: () => Computation | null;
+    getCurrentOwner: () => Owner | null;
+    getComputationCount: () => number;
+    getOwnerCount: () => number;
+    isBatching: () => boolean;
+    getModuleInstances: () => string[];
+    getModuleId: () => string;
+};
+//# sourceMappingURL=context.d.ts.map

package/dist/core/src/reactive/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../../../core/src/reactive/context.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,eAAe,EACf,WAAW,EACX,qBAAqB,EACrB,KAAK,EACL,eAAe,EAChB,MAAM,SAAS,CAAA;AA0ChB;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,WAAW,GAAG,IAAI,CAG1D;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,KAAK,GAAG,IAAI,CAE9C;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAE3C;AA8CD;;GAEG;AACH,qBAAa,eAAgB,YAAW,WAAW;IACjD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAA;IAC5B,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,CAAA;IACtB,QAAQ,CAAC,OAAO,WAAiB;IACjC,QAAQ,CAAC,SAAS,mBAAyB;IAC3C,KAAK,EAAE,qBAAqB,CAAyB;IACrD,KAAK,EAAE,GAAG,CAAY;gBAEV,EAAE,EAAE,MAAM,GAAG,EAAE,KAAK,GAAE,KAAK,GAAG,IAAW;IAUrD,OAAO,IAAI,GAAG;IAiCd,OAAO,IAAI,IAAI;CAwBhB;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,OAAO,EAAE,MAAM,IAAI,KAAK,CAAC,GAAG,CAAC,CAU/D;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CASnE;AAED;;GAEG;AACH,wBAAgB,QAAQ,IAAI,KAAK,GAAG,IAAI,CAEvC;AAKD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,IAAI,CAErD;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAkBvC;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CASzC;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,EAAE,EAAE,eAAe,GAAG,IAAI,CAKnD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EACjC,EAAE,EAAE,MAAM,CAAC,EACX,KAAK,CAAC,EAAE,KAAK,GACZ,eAAe,CAOjB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,eAAe,CAKpD;AAED;;GAEG;AACH,eAAO,MAAM,KAAK;;;;;;;;CAQjB,CAAA"}