@densetsuuu/docteur 0.1.1-beta.3 → 0.1.1-beta.5

package/README.md

@@ -150,7 +150,7 @@ Docteur measures cold start performance through two complementary approaches:
 ## Requirements
 
 - AdonisJS v7+
-- Node.js 21+
+- Node.js 22+
 
 ## License
 

package/build/index.d.ts

@@ -20,4 +20,4 @@ export { colorDuration, createBar, formatDuration, getCategoryIcon, getEffective
 /**
  * Export registries for customization
  */
-export { categories, fileIcons, symbols, type CategoryDefinition, type SymbolKey, } from './src/profiler/registries/index.js';
+export { categories, fileIcons, symbols, type CategoryDefinition, type SymbolKey, } from './src/registries/index.js';

package/build/index.js

@@ -20,4 +20,4 @@ export { colorDuration, createBar, formatDuration, getCategoryIcon, getEffective
 /**
  * Export registries for customization
  */
-export { categories, fileIcons, symbols, } from './src/profiler/registries/index.js';
+export { categories, fileIcons, symbols, } from './src/registries/index.js';

package/build/src/cli/commands/diagnose.js

@@ -1,7 +1,7 @@
 import { defineCommand } from 'citty';
-import { isAdonisProject, profile } from '../../profiler/profiler.js';
-import { ConsoleReporter } from '../../profiler/reporters/console_reporter.js';
-import { ui } from '../../profiler/reporters/format.js';
+import { isAdonisProject, profile } from '#profiler/profiler';
+import { ConsoleReporter } from '#profiler/reporters/console_reporter';
+import { ui } from '#profiler/reporters/format';
 export const diagnoseCommand = defineCommand({
     meta: {
         name: 'diagnose',

package/build/src/cli/commands/xray.js

@@ -1,7 +1,7 @@
 import { defineCommand } from 'citty';
-import { isAdonisProject, profile } from '../../profiler/profiler.js';
-import { TuiReporter } from '../../profiler/reporters/tui_reporter.js';
-import { ui } from '../../profiler/reporters/format.js';
+import { isAdonisProject, profile } from '#profiler/profiler';
+import { TuiReporter } from '#profiler/reporters/tui_reporter';
+import { ui } from '#profiler/reporters/format';
 export const xrayCommand = defineCommand({
     meta: {
         name: 'xray',

package/build/src/profiler/collector.d.ts

@@ -1,4 +1,4 @@
-import type { AppFileGroup, ModuleTiming, ProfileResult, ProfileSummary, ProviderTiming, ResolvedConfig } from '../types.js';
+import type { AppFileGroup, ModuleTiming, ProfileResult, ProfileSummary, ProviderTiming, ResolvedConfig } from '#types';
 export interface PackageGroup {
     name: string;
     totalTime: number;

package/build/src/profiler/collector.js

@@ -8,7 +8,7 @@
 | category or package.
 |
 */
-import { categories } from './registries/index.js';
+import { categories } from '#registries/index';
 export class ProfileCollector {
     #modules;
     #providers;

package/build/src/profiler/hooks.d.ts

@@ -1,27 +1,7 @@
+import type { InitializeHook, LoadHook, ResolveHook } from 'node:module';
 import type { MessagePort } from 'node:worker_threads';
-type ResolveFn = (specifier: string, context?: {
-    parentURL?: string;
-}) => Promise<{
-    url: string;
-}>;
-type LoadFn = (url: string, context?: {
-    format?: string;
-}) => Promise<{
-    format: string;
-    source: string | ArrayBuffer | SharedArrayBuffer;
-}>;
-export declare function initialize(data: {
+export declare const initialize: InitializeHook<{
     port: MessagePort;
-}): void;
-export declare function resolve(specifier: string, context: {
-    parentURL?: string;
-}, next: ResolveFn): Promise<{
-    url: string;
-}>;
-export declare function load(url: string, context: {
-    format?: string;
-}, next: LoadFn): Promise<{
-    format: string;
-    source: string | ArrayBuffer | SharedArrayBuffer;
 }>;
-export {};
+export declare const resolve: ResolveHook;
+export declare const load: LoadHook;

package/build/src/profiler/hooks.js

@@ -10,17 +10,17 @@
 */
 import { performance } from 'node:perf_hooks';
 let port;
-export function initialize(data) {
+export const initialize = (data) => {
     port = data.port;
-}
-export async function resolve(specifier, context, next) {
+};
+export const resolve = async (specifier, context, next) => {
     const result = await next(specifier, context);
     if (context.parentURL && result.url.startsWith('file://')) {
         port.postMessage({ type: 'parent', child: result.url, parent: context.parentURL });
     }
     return result;
-}
-export async function load(url, context, next) {
+};
+export const load = async (url, context, next) => {
     if (!url.startsWith('file://')) {
         return next(url, context);
     }
@@ -30,4 +30,4 @@ export async function load(url, context, next) {
         port.postMessage({ type: 'timing', url, loadTime: performance.now() - start });
     }
     return result;
-}
+};

package/build/src/profiler/loader.js

@@ -13,14 +13,11 @@ import { performance } from 'node:perf_hooks';
 import { MessageChannel } from 'node:worker_threads';
 const require = createRequire(join(process.cwd(), 'node_modules', '_'));
 const { tracingChannels } = require('@adonisjs/application');
-// Module timing data from hooks
+/**
+ * Module timing data collected via ESM hooks
+ */
 const parents = new Map();
 const loadTimes = new Map();
-// Provider timing data
-const providerPhases = new Map();
-const providerStarts = new Map();
-const asyncCalls = new Set();
-// Set up message channel for hooks
 const { port1, port2 } = new MessageChannel();
 port1.unref();
 port1.on('message', (msg) => {
@@ -34,54 +31,57 @@ register('./hooks.js', {
     data: { port: port2 },
     transferList: [port2],
 });
-// Subscribe to provider lifecycle phases
-// For async methods: start -> end -> asyncStart -> asyncEnd (we wait for asyncEnd)
-// For sync methods: start -> end (we record on end, but defer to check if async fires)
-function getProviderName(msg) {
+/**
+ * Provider lifecycle timing via tracing channels.
+ *
+ * Tracing channels emit: start → end (sync) or start → end → asyncStart → asyncEnd (async).
+ * We defer sync recording with setTimeout so asyncStart can claim the phase first.
+ */
+const providerPhases = new Map();
+const starts = new Map();
+const asyncPhases = new Set();
+function name(msg) {
     return msg.provider.constructor.name;
 }
-function recordPhase(name, phase, endTime) {
-    const key = `${name}:${phase}`;
-    const start = providerStarts.get(key);
+function record(provider, phase, endTime) {
+    const start = starts.get(`${provider}:${phase}`);
     if (start === undefined)
         return;
-    const phases = providerPhases.get(name) || {};
+    const phases = providerPhases.get(provider) ?? {};
     phases[phase] = endTime - start;
-    providerPhases.set(name, phases);
-    providerStarts.delete(key);
+    providerPhases.set(provider, phases);
+    starts.delete(`${provider}:${phase}`);
 }
-function subscribePhase(channel, phase) {
-    channel.subscribe({
+const phases = ['register', 'boot', 'start', 'ready', 'shutdown'];
+for (const phase of phases) {
+    const channelKey = `provider${phase[0].toUpperCase()}${phase.slice(1)}`;
+    tracingChannels[channelKey].subscribe({
         start(msg) {
-            providerStarts.set(`${getProviderName(msg)}:${phase}`, performance.now());
+            starts.set(`${name(msg)}:${phase}`, performance.now());
         },
         end(msg) {
-            const name = getProviderName(msg);
-            const key = `${name}:${phase}`;
+            const provider = name(msg);
             const endTime = performance.now();
-            // Defer to check if this becomes async (asyncStart fires before our setTimeout)
+            const key = `${provider}:${phase}`;
             setTimeout(() => {
-                if (!asyncCalls.has(key))
-                    recordPhase(name, phase, endTime);
+                if (!asyncPhases.has(key))
+                    record(provider, phase, endTime);
             }, 0);
         },
         asyncStart(msg) {
-            asyncCalls.add(`${getProviderName(msg)}:${phase}`);
+            asyncPhases.add(`${name(msg)}:${phase}`);
         },
         asyncEnd(msg) {
-            const name = getProviderName(msg);
-            recordPhase(name, phase, performance.now());
-            asyncCalls.delete(`${name}:${phase}`);
+            const provider = name(msg);
+            record(provider, phase, performance.now());
+            asyncPhases.delete(`${provider}:${phase}`);
         },
         error() { },
     });
 }
-subscribePhase(tracingChannels.providerRegister, 'register');
-subscribePhase(tracingChannels.providerBoot, 'boot');
-subscribePhase(tracingChannels.providerStart, 'start');
-subscribePhase(tracingChannels.providerReady, 'ready');
-subscribePhase(tracingChannels.providerShutdown, 'shutdown');
-// Send results to parent process when requested
+/**
+ * IPC: send collected results to parent process
+ */
 if (process.send) {
     process.on('message', (msg) => {
         if (msg.type !== 'getResults')

package/build/src/profiler/profiler.d.ts

@@ -1,4 +1,4 @@
-import type { ProfileResult } from '../types.js';
+import type { ProfileResult } from '#types';
 export interface ProfileOptions {
     entryPoint?: string;
     suppressOutput?: boolean;

package/build/src/profiler/profiler.js

@@ -8,10 +8,10 @@
 |
 */
 import { fork } from 'node:child_process';
-import { join } from 'node:path';
 import { existsSync } from 'node:fs';
+import { join } from 'node:path';
 import { ProfileCollector } from './collector.js';
-import { simplifyUrl } from './reporters/format.js';
+import { simplifyUrl } from '#profiler/reporters/format';
 const TIMEOUT_MS = 30_000;
 export function findLoaderPath() {
     return import.meta.resolve('@densetsuuu/docteur/profiler/loader');

package/build/src/profiler/reporters/base_reporter.d.ts

@@ -1,4 +1,4 @@
-import type { ProfileResult, ResolvedConfig } from '../../types.js';
+import type { ProfileResult, ResolvedConfig } from '#types';
 /**
  * Context passed to reporters containing all data needed for rendering.
  */

package/build/src/profiler/reporters/console_reporter.js

@@ -6,8 +6,8 @@
 | Renders profiling results to the terminal using @poppinss/cliui.
 |
 */
-import { ProfileCollector } from '../collector.js';
-import { symbols } from '../registries/index.js';
+import { ProfileCollector } from '#profiler/collector';
+import { symbols } from '#registries/index';
 import { colorDuration, createBar, formatDuration, getCategoryIcon, getEffectiveTime, simplifyUrl, ui, } from './format.js';
 export class ConsoleReporter {
     /**

package/build/src/profiler/reporters/format.d.ts

@@ -1,17 +1,11 @@
-import type { AppFileCategory, ModuleTiming } from '../../types.js';
+import type { AppFileCategory, ModuleTiming } from '#types';
 /**
  * Shared UI instance for consistent styling
  */
 export declare const ui: {
     colors: import("@poppinss/colors/types").Colors;
     logger: import("@poppinss/cliui").Logger;
-    table: (tableOptions
-    /**
-     * Colors a duration based on how slow it is
-     */
-    ? /**
-     * Colors a duration based on how slow it is
-     */: Partial<import("@poppinss/cliui/types").TableOptions>) => import("@poppinss/cliui").Table;
+    table: (tableOptions?: Partial<import("@poppinss/cliui/types").TableOptions>) => import("@poppinss/cliui").Table;
     tasks: (tasksOptions?: Partial<import("@poppinss/cliui/types").TaskManagerOptions>) => import("@poppinss/cliui").TaskManager;
     steps: () => import("@poppinss/cliui").Steps;
     icons: {

package/build/src/profiler/reporters/format.js

@@ -7,7 +7,7 @@
 |
 */
 import { cliui } from '@poppinss/cliui';
-import { categories, symbols } from '../registries/index.js';
+import { categories, symbols } from '#registries/index';
 /**
  * Shared UI instance for consistent styling
  */

package/build/src/profiler/reporters/tui_reporter.js

@@ -9,7 +9,7 @@
 */
 import React from 'react';
 import { render } from 'ink';
-import { XRayApp } from '../../xray/components/XRayApp.js';
+import { XRayApp } from '#xray/components/XRayApp';
 export class TuiReporter {
     /**
      * Renders an interactive TUI report using the XRay explorer.

package/build/src/{profiler/registries → registries}/categories.d.ts

@@ -1,4 +1,4 @@
-import type { AppFileCategory } from '../../types.js';
+import type { AppFileCategory } from '#types';
 export interface CategoryDefinition {
     displayName: string;
     icon: string;

package/build/src/xray/components/ListView.js

@@ -2,7 +2,7 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { Box, Text } from 'ink';
 import SelectInput from 'ink-select-input';
 import { formatDuration, getEffectiveTime, getFileIcon, getTimeColor, isDependency, } from '../tree.js';
-import { symbols } from '../../profiler/registries/index.js';
+import { symbols } from '#registries/index';
 function ItemComponent({ isSelected = false, label, timeStr, timeColor, fileIcon, displayName, }) {
     // Spacer
     if (!label) {

package/build/src/xray/components/ModuleView.js

@@ -3,7 +3,7 @@ import { useMemo } from 'react';
 import { Box, Text } from 'ink';
 import SelectInput from 'ink-select-input';
 import { formatDuration, getEffectiveTime, getImportChain, getFileIcon, getSourceIcon, getTimeColor, isDependency, } from '../tree.js';
-import { symbols } from '../../profiler/registries/index.js';
+import { symbols } from '#registries/index';
 function ItemComponent({ isSelected = false, label }) {
     if (!label) {
         return _jsx(Text, { children: " " });

package/build/src/xray/components/ProviderListView.d.ts

@@ -1,4 +1,4 @@
-import type { ProviderTiming } from '../../types.js';
+import type { ProviderTiming } from '#types';
 interface Props {
     providers: ProviderTiming[];
     onSelect: (provider: ProviderTiming) => void;

package/build/src/xray/components/ProviderListView.js

@@ -2,7 +2,7 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { Box, Text } from 'ink';
 import SelectInput from 'ink-select-input';
 import { formatDuration, getTimeColor } from '../tree.js';
-import { symbols } from '../../profiler/registries/index.js';
+import { symbols } from '#registries/index';
 function ItemComponent({ isSelected = false, timeStr, timeColor, name, label }) {
     // Spacer
     if (!label) {

package/build/src/xray/components/ProviderView.d.ts

@@ -1,4 +1,4 @@
-import type { ProviderTiming } from '../../types.js';
+import type { ProviderTiming } from '#types';
 interface Props {
     provider: ProviderTiming;
     onBack: () => void;

package/build/src/xray/components/ProviderView.js

@@ -2,7 +2,7 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { Box, Text } from 'ink';
 import SelectInput from 'ink-select-input';
 import { formatDuration, getTimeColor } from '../tree.js';
-import { symbols } from '../../profiler/registries/index.js';
+import { symbols } from '#registries/index';
 function Bar({ value, max, width = 30 }) {
     const ratio = max > 0 ? Math.min(value / max, 1) : 0;
     const filled = Math.round(ratio * width);

package/build/src/xray/components/XRayApp.d.ts

@@ -1,4 +1,4 @@
-import type { ProfileResult } from '../../types.js';
+import type { ProfileResult } from '#types';
 interface Props {
     result: ProfileResult;
     cwd: string;

package/build/src/xray/tree.d.ts

@@ -1,5 +1,5 @@
-import type { ModuleTiming } from '../types.js';
-import { formatDuration, getEffectiveTime } from '../profiler/reporters/format.js';
+import type { ModuleTiming } from '#types';
+import { formatDuration, getEffectiveTime } from '#profiler/reporters/format';
 export interface ModuleNode {
     timing: ModuleTiming;
     displayName: string;

package/build/src/xray/tree.js

@@ -7,8 +7,8 @@
 | Provides utilities for traversing and displaying the tree.
 |
 */
-import { formatDuration, getEffectiveTime, simplifyUrl } from '../profiler/reporters/format.js';
-import { fileIcons, symbols } from '../profiler/registries/index.js';
+import { formatDuration, getEffectiveTime, simplifyUrl } from '#profiler/reporters/format';
+import { fileIcons, symbols } from '#registries/index';
 export function buildDependencyTree(modules, cwd) {
     const nodeMap = new Map();
     const time = (n) => getEffectiveTime(n.timing);

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "@densetsuuu/docteur",
   "description": "AdonisJS cold start profiler - analyze and optimize your application boot time",
-  "version": "0.1.1-beta.3",
+  "version": "0.1.1-beta.5",
   "engines": {
-    "node": ">=21.0.0"
+    "node": ">=22.0.0"
   },
   "main": "./build/index.js",
   "types": "./build/index.d.ts",
@@ -30,7 +30,7 @@
     "typecheck": "tsc --noEmit",
     "lint": "eslint .",
     "format": "prettier --write .",
-    "quick:test": "node --import=./tsnode.esm.js --enable-source-maps bin/test.ts",
+    "quick:test": "node --conditions=development --import=./tsnode.esm.js --enable-source-maps bin/test.ts",
     "pretest": "npm run lint",
     "test": "c8 npm run quick:test",
     "prebuild": "npm run lint && npm run clean",
@@ -92,6 +92,24 @@
       "optional": true
     }
   },
+  "imports": {
+    "#registries/*": {
+      "development": "./src/registries/*.js",
+      "default": "./build/src/registries/*.js"
+    },
+    "#types": {
+      "development": "./src/types.js",
+      "default": "./build/src/types.js"
+    },
+    "#profiler/*": {
+      "development": "./src/profiler/*.js",
+      "default": "./build/src/profiler/*.js"
+    },
+    "#xray/*": {
+      "development": "./src/xray/*.js",
+      "default": "./build/src/xray/*.js"
+    }
+  },
   "publishConfig": {
     "access": "public",
     "tag": "latest"