@coherent.js/profiler 1.0.0-beta.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Coherent.js Team
+
+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,43 @@
+# @coherent.js/profiler
+
+Advanced performance monitoring and profiling tools for Coherent.js applications.
+
+## Installation
+
+```bash
+npm install @coherent.js/profiler
+```
+
+## Usage
+
+### Basic Profiling
+
+```js
+import { PerformanceProfiler } from '@coherent.js/profiler';
+
+const profiler = new PerformanceProfiler();
+
+const profileId = profiler.startProfile('render-component');
+profiler.mark(profileId, 'start-render');
+// ... your code
+profiler.mark(profileId, 'end-render');
+const report = profiler.endProfile(profileId);
+```
+
+### Metrics Collection
+
+```js
+import { MetricsCollector } from '@coherent.js/performance-profiler';
+
+const collector = new MetricsCollector();
+collector.recordMetric('render-time', 16.5);
+```
+
+### Performance Dashboard
+
+```js
+import { createDashboard } from '@coherent.js/performance-profiler';
+
+const dashboard = createDashboard(profiler);
+const dashboardHTML = dashboard.render();
+```

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@coherent.js/profiler",
+  "version": "1.0.0-beta.3",
+  "description": "Performance profiling and monitoring tools for Coherent.js applications",
+  "type": "module",
+  "main": "src/index.js",
+  "types": "./types/index.d.ts",
+  "exports": {
+    ".": "./src/index.js",
+    "./profiler": "./src/profiler.js",
+    "./server": "./src/server.js",
+    "./dashboard": "./src/dashboard/index.js"
+  },
+  "files": [
+    "src/",
+    "types/",
+    "README.md",
+    "LICENSE"
+  ],
+  "keywords": [
+    "performance",
+    "profiling",
+    "monitoring",
+    "coherent",
+    "ssr"
+  ],
+  "author": "Coherent.js Team",
+  "license": "MIT",
+  "devDependencies": {
+    "vitest": "^3.2.4"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Tomdrouv1/coherent.js.git"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "node build.mjs",
+    "test": "vitest",
+    "dev": "node src/server.js"
+  }
+}

package/src/collectors/metrics-collector.js

@@ -0,0 +1,36 @@
+/**
+ * Metrics Collector for Performance Profiler
+ */
+
+export class MetricsCollector {
+  constructor(options = {}) {
+    this.options = options;
+    this.collectors = new Map();
+  }
+
+  addCollector(name, collector) {
+    this.collectors.set(name, collector);
+  }
+
+  async collect() {
+    const results = {};
+    for (const [name, collector] of this.collectors) {
+      try {
+        results[name] = await collector.collect();
+      } catch (error) {
+        results[name] = { error: error.message };
+      }
+    }
+    return results;
+  }
+
+  createRenderingCollector() {
+    return {
+      collect: () => ({
+        renderCount: 0,
+        averageRenderTime: 0,
+        slowestRender: 0
+      })
+    };
+  }
+}

package/src/dashboard/index.js

@@ -0,0 +1,37 @@
+export function createDashboard(profiler, _options = {}) {
+  return {
+    render() {
+      const metrics = profiler.getMetrics();
+      return {
+        div: {
+          className: 'performance-dashboard',
+          children: [
+            {
+              h2: {
+                text: 'Performance Dashboard',
+                className: 'dashboard-title'
+              }
+            },
+            {
+              div: {
+                className: 'metrics-grid',
+                children: Object.entries(metrics).map(([name, metric]) => ({
+                  div: {
+                    className: 'metric-card',
+                    children: [
+                      { h3: { text: name } },
+                      { p: { text: `Count: ${metric.count}` } },
+                      { p: { text: `Average: ${metric.average?.toFixed(2)}ms` } },
+                      { p: { text: `Min: ${metric.min}ms` } },
+                      { p: { text: `Max: ${metric.max}ms` } }
+                    ]
+                  }
+                }))
+              }
+            }
+          ]
+        }
+      };
+    }
+  };
+}

package/src/index.js

@@ -0,0 +1,9 @@
+/**
+ * Coherent.js Performance Profiler
+ * Advanced performance monitoring and profiling tools
+ */
+
+export { PerformanceProfiler } from './profiler.js';
+export { MetricsCollector } from './collectors/metrics-collector.js';
+export { createProfilerServer } from './server.js';
+export { createDashboard } from './dashboard/index.js';

package/src/profiler.js

@@ -0,0 +1,47 @@
+/**
+ * Performance Profiler for Coherent.js
+ */
+
+export class PerformanceProfiler {
+  constructor(options = {}) {
+    this.options = {
+      enableMetrics: true,
+      enableTracing: true,
+      sampleRate: 1.0,
+      ...options
+    };
+    this.metrics = new Map();
+    this.traces = [];
+  }
+
+  startProfiling(name) {
+    const start = performance.now();
+    return {
+      end: () => {
+        const duration = performance.now() - start;
+        this.recordMetric(name, duration);
+        return duration;
+      }
+    };
+  }
+
+  recordMetric(name, value, tags = {}) {
+    if (!this.metrics.has(name)) {
+      this.metrics.set(name, []);
+    }
+    this.metrics.get(name).push({
+      value,
+      timestamp: Date.now(),
+      tags
+    });
+  }
+
+  getMetrics() {
+    return Object.fromEntries(this.metrics);
+  }
+
+  reset() {
+    this.metrics.clear();
+    this.traces = [];
+  }
+}

package/src/server.js

@@ -0,0 +1,14 @@
+export function createProfilerServer(profiler, options = {}) {
+  const port = options.port || 3001;
+  
+  return {
+    start() {
+      console.log(`Performance profiler server would start on port ${port}`);
+      return Promise.resolve();
+    },
+    stop() {
+      console.log('Performance profiler server stopped');
+      return Promise.resolve();
+    }
+  };
+}