modestbench 0.2.0 → 0.3.1

package/dist/utils/type-guards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-guards.d.ts","sourceRoot":"","sources":["../../src/utils/type-guards.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAYH;;;;;GAKG;AACH,eAAO,MAAM,OAAO,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,KAEjD,CAAC;AAgBF;;;;;GAKG;AACH,eAAO,MAAM,YAAY,GACvB,OAAO,OAAO,KACb,KAAK,IAAI,KAAK,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAEjC,CAAC"}

package/dist/utils/type-guards.js

@@ -0,0 +1,43 @@
+/**
+ * Type Guard Utilities
+ *
+ * Reusable type guard functions for runtime type checking and narrowing.
+ */
+/**
+ * Type guard to check if a value is an object (not null or array)
+ *
+ * @param value - Value to check
+ * @returns True if value is a non-null object
+ */
+const isObject = (value) => {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+};
+/**
+ * Type guard to check if a value is an Error instance
+ *
+ * @param value - Value to check
+ * @returns True if value is an Error
+ */
+export const isError = (value) => {
+    return value instanceof Error;
+};
+/**
+ * Type guard to check if a value has a specific property
+ *
+ * @param value - Value to check
+ * @param property - Property name to check for
+ * @returns True if value is an object with the specified property
+ */
+const hasProperty = (value, property) => {
+    return isObject(value) && property in value;
+};
+/**
+ * Type guard to check if an error has a code property
+ *
+ * @param error - Error to check
+ * @returns True if error has a code property
+ */
+export const hasErrorCode = (error) => {
+    return isError(error) && hasProperty(error, 'code');
+};
+//# sourceMappingURL=type-guards.js.map

package/dist/utils/type-guards.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-guards.js","sourceRoot":"","sources":["../../src/utils/type-guards.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;GAKG;AACH,MAAM,QAAQ,GAAG,CAAC,KAAc,EAAoC,EAAE;IACpE,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,KAAc,EAAkB,EAAE;IACxD,OAAO,KAAK,YAAY,KAAK,CAAC;AAChC,CAAC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,WAAW,GAAG,CAClB,KAAc,EACd,QAAW,EACkB,EAAE;IAC/B,OAAO,QAAQ,CAAC,KAAK,CAAC,IAAI,QAAQ,IAAI,KAAK,CAAC;AAC9C,CAAC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAC1B,KAAc,EACqB,EAAE;IACrC,OAAO,OAAO,CAAC,KAAK,CAAC,IAAI,WAAW,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;AACtD,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "modestbench",
-  "version": "0.2.0",
+  "version": "0.3.1",
   "type": "module",
   "description": "A full-ass benchmarking framework for Node.js",
   "repository": {
@@ -16,9 +16,7 @@
   "engines": {
     "node": ">=20.0.0"
   },
-  "bin": {
-    "modestbench": "dist/cli/index.js"
-  },
+  "bin": "./dist/cli/index.cjs",
   "main": "./dist/index.cjs",
   "types": "./dist/index.d.cts",
   "module": "./dist/index.js",
@@ -72,14 +70,14 @@
     "docs:preview": "astro preview --config astro.config.js",
     "fix": "run-s -sl fix:*",
     "fix:eslint": "eslint --fix .",
-    "fix:format": "prettier --write . && markdownlint-cli2 --fix \"**/*.md\"",
     "fix:pkg": "npm pkg fix",
+    "fix:prettier": "prettier --write . && markdownlint-cli2 --fix \"**/*.md\"",
     "lint": "run-p -sl --aggregate-output lint:*",
     "lint-staged": "lint-staged",
     "lint:eslint": "eslint .",
-    "lint:format": "prettier --check .",
     "lint:knip": "knip",
     "lint:markdown": "markdownlint-cli2 \"**/*.md\"",
+    "lint:prettier": "prettier --check .",
     "lint:spelling": "cspell .",
     "lint:types": "tsc --noEmit",
     "prepack": "run-s -s clean build",
@@ -99,11 +97,13 @@
     "cosmiconfig": "9.0.0",
     "cosmiconfig-typescript-loader": "6.2.0",
     "glob": "11.0.3",
-    "tinybench": "5.0.1",
+    "minimatch": "10.0.3",
+    "tinybench": "5.1.0",
     "yargs": "18.0.0",
     "zod": "4.1.12"
   },
   "devDependencies": {
+    "@astrojs/mdx": "4.3.9",
     "@astrojs/starlight": "0.36.1",
     "@commitlint/cli": "20.1.0",
     "@commitlint/config-conventional": "20.0.0",
@@ -112,17 +112,17 @@
     "@stylistic/eslint-plugin": "5.5.0",
     "@types/node": "24.9.1",
     "@types/wallabyjs": "0.0.15",
-    "@types/yargs": "17.0.33",
+    "@types/yargs": "17.0.34",
     "asciinema-player": "3.12.1",
-    "astro": "5.15.1",
-    "bupkis": "0.11.1",
+    "astro": "5.15.2",
+    "bupkis": "0.12.0",
     "cspell": "9.2.2",
     "eslint": "9.38.0",
     "eslint-plugin-jsonc": "2.21.0",
     "eslint-plugin-perfectionist": "4.15.1",
     "globals": "16.4.0",
     "husky": "9.1.7",
-    "knip": "5.66.2",
+    "knip": "5.66.3",
     "lint-staged": "16.2.6",
     "markdownlint-cli2": "0.18.1",
     "markdownlint-cli2-formatter-pretty": "0.0.8",
@@ -145,7 +145,8 @@
     "ignoreDependencies": [
       "@types/wallabyjs",
       "markdownlint-cli2-formatter-pretty",
-      "asciinema-player"
+      "asciinema-player",
+      "@astrojs/mdx"
     ],
     "ignore": [
       ".wallaby.js",
@@ -172,27 +173,24 @@
     }
   },
   "lint-staged": {
-    "package.json": [
-      "npm pkg fix"
-    ],
     "*.{ts,cts,js,cjs,yml,json5}": [
       "eslint --fix",
       "prettier --write",
-      "cspell"
+      "cspell lint --no-must-find-files"
     ],
     "**/!(package-lock).json": [
       "eslint --fix",
       "prettier --write",
-      "cspell"
+      "cspell lint --no-must-find-files"
     ],
     "*.md": [
       "markdownlint-cli2 --fix",
       "prettier --write",
-      "cspell"
+      "cspell lint --no-must-find-files"
     ],
     "*.mdx": [
       "prettier --write",
-      "cspell"
+      "cspell lint --no-must-find-files"
     ]
   },
   "prettier": {
@@ -207,6 +205,7 @@
     "tsdoc": true
   },
   "zshy": {
+    "bin": "./src/cli/index.ts",
     "exports": {
       ".": "./src/index.ts",
       "./cli": "./src/cli/index.ts",

package/src/cli/commands/analyze.ts

@@ -0,0 +1,101 @@
+/**
+ * Analyze Command
+ *
+ * CLI command for analyzing code execution and identifying benchmark
+ * candidates. Uses Node.js V8 profiler to capture function execution data.
+ *
+ * @packageDocumentation
+ */
+
+import type { ProfileConfig } from '../../types/profiler.js';
+import type { CliContext } from '../index.js';
+
+import { ProfileHumanReporter } from '../../reporters/profile-human.js';
+import { filterProfile } from '../../services/profiler/profile-filter.js';
+import { parseProfile } from '../../services/profiler/profile-parser.js';
+import { runWithProfiling } from '../../services/profiler/profile-runner.js';
+import { findPackageRoot } from '../../utils/package.js';
+
+/**
+ * Analyze command options interface
+ */
+export interface AnalyzeOptions {
+  /** Enable color output */
+  color?: boolean | undefined;
+
+  /** Command to analyze */
+  command?: string | undefined;
+
+  /** Working directory */
+  cwd: string;
+
+  /** Filter by file pattern */
+  filterFile?: string | undefined;
+
+  /** Group by file */
+  groupByFile?: boolean | undefined;
+
+  /** Input profile file */
+  input?: string | undefined;
+
+  /** Minimum execution percentage */
+  minPercent?: number | undefined;
+
+  /** Number of top functions to show */
+  top?: number | undefined;
+}
+
+/**
+ * Handle analyze command
+ */
+export const handleAnalyzeCommand = async (
+  _context: CliContext,
+  options: AnalyzeOptions,
+): Promise<number> => {
+  try {
+    const startTime = Date.now();
+
+    // Run profiling or load existing profile
+    const logPath = options.input
+      ? options.input
+      : await runWithProfiling(options.command!, {
+          cwd: options.cwd,
+        });
+
+    const duration = Date.now() - startTime;
+
+    // Parse profile data
+    const profileData = await parseProfile(logPath);
+
+    // Find package root for smart detection
+    const packageRoot = await findPackageRoot(options.cwd);
+
+    // Apply filtering
+    const config: ProfileConfig = {
+      focus: options.filterFile ? [options.filterFile] : undefined,
+      groupByFile: options.groupByFile,
+      minExecutionPercent: options.minPercent,
+      smartDetection: true,
+      topN: options.top,
+    };
+
+    const filtered = filterProfile(profileData, config, packageRoot);
+
+    // Add command and duration to filtered data
+    filtered.command = options.command;
+    filtered.duration = duration;
+
+    // Report results
+    const reporter = new ProfileHumanReporter({
+      color: options.color,
+      groupByFile: options.groupByFile,
+    });
+
+    reporter.report(filtered);
+
+    return 0;
+  } catch (error) {
+    console.error('Analyze command failed:', error);
+    return 1;
+  }
+};