@fuzdev/fuz_util 0.54.0 → 0.56.0

package/dist/zod.d.ts

@@ -10,8 +10,8 @@ import type { z } from 'zod';
 /**
  * Unwrap nested schema types (optional, default, nullable, etc).
  *
- * @param def - Zod type definition to unwrap.
- * @returns Inner schema if wrapped, undefined otherwise.
+ * @param def - Zod type definition to unwrap
+ * @returns inner schema if wrapped, undefined otherwise
  */
 export declare const zod_to_subschema: (def: z.core.$ZodTypeDef) => z.ZodType | undefined;
 /** Zod wrapper type names that `zod_unwrap_def` traverses through. */
@@ -78,36 +78,36 @@ export declare const zod_extract_fields: (schema: z.ZodObject) => Array<ZodField
 /**
  * Get the description from a schema's metadata, unwrapping if needed.
  *
- * @param schema - Zod schema to extract description from.
- * @returns Description string or null if not found.
+ * @param schema - Zod schema to extract description from
+ * @returns description string or null if not found
  */
 export declare const zod_to_schema_description: (schema: z.ZodType) => string | null;
 /**
  * Get the default value from a schema, unwrapping if needed.
  *
- * @param schema - Zod schema to extract default from.
- * @returns Default value or undefined.
+ * @param schema - Zod schema to extract default from
+ * @returns default value or undefined
  */
 export declare const zod_to_schema_default: (schema: z.ZodType) => unknown;
 /**
  * Get aliases from a schema's metadata, unwrapping if needed.
  *
- * @param schema - Zod schema to extract aliases from.
- * @returns Array of alias strings.
+ * @param schema - Zod schema to extract aliases from
+ * @returns array of alias strings
  */
 export declare const zod_to_schema_aliases: (schema: z.ZodType) => Array<string>;
 /**
  * Get the type string for a schema, suitable for display.
  *
- * @param schema - Zod schema to get type string for.
- * @returns Human-readable type string.
+ * @param schema - Zod schema to get type string for
+ * @returns human-readable type string
  */
 export declare const zod_to_schema_type_string: (schema: z.ZodType) => string;
 /**
  * Format a value for display in help text.
  *
- * @param value - Value to format.
- * @returns Formatted string representation.
+ * @param value - value to format
+ * @returns formatted string representation
  */
 export declare const zod_format_value: (value: unknown) => string;
 /**
@@ -123,15 +123,15 @@ export interface ZodSchemaProperty {
 /**
  * Extract properties from a Zod object schema.
  *
- * @param schema - Zod object schema to extract from.
- * @returns Array of property definitions.
+ * @param schema - Zod object schema to extract from
+ * @returns array of property definitions
  */
 export declare const zod_to_schema_properties: (schema: z.ZodType) => Array<ZodSchemaProperty>;
 /**
  * Get all property names and their aliases from an object schema.
  *
- * @param schema - Zod object schema.
- * @returns Set of all names and aliases.
+ * @param schema - Zod object schema
+ * @returns set of all names and aliases
  */
 export declare const zod_to_schema_names_with_aliases: (schema: z.ZodType) => Set<string>;
 //# sourceMappingURL=zod.d.ts.map

package/dist/zod.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"zod.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/zod.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAM3B;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,GAAI,KAAK,CAAC,CAAC,IAAI,CAAC,WAAW,KAAG,CAAC,CAAC,OAAO,GAAG,SAStE,CAAC;AAEF,sEAAsE;AACtE,eAAO,MAAM,iBAAiB,aAO5B,CAAC;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,GAAI,QAAQ,CAAC,CAAC,OAAO,KAAG,CAAC,CAAC,IAAI,CAAC,WAOzD,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,GAAI,QAAQ,CAAC,CAAC,OAAO,KAAG,MAAqC,CAAC;AAE5F;;;;GAIG;AACH,eAAO,MAAM,eAAe,GAAI,QAAQ,CAAC,CAAC,OAAO,KAAG,OAA8C,CAAC;AAEnG;;;;GAIG;AACH,eAAO,MAAM,eAAe,GAAI,QAAQ,CAAC,CAAC,OAAO,KAAG,OAQnD,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,GAAI,QAAQ,CAAC,CAAC,OAAO,KAAG,OAMnD,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,GAAI,QAAQ,CAAC,CAAC,OAAO,KAAG,CAAC,CAAC,SAAS,GAAG,IAUtE,CAAC;AAIF,qEAAqE;AACrE,MAAM,WAAW,YAAY;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,EAAE,OAAO,CAAC;IACrB,QAAQ,EAAE,OAAO,CAAC;CAClB;AAED;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,GAAI,QAAQ,CAAC,CAAC,SAAS,KAAG,KAAK,CAAC,YAAY,CAa1E,CAAC;AAIF;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB,GAAI,QAAQ,CAAC,CAAC,OAAO,KAAG,MAAM,GAAG,IAUtE,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,GAAI,QAAQ,CAAC,CAAC,OAAO,KAAG,OAUzD,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,GAAI,QAAQ,CAAC,CAAC,OAAO,KAAG,KAAK,CAAC,MAAM,CAUrE,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB,GAAI,QAAQ,CAAC,CAAC,OAAO,KAAG,MA4C7D,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,GAAI,OAAO,OAAO,KAAG,MAQjD,CAAC;AAMF;;GAEG;AACH,MAAM,WAAW,iBAAiB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;CACvB;AAED;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,GAAI,QAAQ,CAAC,CAAC,OAAO,KAAG,KAAK,CAAC,iBAAiB,CAuBnF,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,gCAAgC,GAAI,QAAQ,CAAC,CAAC,OAAO,KAAG,GAAG,CAAC,MAAM,CAW9E,CAAC"}
+{"version":3,"file":"zod.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/zod.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAM3B;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,GAAI,KAAK,CAAC,CAAC,IAAI,CAAC,WAAW,KAAG,CAAC,CAAC,OAAO,GAAG,SAStE,CAAC;AAEF,sEAAsE;AACtE,eAAO,MAAM,iBAAiB,aAO5B,CAAC;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,GAAI,QAAQ,CAAC,CAAC,OAAO,KAAG,CAAC,CAAC,IAAI,CAAC,WAOzD,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,GAAI,QAAQ,CAAC,CAAC,OAAO,KAAG,MAAqC,CAAC;AAE5F;;;;GAIG;AACH,eAAO,MAAM,eAAe,GAAI,QAAQ,CAAC,CAAC,OAAO,KAAG,OAAyC,CAAC;AAE9F;;;;GAIG;AACH,eAAO,MAAM,eAAe,GAAI,QAAQ,CAAC,CAAC,OAAO,KAAG,OAQnD,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,GAAI,QAAQ,CAAC,CAAC,OAAO,KAAG,OAMnD,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,GAAI,QAAQ,CAAC,CAAC,OAAO,KAAG,CAAC,CAAC,SAAS,GAAG,IAUtE,CAAC;AAIF,qEAAqE;AACrE,MAAM,WAAW,YAAY;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,EAAE,OAAO,CAAC;IACrB,QAAQ,EAAE,OAAO,CAAC;CAClB;AAED;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,GAAI,QAAQ,CAAC,CAAC,SAAS,KAAG,KAAK,CAAC,YAAY,CAa1E,CAAC;AAIF;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB,GAAI,QAAQ,CAAC,CAAC,OAAO,KAAG,MAAM,GAAG,IAUtE,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,GAAI,QAAQ,CAAC,CAAC,OAAO,KAAG,OAUzD,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,GAAI,QAAQ,CAAC,CAAC,OAAO,KAAG,KAAK,CAAC,MAAM,CAUrE,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB,GAAI,QAAQ,CAAC,CAAC,OAAO,KAAG,MA4C7D,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,GAAI,OAAO,OAAO,KAAG,MAQjD,CAAC;AAMF;;GAEG;AACH,MAAM,WAAW,iBAAiB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;CACvB;AAED;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,GAAI,QAAQ,CAAC,CAAC,OAAO,KAAG,KAAK,CAAC,iBAAiB,CAuBnF,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,gCAAgC,GAAI,QAAQ,CAAC,CAAC,OAAO,KAAG,GAAG,CAAC,MAAM,CAW9E,CAAC"}

package/dist/zod.js

@@ -12,8 +12,8 @@
 /**
  * Unwrap nested schema types (optional, default, nullable, etc).
  *
- * @param def - Zod type definition to unwrap.
- * @returns Inner schema if wrapped, undefined otherwise.
+ * @param def - Zod type definition to unwrap
+ * @returns inner schema if wrapped, undefined otherwise
  */
 export const zod_to_subschema = (def) => {
     if ('innerType' in def) {
@@ -44,7 +44,7 @@ export const ZOD_WRAPPER_TYPES = new Set([
  * @returns the innermost non-wrapper type definition
  */
 export const zod_unwrap_def = (schema) => {
-    const def = schema._zod.def;
+    const { def } = schema;
     if (ZOD_WRAPPER_TYPES.has(def.type)) {
         const sub = zod_to_subschema(def);
         if (sub)
@@ -64,14 +64,14 @@ export const zod_get_base_type = (schema) => zod_unwrap_def(schema).type;
  *
  * @param schema - Zod schema to check
  */
-export const zod_is_optional = (schema) => schema._zod.def.type === 'optional';
+export const zod_is_optional = (schema) => schema.def.type === 'optional';
 /**
  * Check if a schema accepts null at any wrapping level.
  *
  * @param schema - Zod schema to check
  */
 export const zod_is_nullable = (schema) => {
-    const def = schema._zod.def;
+    const { def } = schema;
     if (def.type === 'nullable')
         return true;
     if (ZOD_WRAPPER_TYPES.has(def.type)) {
@@ -90,7 +90,7 @@ export const zod_is_nullable = (schema) => {
  * @param schema - Zod schema to check
  */
 export const zod_has_default = (schema) => {
-    const def = schema._zod.def;
+    const { def } = schema;
     if ('defaultValue' in def)
         return true;
     const sub = zod_to_subschema(def);
@@ -110,8 +110,8 @@ export const zod_unwrap_to_object = (schema) => {
     if (def.type !== 'object')
         return null;
     let s = schema;
-    while (s._zod.def.type !== 'object') {
-        const sub = zod_to_subschema(s._zod.def);
+    while (s.def.type !== 'object') {
+        const sub = zod_to_subschema(s.def);
         if (!sub)
             return null;
         s = sub;
@@ -142,8 +142,8 @@ export const zod_extract_fields = (schema) => {
 /**
  * Get the description from a schema's metadata, unwrapping if needed.
  *
- * @param schema - Zod schema to extract description from.
- * @returns Description string or null if not found.
+ * @param schema - Zod schema to extract description from
+ * @returns description string or null if not found
  */
 export const zod_to_schema_description = (schema) => {
     const meta = schema.meta();
@@ -159,11 +159,11 @@ export const zod_to_schema_description = (schema) => {
 /**
  * Get the default value from a schema, unwrapping if needed.
  *
- * @param schema - Zod schema to extract default from.
- * @returns Default value or undefined.
+ * @param schema - Zod schema to extract default from
+ * @returns default value or undefined
  */
 export const zod_to_schema_default = (schema) => {
-    const { def } = schema._zod;
+    const { def } = schema;
     if ('defaultValue' in def) {
         return def.defaultValue;
     }
@@ -176,8 +176,8 @@ export const zod_to_schema_default = (schema) => {
 /**
  * Get aliases from a schema's metadata, unwrapping if needed.
  *
- * @param schema - Zod schema to extract aliases from.
- * @returns Array of alias strings.
+ * @param schema - Zod schema to extract aliases from
+ * @returns array of alias strings
  */
 export const zod_to_schema_aliases = (schema) => {
     const meta = schema.meta();
@@ -193,11 +193,11 @@ export const zod_to_schema_aliases = (schema) => {
 /**
  * Get the type string for a schema, suitable for display.
  *
- * @param schema - Zod schema to get type string for.
- * @returns Human-readable type string.
+ * @param schema - Zod schema to get type string for
+ * @returns human-readable type string
  */
 export const zod_to_schema_type_string = (schema) => {
-    const { def } = schema._zod;
+    const { def } = schema;
     switch (def.type) {
         case 'string':
             return 'string';
@@ -244,8 +244,8 @@ export const zod_to_schema_type_string = (schema) => {
 /**
  * Format a value for display in help text.
  *
- * @param value - Value to format.
- * @returns Formatted string representation.
+ * @param value - value to format
+ * @returns formatted string representation
  */
 export const zod_format_value = (value) => {
     if (value === undefined)
@@ -265,8 +265,8 @@ export const zod_format_value = (value) => {
 /**
  * Extract properties from a Zod object schema.
  *
- * @param schema - Zod object schema to extract from.
- * @returns Array of property definitions.
+ * @param schema - Zod object schema to extract from
+ * @returns array of property definitions
  */
 export const zod_to_schema_properties = (schema) => {
     const { def } = schema;
@@ -293,8 +293,8 @@ export const zod_to_schema_properties = (schema) => {
 /**
  * Get all property names and their aliases from an object schema.
  *
- * @param schema - Zod object schema.
- * @returns Set of all names and aliases.
+ * @param schema - Zod object schema
+ * @returns set of all names and aliases
  */
 export const zod_to_schema_names_with_aliases = (schema) => {
     const names = new Set();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fuzdev/fuz_util",
-  "version": "0.54.0",
+  "version": "0.56.0",
   "description": "utility belt for JS",
   "glyph": "🦕",
   "logo": "logo.svg",
@@ -75,11 +75,11 @@
   },
   "devDependencies": {
     "@changesets/changelog-git": "^0.2.1",
-    "@fuzdev/blake3_wasm": "^0.1.0",
+    "@fuzdev/blake3_wasm": "^0.1.1",
     "@fuzdev/fuz_code": "^0.45.1",
-    "@fuzdev/fuz_css": "^0.55.0",
-    "@fuzdev/fuz_ui": "^0.188.0",
-    "@fuzdev/gro": "^0.197.0",
+    "@fuzdev/fuz_css": "^0.58.0",
+    "@fuzdev/fuz_ui": "^0.191.3",
+    "@fuzdev/gro": "^0.197.3",
     "@jridgewell/trace-mapping": "^0.3.31",
     "@ryanatkn/eslint-config": "^0.10.1",
     "@sveltejs/acorn-typescript": "^1.0.9",
@@ -98,7 +98,7 @@
     "magic-string": "^0.30.21",
     "prettier": "^3.7.4",
     "prettier-plugin-svelte": "^3.4.1",
-    "svelte": "^5.53.10",
+    "svelte": "^5.55.0",
     "svelte-check": "^4.3.6",
     "svelte2tsx": "^0.7.47",
     "tslib": "^2.8.1",

package/src/lib/args.ts

@@ -25,7 +25,7 @@ export type ArgValue = string | number | boolean | undefined | Array<string | nu
 
 /**
  * Schema description for help text generation.
- * Not used by args_parse/args_serialize directly - provided for consumers
+ * Not used by `args_parse`/`args_serialize` directly - provided for consumers
  * building CLI help output.
  */
 export interface ArgSchema {
@@ -184,8 +184,8 @@ const get_schema_cache = (schema: z.ZodType): SchemaCacheEntry => {
  *
  * Results are cached per schema (WeakMap). Safe to call multiple times.
  *
- * @param schema Zod object schema with optional alias metadata
- * @returns Validation result with success flag and optional error
+ * @param schema - zod object schema with optional alias metadata
+ * @returns validation result with success flag and optional error
  */
 export const args_validate_schema = (
 	schema: z.ZodType,
@@ -209,8 +209,8 @@ export const args_validate_schema = (
  *
  * Schema analysis is cached per schema (WeakMap) for performance.
  *
- * @param unparsed_args Args object from CLI parser (mri, minimist, etc.)
- * @param schema Zod object schema with optional alias metadata
+ * @param unparsed_args - args object from CLI parser (mri, minimist, etc.)
+ * @param schema - zod object schema with optional alias metadata
  * @returns Zod SafeParseResult with expanded/synced data on success
  */
 export const args_parse = <TOutput extends Record<string, ArgValue> = Args>(
@@ -276,9 +276,9 @@ export const args_parse = <TOutput extends Record<string, ArgValue> = Args>(
  *
  * Schema analysis is cached per schema (WeakMap) for performance.
  *
- * @param args Args object to serialize
- * @param schema Optional zod schema to extract aliases for short form preference
- * @returns Array of CLI argument strings
+ * @param args - args object to serialize
+ * @param schema - optional zod schema to extract aliases for short form preference
+ * @returns array of CLI argument strings
  */
 export const args_serialize = (args: Args, schema?: z.ZodType): Array<string> => {
 	const result: Array<string> = [];
@@ -349,8 +349,8 @@ export const args_serialize = (args: Args, schema?: z.ZodType): Array<string> =>
  *
  * Note: Returns copies of the cached data to prevent mutation of internal cache.
  *
- * @param schema Zod object schema with optional `.meta({aliases})` on fields
- * @returns Object with aliases map and canonical_keys set
+ * @param schema - zod object schema with optional `.meta({aliases})` on fields
+ * @returns object with aliases map and canonical_keys set
  */
 export const args_extract_aliases = (schema: z.ZodType): ArgsAliasesResult => {
 	const cache = get_schema_cache(schema);
@@ -419,8 +419,8 @@ const set_arg = (args: Args, key: string, value: string | number | boolean): voi
  * The returned object uses `Object.create(null)` to prevent prototype pollution
  * and allow any key name including `__proto__` and `constructor`.
  *
- * @param argv Raw argument array (typically process.argv.slice(2))
- * @returns Parsed Args object with guaranteed `_` array (null prototype)
+ * @param argv - raw argument array (typically process.argv.slice(2))
+ * @returns parsed `Args` object with guaranteed `_` array (null prototype)
  */
 export const argv_parse = (argv: Array<string>): ParsedArgs => {
 	// Use Object.create(null) to allow __proto__ as a normal key

package/src/lib/async.ts

@@ -38,10 +38,10 @@ export const create_deferred = <T>(): Deferred<T> => {
  * Runs a function on each item with controlled concurrency.
  * Like `map_concurrent` but doesn't collect results (more efficient for side effects).
  *
- * @param items items to process
- * @param concurrency maximum number of concurrent operations
- * @param fn function to apply to each item
- * @param signal optional `AbortSignal` to cancel processing
+ * @param items - items to process
+ * @param concurrency - maximum number of concurrent operations
+ * @param fn - function to apply to each item
+ * @param signal - optional `AbortSignal` to cancel processing
  *
  * @example
  * ```ts
@@ -123,10 +123,10 @@ export const each_concurrent = async <T>(
 /**
  * Maps over items with controlled concurrency, preserving input order.
  *
- * @param items items to process
- * @param concurrency maximum number of concurrent operations
- * @param fn function to apply to each item
- * @param signal optional `AbortSignal` to cancel processing
+ * @param items - items to process
+ * @param concurrency - maximum number of concurrent operations
+ * @param fn - function to apply to each item
+ * @param signal - optional `AbortSignal` to cancel processing
  * @returns promise resolving to array of results in same order as input
  *
  * @example
@@ -215,10 +215,10 @@ export const map_concurrent = async <T, R>(
  * On abort, resolves with partial results: completed items keep their real settlements,
  * in-flight and un-started items are settled as rejected with the abort reason.
  *
- * @param items items to process
- * @param concurrency maximum number of concurrent operations
- * @param fn function to apply to each item
- * @param signal optional `AbortSignal` to cancel processing
+ * @param items - items to process
+ * @param concurrency - maximum number of concurrent operations
+ * @param fn - function to apply to each item
+ * @param signal - optional `AbortSignal` to cancel processing
  * @returns promise resolving to array of `PromiseSettledResult` objects in input order
  *
  * @example

package/src/lib/benchmark.ts

@@ -44,8 +44,8 @@ import type {
 const DEFAULT_DURATION_MS = 1000;
 const DEFAULT_WARMUP_ITERATIONS = 10;
 const DEFAULT_COOLDOWN_MS = 100;
-const DEFAULT_MIN_ITERATIONS = 10;
-const DEFAULT_MAX_ITERATIONS = 100_000;
+const DEFAULT_ITERATIONS_MIN = 10;
+const DEFAULT_ITERATIONS_MAX = 100_000;
 
 /**
  * Validate and normalize benchmark configuration.
@@ -90,10 +90,10 @@ interface BenchmarkTaskInternal extends BenchmarkTask {
  * Warmup function by running it multiple times.
  * Detects whether the function is async based on return value.
  *
- * @param fn - Function to warmup (sync or async)
- * @param iterations - Number of warmup iterations
- * @param async_hint - If provided, use this instead of detecting
- * @returns Whether the function is async
+ * @param fn - function to warmup (sync or async)
+ * @param iterations - number of warmup iterations
+ * @param async_hint - if provided, use this instead of detecting
+ * @returns whether the function is async
  *
  * @example
  * ```ts
@@ -146,8 +146,8 @@ export class Benchmark {
 			duration_ms: config.duration_ms ?? DEFAULT_DURATION_MS,
 			warmup_iterations: config.warmup_iterations ?? DEFAULT_WARMUP_ITERATIONS,
 			cooldown_ms: config.cooldown_ms ?? DEFAULT_COOLDOWN_MS,
-			min_iterations: config.min_iterations ?? DEFAULT_MIN_ITERATIONS,
-			max_iterations: config.max_iterations ?? DEFAULT_MAX_ITERATIONS,
+			min_iterations: config.min_iterations ?? DEFAULT_ITERATIONS_MIN,
+			max_iterations: config.max_iterations ?? DEFAULT_ITERATIONS_MAX,
 			timer: config.timer ?? timer_default,
 			on_iteration: config.on_iteration,
 			on_task_complete: config.on_task_complete,
@@ -156,9 +156,9 @@ export class Benchmark {
 
 	/**
 	 * Add a benchmark task.
-	 * @param name - Task name or full task object
+	 * @param name - task name or full task object
 	 * @param fn - Function to benchmark (if name is string). Return values are ignored.
-	 * @returns This Benchmark instance for chaining
+	 * @returns this `Benchmark` instance for chaining
 	 *
 	 * @example
 	 * ```ts
@@ -194,8 +194,8 @@ export class Benchmark {
 
 	/**
 	 * Remove a benchmark task by name.
-	 * @param name - Name of the task to remove
-	 * @returns This Benchmark instance for chaining
+	 * @param name - name of the task to remove
+	 * @returns this `Benchmark` instance for chaining
 	 * @throws Error if task with given name doesn't exist
 	 *
 	 * @example
@@ -217,8 +217,8 @@ export class Benchmark {
 
 	/**
 	 * Mark a task to be skipped during benchmark runs.
-	 * @param name - Name of the task to skip
-	 * @returns This Benchmark instance for chaining
+	 * @param name - name of the task to skip
+	 * @returns this `Benchmark` instance for chaining
 	 * @throws Error if task with given name doesn't exist
 	 *
 	 * @example
@@ -240,8 +240,8 @@ export class Benchmark {
 
 	/**
 	 * Mark a task to run exclusively (along with other `only` tasks).
-	 * @param name - Name of the task to run exclusively
-	 * @returns This Benchmark instance for chaining
+	 * @param name - name of the task to run exclusively
+	 * @returns this `Benchmark` instance for chaining
 	 * @throws Error if task with given name doesn't exist
 	 *
 	 * @example
@@ -264,7 +264,7 @@ export class Benchmark {
 
 	/**
 	 * Run all benchmark tasks.
-	 * @returns Array of benchmark results
+	 * @returns array of benchmark results
 	 */
 	async run(): Promise<Array<BenchmarkResult>> {
 		this.#results = [];
@@ -385,8 +385,8 @@ export class Benchmark {
 
 	/**
 	 * Format results as an ASCII table with percentiles, min/max, and relative performance.
-	 * @param options - Formatting options
-	 * @returns Formatted table string
+	 * @param options - formatting options
+	 * @returns formatted table string
 	 *
 	 * @example
 	 * ```ts
@@ -410,8 +410,8 @@ export class Benchmark {
 
 	/**
 	 * Format results as a Markdown table.
-	 * @param options - Formatting options (groups for organized output with optional baselines)
-	 * @returns Formatted markdown string
+	 * @param options - formatting options (groups for organized output with optional baselines)
+	 * @returns formatted markdown string
 	 *
 	 * @example
 	 * ```ts
@@ -435,7 +435,7 @@ export class Benchmark {
 
 	/**
 	 * Format results as JSON.
-	 * @param options - Formatting options (pretty, include_timings)
+	 * @param options - formatting options (pretty, include_timings)
 	 * @returns JSON string
 	 */
 	json(options?: BenchmarkFormatJsonOptions): string {
@@ -445,7 +445,7 @@ export class Benchmark {
 	/**
 	 * Get the benchmark results.
 	 * Returns a shallow copy to prevent external mutation.
-	 * @returns Array of benchmark results
+	 * @returns array of benchmark results
 	 */
 	results(): Array<BenchmarkResult> {
 		return [...this.#results];
@@ -453,7 +453,7 @@ export class Benchmark {
 
 	/**
 	 * Check if the benchmark has been run and has results.
-	 * @returns True if results are available
+	 * @returns true if results are available
 	 *
 	 * @example
 	 * ```ts
@@ -469,7 +469,7 @@ export class Benchmark {
 	/**
 	 * Get results as a map for convenient lookup by task name.
 	 * Returns a new Map each call to prevent external mutation.
-	 * @returns Map of task name to benchmark result
+	 * @returns map of task name to benchmark result
 	 *
 	 * @example
 	 * ```ts
@@ -487,7 +487,7 @@ export class Benchmark {
 	/**
 	 * Reset the benchmark results.
 	 * Keeps tasks intact so benchmarks can be rerun.
-	 * @returns This Benchmark instance for chaining
+	 * @returns this `Benchmark` instance for chaining
 	 */
 	reset(): this {
 		this.#results = [];
@@ -497,7 +497,7 @@ export class Benchmark {
 	/**
 	 * Clear everything (results and tasks).
 	 * Use this to start fresh with a new set of benchmarks.
-	 * @returns This Benchmark instance for chaining
+	 * @returns this `Benchmark` instance for chaining
 	 */
 	clear(): this {
 		this.#results = [];
@@ -507,7 +507,7 @@ export class Benchmark {
 
 	/**
 	 * Get a quick text summary of the fastest task.
-	 * @returns Human-readable summary string
+	 * @returns human-readable summary string
 	 *
 	 * @example
 	 * ```ts