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

package/dist/lifecycle/BlocLifecycle.js

@@ -0,0 +1,123 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BlocLifecycleManager = exports.BlocLifecycleState = void 0;
+/**
+ * Enum representing the lifecycle states of a Bloc instance
+ */
+var BlocLifecycleState;
+(function (BlocLifecycleState) {
+    BlocLifecycleState["ACTIVE"] = "active";
+    BlocLifecycleState["DISPOSAL_REQUESTED"] = "disposal_requested";
+    BlocLifecycleState["DISPOSING"] = "disposing";
+    BlocLifecycleState["DISPOSED"] = "disposed";
+})(BlocLifecycleState || (exports.BlocLifecycleState = BlocLifecycleState = {}));
+/**
+ * Manages the lifecycle state transitions for Bloc instances.
+ * Ensures atomic state transitions to prevent race conditions during disposal.
+ */
+class BlocLifecycleManager {
+    disposalState = BlocLifecycleState.ACTIVE;
+    disposalLock = false;
+    disposalTimer;
+    disposalHandler;
+    get currentState() {
+        return this.disposalState;
+    }
+    get isDisposed() {
+        return this.disposalState === BlocLifecycleState.DISPOSED;
+    }
+    /**
+     * Atomic state transition for disposal
+     */
+    atomicStateTransition(expectedState, newState) {
+        if (this.disposalLock) {
+            return {
+                success: false,
+                currentState: this.disposalState,
+                previousState: this.disposalState,
+            };
+        }
+        this.disposalLock = true;
+        try {
+            if (this.disposalState !== expectedState) {
+                return {
+                    success: false,
+                    currentState: this.disposalState,
+                    previousState: this.disposalState,
+                };
+            }
+            const previousState = this.disposalState;
+            this.disposalState = newState;
+            return {
+                success: true,
+                currentState: newState,
+                previousState,
+            };
+        }
+        finally {
+            this.disposalLock = false;
+        }
+    }
+    /**
+     * Schedule disposal after a delay
+     */
+    scheduleDisposal(delay, canDispose, onDispose) {
+        // Cancel any existing disposal timer
+        if (this.disposalTimer) {
+            clearTimeout(this.disposalTimer);
+            this.disposalTimer = undefined;
+        }
+        const transitionResult = this.atomicStateTransition(BlocLifecycleState.ACTIVE, BlocLifecycleState.DISPOSAL_REQUESTED);
+        if (!transitionResult.success) {
+            return;
+        }
+        this.disposalTimer = setTimeout(() => {
+            if (canDispose() &&
+                this.disposalState === BlocLifecycleState.DISPOSAL_REQUESTED) {
+                onDispose();
+            }
+            else {
+                this.atomicStateTransition(BlocLifecycleState.DISPOSAL_REQUESTED, BlocLifecycleState.ACTIVE);
+            }
+        }, delay);
+    }
+    /**
+     * Cancel disposal if in disposal requested state
+     */
+    cancelDisposal() {
+        if (this.disposalState === BlocLifecycleState.DISPOSAL_REQUESTED) {
+            // Cancel disposal timer
+            if (this.disposalTimer) {
+                clearTimeout(this.disposalTimer);
+                this.disposalTimer = undefined;
+            }
+            // Transition back to active state
+            const result = this.atomicStateTransition(BlocLifecycleState.DISPOSAL_REQUESTED, BlocLifecycleState.ACTIVE);
+            return result.success;
+        }
+        return false;
+    }
+    /**
+     * Set disposal handler
+     */
+    setDisposalHandler(handler) {
+        this.disposalHandler = handler;
+    }
+    /**
+     * Get disposal handler
+     */
+    getDisposalHandler() {
+        return this.disposalHandler;
+    }
+    /**
+     * Clear disposal timer
+     */
+    clearDisposalTimer() {
+        if (this.disposalTimer) {
+            clearTimeout(this.disposalTimer);
+            this.disposalTimer = undefined;
+        }
+    }
+}
+exports.BlocLifecycleManager = BlocLifecycleManager;
+//# sourceMappingURL=BlocLifecycle.js.map

package/dist/lifecycle/BlocLifecycle.js.map

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

package/dist/lifecycle/index.d.ts

@@ -0,0 +1,2 @@
+export * from './BlocLifecycle';
+//# sourceMappingURL=index.d.ts.map

package/dist/lifecycle/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/lifecycle/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC"}

package/dist/lifecycle/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./BlocLifecycle"), exports);
+//# sourceMappingURL=index.js.map

package/dist/lifecycle/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/lifecycle/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,kDAAgC"}

package/dist/plugins/BlocPluginRegistry.d.ts

@@ -0,0 +1,58 @@
+import { BlocPlugin, PluginRegistry, ErrorContext } from './types';
+/**
+ * Registry for bloc-specific plugins
+ */
+export declare class BlocPluginRegistry<TState, TEvent = never> implements PluginRegistry<BlocPlugin<TState, TEvent>> {
+    private plugins;
+    private executionOrder;
+    private attached;
+    /**
+     * Add a bloc plugin
+     */
+    add(plugin: BlocPlugin<TState, TEvent>): void;
+    /**
+     * Remove a bloc plugin
+     */
+    remove(pluginName: string): boolean;
+    /**
+     * Get a plugin by name
+     */
+    get(pluginName: string): BlocPlugin<TState, TEvent> | undefined;
+    /**
+     * Get all plugins in execution order
+     */
+    getAll(): ReadonlyArray<BlocPlugin<TState, TEvent>>;
+    /**
+     * Clear all plugins
+     */
+    clear(): void;
+    /**
+     * Attach all plugins to a bloc
+     */
+    attach(bloc: any): void;
+    /**
+     * Transform state through all plugins
+     */
+    transformState(previousState: TState, nextState: TState): TState;
+    /**
+     * Transform event through all plugins
+     */
+    transformEvent(event: TEvent): TEvent | null;
+    /**
+     * Notify plugins of state change
+     */
+    notifyStateChange(previousState: TState, currentState: TState): void;
+    /**
+     * Notify plugins of event
+     */
+    notifyEvent(event: TEvent): void;
+    /**
+     * Notify plugins of error
+     */
+    notifyError(error: Error, context: ErrorContext): void;
+    private validateCapabilities;
+    private canReadState;
+    private canTransformState;
+    private canInterceptEvents;
+}
+//# sourceMappingURL=BlocPluginRegistry.d.ts.map

package/dist/plugins/BlocPluginRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BlocPluginRegistry.d.ts","sourceRoot":"","sources":["../../src/plugins/BlocPluginRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAInE;;GAEG;AACH,qBAAa,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK,CACpD,YAAW,cAAc,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAErD,OAAO,CAAC,OAAO,CAAiD;IAChE,OAAO,CAAC,cAAc,CAAgB;IACtC,OAAO,CAAC,QAAQ,CAAS;IAEzB;;OAEG;IACH,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAc7C;;OAEG;IACH,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAoBnC;;OAEG;IACH,GAAG,CAAC,UAAU,EAAE,MAAM,GAAG,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS;IAI/D;;OAEG;IACH,MAAM,IAAI,aAAa,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAInD;;OAEG;IACH,KAAK,IAAI,IAAI;IAkBb;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,GAAG,GAAG,IAAI;IAoBvB;;OAEG;IACH,cAAc,CAAC,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM;IAuBhE;;OAEG;IACH,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAsB5C;;OAEG;IACH,iBAAiB,CAAC,aAAa,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI;IAepE;;OAEG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAYhC;;OAEG;IACH,WAAW,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,YAAY,GAAG,IAAI;IAYtD,OAAO,CAAC,oBAAoB;IAiB5B,OAAO,CAAC,YAAY;IAIpB,OAAO,CAAC,iBAAiB;IAIzB,OAAO,CAAC,kBAAkB;CAG3B"}

package/dist/plugins/BlocPluginRegistry.js

@@ -0,0 +1,201 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BlocPluginRegistry = void 0;
+const handleError_1 = require("../errors/handleError");
+const BlacError_1 = require("../errors/BlacError");
+/**
+ * Registry for bloc-specific plugins
+ */
+class BlocPluginRegistry {
+    plugins = new Map();
+    executionOrder = [];
+    attached = false;
+    /**
+     * Add a bloc plugin
+     */
+    add(plugin) {
+        if (this.plugins.has(plugin.name)) {
+            throw new Error(`Plugin '${plugin.name}' is already registered`);
+        }
+        // Validate capabilities
+        if (plugin.capabilities) {
+            this.validateCapabilities(plugin);
+        }
+        this.plugins.set(plugin.name, plugin);
+        this.executionOrder.push(plugin.name);
+    }
+    /**
+     * Remove a bloc plugin
+     */
+    remove(pluginName) {
+        const plugin = this.plugins.get(pluginName);
+        if (!plugin)
+            return false;
+        // Call onDetach if attached
+        if (this.attached && plugin.onDetach) {
+            handleError_1.handleError.wrap(() => plugin.onDetach(), BlacError_1.ErrorCategory.PLUGIN, {
+                pluginName,
+                operation: 'onDetach',
+            });
+        }
+        this.plugins.delete(pluginName);
+        this.executionOrder = this.executionOrder.filter((name) => name !== pluginName);
+        return true;
+    }
+    /**
+     * Get a plugin by name
+     */
+    get(pluginName) {
+        return this.plugins.get(pluginName);
+    }
+    /**
+     * Get all plugins in execution order
+     */
+    getAll() {
+        return this.executionOrder.map((name) => this.plugins.get(name));
+    }
+    /**
+     * Clear all plugins
+     */
+    clear() {
+        // Detach all plugins first
+        if (this.attached) {
+            for (const plugin of this.getAll()) {
+                if (plugin.onDetach) {
+                    handleError_1.handleError.wrap(() => plugin.onDetach(), BlacError_1.ErrorCategory.PLUGIN, {
+                        pluginName: plugin.name,
+                        operation: 'onDetach',
+                    });
+                }
+            }
+        }
+        this.plugins.clear();
+        this.executionOrder = [];
+        this.attached = false;
+    }
+    /**
+     * Attach all plugins to a bloc
+     */
+    attach(bloc) {
+        if (this.attached) {
+            throw new Error('Plugins are already attached');
+        }
+        for (const plugin of this.getAll()) {
+            if (plugin.onAttach) {
+                try {
+                    plugin.onAttach(bloc);
+                }
+                catch (error) {
+                    console.error(`Plugin '${plugin.name}' error in onAttach:`, error);
+                    // Remove failing plugin
+                    this.remove(plugin.name);
+                }
+            }
+        }
+        this.attached = true;
+    }
+    /**
+     * Transform state through all plugins
+     */
+    transformState(previousState, nextState) {
+        let transformedState = nextState;
+        for (const plugin of this.getAll()) {
+            if (plugin.transformState && this.canTransformState(plugin)) {
+                try {
+                    transformedState = plugin.transformState(previousState, transformedState);
+                }
+                catch (error) {
+                    console.error(`Plugin '${plugin.name}' error in transformState:`, error);
+                    // Continue with untransformed state
+                }
+            }
+        }
+        return transformedState;
+    }
+    /**
+     * Transform event through all plugins
+     */
+    transformEvent(event) {
+        let transformedEvent = event;
+        for (const plugin of this.getAll()) {
+            if (transformedEvent === null)
+                break;
+            if (plugin.transformEvent && this.canInterceptEvents(plugin)) {
+                try {
+                    transformedEvent = plugin.transformEvent(transformedEvent);
+                }
+                catch (error) {
+                    console.error(`Plugin '${plugin.name}' error in transformEvent:`, error);
+                    // Continue with untransformed event
+                }
+            }
+        }
+        return transformedEvent;
+    }
+    /**
+     * Notify plugins of state change
+     */
+    notifyStateChange(previousState, currentState) {
+        for (const plugin of this.getAll()) {
+            if (plugin.onStateChange && this.canReadState(plugin)) {
+                try {
+                    plugin.onStateChange(previousState, currentState);
+                }
+                catch (error) {
+                    console.error(`Plugin '${plugin.name}' error in onStateChange:`, error);
+                }
+            }
+        }
+    }
+    /**
+     * Notify plugins of event
+     */
+    notifyEvent(event) {
+        for (const plugin of this.getAll()) {
+            if (plugin.onEvent && this.canReadState(plugin)) {
+                try {
+                    plugin.onEvent(event);
+                }
+                catch (error) {
+                    console.error(`Plugin '${plugin.name}' error in onEvent:`, error);
+                }
+            }
+        }
+    }
+    /**
+     * Notify plugins of error
+     */
+    notifyError(error, context) {
+        for (const plugin of this.getAll()) {
+            if (plugin.onError) {
+                try {
+                    plugin.onError(error, context);
+                }
+                catch (hookError) {
+                    console.error(`Plugin '${plugin.name}' error in onError:`, hookError);
+                }
+            }
+        }
+    }
+    validateCapabilities(plugin) {
+        const caps = plugin.capabilities;
+        // Validate logical constraints
+        if (caps.transformState && !caps.readState) {
+            throw new Error(`Plugin '${plugin.name}': transformState requires readState capability`);
+        }
+        if (caps.interceptEvents && !caps.readState) {
+            throw new Error(`Plugin '${plugin.name}': interceptEvents requires readState capability`);
+        }
+    }
+    canReadState(plugin) {
+        return !plugin.capabilities || plugin.capabilities.readState !== false;
+    }
+    canTransformState(plugin) {
+        return !plugin.capabilities || plugin.capabilities.transformState === true;
+    }
+    canInterceptEvents(plugin) {
+        return !plugin.capabilities || plugin.capabilities.interceptEvents === true;
+    }
+}
+exports.BlocPluginRegistry = BlocPluginRegistry;
+//# sourceMappingURL=BlocPluginRegistry.js.map

package/dist/plugins/BlocPluginRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BlocPluginRegistry.js","sourceRoot":"","sources":["../../src/plugins/BlocPluginRegistry.ts"],"names":[],"mappings":";;;AACA,uDAAoD;AACpD,mDAAoD;AAEpD;;GAEG;AACH,MAAa,kBAAkB;IAGrB,OAAO,GAAG,IAAI,GAAG,EAAsC,CAAC;IACxD,cAAc,GAAa,EAAE,CAAC;IAC9B,QAAQ,GAAG,KAAK,CAAC;IAEzB;;OAEG;IACH,GAAG,CAAC,MAAkC;QACpC,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;YAClC,MAAM,IAAI,KAAK,CAAC,WAAW,MAAM,CAAC,IAAI,yBAAyB,CAAC,CAAC;QACnE,CAAC;QAED,wBAAwB;QACxB,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC;YACxB,IAAI,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAC;QACpC,CAAC;QAED,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACtC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACxC,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,UAAkB;QACvB,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAC5C,IAAI,CAAC,MAAM;YAAE,OAAO,KAAK,CAAC;QAE1B,4BAA4B;QAC5B,IAAI,IAAI,CAAC,QAAQ,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;YACrC,yBAAW,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,QAAS,EAAE,EAAE,yBAAa,CAAC,MAAM,EAAE;gBAC/D,UAAU;gBACV,SAAS,EAAE,UAAU;aACtB,CAAC,CAAC;QACL,CAAC;QAED,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QAChC,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,cAAc,CAAC,MAAM,CAC9C,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,UAAU,CAC9B,CAAC;QAEF,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,UAAkB;QACpB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IACtC,CAAC;IAED;;OAEG;IACH,MAAM;QACJ,OAAO,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAE,CAAC,CAAC;IACpE,CAAC;IAED;;OAEG;IACH,KAAK;QACH,2BAA2B;QAC3B,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;gBACnC,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;oBACpB,yBAAW,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,QAAS,EAAE,EAAE,yBAAa,CAAC,MAAM,EAAE;wBAC/D,UAAU,EAAE,MAAM,CAAC,IAAI;wBACvB,SAAS,EAAE,UAAU;qBACtB,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC;QAED,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACrB,IAAI,CAAC,cAAc,GAAG,EAAE,CAAC;QACzB,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;IACxB,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,IAAS;QACd,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;QAClD,CAAC;QAED,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;YACnC,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;gBACpB,IAAI,CAAC;oBACH,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;gBACxB,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,OAAO,CAAC,KAAK,CAAC,WAAW,MAAM,CAAC,IAAI,sBAAsB,EAAE,KAAK,CAAC,CAAC;oBACnE,wBAAwB;oBACxB,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;gBAC3B,CAAC;YACH,CAAC;QACH,CAAC;QAED,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;IACvB,CAAC;IAED;;OAEG;IACH,cAAc,CAAC,aAAqB,EAAE,SAAiB;QACrD,IAAI,gBAAgB,GAAG,SAAS,CAAC;QAEjC,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;YACnC,IAAI,MAAM,CAAC,cAAc,IAAI,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC5D,IAAI,CAAC;oBACH,gBAAgB,GAAG,MAAM,CAAC,cAAc,CACtC,aAAa,EACb,gBAAgB,CACjB,CAAC;gBACJ,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,OAAO,CAAC,KAAK,CACX,WAAW,MAAM,CAAC,IAAI,4BAA4B,EAClD,KAAK,CACN,CAAC;oBACF,oCAAoC;gBACtC,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO,gBAAgB,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,cAAc,CAAC,KAAa;QAC1B,IAAI,gBAAgB,GAAkB,KAAK,CAAC;QAE5C,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;YACnC,IAAI,gBAAgB,KAAK,IAAI;gBAAE,MAAM;YAErC,IAAI,MAAM,CAAC,cAAc,IAAI,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC7D,IAAI,CAAC;oBACH,gBAAgB,GAAG,MAAM,CAAC,cAAc,CAAC,gBAAgB,CAAC,CAAC;gBAC7D,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,OAAO,CAAC,KAAK,CACX,WAAW,MAAM,CAAC,IAAI,4BAA4B,EAClD,KAAK,CACN,CAAC;oBACF,oCAAoC;gBACtC,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO,gBAAgB,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,iBAAiB,CAAC,aAAqB,EAAE,YAAoB;QAC3D,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;YACnC,IAAI,MAAM,CAAC,aAAa,IAAI,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC;gBACtD,IAAI,CAAC;oBACH,MAAM,CAAC,aAAa,CAAC,aAAa,EAAE,YAAY,CAAC,CAAC;gBACpD,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,OAAO,CAAC,KAAK,CACX,WAAW,MAAM,CAAC,IAAI,2BAA2B,EACjD,KAAK,CACN,CAAC;gBACJ,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,KAAa;QACvB,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;YACnC,IAAI,MAAM,CAAC,OAAO,IAAI,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC;gBAChD,IAAI,CAAC;oBACH,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;gBACxB,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,OAAO,CAAC,KAAK,CAAC,WAAW,MAAM,CAAC,IAAI,qBAAqB,EAAE,KAAK,CAAC,CAAC;gBACpE,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,KAAY,EAAE,OAAqB;QAC7C,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;YACnC,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;gBACnB,IAAI,CAAC;oBACH,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;gBACjC,CAAC;gBAAC,OAAO,SAAS,EAAE,CAAC;oBACnB,OAAO,CAAC,KAAK,CAAC,WAAW,MAAM,CAAC,IAAI,qBAAqB,EAAE,SAAS,CAAC,CAAC;gBACxE,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAEO,oBAAoB,CAAC,MAAkC;QAC7D,MAAM,IAAI,GAAG,MAAM,CAAC,YAAa,CAAC;QAElC,+BAA+B;QAC/B,IAAI,IAAI,CAAC,cAAc,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YAC3C,MAAM,IAAI,KAAK,CACb,WAAW,MAAM,CAAC,IAAI,iDAAiD,CACxE,CAAC;QACJ,CAAC;QAED,IAAI,IAAI,CAAC,eAAe,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YAC5C,MAAM,IAAI,KAAK,CACb,WAAW,MAAM,CAAC,IAAI,kDAAkD,CACzE,CAAC;QACJ,CAAC;IACH,CAAC;IAEO,YAAY,CAAC,MAAkC;QACrD,OAAO,CAAC,MAAM,CAAC,YAAY,IAAI,MAAM,CAAC,YAAY,CAAC,SAAS,KAAK,KAAK,CAAC;IACzE,CAAC;IAEO,iBAAiB,CAAC,MAAkC;QAC1D,OAAO,CAAC,MAAM,CAAC,YAAY,IAAI,MAAM,CAAC,YAAY,CAAC,cAAc,KAAK,IAAI,CAAC;IAC7E,CAAC;IAEO,kBAAkB,CAAC,MAAkC;QAC3D,OAAO,CAAC,MAAM,CAAC,YAAY,IAAI,MAAM,CAAC,YAAY,CAAC,eAAe,KAAK,IAAI,CAAC;IAC9E,CAAC;CACF;AAxOD,gDAwOC"}

package/dist/plugins/SystemPluginRegistry.d.ts

@@ -0,0 +1,79 @@
+import { BlacPlugin, PluginRegistry, PluginMetrics, ErrorContext, AdapterMetadata } from './types';
+import { BlocBase } from '../BlocBase';
+import { Bloc } from '../Bloc';
+/**
+ * Registry for system-wide plugins
+ */
+export declare class SystemPluginRegistry implements PluginRegistry<BlacPlugin> {
+    private plugins;
+    private metrics;
+    private executionOrder;
+    /**
+     * Add a system plugin
+     */
+    add(plugin: BlacPlugin): void;
+    /**
+     * Remove a system plugin
+     */
+    remove(pluginName: string): boolean;
+    /**
+     * Get a plugin by name
+     */
+    get(pluginName: string): BlacPlugin | undefined;
+    /**
+     * Get all plugins in execution order
+     */
+    getAll(): ReadonlyArray<BlacPlugin>;
+    /**
+     * Clear all plugins
+     */
+    clear(): void;
+    /**
+     * Execute a hook on all plugins
+     */
+    executeHook(hookName: keyof BlacPlugin, args: unknown[], errorHandler?: (error: Error, plugin: BlacPlugin) => void): void;
+    /**
+     * Bootstrap all plugins
+     */
+    bootstrap(): void;
+    /**
+     * Shutdown all plugins
+     */
+    shutdown(): void;
+    /**
+     * Notify plugins of bloc creation
+     */
+    notifyBlocCreated(bloc: BlocBase<any>): void;
+    /**
+     * Notify plugins of bloc disposal
+     */
+    notifyBlocDisposed(bloc: BlocBase<any>): void;
+    /**
+     * Notify plugins of state change
+     */
+    notifyStateChanged(bloc: BlocBase<any>, previousState: any, currentState: any): void;
+    /**
+     * Notify plugins of event addition
+     */
+    notifyEventAdded(bloc: Bloc<any, any>, event: any): void;
+    /**
+     * Notify plugins of errors
+     */
+    notifyError(error: Error, bloc: BlocBase<unknown>, context: ErrorContext): void;
+    /**
+     * Notify plugins of adapter lifecycle events
+     */
+    notifyAdapterCreated(adapter: any, metadata: AdapterMetadata): void;
+    notifyAdapterMount(adapter: any, metadata: AdapterMetadata): void;
+    notifyAdapterUnmount(adapter: any, metadata: AdapterMetadata): void;
+    notifyAdapterRender(adapter: any, metadata: AdapterMetadata): void;
+    notifyAdapterDisposed(adapter: any, metadata: AdapterMetadata): void;
+    /**
+     * Get metrics for a plugin
+     */
+    getMetrics(pluginName: string): Map<string, PluginMetrics> | undefined;
+    private initializeMetrics;
+    private recordSuccess;
+    private recordError;
+}
+//# sourceMappingURL=SystemPluginRegistry.d.ts.map

package/dist/plugins/SystemPluginRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SystemPluginRegistry.d.ts","sourceRoot":"","sources":["../../src/plugins/SystemPluginRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,cAAc,EACd,aAAa,EACb,YAAY,EACZ,eAAe,EAChB,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAE/B;;GAEG;AACH,qBAAa,oBAAqB,YAAW,cAAc,CAAC,UAAU,CAAC;IACrE,OAAO,CAAC,OAAO,CAAiC;IAChD,OAAO,CAAC,OAAO,CAAiD;IAChE,OAAO,CAAC,cAAc,CAAgB;IAEtC;;OAEG;IACH,GAAG,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI;IAU7B;;OAEG;IACH,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAanC;;OAEG;IACH,GAAG,CAAC,UAAU,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAI/C;;OAEG;IACH,MAAM,IAAI,aAAa,CAAC,UAAU,CAAC;IAInC;;OAEG;IACH,KAAK,IAAI,IAAI;IAMb;;OAEG;IACH,WAAW,CACT,QAAQ,EAAE,MAAM,UAAU,EAC1B,IAAI,EAAE,OAAO,EAAE,EACf,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,KAAK,IAAI,GACxD,IAAI;IA4BP;;OAEG;IACH,SAAS,IAAI,IAAI;IAKjB;;OAEG;IACH,QAAQ,IAAI,IAAI;IAKhB;;OAEG;IACH,iBAAiB,CAAC,IAAI,EAAE,QAAQ,CAAC,GAAG,CAAC,GAAG,IAAI;IAI5C;;OAEG;IACH,kBAAkB,CAAC,IAAI,EAAE,QAAQ,CAAC,GAAG,CAAC,GAAG,IAAI;IAI7C;;OAEG;IACH,kBAAkB,CAChB,IAAI,EAAE,QAAQ,CAAC,GAAG,CAAC,EACnB,aAAa,EAAE,GAAG,EAClB,YAAY,EAAE,GAAG,GAChB,IAAI;IAIP;;OAEG;IACH,gBAAgB,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,KAAK,EAAE,GAAG,GAAG,IAAI;IAIxD;;OAEG;IACH,WAAW,CACT,KAAK,EAAE,KAAK,EACZ,IAAI,EAAE,QAAQ,CAAC,OAAO,CAAC,EACvB,OAAO,EAAE,YAAY,GACpB,IAAI;IAOP;;OAEG;IACH,oBAAoB,CAAC,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,eAAe,GAAG,IAAI;IAInE,kBAAkB,CAAC,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,eAAe,GAAG,IAAI;IAIjE,oBAAoB,CAAC,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,eAAe,GAAG,IAAI;IAInE,mBAAmB,CAAC,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,eAAe,GAAG,IAAI;IAIlE,qBAAqB,CAAC,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,eAAe,GAAG,IAAI;IAIpE;;OAEG;IACH,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,GAAG,SAAS;IAItE,OAAO,CAAC,iBAAiB;IAIzB,OAAO,CAAC,aAAa;IAsBrB,OAAO,CAAC,WAAW;CAkBpB"}