@blac/logging-plugin 2.0.20 → 2.0.21

package/README.md

@@ -19,7 +19,7 @@ pnpm add @blac/logging-plugin
 ## Usage
 
 ```ts
-import { getPluginManager } from '@blac/core';
+import { getPluginManager } from '@blac/core/plugins';
 import { LoggingPlugin } from '@blac/logging-plugin';
 
 getPluginManager().install(new LoggingPlugin(), {

package/dist/LoggingPlugin.d.cts

@@ -0,0 +1,27 @@
+import type { BlacPlugin, PathSet, PluginContext } from '@blac/core';
+import type { LoggingPluginConfig } from './types';
+export declare class LoggingPlugin implements BlacPlugin {
+    readonly name = "LoggingPlugin";
+    readonly version = "1.0.0";
+    private config;
+    private context?;
+    private simpleFormatter;
+    private groupedFormatter;
+    private instanceCountMonitor;
+    private lifecycleMonitor;
+    private stateChangeCount;
+    private stateChangeWindowStart;
+    private stateChangeLoggingDisabled;
+    constructor(config?: LoggingPluginConfig);
+    onInstall(ctx: PluginContext): void;
+    onUninstall(): void;
+    onCreated(ctx: PluginContext): void;
+    onStateChange<S extends object>(ctx: PluginContext, previousState: S, currentState: S, paths: PathSet): void;
+    onDestroyed(ctx: PluginContext): void;
+    logStats(): void;
+    private shouldLog;
+    private shouldLogLifecycle;
+    private shouldLogStateChanges;
+    private logWarning;
+}
+//# sourceMappingURL=LoggingPlugin.d.ts.map

package/dist/types.d.cts

@@ -0,0 +1,68 @@
+import type { StateContainer } from '@blac/core';
+export type LogLevel = 'minimal' | 'info' | 'debug' | 'verbose';
+export type LogFormat = 'simple' | 'grouped';
+export interface Logger {
+    log(...args: unknown[]): void;
+    warn(...args: unknown[]): void;
+    error(...args: unknown[]): void;
+    group?(label: string): void;
+    groupEnd?(): void;
+    groupCollapsed?(label: string): void;
+}
+export interface FilterContext {
+    instance: StateContainer<any>;
+    className: string;
+    instanceId: string;
+}
+export type FilterFn = (ctx: FilterContext) => boolean;
+export interface LoggingPluginConfig {
+    /** Log verbosity level (default: 'info') */
+    level?: LogLevel;
+    /** Output format (default: 'grouped') */
+    format?: LogFormat;
+    /** Custom logger implementation (default: console) */
+    logger?: Logger;
+    /** Filter which instances to log */
+    filter?: FilterFn;
+    /** Include class names to log (whitelist) */
+    include?: string[];
+    /** Exclude class names from logging (blacklist) */
+    exclude?: string[];
+    /** Log instance creation/disposal (default: true) */
+    logLifecycle?: boolean;
+    /** Log state changes (default: true) */
+    logStateChanges?: boolean;
+    /** Include callstack in state change logs (default: false) */
+    includeCallstack?: boolean;
+    /** Log changed path names in state change output (default: false) */
+    logPaths?: boolean;
+    /** Warn when instance count exceeds threshold (default: 50) */
+    instanceCountWarningThreshold?: number;
+    /** Warn on rapid init/dispose cycles (default: true) */
+    detectRapidLifecycles?: boolean;
+    /** Time window for rapid lifecycle detection in ms (default: 1000) */
+    rapidLifecycleWindowMs?: number;
+    /** Number of cycles in window to trigger warning (default: 5) */
+    rapidLifecycleThreshold?: number;
+    /** Log prefix (default: '[BlaC]') */
+    prefix?: string;
+}
+export interface ResolvedConfig {
+    level: LogLevel;
+    format: LogFormat;
+    logger: Logger;
+    filter: FilterFn | undefined;
+    include: string[] | undefined;
+    exclude: string[] | undefined;
+    logLifecycle: boolean;
+    logStateChanges: boolean;
+    includeCallstack: boolean;
+    logPaths: boolean;
+    instanceCountWarningThreshold: number;
+    detectRapidLifecycles: boolean;
+    rapidLifecycleWindowMs: number;
+    rapidLifecycleThreshold: number;
+    prefix: string;
+}
+export declare function resolveConfig(config?: LoggingPluginConfig): ResolvedConfig;
+//# sourceMappingURL=types.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blac/logging-plugin",
-  "version": "2.0.20",
+  "version": "2.0.21",
   "license": "MIT",
   "author": "Brendan Mullins <jsnanigans@gmail.com>",
   "description": "Logging and debugging plugin for BlaC state management",
@@ -46,18 +46,18 @@
     "devtools"
   ],
   "peerDependencies": {
-    "@blac/core": "^2.0.20"
+    "@blac/core": "^2.1.1"
   },
   "devDependencies": {
-    "publint": "^0.3.21",
+    "publint": "^0.3.24",
     "typescript": "^6.0.3",
-    "vite-plus": "^0.1.23",
-    "vitest": "npm:@voidzero-dev/vite-plus-test@latest",
-    "@blac/core": "2.0.20"
+    "vite-plus": "^0.1.24",
+    "vitest": "npm:@voidzero-dev/vite-plus-test@0.1.24",
+    "@blac/core": "2.1.1"
   },
   "scripts": {
     "dev": "vp pack --watch",
-    "build": "vp pack && tsc -p tsconfig.build.json && cp dist/index.d.ts dist/index.d.cts",
+    "build": "vp pack && tsc -p tsconfig.build.json && for f in dist/*.d.ts; do cp \"$f\" \"${f%.d.ts}.d.cts\"; done",
     "clean": "rm -rf dist",
     "format": "vp fmt \".\"",
     "format:check": "vp fmt \".\" --check",