@blac/core 2.0.0-rc-16 → 2.0.0-rc.1

package/dist/Bloc.d.ts

@@ -0,0 +1,41 @@
+import { BlocBase } from './BlocBase';
+import { BlocEventConstraint } from './types';
+export declare abstract class Bloc<S, // State type
+A extends BlocEventConstraint = BlocEventConstraint> extends BlocBase<S> {
+    readonly eventHandlers: Map<new (...args: any[]) => A, (event: A, emit: (newState: S) => void) => void | Promise<void>>;
+    /**
+     * @internal
+     * Event queue to ensure sequential processing of async events
+     */
+    private _eventQueue;
+    /**
+     * @internal
+     * Flag indicating if an event is currently being processed
+     */
+    private _isProcessingEvent;
+    /**
+     * Registers an event handler for a specific event type.
+     * This method is typically called in the constructor of a derived Bloc class.
+     * @param eventConstructor The constructor of the event to handle (e.g., LoadDataEvent).
+     * @param handler A function that processes the event and can emit new states.
+     *                The 'event' parameter in the handler will be typed to the specific eventConstructor.
+     */
+    protected on<E extends A>(eventConstructor: new (...args: any[]) => E, handler: (event: E, emit: (newState: S) => void) => void | Promise<void>): void;
+    /**
+     * Dispatches an action/event to the Bloc.
+     * Events are queued and processed sequentially to prevent race conditions.
+     * @param action The action/event instance to be processed.
+     */
+    add: (action: A) => Promise<void>;
+    /**
+     * @internal
+     * Processes events from the queue sequentially
+     */
+    private _processEventQueue;
+    /**
+     * @internal
+     * Processes a single event
+     */
+    private _processEvent;
+}
+//# sourceMappingURL=Bloc.d.ts.map

package/dist/Bloc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Bloc.d.ts","sourceRoot":"","sources":["../src/Bloc.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAE9C,8BAAsB,IAAI,CACxB,CAAC,EAAE,aAAa;AAChB,CAAC,SAAS,mBAAmB,GAAG,mBAAmB,CACnD,SAAQ,QAAQ,CAAC,CAAC,CAAC;IACnB,QAAQ,CAAC,aAAa,EAAE,GAAG,CACzB,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,EACzB,CAAC,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAK,IAAI,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAChE,CAAa;IAEd;;;OAGG;IACH,OAAO,CAAC,WAAW,CAAW;IAE9B;;;OAGG;IACH,OAAO,CAAC,kBAAkB,CAAS;IAEnC;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,EACtB,gBAAgB,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,EAC3C,OAAO,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAK,IAAI,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GACvE,IAAI;IAeP;;;;OAIG;IACI,GAAG,GAAU,QAAQ,CAAC,KAAG,OAAO,CAAC,IAAI,CAAC,CA8B3C;IAEF;;;OAGG;YACW,kBAAkB;IAiBhC;;;OAGG;YACW,aAAa;CAmE5B"}

package/dist/Bloc.js

@@ -0,0 +1,140 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Bloc = void 0;
+const Blac_1 = require("./Blac");
+const BlocBase_1 = require("./BlocBase");
+class Bloc extends BlocBase_1.BlocBase {
+    eventHandlers = new Map();
+    /**
+     * @internal
+     * Event queue to ensure sequential processing of async events
+     */
+    _eventQueue = [];
+    /**
+     * @internal
+     * Flag indicating if an event is currently being processed
+     */
+    _isProcessingEvent = false;
+    /**
+     * Registers an event handler for a specific event type.
+     * This method is typically called in the constructor of a derived Bloc class.
+     * @param eventConstructor The constructor of the event to handle (e.g., LoadDataEvent).
+     * @param handler A function that processes the event and can emit new states.
+     *                The 'event' parameter in the handler will be typed to the specific eventConstructor.
+     */
+    on(eventConstructor, handler) {
+        if (this.eventHandlers.has(eventConstructor)) {
+            Blac_1.Blac.warn(`[Bloc ${this._name}:${String(this._id)}] Handler for event '${eventConstructor.name}' already registered. It will be overwritten.`);
+        }
+        this.eventHandlers.set(eventConstructor, handler);
+    }
+    /**
+     * Dispatches an action/event to the Bloc.
+     * Events are queued and processed sequentially to prevent race conditions.
+     * @param action The action/event instance to be processed.
+     */
+    add = async (action) => {
+        // Transform event through plugins
+        let transformedAction = action;
+        try {
+            transformedAction = this._plugins.transformEvent(action);
+        }
+        catch (error) {
+            console.error('Error transforming event:', error);
+            // Continue with original event if transformation fails
+        }
+        // If event was cancelled by plugin, don't process it
+        if (transformedAction === null) {
+            return;
+        }
+        // Notify bloc plugins of event
+        try {
+            this._plugins.notifyEvent(transformedAction);
+        }
+        catch (error) {
+            console.error('Error notifying plugins of event:', error);
+        }
+        // Notify system plugins of event
+        Blac_1.Blac.instance.plugins.notifyEventAdded(this, transformedAction);
+        this._eventQueue.push(transformedAction);
+        if (!this._isProcessingEvent) {
+            await this._processEventQueue();
+        }
+    };
+    /**
+     * @internal
+     * Processes events from the queue sequentially
+     */
+    async _processEventQueue() {
+        if (this._isProcessingEvent) {
+            return;
+        }
+        this._isProcessingEvent = true;
+        try {
+            while (this._eventQueue.length > 0) {
+                const action = this._eventQueue.shift();
+                await this._processEvent(action);
+            }
+        }
+        finally {
+            this._isProcessingEvent = false;
+        }
+    }
+    /**
+     * @internal
+     * Processes a single event
+     */
+    async _processEvent(action) {
+        const eventConstructor = action.constructor;
+        const handler = this.eventHandlers.get(eventConstructor);
+        if (handler) {
+            const emit = (newState) => {
+                const previousState = this.state; // State just before this specific emission
+                this._pushState(newState, previousState, action);
+            };
+            try {
+                await handler(action, emit);
+            }
+            catch (error) {
+                const constructorName = action.constructor.name ||
+                    'UnnamedConstructor';
+                const errorContext = {
+                    blocName: this._name,
+                    blocId: String(this._id),
+                    eventType: constructorName,
+                    currentState: this.state,
+                    action: action,
+                    timestamp: new Date().toISOString(),
+                };
+                Blac_1.Blac.error(`[Bloc ${this._name}:${String(this._id)}] Error in event handler for '${constructorName}':`, error, 'Context:', errorContext);
+                // Notify plugins of the error
+                if (error instanceof Error) {
+                    try {
+                        this._plugins.notifyError(error, {
+                            phase: 'event-processing',
+                            operation: 'handler',
+                            metadata: { event: action },
+                        });
+                        Blac_1.Blac.instance.plugins.notifyError(error, this, {
+                            phase: 'event-processing',
+                            operation: 'handler',
+                            metadata: { event: action },
+                        });
+                    }
+                    catch (pluginError) {
+                        console.error('Error notifying plugins:', pluginError);
+                    }
+                }
+                if (error instanceof Error && error.name === 'CriticalError') {
+                    throw error;
+                }
+            }
+        }
+        else {
+            const constructorName = action.constructor.name || 'UnnamedConstructor';
+            Blac_1.Blac.warn(`[Bloc ${this._name}:${String(this._id)}] No handler registered for action type: '${constructorName}'.`, 'Registered handlers:', Array.from(this.eventHandlers.keys()).map((k) => k.name), 'Action was:', action);
+        }
+    }
+}
+exports.Bloc = Bloc;
+//# sourceMappingURL=Bloc.js.map

package/dist/Bloc.js.map

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

package/dist/BlocBase.d.ts

@@ -0,0 +1,110 @@
+import { BlocPlugin } from './plugins/types';
+import { BlocPluginRegistry } from './plugins/BlocPluginRegistry';
+import { SubscriptionManager } from './subscription/SubscriptionManager';
+import { BlocLifecycleState, StateTransitionResult } from './lifecycle/BlocLifecycle';
+import type { Blac } from './Blac';
+export type BlocInstanceId = string | number | undefined;
+/**
+ * Base class for both Blocs and Cubits using unified subscription model.
+ */
+export declare abstract class BlocBase<S> {
+    uid: string;
+    blacInstance?: Blac;
+    static isolated: boolean;
+    get isIsolated(): boolean;
+    static keepAlive: boolean;
+    get isKeepAlive(): boolean;
+    _isolated: boolean;
+    _id: BlocInstanceId;
+    _instanceRef?: string;
+    _name: string;
+    /**
+     * Unified subscription manager for all state notifications
+     */
+    _subscriptionManager: SubscriptionManager<S>;
+    _state: S;
+    private _lifecycleManager;
+    private _batchingManager;
+    _keepAlive: boolean;
+    lastUpdate?: number;
+    _plugins: BlocPluginRegistry<S, any>;
+    onDispose?: () => void;
+    /**
+     * Creates a new BlocBase instance with unified subscription management
+     */
+    constructor(initialState: S);
+    /**
+     * Returns the current state
+     */
+    get state(): S;
+    /**
+     * Subscribe to all state changes
+     */
+    subscribe(callback: (state: S) => void): () => void;
+    /**
+     * Subscribe with a selector for optimized updates
+     */
+    subscribeWithSelector<T>(selector: (state: S) => T, callback: (value: T) => void, equalityFn?: (a: T, b: T) => boolean): () => void;
+    /**
+     * Subscribe with React component reference for automatic cleanup
+     */
+    subscribeComponent(componentRef: WeakRef<object>, callback: () => void): () => void;
+    /**
+     * Get current subscription count
+     */
+    get subscriptionCount(): number;
+    /**
+     * Track property access for a subscription
+     */
+    trackAccess(subscriptionId: string, path: string, value?: unknown): void;
+    /**
+     * Emit a new state
+     */
+    protected emit(newState: S, action?: unknown): void;
+    /**
+     * Internal state push method used by Bloc
+     */
+    _pushState(newState: S, oldState: S, action?: unknown): void;
+    _batchUpdates(callback: () => void): void;
+    /**
+     * Add a plugin
+     */
+    addPlugin(plugin: BlocPlugin<S, any>): void;
+    /**
+     * Remove a plugin
+     */
+    removePlugin(plugin: BlocPlugin<S, any>): void;
+    /**
+     * Get all plugins
+     */
+    get plugins(): ReadonlyArray<BlocPlugin<S, any>>;
+    /**
+     * Disposal management
+     */
+    get isDisposed(): boolean;
+    /**
+     * Atomic state transition for disposal
+     */
+    _atomicStateTransition(expectedState: BlocLifecycleState, newState: BlocLifecycleState): StateTransitionResult;
+    /**
+     * Dispose the bloc and clean up resources
+     */
+    dispose(): Promise<void>;
+    /**
+     * Schedule disposal when no subscriptions remain
+     */
+    _scheduleDisposal(): void;
+    /**
+     * Set disposal handler
+     */
+    setDisposalHandler(handler: (bloc: BlocBase<unknown>) => void): void;
+    /**
+     * Check if disposal should be scheduled (called by subscription manager)
+     */
+    checkDisposal(): void;
+    /**
+     * Cancel disposal if bloc is in disposal_requested state
+     */
+    _cancelDisposalIfRequested(): void;
+}
+//# sourceMappingURL=BlocBase.d.ts.map

package/dist/BlocBase.d.ts.map

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

package/dist/BlocBase.js

@@ -0,0 +1,287 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BlocBase = void 0;
+const uuid_1 = require("./utils/uuid");
+const BlocPluginRegistry_1 = require("./plugins/BlocPluginRegistry");
+const SubscriptionManager_1 = require("./subscription/SubscriptionManager");
+const BlocLifecycle_1 = require("./lifecycle/BlocLifecycle");
+const BatchingManager_1 = require("./utils/BatchingManager");
+/**
+ * Base class for both Blocs and Cubits using unified subscription model.
+ */
+class BlocBase {
+    uid = (0, uuid_1.generateUUID)();
+    blacInstance;
+    static isolated = false;
+    get isIsolated() {
+        return this._isolated;
+    }
+    static keepAlive = false;
+    get isKeepAlive() {
+        return this._keepAlive;
+    }
+    _isolated = false;
+    _id;
+    _instanceRef;
+    _name;
+    /**
+     * Unified subscription manager for all state notifications
+     */
+    _subscriptionManager;
+    _state;
+    _lifecycleManager = new BlocLifecycle_1.BlocLifecycleManager();
+    _batchingManager = new BatchingManager_1.BatchingManager();
+    _keepAlive = false;
+    lastUpdate;
+    _plugins = new BlocPluginRegistry_1.BlocPluginRegistry();
+    onDispose;
+    /**
+     * Creates a new BlocBase instance with unified subscription management
+     */
+    constructor(initialState) {
+        this._state = initialState;
+        this._id = this.constructor.name;
+        this._name = this.constructor.name;
+        // Initialize unified subscription system
+        this._subscriptionManager = new SubscriptionManager_1.SubscriptionManager(this);
+        // Access static properties
+        const Constructor = this.constructor;
+        this._keepAlive =
+            typeof Constructor.keepAlive === 'boolean'
+                ? Constructor.keepAlive
+                : false;
+        this._isolated =
+            typeof Constructor.isolated === 'boolean' ? Constructor.isolated : false;
+        // Initialize plugin registry
+        this._plugins = new BlocPluginRegistry_1.BlocPluginRegistry();
+        // Register static plugins
+        if (Constructor.plugins && Array.isArray(Constructor.plugins)) {
+            for (const plugin of Constructor.plugins) {
+                this._plugins.add(plugin);
+            }
+        }
+        // Attach all plugins
+        this._plugins.attach(this);
+    }
+    /**
+     * Returns the current state
+     */
+    get state() {
+        if (this._lifecycleManager.isDisposed) {
+            return this._state; // Return last known state for disposed blocs
+        }
+        return this._state;
+    }
+    /**
+     * Subscribe to all state changes
+     */
+    subscribe(callback) {
+        return this._subscriptionManager.subscribe({
+            type: 'observer',
+            notify: (state) => callback(state),
+        });
+    }
+    /**
+     * Subscribe with a selector for optimized updates
+     */
+    subscribeWithSelector(selector, callback, equalityFn) {
+        return this._subscriptionManager.subscribe({
+            type: 'consumer',
+            selector: selector,
+            equalityFn: equalityFn,
+            notify: (value) => callback(value),
+        });
+    }
+    /**
+     * Subscribe with React component reference for automatic cleanup
+     */
+    subscribeComponent(componentRef, callback) {
+        return this._subscriptionManager.subscribe({
+            type: 'consumer',
+            weakRef: componentRef,
+            notify: callback,
+        });
+    }
+    /**
+     * Get current subscription count
+     */
+    get subscriptionCount() {
+        return this._subscriptionManager.size;
+    }
+    /**
+     * Track property access for a subscription
+     */
+    trackAccess(subscriptionId, path, value) {
+        this._subscriptionManager.trackAccess(subscriptionId, path, value);
+    }
+    /**
+     * Emit a new state
+     */
+    emit(newState, action) {
+        this._pushState(newState, this._state, action);
+    }
+    /**
+     * Internal state push method used by Bloc
+     */
+    _pushState(newState, oldState, action) {
+        // Validate state emission conditions
+        if (this._lifecycleManager.currentState !== BlocLifecycle_1.BlocLifecycleState.ACTIVE) {
+            this.blacInstance?.error(`[${this._name}:${this._id}] Attempted state update on ${this._lifecycleManager.currentState} bloc. Update ignored.`);
+            return;
+        }
+        if (newState === undefined) {
+            return; // Silent failure for undefined states
+        }
+        this._state = newState;
+        // Apply plugins
+        const transformedState = this._plugins.transformState(oldState, newState);
+        this._state = transformedState;
+        // Notify plugins of state change
+        this._plugins.notifyStateChange(oldState, transformedState);
+        // Notify system plugins of state change
+        this.blacInstance?.plugins.notifyStateChanged(this, oldState, transformedState);
+        // Handle batching
+        if (this._batchingManager.isCurrentlyBatching) {
+            this._batchingManager.addUpdate({
+                newState: transformedState,
+                oldState,
+                action,
+            });
+            return;
+        }
+        // Notify all subscriptions
+        this._subscriptionManager.notify(transformedState, oldState, action);
+        this.lastUpdate = Date.now();
+    }
+    _batchUpdates(callback) {
+        this._batchingManager.batchUpdates(callback, (finalUpdate) => {
+            this._subscriptionManager.notify(finalUpdate.newState, finalUpdate.oldState, finalUpdate.action);
+        });
+    }
+    /**
+     * Add a plugin
+     */
+    addPlugin(plugin) {
+        this._plugins.add(plugin);
+        // If plugins are already attached (bloc is active), attach the new plugin
+        if (this._plugins.attached && plugin.onAttach) {
+            try {
+                plugin.onAttach(this);
+            }
+            catch (error) {
+                console.error(`Plugin '${plugin.name}' error in onAttach:`, error);
+            }
+        }
+    }
+    /**
+     * Remove a plugin
+     */
+    removePlugin(plugin) {
+        this._plugins.remove(plugin.name);
+    }
+    /**
+     * Get all plugins
+     */
+    get plugins() {
+        return this._plugins.getAll();
+    }
+    /**
+     * Disposal management
+     */
+    get isDisposed() {
+        return this._lifecycleManager.isDisposed;
+    }
+    /**
+     * Atomic state transition for disposal
+     */
+    _atomicStateTransition(expectedState, newState) {
+        return this._lifecycleManager.atomicStateTransition(expectedState, newState);
+    }
+    /**
+     * Dispose the bloc and clean up resources
+     */
+    async dispose() {
+        const transitionResult = this._lifecycleManager.atomicStateTransition(BlocLifecycle_1.BlocLifecycleState.ACTIVE, BlocLifecycle_1.BlocLifecycleState.DISPOSING);
+        if (!transitionResult.success) {
+            if (this._lifecycleManager.currentState ===
+                BlocLifecycle_1.BlocLifecycleState.DISPOSAL_REQUESTED) {
+                this._lifecycleManager.atomicStateTransition(BlocLifecycle_1.BlocLifecycleState.DISPOSAL_REQUESTED, BlocLifecycle_1.BlocLifecycleState.DISPOSING);
+            }
+            else {
+                return;
+            }
+        }
+        try {
+            // Clear subscriptions
+            this._subscriptionManager.clear();
+            // Call disposal hook
+            if (this.onDispose) {
+                this.onDispose();
+            }
+            // Notify plugins of disposal
+            for (const plugin of this._plugins.getAll()) {
+                try {
+                    if ('onDispose' in plugin && typeof plugin.onDispose === 'function') {
+                        plugin.onDispose(this);
+                    }
+                }
+                catch (error) {
+                    console.error('Plugin disposal error:', error);
+                }
+            }
+            // Call disposal handler
+            const handler = this._lifecycleManager.getDisposalHandler();
+            if (handler) {
+                handler(this);
+            }
+        }
+        finally {
+            this._lifecycleManager.atomicStateTransition(BlocLifecycle_1.BlocLifecycleState.DISPOSING, BlocLifecycle_1.BlocLifecycleState.DISPOSED);
+        }
+    }
+    /**
+     * Schedule disposal when no subscriptions remain
+     */
+    _scheduleDisposal() {
+        const shouldDispose = this._subscriptionManager.size === 0 && !this._keepAlive;
+        if (!shouldDispose) {
+            return;
+        }
+        this._lifecycleManager.scheduleDisposal(16, () => this._subscriptionManager.size === 0 && !this._keepAlive, () => this.dispose());
+    }
+    /**
+     * Set disposal handler
+     */
+    setDisposalHandler(handler) {
+        this._lifecycleManager.setDisposalHandler(handler);
+    }
+    /**
+     * Check if disposal should be scheduled (called by subscription manager)
+     */
+    checkDisposal() {
+        if (this._subscriptionManager.size === 0 &&
+            !this._keepAlive &&
+            this._lifecycleManager.currentState === BlocLifecycle_1.BlocLifecycleState.ACTIVE) {
+            this._scheduleDisposal();
+        }
+    }
+    /**
+     * Cancel disposal if bloc is in disposal_requested state
+     */
+    _cancelDisposalIfRequested() {
+        this.blacInstance?.log(`[${this._name}:${this._id}] _cancelDisposalIfRequested called. Current state: ${this._lifecycleManager.currentState}`);
+        const success = this._lifecycleManager.cancelDisposal();
+        if (success) {
+            this.blacInstance?.log(`[${this._name}:${this._id}] Disposal cancelled - new subscription added`);
+        }
+        else if (this._lifecycleManager.currentState ===
+            BlocLifecycle_1.BlocLifecycleState.DISPOSAL_REQUESTED) {
+            this.blacInstance?.warn(`[${this._name}:${this._id}] Failed to cancel disposal. Current state: ${this._lifecycleManager.currentState}`);
+        }
+        else if (this._lifecycleManager.isDisposed) {
+            this.blacInstance?.error(`[${this._name}:${this._id}] Cannot cancel disposal - bloc is already disposed`);
+        }
+    }
+}
+exports.BlocBase = BlocBase;
+//# sourceMappingURL=BlocBase.js.map

package/dist/BlocBase.js.map

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

package/dist/Cubit.d.ts

@@ -0,0 +1,25 @@
+import { BlocBase } from './BlocBase';
+/**
+ * A Cubit is a simpler version of a Bloc that doesn't handle events.
+ * It manages state and provides methods to update it.
+ * @template S - The type of state this Cubit manages
+ */
+export declare abstract class Cubit<S> extends BlocBase<S> {
+    /**
+     * Updates the current state and notifies all observers of the change.
+     * If the new state is identical to the current state (using Object.is),
+     * no update will occur.
+     * @param state - The new state to set
+     */
+    emit(state: S): void;
+    /**
+     * Partially updates the current state by merging it with the provided state patch.
+     * This method is only applicable when the state is an object type.
+     *
+     * @param statePatch - A partial state object containing only the properties to update
+     * @param ignoreChangeCheck - If true, skips checking if the state has actually changed
+     * @throws {TypeError} If the state is not an object type
+     */
+    patch(statePatch: S extends object ? Partial<S> : S, ignoreChangeCheck?: boolean): void;
+}
+//# sourceMappingURL=Cubit.d.ts.map

package/dist/Cubit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Cubit.d.ts","sourceRoot":"","sources":["../src/Cubit.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC;;;;GAIG;AACH,8BAAsB,KAAK,CAAC,CAAC,CAAE,SAAQ,QAAQ,CAAC,CAAC,CAAC;IAChD;;;;;OAKG;IACH,IAAI,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI;IAUpB;;;;;;;OAOG;IACH,KAAK,CACH,UAAU,EAAE,CAAC,SAAS,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,EAC7C,iBAAiB,UAAQ,GACxB,IAAI;CA+BR"}