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

package/dist/Blac.d.ts

@@ -1,246 +0,0 @@
-import { BlocBase, BlocInstanceId } from './BlocBase';
-import { BlocConstructor, BlocHookDependencyArrayFn, BlocState } from './types';
-import { SystemPluginRegistry } from './plugins/SystemPluginRegistry';
-/**
- * Configuration options for the Blac instance
- */
-export interface BlacConfig {
-    /**
-     * Whether to enable proxy dependency tracking for automatic re-render optimization.
-     * When false, state changes always cause re-renders unless dependencies are manually specified.
-     * Default: true
-     */
-    proxyDependencyTracking?: boolean;
-}
-export interface GetBlocOptions<B extends BlocBase<unknown>> {
-    id?: string;
-    selector?: BlocHookDependencyArrayFn<BlocState<B>>;
-    constructorParams?: ConstructorParameters<BlocConstructor<B>>[];
-    onMount?: (bloc: B) => void;
-    instanceRef?: string;
-    throwIfNotFound?: boolean;
-    /** Force creation of a new instance for isolated blocs, bypassing instance lookup */
-    forceNewInstance?: boolean;
-}
-/**
- * Interface for Blac instance management
- */
-export interface BlacInstanceManager {
-    getInstance(): Blac;
-    setInstance(instance: Blac): void;
-    resetInstance(): void;
-}
-/**
- * Sets a custom instance manager (useful for testing or advanced patterns)
- */
-export declare function setBlacInstanceManager(manager: BlacInstanceManager): void;
-/**
- * Main Blac class that manages the state management system.
- * Can work with singleton pattern or dependency injection.
- * Handles bloc lifecycle, and instance tracking.
- *
- * Key responsibilities:
- * - Managing bloc instances (creation, disposal, lookup)
- * - Handling isolated and non-isolated blocs
- * - Providing logging and debugging capabilities
- */
-export declare class Blac {
-    static get instance(): Blac;
-    /** Timestamp when the instance was created */
-    createdAt: number;
-    private errorManager;
-    static get getAllBlocs(): <B extends BlocConstructor<any>>(blocClass: B, options?: {
-        searchIsolated?: boolean;
-    }) => InstanceType<B>[];
-    /** Private static configuration */
-    private static _config;
-    /** Get current configuration */
-    static get config(): Readonly<BlacConfig>;
-    /**
-     * Set or update Blac configuration
-     * @param config - Partial configuration to merge with existing config
-     * @throws Error if configuration is invalid
-     */
-    static setConfig(config: Partial<BlacConfig>): void;
-    /** Map storing all registered bloc instances by their class name and ID */
-    blocInstanceMap: Map<string, BlocBase<unknown>>;
-    /** Map storing isolated bloc instances grouped by their constructor */
-    isolatedBlocMap: Map<BlocConstructor<any>, BlocBase<unknown>[]>;
-    /** Map for O(1) lookup of isolated blocs by UID */
-    isolatedBlocIndex: Map<string, BlocBase<unknown>>;
-    /** Map tracking UIDs to prevent memory leaks */
-    uidRegistry: Map<string, BlocBase<unknown>>;
-    /** Set of keep-alive blocs for controlled cleanup */
-    keepAliveBlocs: Set<BlocBase<unknown>>;
-    /** Flag to control whether changes should be posted to document */
-    postChangesToDocument: boolean;
-    /** System plugin registry */
-    readonly plugins: SystemPluginRegistry;
-    /**
-     * Creates a new Blac instance.
-     * @param options - Configuration options including singleton control
-     */
-    constructor(options?: {
-        __unsafe_ignore_singleton?: boolean;
-    });
-    /** Flag to enable/disable logging */
-    static enableLog: boolean;
-    static logLevel: 'warn' | 'log';
-    static logSpy: ((...args: unknown[]) => void) | null;
-    /**
-     * Logs messages to console when logging is enabled
-     * @param args - Arguments to log
-     */
-    log: (...args: unknown[]) => void;
-    static get log(): (...args: unknown[]) => void;
-    /**
-     * Gets the current Blac instance
-     * @returns The Blac instance
-     */
-    static getInstance(): Blac;
-    /**
-     * Logs a warning message
-     * @param message - Warning message
-     * @param args - Additional arguments
-     */
-    warn: (message: string, ...args: unknown[]) => void;
-    static get warn(): (message: string, ...args: unknown[]) => void;
-    /**
-     * Logs an error message
-     * @param message - Error message
-     * @param args - Additional arguments
-     */
-    error: (message: string, ...args: unknown[]) => void;
-    static get error(): (message: string, ...args: unknown[]) => void;
-    /**
-     * Resets the Blac instance to a new one, disposing non-keepAlive blocs
-     * from the old instance.
-     */
-    resetInstance: () => void;
-    static resetInstance: () => void;
-    /**
-     * Disposes of a bloc instance by removing it from the appropriate registry
-     * @param bloc - The bloc instance to dispose
-     */
-    disposeBloc: (bloc: BlocBase<unknown>) => void;
-    static get disposeBloc(): (bloc: BlocBase<unknown>) => void;
-    /**
-     * Creates a unique key for a bloc instance in the map based on the bloc class name and instance ID
-     * @param blocClassName - The name of the bloc class
-     * @param id - The instance ID
-     * @returns A unique key string in the format "className:id"
-     */
-    createBlocInstanceMapKey(blocClassName: string, id: BlocInstanceId): string;
-    /**
-     * Unregister a bloc instance from the main registry
-     * @param bloc - The bloc instance to unregister
-     */
-    unregisterBlocInstance(bloc: BlocBase<unknown>): void;
-    /**
-     * Registers a bloc instance in the main registry
-     * @param bloc - The bloc instance to register
-     */
-    registerBlocInstance(bloc: BlocBase<unknown>): void;
-    /**
-     * Finds a registered bloc instance by its class and ID
-     * @param blocClass - The bloc class to search for
-     * @param id - The instance ID
-     * @returns The found bloc instance or undefined if not found
-     */
-    findRegisteredBlocInstance<B extends BlocConstructor<any>>(blocClass: B, id: BlocInstanceId): InstanceType<B> | undefined;
-    /**
-     * Registers an isolated bloc instance in the isolated registry
-     * @param bloc - The isolated bloc instance to register
-     */
-    registerIsolatedBlocInstance(bloc: BlocBase<unknown>): void;
-    /**
-     * Unregister an isolated bloc instance from the isolated registry
-     * @param bloc - The isolated bloc instance to unregister
-     */
-    unregisterIsolatedBlocInstance(bloc: BlocBase<unknown>): void;
-    /**
-     * Finds an isolated bloc instance by its class and ID (O(n) lookup)
-     */
-    findIsolatedBlocInstance<B extends BlocConstructor<any>>(blocClass: B, id: BlocInstanceId): InstanceType<B> | undefined;
-    /**
-     * Finds an isolated bloc instance by UID (O(1) lookup)
-     */
-    findIsolatedBlocInstanceByUid<B extends BlocBase<unknown>>(uid: string): B | undefined;
-    /**
-     * Creates a new bloc instance and registers it in the appropriate registry
-     * @param blocClass - The bloc class to instantiate
-     * @param id - The instance ID
-     * @param props - Properties to pass to the bloc constructor
-     * @param instanceRef - Optional reference string for the instance
-     * @returns The newly created bloc instance
-     */
-    createNewBlocInstance<B extends BlocConstructor<BlocBase<any>>>(blocClass: B, id: BlocInstanceId, options?: GetBlocOptions<InstanceType<B>>): InstanceType<B>;
-    activateBloc: (bloc: BlocBase<unknown>) => void;
-    static get activateBloc(): (bloc: BlocBase<unknown>) => void;
-    /**
-     * Gets or creates a bloc instance based on the provided class and options.
-     * If a bloc with the given ID exists, it will be returned. Otherwise, a new instance will be created.
-     *
-     * @param blocClass - The bloc class to get or create
-     * @param options - Options including:
-     *   - id: The instance ID (defaults to class name if not provided)
-     *   - props: Properties to pass to the bloc constructor
-     *   - instanceRef: Optional reference string for the instance
-     * @returns The bloc instance
-     */
-    getBloc: <B extends BlocConstructor<BlocBase<any>>>(blocClass: B, options?: GetBlocOptions<InstanceType<B>>) => InstanceType<B>;
-    static get getBloc(): <B extends BlocConstructor<BlocBase<any>>>(blocClass: B, options?: GetBlocOptions<InstanceType<B>>) => InstanceType<B>;
-    /**
-     * Gets all instances of a specific bloc class
-     * @param blocClass - The bloc class to search for
-     * @param options - Options including:
-     *   - searchIsolated: Whether to search in isolated blocs (defaults to bloc's isolated property)
-     * @returns Array of matching bloc instances
-     */
-    getAllBlocs: <B extends BlocConstructor<any>>(blocClass: B, options?: {
-        searchIsolated?: boolean;
-    }) => InstanceType<B>[];
-    /**
-     * Disposes all keep-alive blocs of a specific type
-     * @param blocClass - The bloc class to dispose
-     */
-    disposeKeepAliveBlocs: <B extends BlocConstructor<any>>(blocClass?: B) => void;
-    static get disposeKeepAliveBlocs(): <B extends BlocConstructor<any>>(blocClass?: B | undefined) => void;
-    /**
-     * Disposes all blocs matching a pattern
-     * @param predicate - Function to test each bloc for disposal
-     */
-    disposeBlocs: (predicate: (bloc: BlocBase<unknown>) => boolean) => void;
-    static get disposeBlocs(): (predicate: (bloc: BlocBase<unknown>) => boolean) => void;
-    /**
-     * Gets memory usage statistics for debugging
-     */
-    getMemoryStats: () => {
-        totalBlocs: number;
-        registeredBlocs: number;
-        isolatedBlocs: number;
-        keepAliveBlocs: number;
-        isolatedBlocTypes: number;
-    };
-    static get getMemoryStats(): () => {
-        totalBlocs: number;
-        registeredBlocs: number;
-        isolatedBlocs: number;
-        keepAliveBlocs: number;
-        isolatedBlocTypes: number;
-    };
-    /**
-     * Validates subscription references and cleans up orphaned blocs
-     */
-    validateConsumers: () => void;
-    static get validateConsumers(): () => void;
-    /**
-     * Bootstrap the Blac instance and all plugins
-     */
-    bootstrap(): void;
-    /**
-     * Shutdown the Blac instance and all plugins
-     */
-    shutdown(): void;
-}
-//# sourceMappingURL=Blac.d.ts.map

package/dist/Blac.d.ts.map

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