@fuzdev/fuz_util 0.55.0 → 0.56.0

package/dist/testing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/testing.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,UAAU,CAAC;AAErC;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,cAAc,GAC1B,IAAI,MAAM,OAAO,CAAC,OAAO,CAAC,EAC1B,UAAU,MAAM,KACd,OAAO,CAAC,KAAK,CAWf,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG;IACjC,WAAW,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IAC5B,UAAU,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IAC3B,UAAU,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IAC3B,WAAW,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;CAC5B,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,QAAO,UAiBrC,CAAC"}

package/dist/testing.js

@@ -0,0 +1,59 @@
+/**
+ * Shared test assertions for the `@fuzdev` ecosystem.
+ *
+ * Extends the fuz-stack testing conventions (`assert` from vitest, tests in `src/test/`,
+ * plain object mocks) with reusable helpers for patterns that appear across multiple repos.
+ * Only depends on vitest — safe for fuz_util's zero-runtime-deps constraint.
+ *
+ * @module
+ */
+import { assert, vi } from 'vitest';
+/**
+ * Asserts that `fn` rejects with an `Error`.
+ * Optionally matches the error message against `pattern`.
+ * Returns the caught `Error` for further assertions by the caller.
+ *
+ * `assert.fail` is placed after the catch block so that assertion failures
+ * from the test itself are not swallowed by the catch.
+ *
+ * @param fn - async function expected to reject
+ * @param pattern - optional regex to match against the error message
+ * @returns the caught `Error`
+ */
+export const assert_rejects = async (fn, pattern) => {
+    try {
+        await fn();
+    }
+    catch (err) {
+        assert(err instanceof Error, 'Expected rejection to be an Error');
+        if (pattern) {
+            assert.match(err.message, pattern);
+        }
+        return err;
+    }
+    assert.fail('Expected to throw');
+};
+/**
+ * Creates a mock `Logger` with `vi.fn()` on each logging method
+ * and tracking arrays for inspecting logged messages.
+ * Follows the fuz-stack convention of plain object mocks over mocking libraries.
+ *
+ * @returns a `MockLogger` assignable to `Logger`
+ */
+export const create_mock_logger = () => {
+    const error_calls = [];
+    const warn_calls = [];
+    const info_calls = [];
+    const debug_calls = [];
+    return {
+        error: vi.fn((msg) => error_calls.push(msg)),
+        warn: vi.fn((msg) => warn_calls.push(msg)),
+        info: vi.fn((msg) => info_calls.push(msg)),
+        debug: vi.fn((msg) => debug_calls.push(msg)),
+        raw: vi.fn(),
+        error_calls,
+        warn_calls,
+        info_calls,
+        debug_calls,
+    };
+};

package/dist/time.d.ts

@@ -65,23 +65,23 @@ export declare const TIME_UNIT_DISPLAY: Record<TimeUnit, string>;
 /**
  * Detect the best time unit for a set of nanosecond values.
  * Chooses the unit where most values fall in the range 1-9999.
- * @param values_ns - Array of times in nanoseconds
- * @returns Best unit to use for all values
+ * @param values_ns - array of times in nanoseconds
+ * @returns best unit to use for all values
  */
 export declare const time_unit_detect_best: (values_ns: Array<number>) => TimeUnit;
 /**
  * Format time with a specific unit.
- * @param ns - Time in nanoseconds
- * @param unit - Unit to use ('ns', 'us', 'ms', 's')
- * @param decimals - Number of decimal places (default: 2)
- * @returns Formatted string like "3.87μs"
+ * @param ns - time in nanoseconds
+ * @param unit - unit to use ('ns', 'us', 'ms', 's')
+ * @param decimals - number of decimal places (default: 2)
+ * @returns formatted string like "3.87μs"
  */
 export declare const time_format: (ns: number, unit: TimeUnit, decimals?: number) => string;
 /**
  * Format time with adaptive units (ns/μs/ms/s) based on magnitude.
- * @param ns - Time in nanoseconds
- * @param decimals - Number of decimal places (default: 2)
- * @returns Formatted string like "3.87μs" or "1.23ms"
+ * @param ns - time in nanoseconds
+ * @param decimals - number of decimal places (default: 2)
+ * @returns formatted string like "3.87μs" or "1.23ms"
  *
  * @example
  * ```ts
@@ -110,9 +110,9 @@ export interface TimeResult {
 }
 /**
  * Time an asynchronous function execution.
- * @param fn - Async function to time
- * @param timer - Timer to use (defaults to timer_default)
- * @returns Object containing the function result and timing information
+ * @param fn - async function to time
+ * @param timer - timer to use (defaults to `timer_default`)
+ * @returns object containing the function result and timing information
  *
  * @example
  * ```ts
@@ -129,9 +129,9 @@ export declare const time_async: <T>(fn: () => Promise<T>, timer?: Timer) => Pro
 }>;
 /**
  * Time a synchronous function execution.
- * @param fn - Sync function to time
- * @param timer - Timer to use (defaults to timer_default)
- * @returns Object containing the function result and timing information
+ * @param fn - sync function to time
+ * @param timer - timer to use (defaults to `timer_default`)
+ * @returns object containing the function result and timing information
  *
  * @example
  * ```ts
@@ -147,10 +147,10 @@ export declare const time_sync: <T>(fn: () => T, timer?: Timer) => {
 };
 /**
  * Measure multiple executions of a function and return all timings.
- * @param fn - Function to measure (sync or async)
- * @param iterations - Number of times to execute
- * @param timer - Timer to use (defaults to timer_default)
- * @returns Array of elapsed times in nanoseconds
+ * @param fn - function to measure (sync or async)
+ * @param iterations - number of times to execute
+ * @param timer - timer to use (defaults to `timer_default`)
+ * @returns array of elapsed times in nanoseconds
  *
  * @example
  * ```ts

package/dist/time.js

@@ -96,8 +96,8 @@ export const TIME_UNIT_DISPLAY = { ns: 'ns', us: 'μs', ms: 'ms', s: 's' };
 /**
  * Detect the best time unit for a set of nanosecond values.
  * Chooses the unit where most values fall in the range 1-9999.
- * @param values_ns - Array of times in nanoseconds
- * @returns Best unit to use for all values
+ * @param values_ns - array of times in nanoseconds
+ * @returns best unit to use for all values
  */
 export const time_unit_detect_best = (values_ns) => {
     if (values_ns.length === 0)
@@ -125,10 +125,10 @@ export const time_unit_detect_best = (values_ns) => {
 };
 /**
  * Format time with a specific unit.
- * @param ns - Time in nanoseconds
- * @param unit - Unit to use ('ns', 'us', 'ms', 's')
- * @param decimals - Number of decimal places (default: 2)
- * @returns Formatted string like "3.87μs"
+ * @param ns - time in nanoseconds
+ * @param unit - unit to use ('ns', 'us', 'ms', 's')
+ * @param decimals - number of decimal places (default: 2)
+ * @returns formatted string like "3.87μs"
  */
 export const time_format = (ns, unit, decimals = 2) => {
     if (!isFinite(ns))
@@ -146,9 +146,9 @@ export const time_format = (ns, unit, decimals = 2) => {
 };
 /**
  * Format time with adaptive units (ns/μs/ms/s) based on magnitude.
- * @param ns - Time in nanoseconds
- * @param decimals - Number of decimal places (default: 2)
- * @returns Formatted string like "3.87μs" or "1.23ms"
+ * @param ns - time in nanoseconds
+ * @param decimals - number of decimal places (default: 2)
+ * @returns formatted string like "3.87μs" or "1.23ms"
  *
  * @example
  * ```ts
@@ -177,9 +177,9 @@ export const time_format_adaptive = (ns, decimals = 2) => {
 };
 /**
  * Time an asynchronous function execution.
- * @param fn - Async function to time
- * @param timer - Timer to use (defaults to timer_default)
- * @returns Object containing the function result and timing information
+ * @param fn - async function to time
+ * @param timer - timer to use (defaults to `timer_default`)
+ * @returns object containing the function result and timing information
  *
  * @example
  * ```ts
@@ -208,9 +208,9 @@ export const time_async = async (fn, timer = timer_default) => {
 };
 /**
  * Time a synchronous function execution.
- * @param fn - Sync function to time
- * @param timer - Timer to use (defaults to timer_default)
- * @returns Object containing the function result and timing information
+ * @param fn - sync function to time
+ * @param timer - timer to use (defaults to `timer_default`)
+ * @returns object containing the function result and timing information
  *
  * @example
  * ```ts
@@ -238,10 +238,10 @@ export const time_sync = (fn, timer = timer_default) => {
 };
 /**
  * Measure multiple executions of a function and return all timings.
- * @param fn - Function to measure (sync or async)
- * @param iterations - Number of times to execute
- * @param timer - Timer to use (defaults to timer_default)
- * @returns Array of elapsed times in nanoseconds
+ * @param fn - function to measure (sync or async)
+ * @param iterations - number of times to execute
+ * @param timer - timer to use (defaults to `timer_default`)
+ * @returns array of elapsed times in nanoseconds
  *
  * @example
  * ```ts

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.55.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.56.0",
-    "@fuzdev/fuz_ui": "^0.190.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