@real-router/logger-plugin 0.0.1

package/LICENSE

@@ -0,0 +1,22 @@
+The MIT License (MIT)
+
+Copyright (c) 2025 Oleg Ivanov
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

package/README.md

@@ -0,0 +1,227 @@
+# @real-router/logger-plugin
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.9-blue.svg)](https://www.typescriptlang.org/)
+
+A plugin for logging router events to the console. Provides transition timing display, parameter diff tracking, Performance API integration, and log grouping.
+
+## Installation
+
+```bash
+npm install @real-router/logger-plugin
+# or
+pnpm add @real-router/logger-plugin
+# or
+yarn add @real-router/logger-plugin
+# or
+bun add @real-router/logger-plugin
+```
+
+## Quick Start
+
+```typescript
+import { createRouter } from "@real-router/core";
+import { loggerPlugin } from "@real-router/logger-plugin";
+
+const router = createRouter(routes);
+
+// Use with default settings
+router.usePlugin(loggerPlugin);
+
+router.start();
+```
+
+**Console output:**
+
+```
+Router started
+▼ Router transition
+  Transition: home → users (1.23ms)
+  Transition success (1.23ms)
+```
+
+**Fast transitions (<0.1ms) display in microseconds:**
+
+```
+Transition success (27.29μs)
+```
+
+## API
+
+### `loggerPlugin`
+
+Ready-to-use plugin instance with default settings.
+
+```typescript
+import { loggerPlugin } from "@real-router/logger-plugin";
+
+router.usePlugin(loggerPlugin);
+```
+
+### `loggerPluginFactory()`
+
+Factory for creating a new plugin instance.
+
+```typescript
+import { loggerPluginFactory } from "@real-router/logger-plugin";
+
+router.usePlugin(loggerPluginFactory());
+```
+
+## Default Configuration
+
+The plugin uses the following default configuration:
+
+```typescript
+interface LoggerPluginConfig {
+  level: "all" | "transitions" | "errors" | "none";  // default: "all"
+  showTiming: boolean;           // default: true
+  showParamsDiff: boolean;       // default: true
+  usePerformanceMarks: boolean;  // default: false
+  context: string;               // default: "real-router-logger-plugin"
+}
+```
+
+### `level`
+
+Event logging level.
+
+- `'all'` **(default)** - logs all events (router start/stop + transitions)
+- `'transitions'` - only transition events (start/success/cancel/error)
+- `'errors'` - only transition errors
+- `'none'` - disables all logs
+
+### `showTiming`
+
+Display transition execution time with adaptive units.
+
+- `true` **(default)** - show timing (μs for fast transitions <0.1ms, ms otherwise)
+- `false` - hide timing
+
+**Output examples:**
+
+```
+Transition success (15ms)      // normal timing
+Transition success (27.29μs)   // fast transitions
+```
+
+### `showParamsDiff`
+
+Show differences in route parameters when navigating within the same route.
+
+- `true` **(default)** - show changed, added, and removed parameters
+- `false` - don't show parameter changes
+
+**Example output:**
+
+```
+▼ Router transition
+  Transition: users.view → users.view
+  Changed: { id: "123" → "456" }, Added: {"sort":"name"}
+  Transition success (2.15ms)
+```
+
+**Diff types displayed:**
+
+- **Changed** - parameters with different values
+- **Added** - new parameters in target state
+- **Removed** - parameters present in source but not in target
+
+**When diff is shown:**
+
+- ✅ Only when navigating within the same route (e.g., `users.view` → `users.view`)
+- ✅ Only when parameters actually changed
+- ❌ Not shown when navigating between different routes
+- ❌ Not shown when parameters are identical
+
+### `context`
+
+Context name for logs. Useful when working with multiple routers.
+
+- **Default:** `'logger-plugin'`
+
+**Example output:**
+
+```
+[logger-plugin] Transition: dashboard → users
+```
+
+## Logged Events
+
+### Router Lifecycle
+
+**`onStart`** - called when router starts
+
+```
+Router started
+```
+
+**`onStop`** - called when router stops
+
+```
+Router stopped
+```
+
+### Transition Events
+
+**`onTransitionStart`** - transition begins
+
+```
+▼ Router transition
+  Transition: home → users
+```
+
+**`onTransitionSuccess`** - transition completed successfully
+
+```
+  Transition success (24ms)
+```
+
+**`onTransitionCancel`** - transition cancelled
+
+```
+  Transition cancelled (12ms)
+```
+
+**`onTransitionError`** - transition error
+
+```
+  Transition error: ROUTE_NOT_FOUND (8ms)
+```
+
+## Log Grouping
+
+Transition events are automatically grouped in the console for better readability:
+
+```
+▼ Router transition
+  Transition: users → users.view
+  [middleware logs...]
+  [guard logs...]
+  Transition success (45ms)
+```
+
+This helps organize logs when working with complex transitions, middleware, and guards.
+
+## TypeScript
+
+The plugin is fully typed:
+
+```typescript
+import {
+  loggerPlugin,
+  loggerPluginFactory,
+  type LoggerPluginConfig,
+  type LogLevel,
+} from "@real-router/logger-plugin";
+```
+
+## Related Packages
+
+- [@real-router/core](https://www.npmjs.com/package/@real-router/core) — Core router
+- [@real-router/react](https://www.npmjs.com/package/@real-router/react) — React integration
+- [@real-router/browser-plugin](https://www.npmjs.com/package/@real-router/browser-plugin) — Browser history
+
+## License
+
+MIT © [Oleg Ivanov](https://github.com/greydragon888)

package/dist/cjs/index.d.ts

@@ -0,0 +1,71 @@
+import { PluginFactory } from '@real-router/core';
+
+/**
+ * Creates a logger plugin for real-router.
+ *
+ * Configuration is managed through the logger singleton.
+ *
+ * @returns Plugin factory function for real-router
+ *
+ * @example
+ * ```ts
+ * import { loggerPluginFactory } from "@real-router/logger-plugin";
+ *
+ * router.usePlugin(loggerPluginFactory());
+ * ```
+ *
+ * @example
+ * ```ts
+ * // Use with default configuration
+ * router.usePlugin(loggerPluginFactory());
+ * ```
+ */
+declare function loggerPluginFactory(): PluginFactory;
+/**
+ * Default logger plugin instance with standard configuration.
+ * Provided for backward compatibility with existing code.
+ *
+ * @example
+ * // Use default configuration
+ * router.usePlugin(loggerPlugin);
+ */
+declare const loggerPlugin: PluginFactory;
+
+/**
+ * Logging level for router events.
+ * Controls which events are logged to the console.
+ */
+type LogLevel = "all" | "transitions" | "errors" | "none";
+/**
+ * Configuration options for the logger plugin.
+ */
+interface LoggerPluginConfig {
+    /**
+     * Logging level - controls what router events to log.
+     *
+     * - 'all': Log all router events (default)
+     * - 'transitions': Log only transition-related events
+     * - 'errors': Log only transition errors
+     * - 'none': Disable all logging
+     *
+     * @default 'all'
+     */
+    level?: LogLevel;
+    /**
+     * Show diff of changed route parameters between transitions.
+     * Only applies when navigating within the same route.
+     * Helps identify which parameters changed during navigation.
+     *
+     * @default false
+     */
+    showParamsDiff?: boolean;
+    /**
+     * Custom context name for logger.
+     * Useful when running multiple routers.
+     *
+     * @default 'logger-plugin'
+     */
+    context?: string;
+}
+
+export { type LogLevel, type LoggerPluginConfig, loggerPlugin, loggerPluginFactory };

package/dist/cjs/index.js

@@ -0,0 +1 @@
+var o={context:"logger-plugin"},n=o=>o?.name??"(none)";function e(){return()=>{const e=o,t=(o=>{let n=!1;return{open(e){o&&!n&&(console.group(e),n=!0)},close(){o&&n&&(console.groupEnd(),n=!1)},isOpen:()=>n}})("undefined"!=typeof console&&"function"==typeof console.group&&"function"==typeof console.groupEnd);return{onStart(){console.log(`[${e.context}] Router started`)},onStop(){t.close(),console.log(`[${e.context}] Router stopped`)},onTransitionStart(o,r){t.open("Router transition");const s=n(r),c=n(o);console.log(`[${e.context}] Transition: ${s} → ${c}`,{from:r,to:o}),((o,n)=>{if(!n)return;if(o.name!==n.name)return;const t=((o,n)=>{const e={},t={},r={};let s=!1;for(const t in o)t in n?o[t]!==n[t]&&(e[t]={from:o[t],to:n[t]},s=!0):(r[t]=o[t],s=!0);for(const e in n)e in o||(t[e]=n[e],s=!0);return s?{changed:e,added:t,removed:r}:null})(n.params,o.params);t&&((o,n)=>{const e=[],t=Object.entries(o.changed);if(t.length>0){const o=[];for(const[n,{from:e,to:r}]of t)o.push(`${n}: ${JSON.stringify(e)} → ${JSON.stringify(r)}`);e.push(`Changed: { ${o.join(", ")} }`)}Object.entries(o.added).length>0&&e.push(`Added: ${JSON.stringify(o.added)}`),Object.entries(o.removed).length>0&&e.push(`Removed: ${JSON.stringify(o.removed)}`),console.log(`[${n}]  ${e.join(", ")}`)})(t,e.context)})(o,r)},onTransitionSuccess(o,n){console.log(`[${e.context}] Transition success`,{to:o,from:n}),t.close()},onTransitionCancel(o,n){console.warn(`[${e.context}] Transition cancelled`,{to:o,from:n}),t.close()},onTransitionError(o,n,r){console.error(`[${e.context}] Transition error: ${r.code}`,{error:r,stack:r.stack,to:o,from:n}),t.close()},teardown(){t.close()}}}}var t=e();exports.loggerPlugin=t,exports.loggerPluginFactory=e;//# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/constants.ts","../../src/internal/console-groups.ts","../../src/internal/formatting.ts","../../src/internal/params-diff.ts","../../src/plugin.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["// packages/logger-plugin/modules/constants.ts\n\nimport type { LoggerPluginConfig } from \"./types\";\n\nexport const DEFAULT_CONFIG: Required<LoggerPluginConfig> = {\n  level: \"all\",\n  showParamsDiff: true,\n  context: \"logger-plugin\",\n};\n","// packages/logger-plugin/modules/internal/console-groups.ts\n\n/**\n * Checks if console.group is supported in the current environment.\n */\nexport const supportsConsoleGroups = (): boolean => {\n  return (\n    typeof console !== \"undefined\" &&\n    typeof console.group === \"function\" &&\n    typeof console.groupEnd === \"function\"\n  );\n};\n\n/**\n * Manager for handling console groups\n */\ninterface GroupManager {\n  /**\n   * Opens a group if it's not already open\n   */\n  open: (label: string) => void;\n  /**\n   * Closes a group if it's open\n   */\n  close: () => void;\n  /**\n   * Checks if a group is currently open\n   */\n  isOpen: () => boolean;\n}\n\n/**\n * Creates a manager for handling console groups.\n * Prevents duplicate group opening.\n *\n * @param enabled - Whether groups are supported in the environment\n * @returns Object with open and close methods\n */\nexport const createGroupManager = (enabled: boolean): GroupManager => {\n  let isOpened = false;\n\n  return {\n    /**\n     * Opens a group if it's not already open.\n     */\n    open(label: string): void {\n      if (!enabled || isOpened) {\n        return;\n      }\n\n      console.group(label);\n      isOpened = true;\n    },\n\n    /**\n     * Closes a group if it's open.\n     */\n    close(): void {\n      if (!enabled || !isOpened) {\n        return;\n      }\n\n      console.groupEnd();\n      isOpened = false;\n    },\n\n    /**\n     * Checks if a group is currently open.\n     */\n    isOpen(): boolean {\n      return isOpened;\n    },\n  };\n};\n","// packages/logger-plugin/modules/internal/formatting.ts\n\nimport type { State } from \"@real-router/core\";\n\n/**\n * Formats route name for logging output.\n * Handles undefined/null.\n */\nexport const formatRouteName = (state?: State): string => {\n  return state?.name ?? \"(none)\";\n};\n","// packages/logger-plugin/modules/internal/params-diff.ts\n\nimport type { Params } from \"@real-router/core\";\n\nexport interface ParamsDiff {\n  changed: Record<string, { from: unknown; to: unknown }>;\n  added: Record<string, unknown>;\n  removed: Record<string, unknown>;\n}\n\n/**\n * Calculates differences between two parameter objects.\n * Performs only shallow comparison.\n *\n * @param fromParams - Previous parameters\n * @param toParams - New parameters\n * @returns Object with differences or null if there are no changes\n */\nexport const getParamsDiff = (\n  fromParams: Params,\n  toParams: Params,\n): ParamsDiff | null => {\n  const changed: ParamsDiff[\"changed\"] = {};\n  const added: ParamsDiff[\"added\"] = {};\n  const removed: ParamsDiff[\"removed\"] = {};\n\n  // Track if any changes found to avoid iterating through objects at the end.\n  // This is a performance optimization: instead of calling Object.keys().length\n  // three times to check if objects are empty, we set this flag when we find\n  // any change and check it once at the end.\n  let hasChanges = false;\n\n  // Find changed and removed\n  for (const key in fromParams) {\n    if (!(key in toParams)) {\n      removed[key] = fromParams[key];\n      hasChanges = true;\n    } else if (fromParams[key] !== toParams[key]) {\n      changed[key] = { from: fromParams[key], to: toParams[key] };\n      hasChanges = true;\n    }\n  }\n\n  // Find added\n  for (const key in toParams) {\n    if (!(key in fromParams)) {\n      added[key] = toParams[key];\n      hasChanges = true;\n    }\n  }\n\n  // Return null if there are no changes\n  if (!hasChanges) {\n    return null;\n  }\n\n  return { changed, added, removed };\n};\n\n/**\n * Formats and logs parameter differences.\n *\n * @param diff - Object with differences\n * @param context - Context for logger\n */\nexport const logParamsDiff = (diff: ParamsDiff, context: string): void => {\n  const parts: string[] = [];\n\n  // Cache entries to avoid double iteration\n  const changedEntries = Object.entries(diff.changed);\n\n  if (changedEntries.length > 0) {\n    const items: string[] = [];\n\n    for (const [key, { from, to }] of changedEntries) {\n      items.push(`${key}: ${JSON.stringify(from)} → ${JSON.stringify(to)}`);\n    }\n\n    parts.push(`Changed: { ${items.join(\", \")} }`);\n  }\n\n  const addedEntries = Object.entries(diff.added);\n\n  if (addedEntries.length > 0) {\n    parts.push(`Added: ${JSON.stringify(diff.added)}`);\n  }\n\n  const removedEntries = Object.entries(diff.removed);\n\n  if (removedEntries.length > 0) {\n    parts.push(`Removed: ${JSON.stringify(diff.removed)}`);\n  }\n\n  console.log(`[${context}]  ${parts.join(\", \")}`);\n};\n","// packages/logger-plugin/modules/plugin.ts\n\nimport { DEFAULT_CONFIG } from \"./constants\";\nimport {\n  createGroupManager,\n  supportsConsoleGroups,\n} from \"./internal/console-groups\";\nimport { formatRouteName } from \"./internal/formatting\";\nimport { getParamsDiff, logParamsDiff } from \"./internal/params-diff\";\n\nimport type { PluginFactory, RouterError, State } from \"@real-router/core\";\n\n/**\n * Creates a logger plugin for real-router.\n *\n * Configuration is managed through the logger singleton.\n *\n * @returns Plugin factory function for real-router\n *\n * @example\n * ```ts\n * import { loggerPluginFactory } from \"@real-router/logger-plugin\";\n *\n * router.usePlugin(loggerPluginFactory());\n * ```\n *\n * @example\n * ```ts\n * // Use with default configuration\n * router.usePlugin(loggerPluginFactory());\n * ```\n */\nexport function loggerPluginFactory(): PluginFactory {\n  // eslint-disable-next-line unicorn/consistent-function-scoping -- factory pattern: closure captures config, groups\n  return () => {\n    const config = DEFAULT_CONFIG;\n\n    // Create helper managers\n    const groups = createGroupManager(supportsConsoleGroups());\n\n    /**\n     * Logs parameter differences when navigating within the same route.\n     */\n    const logParamsIfNeeded = (toState: State, fromState?: State): void => {\n      if (!fromState) {\n        return;\n      }\n\n      // Show diff only for the same route\n      if (toState.name !== fromState.name) {\n        return;\n      }\n\n      const diff = getParamsDiff(fromState.params, toState.params);\n\n      if (diff) {\n        logParamsDiff(diff, config.context);\n      }\n    };\n\n    return {\n      onStart() {\n        console.log(`[${config.context}] Router started`);\n      },\n\n      onStop() {\n        groups.close();\n        console.log(`[${config.context}] Router stopped`);\n      },\n\n      onTransitionStart(toState: State, fromState?: State) {\n        groups.open(\"Router transition\");\n\n        const fromRoute = formatRouteName(fromState);\n        const toRoute = formatRouteName(toState);\n\n        console.log(\n          `[${config.context}] Transition: ${fromRoute} → ${toRoute}`,\n          {\n            from: fromState,\n            to: toState,\n          },\n        );\n\n        logParamsIfNeeded(toState, fromState);\n      },\n\n      onTransitionSuccess(toState: State, fromState?: State) {\n        console.log(`[${config.context}] Transition success`, {\n          to: toState,\n          from: fromState,\n        });\n\n        groups.close();\n      },\n\n      onTransitionCancel(toState: State, fromState?: State) {\n        console.warn(`[${config.context}] Transition cancelled`, {\n          to: toState,\n          from: fromState,\n        });\n\n        groups.close();\n      },\n\n      onTransitionError(\n        toState: State | undefined,\n        fromState: State | undefined,\n        err: RouterError,\n      ) {\n        console.error(`[${config.context}] Transition error: ${err.code}`, {\n          error: err,\n          stack: err.stack,\n          to: toState,\n          from: fromState,\n        });\n\n        groups.close();\n      },\n\n      teardown() {\n        groups.close();\n      },\n    };\n  };\n}\n\n/**\n * Default logger plugin instance with standard configuration.\n * Provided for backward compatibility with existing code.\n *\n * @example\n * // Use default configuration\n * router.usePlugin(loggerPlugin);\n */\nexport const loggerPlugin = loggerPluginFactory();\n"]}

package/dist/cjs/metafile-cjs.json

@@ -0,0 +1 @@
+{"inputs":{"../../node_modules/.pnpm/tsup@8.5.1_jiti@2.6.1_postcss@8.5.6_typescript@5.9.3/node_modules/tsup/assets/cjs_shims.js":{"bytes":569,"imports":[],"format":"esm"},"src/constants.ts":{"bytes":233,"imports":[{"path":"/Users/olegivanov/WebstormProjects/real-router/node_modules/.pnpm/tsup@8.5.1_jiti@2.6.1_postcss@8.5.6_typescript@5.9.3/node_modules/tsup/assets/cjs_shims.js","kind":"import-statement","external":true}],"format":"esm"},"src/internal/console-groups.ts":{"bytes":1490,"imports":[{"path":"/Users/olegivanov/WebstormProjects/real-router/node_modules/.pnpm/tsup@8.5.1_jiti@2.6.1_postcss@8.5.6_typescript@5.9.3/node_modules/tsup/assets/cjs_shims.js","kind":"import-statement","external":true}],"format":"esm"},"src/internal/formatting.ts":{"bytes":281,"imports":[{"path":"/Users/olegivanov/WebstormProjects/real-router/node_modules/.pnpm/tsup@8.5.1_jiti@2.6.1_postcss@8.5.6_typescript@5.9.3/node_modules/tsup/assets/cjs_shims.js","kind":"import-statement","external":true}],"format":"esm"},"src/internal/params-diff.ts":{"bytes":2619,"imports":[{"path":"/Users/olegivanov/WebstormProjects/real-router/node_modules/.pnpm/tsup@8.5.1_jiti@2.6.1_postcss@8.5.6_typescript@5.9.3/node_modules/tsup/assets/cjs_shims.js","kind":"import-statement","external":true}],"format":"esm"},"src/plugin.ts":{"bytes":3413,"imports":[{"path":"src/constants.ts","kind":"import-statement","original":"./constants"},{"path":"src/internal/console-groups.ts","kind":"import-statement","original":"./internal/console-groups"},{"path":"src/internal/formatting.ts","kind":"import-statement","original":"./internal/formatting"},{"path":"src/internal/params-diff.ts","kind":"import-statement","original":"./internal/params-diff"},{"path":"/Users/olegivanov/WebstormProjects/real-router/node_modules/.pnpm/tsup@8.5.1_jiti@2.6.1_postcss@8.5.6_typescript@5.9.3/node_modules/tsup/assets/cjs_shims.js","kind":"import-statement","external":true}],"format":"esm"},"src/index.ts":{"bytes":266,"imports":[{"path":"src/plugin.ts","kind":"import-statement","original":"./plugin"},{"path":"/Users/olegivanov/WebstormProjects/real-router/node_modules/.pnpm/tsup@8.5.1_jiti@2.6.1_postcss@8.5.6_typescript@5.9.3/node_modules/tsup/assets/cjs_shims.js","kind":"import-statement","external":true}],"format":"esm"}},"outputs":{"dist/cjs/index.js.map":{"imports":[],"exports":[],"inputs":{},"bytes":11720},"dist/cjs/index.js":{"imports":[],"exports":["loggerPlugin","loggerPluginFactory"],"entryPoint":"src/index.ts","inputs":{"src/constants.ts":{"bytesInOutput":93},"src/internal/console-groups.ts":{"bytesInOutput":727},"src/internal/formatting.ts":{"bytesInOutput":72},"src/internal/params-diff.ts":{"bytesInOutput":1361},"src/plugin.ts":{"bytesInOutput":1902},"src/index.ts":{"bytesInOutput":0}},"bytes":4341}}}

package/dist/esm/index.d.mts

@@ -0,0 +1,71 @@
+import { PluginFactory } from '@real-router/core';
+
+/**
+ * Creates a logger plugin for real-router.
+ *
+ * Configuration is managed through the logger singleton.
+ *
+ * @returns Plugin factory function for real-router
+ *
+ * @example
+ * ```ts
+ * import { loggerPluginFactory } from "@real-router/logger-plugin";
+ *
+ * router.usePlugin(loggerPluginFactory());
+ * ```
+ *
+ * @example
+ * ```ts
+ * // Use with default configuration
+ * router.usePlugin(loggerPluginFactory());
+ * ```
+ */
+declare function loggerPluginFactory(): PluginFactory;
+/**
+ * Default logger plugin instance with standard configuration.
+ * Provided for backward compatibility with existing code.
+ *
+ * @example
+ * // Use default configuration
+ * router.usePlugin(loggerPlugin);
+ */
+declare const loggerPlugin: PluginFactory;
+
+/**
+ * Logging level for router events.
+ * Controls which events are logged to the console.
+ */
+type LogLevel = "all" | "transitions" | "errors" | "none";
+/**
+ * Configuration options for the logger plugin.
+ */
+interface LoggerPluginConfig {
+    /**
+     * Logging level - controls what router events to log.
+     *
+     * - 'all': Log all router events (default)
+     * - 'transitions': Log only transition-related events
+     * - 'errors': Log only transition errors
+     * - 'none': Disable all logging
+     *
+     * @default 'all'
+     */
+    level?: LogLevel;
+    /**
+     * Show diff of changed route parameters between transitions.
+     * Only applies when navigating within the same route.
+     * Helps identify which parameters changed during navigation.
+     *
+     * @default false
+     */
+    showParamsDiff?: boolean;
+    /**
+     * Custom context name for logger.
+     * Useful when running multiple routers.
+     *
+     * @default 'logger-plugin'
+     */
+    context?: string;
+}
+
+export { type LogLevel, type LoggerPluginConfig, loggerPlugin, loggerPluginFactory };

package/dist/esm/index.mjs

@@ -0,0 +1 @@
+var o={context:"logger-plugin"},n=o=>o?.name??"(none)";function e(){return()=>{const e=o,t=(o=>{let n=!1;return{open(e){o&&!n&&(console.group(e),n=!0)},close(){o&&n&&(console.groupEnd(),n=!1)},isOpen:()=>n}})("undefined"!=typeof console&&"function"==typeof console.group&&"function"==typeof console.groupEnd);return{onStart(){console.log(`[${e.context}] Router started`)},onStop(){t.close(),console.log(`[${e.context}] Router stopped`)},onTransitionStart(o,r){t.open("Router transition");const s=n(r),c=n(o);console.log(`[${e.context}] Transition: ${s} → ${c}`,{from:r,to:o}),((o,n)=>{if(!n)return;if(o.name!==n.name)return;const t=((o,n)=>{const e={},t={},r={};let s=!1;for(const t in o)t in n?o[t]!==n[t]&&(e[t]={from:o[t],to:n[t]},s=!0):(r[t]=o[t],s=!0);for(const e in n)e in o||(t[e]=n[e],s=!0);return s?{changed:e,added:t,removed:r}:null})(n.params,o.params);t&&((o,n)=>{const e=[],t=Object.entries(o.changed);if(t.length>0){const o=[];for(const[n,{from:e,to:r}]of t)o.push(`${n}: ${JSON.stringify(e)} → ${JSON.stringify(r)}`);e.push(`Changed: { ${o.join(", ")} }`)}Object.entries(o.added).length>0&&e.push(`Added: ${JSON.stringify(o.added)}`),Object.entries(o.removed).length>0&&e.push(`Removed: ${JSON.stringify(o.removed)}`),console.log(`[${n}]  ${e.join(", ")}`)})(t,e.context)})(o,r)},onTransitionSuccess(o,n){console.log(`[${e.context}] Transition success`,{to:o,from:n}),t.close()},onTransitionCancel(o,n){console.warn(`[${e.context}] Transition cancelled`,{to:o,from:n}),t.close()},onTransitionError(o,n,r){console.error(`[${e.context}] Transition error: ${r.code}`,{error:r,stack:r.stack,to:o,from:n}),t.close()},teardown(){t.close()}}}}var t=e();export{t as loggerPlugin,e as loggerPluginFactory};//# sourceMappingURL=index.mjs.map

package/dist/esm/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/constants.ts","../../src/internal/console-groups.ts","../../src/internal/formatting.ts","../../src/internal/params-diff.ts","../../src/plugin.ts"],"names":[],"mappings":";AAIO,IAAM,cAAA,GAA+C;AAAA,EAG1D,OAAA,EAAS;AACX,CAAA;;;ACHO,IAAM,wBAAwB,MAAe;AAClD,EAAA,OACE,OAAO,YAAY,WAAA,IACnB,OAAO,QAAQ,KAAA,KAAU,UAAA,IACzB,OAAO,OAAA,CAAQ,QAAA,KAAa,UAAA;AAEhC,CAAA;AA2BO,IAAM,kBAAA,GAAqB,CAAC,OAAA,KAAmC;AACpE,EAAA,IAAI,QAAA,GAAW,KAAA;AAEf,EAAA,OAAO;AAAA;AAAA;AAAA;AAAA,IAIL,KAAK,KAAA,EAAqB;AACxB,MAAA,IAAI,CAAC,WAAW,QAAA,EAAU;AACxB,QAAA;AAAA,MACF;AAEA,MAAA,OAAA,CAAQ,MAAM,KAAK,CAAA;AACnB,MAAA,QAAA,GAAW,IAAA;AAAA,IACb,CAAA;AAAA;AAAA;AAAA;AAAA,IAKA,KAAA,GAAc;AACZ,MAAA,IAAI,CAAC,OAAA,IAAW,CAAC,QAAA,EAAU;AACzB,QAAA;AAAA,MACF;AAEA,MAAA,OAAA,CAAQ,QAAA,EAAS;AACjB,MAAA,QAAA,GAAW,KAAA;AAAA,IACb,CAAA;AAAA;AAAA;AAAA;AAAA,IAKA,MAAA,GAAkB;AAChB,MAAA,OAAO,QAAA;AAAA,IACT;AAAA,GACF;AACF,CAAA;;;ACjEO,IAAM,eAAA,GAAkB,CAAC,KAAA,KAA0B;AACxD,EAAA,OAAO,OAAO,IAAA,IAAQ,QAAA;AACxB,CAAA;;;ACQO,IAAM,aAAA,GAAgB,CAC3B,UAAA,EACA,QAAA,KACsB;AACtB,EAAA,MAAM,UAAiC,EAAC;AACxC,EAAA,MAAM,QAA6B,EAAC;AACpC,EAAA,MAAM,UAAiC,EAAC;AAMxC,EAAA,IAAI,UAAA,GAAa,KAAA;AAGjB,EAAA,KAAA,MAAW,OAAO,UAAA,EAAY;AAC5B,IAAA,IAAI,EAAE,OAAO,QAAA,CAAA,EAAW;AACtB,MAAA,OAAA,CAAQ,GAAG,CAAA,GAAI,UAAA,CAAW,GAAG,CAAA;AAC7B,MAAA,UAAA,GAAa,IAAA;AAAA,IACf,WAAW,UAAA,CAAW,GAAG,CAAA,KAAM,QAAA,CAAS,GAAG,CAAA,EAAG;AAC5C,MAAA,OAAA,CAAQ,GAAG,CAAA,GAAI,EAAE,IAAA,EAAM,UAAA,CAAW,GAAG,CAAA,EAAG,EAAA,EAAI,QAAA,CAAS,GAAG,CAAA,EAAE;AAC1D,MAAA,UAAA,GAAa,IAAA;AAAA,IACf;AAAA,EACF;AAGA,EAAA,KAAA,MAAW,OAAO,QAAA,EAAU;AAC1B,IAAA,IAAI,EAAE,OAAO,UAAA,CAAA,EAAa;AACxB,MAAA,KAAA,CAAM,GAAG,CAAA,GAAI,QAAA,CAAS,GAAG,CAAA;AACzB,MAAA,UAAA,GAAa,IAAA;AAAA,IACf;AAAA,EACF;AAGA,EAAA,IAAI,CAAC,UAAA,EAAY;AACf,IAAA,OAAO,IAAA;AAAA,EACT;AAEA,EAAA,OAAO,EAAE,OAAA,EAAS,KAAA,EAAO,OAAA,EAAQ;AACnC,CAAA;AAQO,IAAM,aAAA,GAAgB,CAAC,IAAA,EAAkB,OAAA,KAA0B;AACxE,EAAA,MAAM,QAAkB,EAAC;AAGzB,EAAA,MAAM,cAAA,GAAiB,MAAA,CAAO,OAAA,CAAQ,IAAA,CAAK,OAAO,CAAA;AAElD,EAAA,IAAI,cAAA,CAAe,SAAS,CAAA,EAAG;AAC7B,IAAA,MAAM,QAAkB,EAAC;AAEzB,IAAA,KAAA,MAAW,CAAC,GAAA,EAAK,EAAE,MAAM,EAAA,EAAI,KAAK,cAAA,EAAgB;AAChD,MAAA,KAAA,CAAM,IAAA,CAAK,CAAA,EAAG,GAAG,CAAA,EAAA,EAAK,IAAA,CAAK,SAAA,CAAU,IAAI,CAAC,CAAA,QAAA,EAAM,IAAA,CAAK,SAAA,CAAU,EAAE,CAAC,CAAA,CAAE,CAAA;AAAA,IACtE;AAEA,IAAA,KAAA,CAAM,KAAK,CAAA,WAAA,EAAc,KAAA,CAAM,IAAA,CAAK,IAAI,CAAC,CAAA,EAAA,CAAI,CAAA;AAAA,EAC/C;AAEA,EAAA,MAAM,YAAA,GAAe,MAAA,CAAO,OAAA,CAAQ,IAAA,CAAK,KAAK,CAAA;AAE9C,EAAA,IAAI,YAAA,CAAa,SAAS,CAAA,EAAG;AAC3B,IAAA,KAAA,CAAM,KAAK,CAAA,OAAA,EAAU,IAAA,CAAK,UAAU,IAAA,CAAK,KAAK,CAAC,CAAA,CAAE,CAAA;AAAA,EACnD;AAEA,EAAA,MAAM,cAAA,GAAiB,MAAA,CAAO,OAAA,CAAQ,IAAA,CAAK,OAAO,CAAA;AAElD,EAAA,IAAI,cAAA,CAAe,SAAS,CAAA,EAAG;AAC7B,IAAA,KAAA,CAAM,KAAK,CAAA,SAAA,EAAY,IAAA,CAAK,UAAU,IAAA,CAAK,OAAO,CAAC,CAAA,CAAE,CAAA;AAAA,EACvD;AAEA,EAAA,OAAA,CAAQ,GAAA,CAAI,IAAI,OAAO,CAAA,GAAA,EAAM,MAAM,IAAA,CAAK,IAAI,CAAC,CAAA,CAAE,CAAA;AACjD,CAAA;;;AC9DO,SAAS,mBAAA,GAAqC;AAEnD,EAAA,OAAO,MAAM;AACX,IAAA,MAAM,MAAA,GAAS,cAAA;AAGf,IAAA,MAAM,MAAA,GAAS,kBAAA,CAAmB,qBAAA,EAAuB,CAAA;AAKzD,IAAA,MAAM,iBAAA,GAAoB,CAAC,OAAA,EAAgB,SAAA,KAA4B;AACrE,MAAA,IAAI,CAAC,SAAA,EAAW;AACd,QAAA;AAAA,MACF;AAGA,MAAA,IAAI,OAAA,CAAQ,IAAA,KAAS,SAAA,CAAU,IAAA,EAAM;AACnC,QAAA;AAAA,MACF;AAEA,MAAA,MAAM,IAAA,GAAO,aAAA,CAAc,SAAA,CAAU,MAAA,EAAQ,QAAQ,MAAM,CAAA;AAE3D,MAAA,IAAI,IAAA,EAAM;AACR,QAAA,aAAA,CAAc,IAAA,EAAM,OAAO,OAAO,CAAA;AAAA,MACpC;AAAA,IACF,CAAA;AAEA,IAAA,OAAO;AAAA,MACL,OAAA,GAAU;AACR,QAAA,OAAA,CAAQ,GAAA,CAAI,CAAA,CAAA,EAAI,MAAA,CAAO,OAAO,CAAA,gBAAA,CAAkB,CAAA;AAAA,MAClD,CAAA;AAAA,MAEA,MAAA,GAAS;AACP,QAAA,MAAA,CAAO,KAAA,EAAM;AACb,QAAA,OAAA,CAAQ,GAAA,CAAI,CAAA,CAAA,EAAI,MAAA,CAAO,OAAO,CAAA,gBAAA,CAAkB,CAAA;AAAA,MAClD,CAAA;AAAA,MAEA,iBAAA,CAAkB,SAAgB,SAAA,EAAmB;AACnD,QAAA,MAAA,CAAO,KAAK,mBAAmB,CAAA;AAE/B,QAAA,MAAM,SAAA,GAAY,gBAAgB,SAAS,CAAA;AAC3C,QAAA,MAAM,OAAA,GAAU,gBAAgB,OAAO,CAAA;AAEvC,QAAA,OAAA,CAAQ,GAAA;AAAA,UACN,IAAI,MAAA,CAAO,OAAO,CAAA,cAAA,EAAiB,SAAS,WAAM,OAAO,CAAA,CAAA;AAAA,UACzD;AAAA,YACE,IAAA,EAAM,SAAA;AAAA,YACN,EAAA,EAAI;AAAA;AACN,SACF;AAEA,QAAA,iBAAA,CAAkB,SAAS,SAAS,CAAA;AAAA,MACtC,CAAA;AAAA,MAEA,mBAAA,CAAoB,SAAgB,SAAA,EAAmB;AACrD,QAAA,OAAA,CAAQ,GAAA,CAAI,CAAA,CAAA,EAAI,MAAA,CAAO,OAAO,CAAA,oBAAA,CAAA,EAAwB;AAAA,UACpD,EAAA,EAAI,OAAA;AAAA,UACJ,IAAA,EAAM;AAAA,SACP,CAAA;AAED,QAAA,MAAA,CAAO,KAAA,EAAM;AAAA,MACf,CAAA;AAAA,MAEA,kBAAA,CAAmB,SAAgB,SAAA,EAAmB;AACpD,QAAA,OAAA,CAAQ,IAAA,CAAK,CAAA,CAAA,EAAI,MAAA,CAAO,OAAO,CAAA,sBAAA,CAAA,EAA0B;AAAA,UACvD,EAAA,EAAI,OAAA;AAAA,UACJ,IAAA,EAAM;AAAA,SACP,CAAA;AAED,QAAA,MAAA,CAAO,KAAA,EAAM;AAAA,MACf,CAAA;AAAA,MAEA,iBAAA,CACE,OAAA,EACA,SAAA,EACA,GAAA,EACA;AACA,QAAA,OAAA,CAAQ,MAAM,CAAA,CAAA,EAAI,MAAA,CAAO,OAAO,CAAA,oBAAA,EAAuB,GAAA,CAAI,IAAI,CAAA,CAAA,EAAI;AAAA,UACjE,KAAA,EAAO,GAAA;AAAA,UACP,OAAO,GAAA,CAAI,KAAA;AAAA,UACX,EAAA,EAAI,OAAA;AAAA,UACJ,IAAA,EAAM;AAAA,SACP,CAAA;AAED,QAAA,MAAA,CAAO,KAAA,EAAM;AAAA,MACf,CAAA;AAAA,MAEA,QAAA,GAAW;AACT,QAAA,MAAA,CAAO,KAAA,EAAM;AAAA,MACf;AAAA,KACF;AAAA,EACF,CAAA;AACF;AAUO,IAAM,eAAe,mBAAA","file":"index.mjs","sourcesContent":["// packages/logger-plugin/modules/constants.ts\n\nimport type { LoggerPluginConfig } from \"./types\";\n\nexport const DEFAULT_CONFIG: Required<LoggerPluginConfig> = {\n  level: \"all\",\n  showParamsDiff: true,\n  context: \"logger-plugin\",\n};\n","// packages/logger-plugin/modules/internal/console-groups.ts\n\n/**\n * Checks if console.group is supported in the current environment.\n */\nexport const supportsConsoleGroups = (): boolean => {\n  return (\n    typeof console !== \"undefined\" &&\n    typeof console.group === \"function\" &&\n    typeof console.groupEnd === \"function\"\n  );\n};\n\n/**\n * Manager for handling console groups\n */\ninterface GroupManager {\n  /**\n   * Opens a group if it's not already open\n   */\n  open: (label: string) => void;\n  /**\n   * Closes a group if it's open\n   */\n  close: () => void;\n  /**\n   * Checks if a group is currently open\n   */\n  isOpen: () => boolean;\n}\n\n/**\n * Creates a manager for handling console groups.\n * Prevents duplicate group opening.\n *\n * @param enabled - Whether groups are supported in the environment\n * @returns Object with open and close methods\n */\nexport const createGroupManager = (enabled: boolean): GroupManager => {\n  let isOpened = false;\n\n  return {\n    /**\n     * Opens a group if it's not already open.\n     */\n    open(label: string): void {\n      if (!enabled || isOpened) {\n        return;\n      }\n\n      console.group(label);\n      isOpened = true;\n    },\n\n    /**\n     * Closes a group if it's open.\n     */\n    close(): void {\n      if (!enabled || !isOpened) {\n        return;\n      }\n\n      console.groupEnd();\n      isOpened = false;\n    },\n\n    /**\n     * Checks if a group is currently open.\n     */\n    isOpen(): boolean {\n      return isOpened;\n    },\n  };\n};\n","// packages/logger-plugin/modules/internal/formatting.ts\n\nimport type { State } from \"@real-router/core\";\n\n/**\n * Formats route name for logging output.\n * Handles undefined/null.\n */\nexport const formatRouteName = (state?: State): string => {\n  return state?.name ?? \"(none)\";\n};\n","// packages/logger-plugin/modules/internal/params-diff.ts\n\nimport type { Params } from \"@real-router/core\";\n\nexport interface ParamsDiff {\n  changed: Record<string, { from: unknown; to: unknown }>;\n  added: Record<string, unknown>;\n  removed: Record<string, unknown>;\n}\n\n/**\n * Calculates differences between two parameter objects.\n * Performs only shallow comparison.\n *\n * @param fromParams - Previous parameters\n * @param toParams - New parameters\n * @returns Object with differences or null if there are no changes\n */\nexport const getParamsDiff = (\n  fromParams: Params,\n  toParams: Params,\n): ParamsDiff | null => {\n  const changed: ParamsDiff[\"changed\"] = {};\n  const added: ParamsDiff[\"added\"] = {};\n  const removed: ParamsDiff[\"removed\"] = {};\n\n  // Track if any changes found to avoid iterating through objects at the end.\n  // This is a performance optimization: instead of calling Object.keys().length\n  // three times to check if objects are empty, we set this flag when we find\n  // any change and check it once at the end.\n  let hasChanges = false;\n\n  // Find changed and removed\n  for (const key in fromParams) {\n    if (!(key in toParams)) {\n      removed[key] = fromParams[key];\n      hasChanges = true;\n    } else if (fromParams[key] !== toParams[key]) {\n      changed[key] = { from: fromParams[key], to: toParams[key] };\n      hasChanges = true;\n    }\n  }\n\n  // Find added\n  for (const key in toParams) {\n    if (!(key in fromParams)) {\n      added[key] = toParams[key];\n      hasChanges = true;\n    }\n  }\n\n  // Return null if there are no changes\n  if (!hasChanges) {\n    return null;\n  }\n\n  return { changed, added, removed };\n};\n\n/**\n * Formats and logs parameter differences.\n *\n * @param diff - Object with differences\n * @param context - Context for logger\n */\nexport const logParamsDiff = (diff: ParamsDiff, context: string): void => {\n  const parts: string[] = [];\n\n  // Cache entries to avoid double iteration\n  const changedEntries = Object.entries(diff.changed);\n\n  if (changedEntries.length > 0) {\n    const items: string[] = [];\n\n    for (const [key, { from, to }] of changedEntries) {\n      items.push(`${key}: ${JSON.stringify(from)} → ${JSON.stringify(to)}`);\n    }\n\n    parts.push(`Changed: { ${items.join(\", \")} }`);\n  }\n\n  const addedEntries = Object.entries(diff.added);\n\n  if (addedEntries.length > 0) {\n    parts.push(`Added: ${JSON.stringify(diff.added)}`);\n  }\n\n  const removedEntries = Object.entries(diff.removed);\n\n  if (removedEntries.length > 0) {\n    parts.push(`Removed: ${JSON.stringify(diff.removed)}`);\n  }\n\n  console.log(`[${context}]  ${parts.join(\", \")}`);\n};\n","// packages/logger-plugin/modules/plugin.ts\n\nimport { DEFAULT_CONFIG } from \"./constants\";\nimport {\n  createGroupManager,\n  supportsConsoleGroups,\n} from \"./internal/console-groups\";\nimport { formatRouteName } from \"./internal/formatting\";\nimport { getParamsDiff, logParamsDiff } from \"./internal/params-diff\";\n\nimport type { PluginFactory, RouterError, State } from \"@real-router/core\";\n\n/**\n * Creates a logger plugin for real-router.\n *\n * Configuration is managed through the logger singleton.\n *\n * @returns Plugin factory function for real-router\n *\n * @example\n * ```ts\n * import { loggerPluginFactory } from \"@real-router/logger-plugin\";\n *\n * router.usePlugin(loggerPluginFactory());\n * ```\n *\n * @example\n * ```ts\n * // Use with default configuration\n * router.usePlugin(loggerPluginFactory());\n * ```\n */\nexport function loggerPluginFactory(): PluginFactory {\n  // eslint-disable-next-line unicorn/consistent-function-scoping -- factory pattern: closure captures config, groups\n  return () => {\n    const config = DEFAULT_CONFIG;\n\n    // Create helper managers\n    const groups = createGroupManager(supportsConsoleGroups());\n\n    /**\n     * Logs parameter differences when navigating within the same route.\n     */\n    const logParamsIfNeeded = (toState: State, fromState?: State): void => {\n      if (!fromState) {\n        return;\n      }\n\n      // Show diff only for the same route\n      if (toState.name !== fromState.name) {\n        return;\n      }\n\n      const diff = getParamsDiff(fromState.params, toState.params);\n\n      if (diff) {\n        logParamsDiff(diff, config.context);\n      }\n    };\n\n    return {\n      onStart() {\n        console.log(`[${config.context}] Router started`);\n      },\n\n      onStop() {\n        groups.close();\n        console.log(`[${config.context}] Router stopped`);\n      },\n\n      onTransitionStart(toState: State, fromState?: State) {\n        groups.open(\"Router transition\");\n\n        const fromRoute = formatRouteName(fromState);\n        const toRoute = formatRouteName(toState);\n\n        console.log(\n          `[${config.context}] Transition: ${fromRoute} → ${toRoute}`,\n          {\n            from: fromState,\n            to: toState,\n          },\n        );\n\n        logParamsIfNeeded(toState, fromState);\n      },\n\n      onTransitionSuccess(toState: State, fromState?: State) {\n        console.log(`[${config.context}] Transition success`, {\n          to: toState,\n          from: fromState,\n        });\n\n        groups.close();\n      },\n\n      onTransitionCancel(toState: State, fromState?: State) {\n        console.warn(`[${config.context}] Transition cancelled`, {\n          to: toState,\n          from: fromState,\n        });\n\n        groups.close();\n      },\n\n      onTransitionError(\n        toState: State | undefined,\n        fromState: State | undefined,\n        err: RouterError,\n      ) {\n        console.error(`[${config.context}] Transition error: ${err.code}`, {\n          error: err,\n          stack: err.stack,\n          to: toState,\n          from: fromState,\n        });\n\n        groups.close();\n      },\n\n      teardown() {\n        groups.close();\n      },\n    };\n  };\n}\n\n/**\n * Default logger plugin instance with standard configuration.\n * Provided for backward compatibility with existing code.\n *\n * @example\n * // Use default configuration\n * router.usePlugin(loggerPlugin);\n */\nexport const loggerPlugin = loggerPluginFactory();\n"]}

package/dist/esm/metafile-esm.json

@@ -0,0 +1 @@
+{"inputs":{"src/constants.ts":{"bytes":233,"imports":[],"format":"esm"},"src/internal/console-groups.ts":{"bytes":1490,"imports":[],"format":"esm"},"src/internal/formatting.ts":{"bytes":281,"imports":[],"format":"esm"},"src/internal/params-diff.ts":{"bytes":2619,"imports":[],"format":"esm"},"src/plugin.ts":{"bytes":3413,"imports":[{"path":"src/constants.ts","kind":"import-statement","original":"./constants"},{"path":"src/internal/console-groups.ts","kind":"import-statement","original":"./internal/console-groups"},{"path":"src/internal/formatting.ts","kind":"import-statement","original":"./internal/formatting"},{"path":"src/internal/params-diff.ts","kind":"import-statement","original":"./internal/params-diff"}],"format":"esm"},"src/index.ts":{"bytes":266,"imports":[{"path":"src/plugin.ts","kind":"import-statement","original":"./plugin"}],"format":"esm"}},"outputs":{"dist/esm/index.mjs.map":{"imports":[],"exports":[],"inputs":{},"bytes":11720},"dist/esm/index.mjs":{"imports":[],"exports":["loggerPlugin","loggerPluginFactory"],"entryPoint":"src/index.ts","inputs":{"src/constants.ts":{"bytesInOutput":93},"src/internal/console-groups.ts":{"bytesInOutput":727},"src/internal/formatting.ts":{"bytesInOutput":72},"src/internal/params-diff.ts":{"bytesInOutput":1361},"src/plugin.ts":{"bytesInOutput":1902},"src/index.ts":{"bytesInOutput":0}},"bytes":4341}}}

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@real-router/logger-plugin",
+  "version": "0.0.1",
+  "type": "commonjs",
+  "description": "Development logging plugin with transition tracking and performance metrics",
+  "main": "./dist/cjs/index.js",
+  "module": "./dist/esm/index.mjs",
+  "types": "./dist/esm/index.d.mts",
+  "exports": {
+    ".": {
+      "types": {
+        "import": "./dist/esm/index.d.mts",
+        "require": "./dist/cjs/index.d.ts"
+      },
+      "import": "./dist/esm/index.mjs",
+      "require": "./dist/cjs/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/greydragon888/real-router.git"
+  },
+  "keywords": [
+    "real-router",
+    "logger",
+    "debugging",
+    "development",
+    "console",
+    "monitoring"
+  ],
+  "author": {
+    "name": "Oleg Ivanov",
+    "email": "greydragon888@gmail.com",
+    "url": "https://github.com/greydragon888"
+  },
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/greydragon888/real-router/issues"
+  },
+  "homepage": "https://github.com/greydragon888/real-router",
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "type-check": "tsc --noEmit",
+    "lint": "eslint --cache --ext .ts src/ tests/ --fix --max-warnings 0",
+    "test:mutation": "stryker run",
+    "test:mutation:report": "open reports/mutation-report.html",
+    "lint:package": "publint",
+    "lint:types": "attw --pack ."
+  },
+  "sideEffects": false,
+  "dependencies": {
+    "@real-router/core": "workspace:^"
+  }
+}