modestbench 0.9.1 → 0.9.2

package/dist/cli/parsers/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cli/parsers/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,aAAa,EAAE,sBAAqB;AAC7C,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,GACnB,uBAAsB;AACvB,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,qBAAoB;AACzD,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,mBAAmB,EACnB,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,GACpB,sBAAqB;AACtB,OAAO,EAAE,UAAU,EAAE,mBAAkB;AACvC,OAAO,EAAE,SAAS,EAAE,kBAAiB;AACrC,OAAO,EAAE,UAAU,EAAE,mBAAkB"}

package/dist/cli/parsers/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * CLI Parsers
+ *
+ * Re-exports all bargs parser definitions for CLI commands.
+ *
+ * @packageDocumentation
+ */
+export { analyzeParser } from "./analyze.js";
+export { baselineAnalyzeParser, baselineDeleteParser, baselineListParser, baselineSetParser, baselineShowParser, } from "./baseline.js";
+export { globalOptions, quietOption } from "./global.js";
+export { historyCleanParser, historyCompareParser, historyExportParser, historyListParser, historyShowParser, historyTrendsParser, } from "./history.js";
+export { initParser } from "./init.js";
+export { runParser } from "./run.js";
+export { testParser } from "./test.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/parsers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cli/parsers/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,aAAa,EAAE,qBAAqB;AAC7C,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,GACnB,sBAAsB;AACvB,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,oBAAoB;AACzD,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,mBAAmB,EACnB,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,GACpB,qBAAqB;AACtB,OAAO,EAAE,UAAU,EAAE,kBAAkB;AACvC,OAAO,EAAE,SAAS,EAAE,iBAAiB;AACrC,OAAO,EAAE,UAAU,EAAE,kBAAkB"}

package/dist/cli/parsers/index.js

@@ -0,0 +1,15 @@
+/**
+ * CLI Parsers
+ *
+ * Re-exports all bargs parser definitions for CLI commands.
+ *
+ * @packageDocumentation
+ */
+export { analyzeParser } from "./analyze.js";
+export { baselineAnalyzeParser, baselineDeleteParser, baselineListParser, baselineSetParser, baselineShowParser, } from "./baseline.js";
+export { globalOptions, quietOption } from "./global.js";
+export { historyCleanParser, historyCompareParser, historyExportParser, historyListParser, historyShowParser, historyTrendsParser, } from "./history.js";
+export { initParser } from "./init.js";
+export { runParser } from "./run.js";
+export { testParser } from "./test.js";
+//# sourceMappingURL=index.js.map

package/dist/cli/parsers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cli/parsers/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,aAAa,EAAE,qBAAqB;AAC7C,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,GACnB,sBAAsB;AACvB,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,oBAAoB;AACzD,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,mBAAmB,EACnB,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,GACpB,qBAAqB;AACtB,OAAO,EAAE,UAAU,EAAE,kBAAkB;AACvC,OAAO,EAAE,SAAS,EAAE,iBAAiB;AACrC,OAAO,EAAE,UAAU,EAAE,kBAAkB"}

package/dist/cli/parsers/init.cjs

@@ -0,0 +1,39 @@
+"use strict";
+/**
+ * Init Command Parser
+ *
+ * Parser for the `init` command which initializes a new benchmark project.
+ *
+ * @packageDocumentation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.initParser = void 0;
+const bargs_1 = require("@boneskull/bargs");
+/**
+ * Parser for `init` command
+ *
+ * Uses camelCaseValues transform for cleaner property access.
+ */
+exports.initParser = (0, bargs_1.map)((0, bargs_1.merge)(bargs_1.opt.options({
+    'config-type': bargs_1.opt.enum(['json', 'yaml', 'js', 'ts'], {
+        description: 'Configuration file format',
+    }),
+    examples: bargs_1.opt.boolean({
+        description: 'Include example benchmark files',
+    }),
+    force: bargs_1.opt.boolean({
+        description: 'Overwrite existing files',
+    }),
+    quiet: bargs_1.opt.boolean({
+        aliases: ['q'],
+        description: 'Minimal output',
+    }),
+    yes: bargs_1.opt.boolean({
+        aliases: ['y'],
+        description: 'Accept all prompts automatically',
+    }),
+}), bargs_1.pos.positionals(bargs_1.pos.enum(['basic', 'advanced', 'library'], {
+    description: 'Type of project to initialize',
+    name: 'type',
+}))), bargs_1.camelCaseValues);
+//# sourceMappingURL=init.js.map

package/dist/cli/parsers/init.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../../src/cli/parsers/init.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAEH,4CAAyE;AAEzE;;;;GAIG;AACU,QAAA,UAAU,GAAG,IAAA,WAAG,EAC3B,IAAA,aAAK,EACH,WAAG,CAAC,OAAO,CAAC;IACV,aAAa,EAAE,WAAG,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAU,EAAE;QAC7D,WAAW,EAAE,2BAA2B;KACzC,CAAC;IACF,QAAQ,EAAE,WAAG,CAAC,OAAO,CAAC;QACpB,WAAW,EAAE,iCAAiC;KAC/C,CAAC;IACF,KAAK,EAAE,WAAG,CAAC,OAAO,CAAC;QACjB,WAAW,EAAE,0BAA0B;KACxC,CAAC;IACF,KAAK,EAAE,WAAG,CAAC,OAAO,CAAC;QACjB,OAAO,EAAE,CAAC,GAAG,CAAC;QACd,WAAW,EAAE,gBAAgB;KAC9B,CAAC;IACF,GAAG,EAAE,WAAG,CAAC,OAAO,CAAC;QACf,OAAO,EAAE,CAAC,GAAG,CAAC;QACd,WAAW,EAAE,kCAAkC;KAChD,CAAC;CACH,CAAC,EACF,WAAG,CAAC,WAAW,CACb,WAAG,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,UAAU,EAAE,SAAS,CAAU,EAAE;IAClD,WAAW,EAAE,+BAA+B;IAC5C,IAAI,EAAE,MAAM;CACb,CAAC,CACH,CACF,EACD,uBAAe,CAChB,CAAC"}

package/dist/cli/parsers/init.d.cts

@@ -0,0 +1,32 @@
+/**
+ * Init Command Parser
+ *
+ * Parser for the `init` command which initializes a new benchmark project.
+ *
+ * @packageDocumentation
+ */
+/**
+ * Parser for `init` command
+ *
+ * Uses camelCaseValues transform for cleaner property access.
+ */
+export declare const initParser: import("@boneskull/bargs").Parser<import("@boneskull/bargs").CamelCaseKeys<import("@boneskull/bargs").InferOptions<{
+    'config-type': import("@boneskull/bargs").EnumOption<"json" | "js" | "ts" | "yaml"> & {
+        description: string;
+    };
+    examples: import("@boneskull/bargs").BooleanOption & {
+        description: string;
+    };
+    force: import("@boneskull/bargs").BooleanOption & {
+        description: string;
+    };
+    quiet: import("@boneskull/bargs").BooleanOption & {
+        aliases: string[];
+        description: string;
+    };
+    yes: import("@boneskull/bargs").BooleanOption & {
+        aliases: string[];
+        description: string;
+    };
+}> & object>, readonly ["advanced" | "basic" | "library" | undefined]>;
+//# sourceMappingURL=init.d.ts.map

package/dist/cli/parsers/init.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/cli/parsers/init.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH;;;;GAIG;AACH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;sEA6BtB,CAAC"}

package/dist/cli/parsers/init.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Init Command Parser
+ *
+ * Parser for the `init` command which initializes a new benchmark project.
+ *
+ * @packageDocumentation
+ */
+/**
+ * Parser for `init` command
+ *
+ * Uses camelCaseValues transform for cleaner property access.
+ */
+export declare const initParser: import("@boneskull/bargs").Parser<import("@boneskull/bargs").CamelCaseKeys<import("@boneskull/bargs").InferOptions<{
+    'config-type': import("@boneskull/bargs").EnumOption<"json" | "js" | "ts" | "yaml"> & {
+        description: string;
+    };
+    examples: import("@boneskull/bargs").BooleanOption & {
+        description: string;
+    };
+    force: import("@boneskull/bargs").BooleanOption & {
+        description: string;
+    };
+    quiet: import("@boneskull/bargs").BooleanOption & {
+        aliases: string[];
+        description: string;
+    };
+    yes: import("@boneskull/bargs").BooleanOption & {
+        aliases: string[];
+        description: string;
+    };
+}> & object>, readonly ["advanced" | "basic" | "library" | undefined]>;
+//# sourceMappingURL=init.d.ts.map

package/dist/cli/parsers/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/cli/parsers/init.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH;;;;GAIG;AACH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;sEA6BtB,CAAC"}

package/dist/cli/parsers/init.js

@@ -0,0 +1,36 @@
+/**
+ * Init Command Parser
+ *
+ * Parser for the `init` command which initializes a new benchmark project.
+ *
+ * @packageDocumentation
+ */
+import { camelCaseValues, map, merge, opt, pos } from '@boneskull/bargs';
+/**
+ * Parser for `init` command
+ *
+ * Uses camelCaseValues transform for cleaner property access.
+ */
+export const initParser = map(merge(opt.options({
+    'config-type': opt.enum(['json', 'yaml', 'js', 'ts'], {
+        description: 'Configuration file format',
+    }),
+    examples: opt.boolean({
+        description: 'Include example benchmark files',
+    }),
+    force: opt.boolean({
+        description: 'Overwrite existing files',
+    }),
+    quiet: opt.boolean({
+        aliases: ['q'],
+        description: 'Minimal output',
+    }),
+    yes: opt.boolean({
+        aliases: ['y'],
+        description: 'Accept all prompts automatically',
+    }),
+}), pos.positionals(pos.enum(['basic', 'advanced', 'library'], {
+    description: 'Type of project to initialize',
+    name: 'type',
+}))), camelCaseValues);
+//# sourceMappingURL=init.js.map

package/dist/cli/parsers/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../../src/cli/parsers/init.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,eAAe,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAC;AAEzE;;;;GAIG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,GAAG,CAC3B,KAAK,CACH,GAAG,CAAC,OAAO,CAAC;IACV,aAAa,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAU,EAAE;QAC7D,WAAW,EAAE,2BAA2B;KACzC,CAAC;IACF,QAAQ,EAAE,GAAG,CAAC,OAAO,CAAC;QACpB,WAAW,EAAE,iCAAiC;KAC/C,CAAC;IACF,KAAK,EAAE,GAAG,CAAC,OAAO,CAAC;QACjB,WAAW,EAAE,0BAA0B;KACxC,CAAC;IACF,KAAK,EAAE,GAAG,CAAC,OAAO,CAAC;QACjB,OAAO,EAAE,CAAC,GAAG,CAAC;QACd,WAAW,EAAE,gBAAgB;KAC9B,CAAC;IACF,GAAG,EAAE,GAAG,CAAC,OAAO,CAAC;QACf,OAAO,EAAE,CAAC,GAAG,CAAC;QACd,WAAW,EAAE,kCAAkC;KAChD,CAAC;CACH,CAAC,EACF,GAAG,CAAC,WAAW,CACb,GAAG,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,UAAU,EAAE,SAAS,CAAU,EAAE;IAClD,WAAW,EAAE,+BAA+B;IAC5C,IAAI,EAAE,MAAM;CACb,CAAC,CACH,CACF,EACD,eAAe,CAChB,CAAC"}

package/dist/cli/parsers/run.cjs

@@ -0,0 +1,99 @@
+"use strict";
+/**
+ * Run Command Parser
+ *
+ * Parser for the `run` command which executes benchmark files.
+ *
+ * @packageDocumentation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runParser = void 0;
+const bargs_1 = require("@boneskull/bargs");
+const constants_js_1 = require("../../constants.cjs");
+/**
+ * Base parser for `run` command options and positionals
+ */
+const runParserBase = (0, bargs_1.merge)(bargs_1.opt.options({
+    bail: bargs_1.opt.boolean({
+        aliases: ['b'],
+        description: 'Stop on first failure',
+    }),
+    engine: bargs_1.opt.enum([constants_js_1.Engines.TINYBENCH, constants_js_1.Engines.ACCURATE], {
+        aliases: ['e'],
+        description: 'Benchmark engine: tinybench (default) or accurate (requires --allow-natives-syntax)',
+    }),
+    exclude: bargs_1.opt.array('string', {
+        aliases: ['X'],
+        description: 'Exclude patterns',
+    }),
+    'exclude-tag': bargs_1.opt.array('string', {
+        aliases: ['T'],
+        description: 'Exclude benchmarks with any of these tags',
+    }),
+    iterations: bargs_1.opt.number({
+        aliases: ['i'],
+        description: 'Number of iterations per benchmark',
+    }),
+    'json-pretty': bargs_1.opt.boolean({
+        description: 'Pretty-print JSON output (only affects json reporter)',
+    }),
+    'limit-by': bargs_1.opt.enum(['time', 'iterations', 'any', 'all'], {
+        aliases: ['l', 'limit'],
+        description: 'How to limit benchmarks: time (time budget), iterations (sample count), any (either threshold), all (both thresholds)',
+    }),
+    output: bargs_1.opt.string({
+        aliases: ['o'],
+        description: 'Output directory for reports',
+    }),
+    'output-file': bargs_1.opt.string({
+        aliases: ['of', 'file'],
+        description: 'Custom filename for reporter output (use with single reporter only)',
+    }),
+    quiet: bargs_1.opt.boolean({
+        aliases: ['q'],
+        description: 'Minimal output',
+    }),
+    reporter: bargs_1.opt.array([
+        constants_js_1.Reporters.HUMAN,
+        constants_js_1.Reporters.JSON,
+        constants_js_1.Reporters.CSV,
+        constants_js_1.Reporters.NYAN,
+        constants_js_1.Reporters.SIMPLE,
+    ], {
+        aliases: ['r'],
+        default: [constants_js_1.DEFAULT_REPORTER],
+        description: 'Output reporters to use (human,json,csv)',
+    }),
+    tag: bargs_1.opt.array('string', {
+        description: 'Include only benchmarks with any of these tags',
+    }),
+    time: bargs_1.opt.number({
+        aliases: ['t'],
+        description: 'Time budget per benchmark in milliseconds',
+    }),
+    timeout: bargs_1.opt.number({
+        description: 'Timeout per benchmark in milliseconds',
+    }),
+    warmup: bargs_1.opt.number({
+        aliases: ['w', 'warm'],
+        description: 'Number of warmup iterations',
+    }),
+}), bargs_1.pos.positionals(bargs_1.pos.variadic('string', {
+    description: 'File paths, directory paths, or glob patterns for benchmark files',
+    name: 'pattern',
+})));
+/**
+ * Parser for `run` command with validation and camelCase values
+ *
+ * Validates that --output-file is only used with a single reporter. Uses
+ * camelCaseValues transform for cleaner property access.
+ */
+exports.runParser = (0, bargs_1.map)((0, bargs_1.map)(runParserBase, ({ positionals, values }) => {
+    if (values.reporter &&
+        values.reporter.length > 1 &&
+        values['output-file']) {
+        throw new Error('--output-file can only be used with a single reporter. Use --output <dir> for multiple reporters.');
+    }
+    return { positionals, values };
+}), bargs_1.camelCaseValues);
+//# sourceMappingURL=run.js.map

package/dist/cli/parsers/run.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.js","sourceRoot":"","sources":["../../../src/cli/parsers/run.ts"],"names":[],"mappings":"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"}

package/dist/cli/parsers/run.d.cts

@@ -0,0 +1,62 @@
+/**
+ * Run Command Parser
+ *
+ * Parser for the `run` command which executes benchmark files.
+ *
+ * @packageDocumentation
+ */
+/**
+ * Parser for `run` command with validation and camelCase values
+ *
+ * Validates that --output-file is only used with a single reporter. Uses
+ * camelCaseValues transform for cleaner property access.
+ */
+export declare const runParser: import("@boneskull/bargs").Parser<import("@boneskull/bargs").CamelCaseKeys<import("@boneskull/bargs").InferOptions<{
+    bail: import("@boneskull/bargs").BooleanOption & {
+        aliases: string[];
+        description: string;
+    };
+    engine: import("@boneskull/bargs").EnumOption<"accurate" | "tinybench"> & {
+        aliases: string[];
+        description: string;
+    };
+    exclude: import("@boneskull/bargs").ArrayOption;
+    'exclude-tag': import("@boneskull/bargs").ArrayOption;
+    iterations: import("@boneskull/bargs").NumberOption & {
+        aliases: string[];
+        description: string;
+    };
+    'json-pretty': import("@boneskull/bargs").BooleanOption & {
+        description: string;
+    };
+    'limit-by': import("@boneskull/bargs").EnumOption<"any" | "time" | "iterations" | "all"> & {
+        aliases: string[];
+        description: string;
+    };
+    output: {
+        aliases: string[];
+        description: string;
+    } & import("@boneskull/bargs").StringOption;
+    'output-file': {
+        aliases: string[];
+        description: string;
+    } & import("@boneskull/bargs").StringOption;
+    quiet: import("@boneskull/bargs").BooleanOption & {
+        aliases: string[];
+        description: string;
+    };
+    reporter: import("@boneskull/bargs").EnumArrayOption<"csv" | "human" | "json" | "nyan" | "simple">;
+    tag: import("@boneskull/bargs").ArrayOption;
+    time: import("@boneskull/bargs").NumberOption & {
+        aliases: string[];
+        description: string;
+    };
+    timeout: import("@boneskull/bargs").NumberOption & {
+        description: string;
+    };
+    warmup: import("@boneskull/bargs").NumberOption & {
+        aliases: string[];
+        description: string;
+    };
+}> & object>, readonly [string[]]>;
+//# sourceMappingURL=run.d.ts.map

package/dist/cli/parsers/run.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../../src/cli/parsers/run.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA2FH;;;;;GAKG;AACH,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kCAcrB,CAAC"}

package/dist/cli/parsers/run.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Run Command Parser
+ *
+ * Parser for the `run` command which executes benchmark files.
+ *
+ * @packageDocumentation
+ */
+/**
+ * Parser for `run` command with validation and camelCase values
+ *
+ * Validates that --output-file is only used with a single reporter. Uses
+ * camelCaseValues transform for cleaner property access.
+ */
+export declare const runParser: import("@boneskull/bargs").Parser<import("@boneskull/bargs").CamelCaseKeys<import("@boneskull/bargs").InferOptions<{
+    bail: import("@boneskull/bargs").BooleanOption & {
+        aliases: string[];
+        description: string;
+    };
+    engine: import("@boneskull/bargs").EnumOption<"accurate" | "tinybench"> & {
+        aliases: string[];
+        description: string;
+    };
+    exclude: import("@boneskull/bargs").ArrayOption;
+    'exclude-tag': import("@boneskull/bargs").ArrayOption;
+    iterations: import("@boneskull/bargs").NumberOption & {
+        aliases: string[];
+        description: string;
+    };
+    'json-pretty': import("@boneskull/bargs").BooleanOption & {
+        description: string;
+    };
+    'limit-by': import("@boneskull/bargs").EnumOption<"any" | "time" | "iterations" | "all"> & {
+        aliases: string[];
+        description: string;
+    };
+    output: {
+        aliases: string[];
+        description: string;
+    } & import("@boneskull/bargs").StringOption;
+    'output-file': {
+        aliases: string[];
+        description: string;
+    } & import("@boneskull/bargs").StringOption;
+    quiet: import("@boneskull/bargs").BooleanOption & {
+        aliases: string[];
+        description: string;
+    };
+    reporter: import("@boneskull/bargs").EnumArrayOption<"csv" | "human" | "json" | "nyan" | "simple">;
+    tag: import("@boneskull/bargs").ArrayOption;
+    time: import("@boneskull/bargs").NumberOption & {
+        aliases: string[];
+        description: string;
+    };
+    timeout: import("@boneskull/bargs").NumberOption & {
+        description: string;
+    };
+    warmup: import("@boneskull/bargs").NumberOption & {
+        aliases: string[];
+        description: string;
+    };
+}> & object>, readonly [string[]]>;
+//# sourceMappingURL=run.d.ts.map

package/dist/cli/parsers/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../../src/cli/parsers/run.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA2FH;;;;;GAKG;AACH,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kCAcrB,CAAC"}

package/dist/cli/parsers/run.js

@@ -0,0 +1,96 @@
+/**
+ * Run Command Parser
+ *
+ * Parser for the `run` command which executes benchmark files.
+ *
+ * @packageDocumentation
+ */
+import { camelCaseValues, map, merge, opt, pos } from '@boneskull/bargs';
+import { DEFAULT_REPORTER, Engines, Reporters } from "../../constants.js";
+/**
+ * Base parser for `run` command options and positionals
+ */
+const runParserBase = merge(opt.options({
+    bail: opt.boolean({
+        aliases: ['b'],
+        description: 'Stop on first failure',
+    }),
+    engine: opt.enum([Engines.TINYBENCH, Engines.ACCURATE], {
+        aliases: ['e'],
+        description: 'Benchmark engine: tinybench (default) or accurate (requires --allow-natives-syntax)',
+    }),
+    exclude: opt.array('string', {
+        aliases: ['X'],
+        description: 'Exclude patterns',
+    }),
+    'exclude-tag': opt.array('string', {
+        aliases: ['T'],
+        description: 'Exclude benchmarks with any of these tags',
+    }),
+    iterations: opt.number({
+        aliases: ['i'],
+        description: 'Number of iterations per benchmark',
+    }),
+    'json-pretty': opt.boolean({
+        description: 'Pretty-print JSON output (only affects json reporter)',
+    }),
+    'limit-by': opt.enum(['time', 'iterations', 'any', 'all'], {
+        aliases: ['l', 'limit'],
+        description: 'How to limit benchmarks: time (time budget), iterations (sample count), any (either threshold), all (both thresholds)',
+    }),
+    output: opt.string({
+        aliases: ['o'],
+        description: 'Output directory for reports',
+    }),
+    'output-file': opt.string({
+        aliases: ['of', 'file'],
+        description: 'Custom filename for reporter output (use with single reporter only)',
+    }),
+    quiet: opt.boolean({
+        aliases: ['q'],
+        description: 'Minimal output',
+    }),
+    reporter: opt.array([
+        Reporters.HUMAN,
+        Reporters.JSON,
+        Reporters.CSV,
+        Reporters.NYAN,
+        Reporters.SIMPLE,
+    ], {
+        aliases: ['r'],
+        default: [DEFAULT_REPORTER],
+        description: 'Output reporters to use (human,json,csv)',
+    }),
+    tag: opt.array('string', {
+        description: 'Include only benchmarks with any of these tags',
+    }),
+    time: opt.number({
+        aliases: ['t'],
+        description: 'Time budget per benchmark in milliseconds',
+    }),
+    timeout: opt.number({
+        description: 'Timeout per benchmark in milliseconds',
+    }),
+    warmup: opt.number({
+        aliases: ['w', 'warm'],
+        description: 'Number of warmup iterations',
+    }),
+}), pos.positionals(pos.variadic('string', {
+    description: 'File paths, directory paths, or glob patterns for benchmark files',
+    name: 'pattern',
+})));
+/**
+ * Parser for `run` command with validation and camelCase values
+ *
+ * Validates that --output-file is only used with a single reporter. Uses
+ * camelCaseValues transform for cleaner property access.
+ */
+export const runParser = map(map(runParserBase, ({ positionals, values }) => {
+    if (values.reporter &&
+        values.reporter.length > 1 &&
+        values['output-file']) {
+        throw new Error('--output-file can only be used with a single reporter. Use --output <dir> for multiple reporters.');
+    }
+    return { positionals, values };
+}), camelCaseValues);
+//# sourceMappingURL=run.js.map

package/dist/cli/parsers/run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.js","sourceRoot":"","sources":["../../../src/cli/parsers/run.ts"],"names":[],"mappings":"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"}

package/dist/cli/parsers/test.cjs

@@ -0,0 +1,42 @@
+"use strict";
+/**
+ * Test Command Parser
+ *
+ * Parser for the `test` command which runs test files as benchmarks.
+ *
+ * @packageDocumentation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.testParser = void 0;
+const bargs_1 = require("@boneskull/bargs");
+/**
+ * Parser for `test` command
+ */
+exports.testParser = (0, bargs_1.merge)(bargs_1.opt.options({
+    bail: bargs_1.opt.boolean({
+        aliases: ['b'],
+        description: 'Stop on first failure',
+    }),
+    iterations: bargs_1.opt.number({
+        aliases: ['i'],
+        default: 100,
+        description: 'Number of iterations per test',
+    }),
+    quiet: bargs_1.opt.boolean({
+        aliases: ['q'],
+        description: 'Minimal output',
+    }),
+    warmup: bargs_1.opt.number({
+        aliases: ['w'],
+        default: 5,
+        description: 'Number of warmup iterations',
+    }),
+}), bargs_1.pos.positionals(bargs_1.pos.enum(['ava', 'jest', 'mocha', 'node-test'], {
+    description: 'Test framework to use',
+    name: 'framework',
+    required: true,
+}), bargs_1.pos.variadic('string', {
+    description: 'Test file paths or glob patterns',
+    name: 'files',
+})));
+//# sourceMappingURL=test.js.map

package/dist/cli/parsers/test.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"test.js","sourceRoot":"","sources":["../../../src/cli/parsers/test.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAEH,4CAAmD;AAEnD;;GAEG;AACU,QAAA,UAAU,GAAG,IAAA,aAAK,EAC7B,WAAG,CAAC,OAAO,CAAC;IACV,IAAI,EAAE,WAAG,CAAC,OAAO,CAAC;QAChB,OAAO,EAAE,CAAC,GAAG,CAAC;QACd,WAAW,EAAE,uBAAuB;KACrC,CAAC;IACF,UAAU,EAAE,WAAG,CAAC,MAAM,CAAC;QACrB,OAAO,EAAE,CAAC,GAAG,CAAC;QACd,OAAO,EAAE,GAAG;QACZ,WAAW,EAAE,+BAA+B;KAC7C,CAAC;IACF,KAAK,EAAE,WAAG,CAAC,OAAO,CAAC;QACjB,OAAO,EAAE,CAAC,GAAG,CAAC;QACd,WAAW,EAAE,gBAAgB;KAC9B,CAAC;IACF,MAAM,EAAE,WAAG,CAAC,MAAM,CAAC;QACjB,OAAO,EAAE,CAAC,GAAG,CAAC;QACd,OAAO,EAAE,CAAC;QACV,WAAW,EAAE,6BAA6B;KAC3C,CAAC;CACH,CAAC,EACF,WAAG,CAAC,WAAW,CACb,WAAG,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,CAAU,EAAE;IACvD,WAAW,EAAE,uBAAuB;IACpC,IAAI,EAAE,WAAW;IACjB,QAAQ,EAAE,IAAI;CACf,CAAC,EACF,WAAG,CAAC,QAAQ,CAAC,QAAQ,EAAE;IACrB,WAAW,EAAE,kCAAkC;IAC/C,IAAI,EAAE,OAAO;CACd,CAAC,CACH,CACF,CAAC"}

package/dist/cli/parsers/test.d.cts

@@ -0,0 +1,31 @@
+/**
+ * Test Command Parser
+ *
+ * Parser for the `test` command which runs test files as benchmarks.
+ *
+ * @packageDocumentation
+ */
+/**
+ * Parser for `test` command
+ */
+export declare const testParser: import("@boneskull/bargs").Parser<import("@boneskull/bargs").InferOptions<{
+    bail: import("@boneskull/bargs").BooleanOption & {
+        aliases: string[];
+        description: string;
+    };
+    iterations: import("@boneskull/bargs").NumberOption & {
+        aliases: string[];
+        default: number;
+        description: string;
+    };
+    quiet: import("@boneskull/bargs").BooleanOption & {
+        aliases: string[];
+        description: string;
+    };
+    warmup: import("@boneskull/bargs").NumberOption & {
+        aliases: string[];
+        default: number;
+        description: string;
+    };
+}> & object, readonly ["ava" | "jest" | "mocha" | "node-test", string[]]>;
+//# sourceMappingURL=test.d.ts.map

package/dist/cli/parsers/test.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test.d.ts","sourceRoot":"","sources":["../../../src/cli/parsers/test.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH;;GAEG;AACH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;yEAgCtB,CAAC"}