@fuzdev/fuz_util 0.54.0 → 0.56.0

package/dist/diff.d.ts

@@ -11,17 +11,17 @@ export interface DiffLine {
 /**
  * Generate a line-based diff between two strings using LCS algorithm.
  *
- * @param a - The original/current content.
- * @param b - The new/desired content.
- * @returns Array of diff lines with type annotations.
+ * @param a - the original/current content
+ * @param b - the new/desired content
+ * @returns array of diff lines with type annotations
  */
 export declare const diff_lines: (a: string, b: string) => Array<DiffLine>;
 /**
  * Filter diff to only include lines within N lines of context around changes.
  *
- * @param diff - The full diff lines.
- * @param context_lines - Number of context lines to show around changes (default: 3).
- * @returns Filtered diff with ellipsis markers for skipped regions.
+ * @param diff - the full diff lines
+ * @param context_lines - number of context lines to show around changes (default: 3)
+ * @returns filtered diff with ellipsis markers for skipped regions
  */
 export declare const filter_diff_context: (diff: Array<DiffLine>, context_lines?: number) => Array<DiffLine>;
 /**
@@ -38,24 +38,24 @@ export interface FormatDiffOptions {
 /**
  * Format a diff for display.
  *
- * @param diff - The diff lines to format.
- * @param current_path - Path label for "current" content.
- * @param desired_path - Path label for "desired" content.
- * @param options - Formatting options.
- * @returns Formatted diff string.
+ * @param diff - the diff lines to format
+ * @param current_path - path label for "current" content
+ * @param desired_path - path label for "desired" content
+ * @param options - formatting options
+ * @returns formatted diff string
  */
 export declare const format_diff: (diff: Array<DiffLine>, current_path: string, desired_path: string, options?: FormatDiffOptions) => string;
 /**
  * Generate a formatted diff between two strings.
  *
- * Combines diff_lines, filter_diff_context, and format_diff for convenience.
+ * Combines `diff_lines`, `filter_diff_context`, and `format_diff` for convenience.
  * Returns null if content is binary.
  *
- * @param current - Current content.
- * @param desired - Desired content.
- * @param path - File path for labels.
- * @param options - Formatting options.
- * @returns Formatted diff string, or null if binary.
+ * @param current - current content
+ * @param desired - desired content
+ * @param path - file path for labels
+ * @param options - formatting options
+ * @returns formatted diff string, or null if binary
  */
 export declare const generate_diff: (current: string, desired: string, path: string, options?: FormatDiffOptions) => string | null;
 //# sourceMappingURL=diff.d.ts.map

package/dist/diff.js

@@ -7,9 +7,9 @@ import { string_is_binary } from './string.js';
 /**
  * Generate a line-based diff between two strings using LCS algorithm.
  *
- * @param a - The original/current content.
- * @param b - The new/desired content.
- * @returns Array of diff lines with type annotations.
+ * @param a - the original/current content
+ * @param b - the new/desired content
+ * @returns array of diff lines with type annotations
  */
 export const diff_lines = (a, b) => {
     const a_lines = a.split('\n');
@@ -84,9 +84,9 @@ const compute_lcs = (a, b) => {
 /**
  * Filter diff to only include lines within N lines of context around changes.
  *
- * @param diff - The full diff lines.
- * @param context_lines - Number of context lines to show around changes (default: 3).
- * @returns Filtered diff with ellipsis markers for skipped regions.
+ * @param diff - the full diff lines
+ * @param context_lines - number of context lines to show around changes (default: 3)
+ * @returns filtered diff with ellipsis markers for skipped regions
  */
 export const filter_diff_context = (diff, context_lines = 3) => {
     if (diff.length === 0)
@@ -131,11 +131,11 @@ const colors = {
 /**
  * Format a diff for display.
  *
- * @param diff - The diff lines to format.
- * @param current_path - Path label for "current" content.
- * @param desired_path - Path label for "desired" content.
- * @param options - Formatting options.
- * @returns Formatted diff string.
+ * @param diff - the diff lines to format
+ * @param current_path - path label for "current" content
+ * @param desired_path - path label for "desired" content
+ * @param options - formatting options
+ * @returns formatted diff string
  */
 export const format_diff = (diff, current_path, desired_path, options = {}) => {
     const { prefix = '', use_color = true, max_lines = 50 } = options;
@@ -165,14 +165,14 @@ export const format_diff = (diff, current_path, desired_path, options = {}) => {
 /**
  * Generate a formatted diff between two strings.
  *
- * Combines diff_lines, filter_diff_context, and format_diff for convenience.
+ * Combines `diff_lines`, `filter_diff_context`, and `format_diff` for convenience.
  * Returns null if content is binary.
  *
- * @param current - Current content.
- * @param desired - Desired content.
- * @param path - File path for labels.
- * @param options - Formatting options.
- * @returns Formatted diff string, or null if binary.
+ * @param current - current content
+ * @param desired - desired content
+ * @param path - file path for labels
+ * @param options - formatting options
+ * @returns formatted diff string, or null if binary
  */
 export const generate_diff = (current, desired, path, options = {}) => {
     // Skip binary files

package/dist/dom.d.ts

@@ -15,11 +15,11 @@ export declare const inside_editable: (el: Element) => boolean;
 export declare const is_interactive: (el: any) => boolean;
 /**
  * Stops an event from bubbling and doing default behavior.
- * @param event
- * @param immediate defaults to `true` to use `stopImmediatePropagation` over `stopPropagation`
- * @param preventDefault defaults to `true`
+ * @param event - the event to swallow
+ * @param immediate - defaults to `true` to use `stopImmediatePropagation` over `stopPropagation`
+ * @param preventDefault - defaults to `true`
+ * @returns the swallowed event
  * @mutates event - calls preventDefault(), stopPropagation(), or stopImmediatePropagation()
- * @returns
  */
 export declare const swallow: <T extends Pick<Event, "preventDefault" | "stopPropagation" | "stopImmediatePropagation">>(event: T, immediate?: boolean, preventDefault?: boolean) => T;
 /**

package/dist/dom.js

@@ -52,11 +52,11 @@ export const is_interactive = (el) => {
 };
 /**
  * Stops an event from bubbling and doing default behavior.
- * @param event
- * @param immediate defaults to `true` to use `stopImmediatePropagation` over `stopPropagation`
- * @param preventDefault defaults to `true`
+ * @param event - the event to swallow
+ * @param immediate - defaults to `true` to use `stopImmediatePropagation` over `stopPropagation`
+ * @param preventDefault - defaults to `true`
+ * @returns the swallowed event
  * @mutates event - calls preventDefault(), stopPropagation(), or stopImmediatePropagation()
- * @returns
  */
 export const swallow = (event, immediate = true, preventDefault = true) => {
     if (preventDefault)

package/dist/fetch.d.ts

@@ -26,7 +26,7 @@ export interface FetchValueOptions<TValue, TParams = undefined> {
  *   (you can still provide headers directly)
  *
  * Unlike `fetch`, this throws on ratelimits (status code 429)
- * to halt whatever is happpening in its tracks to avoid accidental abuse,
+ * to halt whatever is happening in its tracks to avoid accidental abuse,
  * but returns a `Result` in all other cases.
  * Handling ratelimit headers with more sophistication gets tricky because behavior
  * differs across services.

package/dist/fetch.js

@@ -14,7 +14,7 @@ const DEFAULT_GITHUB_API_VERSION_HEADER = '2022-11-28';
  *   (you can still provide headers directly)
  *
  * Unlike `fetch`, this throws on ratelimits (status code 429)
- * to halt whatever is happpening in its tracks to avoid accidental abuse,
+ * to halt whatever is happening in its tracks to avoid accidental abuse,
  * but returns a `Result` in all other cases.
  * Handling ratelimit headers with more sophistication gets tricky because behavior
  * differs across services.

package/dist/git.d.ts

@@ -62,7 +62,7 @@ export interface GitWorkspaceStatus {
  * Note: This implementation treats submodules the same as regular files.
  * Submodule-specific status codes (lowercase m, ?) are interpreted as changes.
  *
- * @param stdout - The raw output from `git status --porcelain -z`
+ * @param stdout - the raw output from `git status --porcelain -z`
  * @returns status object with flags for unstaged changes, staged changes, and untracked files
  */
 export declare const git_parse_workspace_status: (stdout: string | null) => GitWorkspaceStatus;

package/dist/git.js

@@ -82,7 +82,7 @@ export const git_local_branch_exists = async (branch, options) => {
  * Note: This implementation treats submodules the same as regular files.
  * Submodule-specific status codes (lowercase m, ?) are interpreted as changes.
  *
- * @param stdout - The raw output from `git status --porcelain -z`
+ * @param stdout - the raw output from `git status --porcelain -z`
  * @returns status object with flags for unstaged changes, staged changes, and untracked files
  */
 export const git_parse_workspace_status = (stdout) => {

package/dist/hash.d.ts

@@ -11,28 +11,28 @@
  * Computes a SHA-1 hash using Web Crypto API.
  *
  * @param data - String or binary data to hash. Strings are UTF-8 encoded.
- * @returns 40-character hexadecimal hash string.
+ * @returns 40-character hexadecimal hash string
  */
 export declare const hash_sha1: (data: BufferSource | string) => Promise<string>;
 /**
  * Computes a SHA-256 hash using Web Crypto API.
  *
  * @param data - String or binary data to hash. Strings are UTF-8 encoded.
- * @returns 64-character hexadecimal hash string.
+ * @returns 64-character hexadecimal hash string
  */
 export declare const hash_sha256: (data: BufferSource | string) => Promise<string>;
 /**
  * Computes a SHA-384 hash using Web Crypto API.
  *
  * @param data - String or binary data to hash. Strings are UTF-8 encoded.
- * @returns 96-character hexadecimal hash string.
+ * @returns 96-character hexadecimal hash string
  */
 export declare const hash_sha384: (data: BufferSource | string) => Promise<string>;
 /**
  * Computes a SHA-512 hash using Web Crypto API.
  *
  * @param data - String or binary data to hash. Strings are UTF-8 encoded.
- * @returns 128-character hexadecimal hash string.
+ * @returns 128-character hexadecimal hash string
  */
 export declare const hash_sha512: (data: BufferSource | string) => Promise<string>;
 /**
@@ -42,8 +42,8 @@ export declare const hash_sha512: (data: BufferSource | string) => Promise<strin
  * Note: Strings use UTF-16 code units, buffers use raw bytes.
  * For non-ASCII, `hash_insecure(str) !== hash_insecure(encoder.encode(str))`.
  *
- * @param data - String or binary data to hash.
- * @returns 8-character hex-encoded unsigned 32-bit hash.
+ * @param data - string or binary data to hash
+ * @returns 8-character hex-encoded unsigned 32-bit hash
  */
 export declare const hash_insecure: (data: BufferSource | string) => string;
 //# sourceMappingURL=hash.d.ts.map

package/dist/hash.js

@@ -12,9 +12,9 @@ const encoder = new TextEncoder();
 /**
  * Computes a hash using Web Crypto API.
  *
- * @param algorithm - Web Crypto algorithm name (e.g. `'SHA-256'`).
+ * @param algorithm - Web Crypto algorithm name (e.g. `'SHA-256'`)
  * @param data - String or binary data to hash. Strings are UTF-8 encoded.
- * @returns hexadecimal hash string.
+ * @returns hexadecimal hash string
  */
 const hash_webcrypto = async (algorithm, data) => {
     const buffer = typeof data === 'string' ? encoder.encode(data) : data;
@@ -25,28 +25,28 @@ const hash_webcrypto = async (algorithm, data) => {
  * Computes a SHA-1 hash using Web Crypto API.
  *
  * @param data - String or binary data to hash. Strings are UTF-8 encoded.
- * @returns 40-character hexadecimal hash string.
+ * @returns 40-character hexadecimal hash string
  */
 export const hash_sha1 = (data) => hash_webcrypto('SHA-1', data);
 /**
  * Computes a SHA-256 hash using Web Crypto API.
  *
  * @param data - String or binary data to hash. Strings are UTF-8 encoded.
- * @returns 64-character hexadecimal hash string.
+ * @returns 64-character hexadecimal hash string
  */
 export const hash_sha256 = (data) => hash_webcrypto('SHA-256', data);
 /**
  * Computes a SHA-384 hash using Web Crypto API.
  *
  * @param data - String or binary data to hash. Strings are UTF-8 encoded.
- * @returns 96-character hexadecimal hash string.
+ * @returns 96-character hexadecimal hash string
  */
 export const hash_sha384 = (data) => hash_webcrypto('SHA-384', data);
 /**
  * Computes a SHA-512 hash using Web Crypto API.
  *
  * @param data - String or binary data to hash. Strings are UTF-8 encoded.
- * @returns 128-character hexadecimal hash string.
+ * @returns 128-character hexadecimal hash string
  */
 export const hash_sha512 = (data) => hash_webcrypto('SHA-512', data);
 /**
@@ -56,8 +56,8 @@ export const hash_sha512 = (data) => hash_webcrypto('SHA-512', data);
  * Note: Strings use UTF-16 code units, buffers use raw bytes.
  * For non-ASCII, `hash_insecure(str) !== hash_insecure(encoder.encode(str))`.
  *
- * @param data - String or binary data to hash.
- * @returns 8-character hex-encoded unsigned 32-bit hash.
+ * @param data - string or binary data to hash
+ * @returns 8-character hex-encoded unsigned 32-bit hash
  */
 export const hash_insecure = (data) => {
     let hash = 5381; // DJB2 initial value, chosen empirically for good distribution

package/dist/hash_blake3.d.ts

@@ -18,7 +18,7 @@ export declare const blake3_ready: Promise<void>;
  * Computes a BLAKE3 hash synchronously.
  *
  * @param data - String or binary data to hash. Strings are UTF-8 encoded.
- * @returns 64-character hexadecimal hash string (32 bytes).
+ * @returns 64-character hexadecimal hash string (32 bytes)
  */
 export declare const hash_blake3: (data: BufferSource | string) => string;
 /** Zod schema for a BLAKE3 hex hash — 64 lowercase hex characters (256-bit output). */

package/dist/hash_blake3.js

@@ -21,7 +21,7 @@ export const blake3_ready = init();
  * Computes a BLAKE3 hash synchronously.
  *
  * @param data - String or binary data to hash. Strings are UTF-8 encoded.
- * @returns 64-character hexadecimal hash string (32 bytes).
+ * @returns 64-character hexadecimal hash string (32 bytes)
  */
 export const hash_blake3 = (data) => to_hex(hash(to_bytes(data)));
 /** Zod schema for a BLAKE3 hex hash — 64 lowercase hex characters (256-bit output). */

package/dist/hex.d.ts

@@ -6,16 +6,16 @@
 /**
  * Converts a `Uint8Array` to a lowercase hex string.
  *
- * @param bytes - Binary data to encode.
- * @returns Hex string with two characters per byte.
+ * @param bytes - binary data to encode
+ * @returns hex string with two characters per byte
  */
 export declare const to_hex: (bytes: Uint8Array) => string;
 /**
  * Decodes a hex string to a `Uint8Array`.
  * Whitespace is stripped before parsing. Returns `null` for invalid hex.
  *
- * @param hex - Hex string to decode (case-insensitive, whitespace allowed).
- * @returns Decoded bytes, or `null` if the input is not valid hex.
+ * @param hex - hex string to decode (case-insensitive, whitespace allowed)
+ * @returns decoded bytes, or `null` if the input is not valid hex
  */
 export declare const from_hex: (hex: string) => Uint8Array | null;
 //# sourceMappingURL=hex.d.ts.map

package/dist/hex.js

@@ -6,8 +6,8 @@
 /**
  * Converts a `Uint8Array` to a lowercase hex string.
  *
- * @param bytes - Binary data to encode.
- * @returns Hex string with two characters per byte.
+ * @param bytes - binary data to encode
+ * @returns hex string with two characters per byte
  */
 export const to_hex = (bytes) => {
     const lookup = get_byte_to_hex();
@@ -21,8 +21,8 @@ export const to_hex = (bytes) => {
  * Decodes a hex string to a `Uint8Array`.
  * Whitespace is stripped before parsing. Returns `null` for invalid hex.
  *
- * @param hex - Hex string to decode (case-insensitive, whitespace allowed).
- * @returns Decoded bytes, or `null` if the input is not valid hex.
+ * @param hex - hex string to decode (case-insensitive, whitespace allowed)
+ * @returns decoded bytes, or `null` if the input is not valid hex
  */
 export const from_hex = (hex) => {
     const clean = hex.replace(/\s/g, '');

package/dist/json.d.ts

@@ -23,8 +23,8 @@ export declare const json_embed: <T>(data: T, stringify?: (data: T) => string) =
  * Recursively sorts object keys alphabetically for consistent hashing.
  * Arrays and primitives are serialized as-is.
  *
- * @param value Any JSON-serializable value
- * @returns Deterministic JSON string representation
+ * @param value - any JSON-serializable value
+ * @returns deterministic JSON string representation
  */
 export declare const json_stringify_deterministic: (value: unknown) => string;
 //# sourceMappingURL=json.d.ts.map

package/dist/json.js

@@ -28,8 +28,8 @@ export const json_embed = (data, stringify = JSON.stringify) => `JSON.parse('${s
  * Recursively sorts object keys alphabetically for consistent hashing.
  * Arrays and primitives are serialized as-is.
  *
- * @param value Any JSON-serializable value
- * @returns Deterministic JSON string representation
+ * @param value - any JSON-serializable value
+ * @returns deterministic JSON string representation
  */
 export const json_stringify_deterministic = (value) => JSON.stringify(value, (_key, val) => {
     if (val !== null && typeof val === 'object' && !Array.isArray(val)) {

package/dist/log.d.ts

@@ -8,21 +8,21 @@
  */
 export type LogLevel = 'off' | 'error' | 'warn' | 'info' | 'debug';
 /**
- * Console interface subset used by Logger for output.
+ * Console interface subset used by `Logger` for output.
  * Allows custom console implementations for testing.
  */
 export type LogConsole = Pick<typeof console, 'error' | 'warn' | 'log'>;
 /**
  * Converts a log level to its numeric value for comparison.
  * Higher numbers indicate more verbose logging.
- * @param level The log level to convert
- * @returns Numeric value (0-4)
+ * @param level - the log level to convert
+ * @returns numeric value (0-4)
  */
 export declare const log_level_to_number: (level: LogLevel) => number;
 /**
  * Parses and validates a log level string.
- * @param value The value to parse as a log level
- * @returns The validated log level, or undefined if value is undefined
+ * @param value - the value to parse as a log level
+ * @returns the validated log level, or undefined if value is undefined
  * @throws Error if value is provided but invalid
  */
 export declare const log_level_parse: (value: string | undefined) => LogLevel | undefined;
@@ -56,10 +56,10 @@ export declare class Logger {
     /**
      * Creates a new Logger instance.
      *
-     * @param label Optional label for this logger. Can be `undefined` for no label, or an
+     * @param label - optional label for this logger. Can be `undefined` for no label, or an
      *   empty string `''` which is functionally equivalent (both produce no brackets in output).
      *   Note: Empty strings are only allowed for root loggers - child loggers cannot have empty labels.
-     * @param options Optional configuration for level, colors, and console
+     * @param options - optional configuration for level, colors, and console
      */
     constructor(label?: string, options?: LoggerOptions);
     /**
@@ -93,7 +93,7 @@ export declare class Logger {
     /**
      * Gets the root logger by walking up the parent chain.
      * Useful for setting global configuration that affects all child loggers.
-     * @returns The root logger (the one without a parent)
+     * @returns the root logger (the one without a parent)
      */
     get root(): Logger;
     /**
@@ -118,11 +118,11 @@ export declare class Logger {
      * Creates a child logger with automatic label concatenation.
      * Children inherit parent configuration unless overridden.
      *
-     * @param label Child label (will be concatenated with parent label using `:`).
+     * @param label - child label (will be concatenated with parent label using `:`)
      *   Cannot be an empty string - empty labels would result in confusing output like `parent:`
      *   with a trailing colon. Use `undefined` or `''` only for root loggers.
-     * @param options Optional configuration overrides
-     * @returns New Logger instance with concatenated label
+     * @param options - optional configuration overrides
+     * @returns new `Logger` instance with concatenated label
      * @throws Error if label is an empty string
      *
      * @example
@@ -163,7 +163,7 @@ export declare class Logger {
      * Note: This method ignores the configured log level - it always outputs regardless of
      * whether the logger is set to 'off' or any other level.
      *
-     * @param args Values to log directly to console
+     * @param args - values to log directly to console
      */
     raw(...args: Array<unknown>): void;
 }

package/dist/log.js

@@ -22,14 +22,14 @@ const LOG_LEVEL_VALUES = {
 /**
  * Converts a log level to its numeric value for comparison.
  * Higher numbers indicate more verbose logging.
- * @param level The log level to convert
- * @returns Numeric value (0-4)
+ * @param level - the log level to convert
+ * @returns numeric value (0-4)
  */
 export const log_level_to_number = (level) => LOG_LEVEL_VALUES[level];
 /**
  * Parses and validates a log level string.
- * @param value The value to parse as a log level
- * @returns The validated log level, or undefined if value is undefined
+ * @param value - the value to parse as a log level
+ * @returns the validated log level, or undefined if value is undefined
  * @throws Error if value is provided but invalid
  */
 export const log_level_parse = (value) => {
@@ -85,10 +85,10 @@ export class Logger {
     /**
      * Creates a new Logger instance.
      *
-     * @param label Optional label for this logger. Can be `undefined` for no label, or an
+     * @param label - optional label for this logger. Can be `undefined` for no label, or an
      *   empty string `''` which is functionally equivalent (both produce no brackets in output).
      *   Note: Empty strings are only allowed for root loggers - child loggers cannot have empty labels.
-     * @param options Optional configuration for level, colors, and console
+     * @param options - optional configuration for level, colors, and console
      */
     constructor(label, options = {}) {
         this.label = label;
@@ -169,7 +169,7 @@ export class Logger {
     /**
      * Gets the root logger by walking up the parent chain.
      * Useful for setting global configuration that affects all child loggers.
-     * @returns The root logger (the one without a parent)
+     * @returns the root logger (the one without a parent)
      */
     get root() {
         let current = this; // eslint-disable-line consistent-this, @typescript-eslint/no-this-alias
@@ -313,11 +313,11 @@ export class Logger {
      * Creates a child logger with automatic label concatenation.
      * Children inherit parent configuration unless overridden.
      *
-     * @param label Child label (will be concatenated with parent label using `:`).
+     * @param label - child label (will be concatenated with parent label using `:`)
      *   Cannot be an empty string - empty labels would result in confusing output like `parent:`
      *   with a trailing colon. Use `undefined` or `''` only for root loggers.
-     * @param options Optional configuration overrides
-     * @returns New Logger instance with concatenated label
+     * @param options - optional configuration overrides
+     * @returns new `Logger` instance with concatenated label
      * @throws Error if label is an empty string
      *
      * @example
@@ -391,7 +391,7 @@ export class Logger {
      * Note: This method ignores the configured log level - it always outputs regardless of
      * whether the logger is set to 'off' or any other level.
      *
-     * @param args Values to log directly to console
+     * @param args - values to log directly to console
      */
     raw(...args) {
         this.console.log(...args);

package/dist/map.d.ts

@@ -1,6 +1,6 @@
 /**
  * Sorts a map by `comparator`, a function that compares two entries,
- * defaulting to using `localCompare` and `>`.
+ * defaulting to using `localeCompare` and `>`.
  */
 export declare const sort_map: <T extends Map<any, any>>(map: T, comparator?: (a: [any, any], b: [any, any]) => number) => T;
 /**

package/dist/map.js

@@ -1,6 +1,6 @@
 /**
  * Sorts a map by `comparator`, a function that compares two entries,
- * defaulting to using `localCompare` and `>`.
+ * defaulting to using `localeCompare` and `>`.
  */
 export const sort_map = (map, comparator = compare_simple_map_entries) => new Map([...map].sort(comparator));
 /**

package/dist/object.d.ts

@@ -23,7 +23,7 @@ export declare const pick_by: <T extends Record<K, any>, K extends string | numb
  * `omit_undefined` is a commonly used form of `pick_by`.
  * See this issue for why it's used so much:
  * https://github.com/Microsoft/TypeScript/issues/13195
- * @param obj
+ * @param obj - the object to filter
  * @returns `obj` with all `undefined` properties removed
  */
 export declare const omit_undefined: <T extends Record<string | number, any>>(obj: T) => T;

package/dist/object.js

@@ -45,7 +45,7 @@ export const pick_by = (obj, should_pick) => {
  * `omit_undefined` is a commonly used form of `pick_by`.
  * See this issue for why it's used so much:
  * https://github.com/Microsoft/TypeScript/issues/13195
- * @param obj
+ * @param obj - the object to filter
  * @returns `obj` with all `undefined` properties removed
  */
 export const omit_undefined = (obj) => pick_by(obj, (v) => v !== undefined);

package/dist/package_json.d.ts

@@ -31,7 +31,7 @@ export type PackageJsonExports = z.infer<typeof PackageJsonExports>;
  */
 export declare const PackageJson: z.ZodObject<{
     name: z.ZodString;
-    version: z.ZodString;
+    version: z.ZodOptional<z.ZodString>;
     private: z.ZodOptional<z.ZodBoolean>;
     description: z.ZodOptional<z.ZodString>;
     tagline: z.ZodOptional<z.ZodString>;

package/dist/package_json.js

@@ -49,7 +49,7 @@ export const PackageJsonExports = z.union([
 export const PackageJson = z.looseObject({
     // according to the npm docs, `name` and `version` are the only required properties
     name: z.string(),
-    version: z.string(),
+    version: z.string().optional(),
     private: z
         .boolean()
         .meta({ description: 'disallow publishing to the configured registry' })

package/dist/path.d.ts

@@ -65,15 +65,15 @@ export declare const parse_path_pieces: (raw_path: string) => Array<PathPiece>;
  * Returns `false` when `filename` is `undefined`, empty string, or `exclude` is empty.
  * String patterns use substring matching. RegExp patterns use `.test()`.
  *
- * @param filename The file path to check, or `undefined` for virtual files.
- * @param exclude Array of string or RegExp exclusion patterns.
- * @returns `true` if the file should be excluded from processing.
+ * @param filename - the file path to check, or `undefined` for virtual files
+ * @param exclude - array of string or RegExp exclusion patterns
+ * @returns `true` if the file should be excluded from processing
  */
 export declare const should_exclude_path: (filename: string | undefined, exclude: Array<string | RegExp>) => boolean;
 /**
  * Converts a string into a URL-compatible slug.
- * @param str the string to convert
- * @param map_special_characters if `true`, characters like `ñ` are converted to their ASCII equivalents, runs around 5x faster when disabled
+ * @param str - the string to convert
+ * @param map_special_characters - if `true`, characters like `ñ` are converted to their ASCII equivalents, runs around 5x faster when disabled
  * @mutates special_char_mappers - calls `get_special_char_mappers()` which lazily initializes the module-level array if `map_special_characters` is true
  */
 export declare const slugify: (str: string, map_special_characters?: boolean) => string;

package/dist/path.js

@@ -54,9 +54,9 @@ export const parse_path_pieces = (raw_path) => {
  * Returns `false` when `filename` is `undefined`, empty string, or `exclude` is empty.
  * String patterns use substring matching. RegExp patterns use `.test()`.
  *
- * @param filename The file path to check, or `undefined` for virtual files.
- * @param exclude Array of string or RegExp exclusion patterns.
- * @returns `true` if the file should be excluded from processing.
+ * @param filename - the file path to check, or `undefined` for virtual files
+ * @param exclude - array of string or RegExp exclusion patterns
+ * @returns `true` if the file should be excluded from processing
  */
 export const should_exclude_path = (filename, exclude) => {
     if (!filename || exclude.length === 0)
@@ -65,8 +65,8 @@ export const should_exclude_path = (filename, exclude) => {
 };
 /**
  * Converts a string into a URL-compatible slug.
- * @param str the string to convert
- * @param map_special_characters if `true`, characters like `ñ` are converted to their ASCII equivalents, runs around 5x faster when disabled
+ * @param str - the string to convert
+ * @param map_special_characters - if `true`, characters like `ñ` are converted to their ASCII equivalents, runs around 5x faster when disabled
  * @mutates special_char_mappers - calls `get_special_char_mappers()` which lazily initializes the module-level array if `map_special_characters` is true
  */
 export const slugify = (str, map_special_characters = true) => {