CHANGELOG.md

@fuzdev/fuz_util

0.59.0

Minor Changes

• feat: add datetime.ts and schema for Uuid (d73e2f8)
• feat: add some zod helpers (d73e2f8)

0.58.0

Minor Changes

• bump node@24.14 (fbefe82)

Patch Changes

• feat: add lru_map.ts with LruMap (3671f15)

0.57.0

Minor Changes

• feat: rework deps interfaces (#76)
• feat: add assert_property test helper (#78)
• feat: kind-based discriminators on SpawnResult and SpawnDetachedResult (breaking: replaces sentinel-null fields; removes spawn_result_is_* type guards) (#77)

Patch Changes

• fix: deep_equal for Error (cede27a)

0.56.0

Minor Changes

• fix: change PackageJson version to be optional (47cb39d)

Patch Changes

• feat: add testing.ts (#75)

0.55.0

Minor Changes

• feat: improve benchmark stats and reliability (#74)

0.54.0

Minor Changes

• rename tagline from motto (8906cac)

Patch Changes

• use Object.hasOwn instead of in for own-property checks in deep_equal (38fd976)

0.53.4

Patch Changes

• add Blake3Hash schema (b3b33ee)

0.53.3

Patch Changes

• feat: add more zod helpers (a86bab6)

0.53.2

Patch Changes

• add format_bytes (de16196)
• add blake3_ready with auto-init (de16196)

0.53.1

Patch Changes

• add from_hex, hash_sha1, hash_sha384, and hash_sha512 (d16f560)

0.53.0

Minor Changes

• unexport masher from random_alea.ts (06d675b)
• rename RandomAlea from Alea (06d675b)
• switch to blake3 hashing (#73)
  • add hash_blake3, sync BLAKE3 via optional peer dep @fuzdev/blake3_wasm
  • rename hash_sha256 from hash_secure and remove the custom algorithm param
  • add hex.ts with to_hex
  • add bytes.ts with to_bytes

Patch Changes

• add random_xoshiro.ts (06d675b)
• fix empty string logging (72dc8f4)

0.52.1

Patch Changes

• feat: add zod.ts (459313d)

0.52.0

Minor Changes

• change args order of async helpers and add cancellation (#72)

0.51.0

Minor Changes

• improve source_json.ts (#71)

0.50.1

Patch Changes

• fix: skip import type declarations in resolve_component_names (87f4287)

0.50.0

Minor Changes

• handle_preprocess_error: preserve error cause chain, simplify format_named_specifiers type (e6c5b82)

0.49.3

Patch Changes

• add try_extract_conditional to svelte_preprocess_helpers.ts (0a966ec)

0.49.2

Patch Changes

• improve has_identifier_in_tree skip behavior (74f5025)

0.49.1

Patch Changes

• add build_static_bindings and support it from evaluate_static_expr (3aeb47c)

0.49.0

Minor Changes

• rename string_is_binary from is_binary (#69)

Patch Changes

• add svelte_preprocess_helpers.ts (#69)

0.48.4

Patch Changes

• add dag.ts, diff.ts, and sort.ts (7b3bf38)
• add AsyncSemaphore to async.ts (7b3bf38)

0.48.3

Patch Changes

• add hash.ts (#68)

0.48.2

Patch Changes

• add spawn_detached (129b37e)

0.48.1

Patch Changes

• parameterize spawn_child_process to ProcessRegistry#spawn (efa8eb0)

0.48.0

Minor Changes

• add args.ts (#66)

0.47.0

Minor Changes

• improve process.ts interfaces (de7a07e)

0.46.0

Minor Changes

• refactor process spawning with ProcessRegistry class and improved APIs (#65)

  breaking changes:

  • remove global_spawn - use default_registry.processes instead
  • remove register_global_spawn - ProcessRegistry.spawn() handles registration automatically
  • rename attach_process_error_handlers to attach_process_error_handler (singular)
  • rename RestartableProcess.running to active (reflects handle state, not OS process state)
  • spawn_out returns '' for empty output instead of null (null only for spawn failures)

  new features:

  • add ProcessRegistry class for testable, isolated process groups
  • add SpawnProcessOptions with signal (AbortSignal) and timeout_ms
  • add DespawnOptions with signal and timeout_ms (SIGKILL escalation)
  • add type guards: spawn_result_is_error, spawn_result_is_signaled, spawn_result_is_exited
  • add active, child, closed, and spawned getters to RestartableProcess
    • spawned promise resolves when initial spawn completes (avoids race conditions)
    • concurrent restart() and kill() calls are coalesced
  • spawn_restartable_process now accepts SpawnProcessOptions instead of SpawnOptions
  • attach_process_error_handler now takes options object instead of positional args
  • attach_error_handler throws if called twice on same registry (was silent no-op)
  • attach_error_handler accepts graceful_timeout_ms option for SIGTERM before SIGKILL

  improvements:

  • fix race condition between concurrent kill() and restart() calls
  • process_is_pid_running rejects fractional PIDs
  • spawn_out explicitly cleans up stream listeners
  • improve JSDoc with usage examples throughout

0.45.3

Patch Changes

• add each_concurrent (#64)

0.45.2

Patch Changes

• add levenshtein_distance (258c441)

0.45.1

Patch Changes

• change library.json property order (af50855)

0.45.0

Minor Changes

• add baseline to benchmark helpers and improve grouping (2550d9e)

0.44.1

Patch Changes

• add process_is_pid_running to process.ts (f1ee638)

0.44.0

Minor Changes

• rework and clean up some APIs (57842f0)

0.43.0

Minor Changes

• change is_promise to return a boolean (#61)
• add benchmark lib (#61)

0.42.0

Minor Changes

• move to fuzdev and rename to fuz_util from belt (8d4e5a0)

0.41.1

Patch Changes

• add fs_search (#59)

0.41.0

Minor Changes

• change map_concurrent_settled to return PromiseSettledResult (8061202)
• make concurrency required for map_concurrent and map_concurrent_settled (8061202)

0.40.2

Patch Changes

• add map_concurrent and map_concurrent_settled (ec8abaf)

0.40.1

Patch Changes

• make optional optional (72146e7)

0.40.0

Minor Changes

• rework library_json.ts and source_json.ts (a87a166)

0.39.0

Minor Changes

• rename PascalCase from Upper_Snake_Case (lol) (#58)

0.38.2

Patch Changes

• improve fs_empty_dir internals (8f4cb8d)

0.38.1

Patch Changes

• add fs.ts with fs_exists and fs_empty_dir (#56)

0.38.0

Minor Changes

• migrate src_json.ts from fuz (#55)
• rename pkg_json identifiers (#55)

0.37.2

Patch Changes

• revert internal paths to .js (#54)

0.37.1

Patch Changes

• switch to ts imports (#48)

0.37.0

Minor Changes

• simplify logging (#51)

0.36.1

Patch Changes

• add deep_equal.ts (#50)

0.36.0

Minor Changes

• • rename json_type_of from to_json_type (4feefaf)
  • rename json_embed from embed_json
  • rename json_stringify_deterministic from to_deterministic_json
  • replace canonicalize with json_stringify_deterministic

0.35.1

Patch Changes

• fix path module to not require node (#47)

0.35.0

Minor Changes

• default logging to info in production (ebdd641)

Patch Changes

• upstream helpers for path.ts and git.ts (#46)

0.34.1

Patch Changes

• change reset_regexp to return the regexp instead of void (48f1324)

0.34.0

Minor Changes

• rename configure_print_colors from set_colors (70503d9)

Patch Changes

• add reset_regexp (f6514a7)

0.33.0

Minor Changes

• change default print_number_with_separators separator to , from _ (#43)
• remove info log labels and loosen log label types (#43)

Patch Changes

• handle arrays in print_value (#43)

0.32.0

Minor Changes

• add optional zod peer dep (#42)

Patch Changes

• add modules package_json.ts, pkg.ts, and src_json.ts (#42)

0.31.1

Patch Changes

• add options arg to ResultError and UnreachableError ctors (34723fe)

0.31.0

Minor Changes

• bump node@22.15 from 22.11 (0989b18)
• chore: bump @types/node@24 (ccd7d5b)

Patch Changes

• add stringify helper (588732b)

0.30.2

Patch Changes

• improve unreachable type to assert never (d6a81c7)

0.30.1

Patch Changes

• upgrade esm-env@1.2.2 (#40)

0.30.0

Minor Changes

• rename Thunk from Lazy and unthunk from lazy (5e36e11)

0.29.1

Patch Changes

• add ClassConstructor to types.ts (dc8f0b9)

0.29.0

Minor Changes

• change is_editable to match all inputs except hidden ones (4889274)

Patch Changes

• add is_interactive (4889274)

0.28.0

Minor Changes

• disable colors by default for better runtime compat - (1972e95) call set_colors(styleText) from print.ts, in Node import {styleText} from 'node:util';

0.27.6

Patch Changes

• add strip_ansi string util (ffb7587)

0.27.5

Patch Changes

• export st from print.ts (95fe446)

0.27.4

Patch Changes

• tweak logging outputs again (2cc4100)
• tweak logging outputs once more (2e2fb84)

0.27.3

Patch Changes

• tweak logging outputs (d292845)

0.27.2

Patch Changes

• change the debug char (6876ebc)

0.27.1

Patch Changes

• improve log symbols and consistency (28371a1)

0.27.0

Minor Changes

• add esm-env optional dep and default logger to debug (9c8d8af)

0.26.1

Patch Changes

• improve Json types, adding JsonPrimitive, JsonObject, and JsonArray (9db9a1d)

0.26.0

Minor Changes

• remove obtainable (#39)

0.25.3

Patch Changes

• add more docs (ddcda63)

0.25.2

Patch Changes

• add optional peer dep @types/node to fix disabled TS skipLibCheck (578f632)

0.25.1

Patch Changes

• add logo (#37)
• add throttle (#38)

0.25.0

Minor Changes

• rework the Logger API (#36)
• remove $lib/styletext.ts (#36)
• move print_log_label to $lib/print.ts from $lib/log.ts (#36)
• bump required node version to 20.17 (#36)

0.24.12

Patch Changes

• add unreachable error helper (b794c07)

0.24.11

Patch Changes

• fix: exit on uncaught exceptions by default (8e2e91a)

0.24.10

Patch Changes

• add despawn_all to process.ts (#35)
• fix attach_process_error_handlers API to only handle exceptions (#35)

0.24.9

Patch Changes

• fix embed_json for multiline strings (dac5852)

0.24.8

Patch Changes

• change embed_json to support multiline strings (d173206)

0.24.7

Patch Changes

• improve slugify (#34)
  • add the arg map_special_characters to optionally disable the expensive special character mappings
  • improve performance with benchmarks

0.24.6

Patch Changes

• add slugify to paths.ts (c77cbe2)

0.24.5

Patch Changes

• improve hsl parsing to allow hsl prefix (#33)

0.24.4

Patch Changes

• publish src files (9af61b0)
• add tsconfig sourceRoot (459eb8a)

0.24.3

Patch Changes

• enable tsconfig declaration and declarationMap (cbe3e31)

0.24.2

Patch Changes

• add embed_json helper for embedding parsed json strings in js (f5c02c0)

0.24.1

Patch Changes

• fix timings type to correctly include undefined for unfinished ones (603bfe4)

0.24.0

Minor Changes

• rename UUID_MATCHER from uuid_matcher for consistency (f974a64)

Patch Changes

• add sideEffects to package.json (8f8c5bd)

0.23.0

Minor Changes

• remove kleur dependency for Node's styleText and wrap it with $lib/styletext.ts (#29)

Patch Changes

• upgrade gro with correctly formatted exports (744b984)

0.22.0

Minor Changes

• support node@20.12 and later (8ee3346)

0.21.1

Patch Changes

• fix hsl parsing for modern comma-less form (963c536)

0.21.0

Minor Changes

• upgrade node@22.3 (#28)
• rename count_graphemes from to_grapheme_count and use Intl.Segmenter without a fallback (f9f62e0)

Patch Changes

• add count_iterator (b02e33a)

0.20.10

Patch Changes

• add format_url and module $lib/url.ts (1843c6c)

0.20.9

Patch Changes

• fix is_editable (ab395cd)

0.20.8

Patch Changes

• add inside_editable and tweak is_editable logic to use getAttribute (8dc7d81)

0.20.7

Patch Changes

• fix contentEditable detection in is_editable (8ed886d)

0.20.6

Patch Changes

• add $lib/async.ts#is_promise (a5d3bb6)

0.20.5

Patch Changes

• change parse_hsl_string to parse values with alpha (37e7094)

0.20.4

Patch Changes

• add $lib/colors.ts (#27)

0.20.3

Patch Changes

• use '_' for print number separator instead of ',' (9ef6700)

0.20.2

Patch Changes

• relax fetch_value token type to accept null (a14e4ee)

0.20.1

Patch Changes

• rename to belt (a8ac0af)

0.20.0

Minor Changes

• move orgs to @ryanatkn from @grogarden (#26)

0.19.3

Patch Changes

• improve some array types to handle readonly arrays (23e739c)

0.19.2

Patch Changes

• add PickUnion and KeyofUnion type helpers (6e6ac53)

0.19.1

Patch Changes

• add ArrayElement type helper (940ec97)

0.19.0

Minor Changes

• remove print_causes (#25)

Patch Changes

• change print_ms to include separators at thousands (#25)
• support custom colors for printing values (#25)
• change print_ms to include separators at thousands was provided (#25)

0.18.3

Patch Changes

• return headers from fetch_value (#24)

0.18.2

Patch Changes

• add a default 'content-type' header for fetch_value (2126d03)

0.18.1

Patch Changes

• add fetch_value (#22)

0.18.0

Minor Changes

• remove random_char (fc99da6)

0.17.0

Minor Changes

• unpublish package.ts (6ff3df5)

0.16.1

Patch Changes

• add random_char helper (8353169)

0.16.0

Minor Changes

• rename to ProperSnakes (#21)

0.15.4

Patch Changes

• add public: true, to package.json (47e32d6)

0.15.3

Patch Changes

• upgrade @fuzdev/gro which adds modules to package.ts (4b0fc13)

0.15.2

Patch Changes

• add shuffle (5c6dd69)

0.15.1

Patch Changes

• publish $routes/package.ts (753a787)

0.15.0

Minor Changes

• fix global_spawn name (530641a)

Patch Changes

• deprecate obtainable (d123ff9)

0.14.0

Minor Changes

• fix some snake_case (#20)
• bump node engine to 20.10 (#20)
• upgrade to @fuzdev/gro@0.86 from @feltjs/gro@0.83 (#20)
• add spawn_out to process (#20)

0.13.1

Patch Changes

• fix exports (d62b1bf)

0.13.0

Minor Changes

• missed a spot renaming create_stopwatch (e373d3a)

0.12.0

Minor Changes

• switch to snake_case (#19)

0.11.0

Minor Changes

• increment timing keys instead of throwing (#18)

0.10.1

Patch Changes

• fix PUBLIC_LOG_LEVEL env var usage (286aa46)
• move to belt.ryanatkn.com from util.felt.dev (db08052)

0.10.0

Minor Changes

• upgrade gro (#17)
• rename to @ryanatkn/belt from @feltjs/util (#17)

0.9.1

• add noop_async and resolved function helpers (commit)

0.9.0

• break: support only deep imports (#16)
• break: remove nulls and undefineds from $lib/object.ts (#16)

0.8.3

• fix is_editable to return true only for actually editable inputs (#15)

0.8.2

• add is_iframed helper to $lib/dom.ts (#14)

0.8.1

• loosen the types of EMPTY_OBJECT and swallow (#13)

0.8.0

• rename log's trace to debug (#12)

0.7.5

• fix root exports to omit modules with Node dependencies (commit)

0.7.4

• fix root exports to not use $lib (commit)

0.7.3

• publish everything from the root (commit)

0.7.2

• add handle_target_value to $lib/dom.ts (commit)

0.7.1

• make select elements count for is_editable (commit)

0.7.0

• break: remove the type ClientId and make it a plain string (commit)

0.6.0

• break: change LogLevel from an enum to a string type union, change its default to info, and add to_log_level_value to convert it to a number (#11)

0.5.3

• change all $lib/ paths to be direct (commit)

0.5.2

• fix published version for @feltjs this time for real (#9)

0.5.1

• fix published version for @feltjs

0.5.0

• break: remove $lib/env (#7)
• break: default log level to import.meta.env.PUBLIC_LOG_LEVEL instead of the obsolete VITE_LOG_LEVEL (#7)
• break: remove exports DEFAULT_LOG_LEVEL and ENV_LOG_LEVEL from $lib/log (#7)

0.4.1

• add to_next to $lib/array (#5)

0.4.0

• break: rename $lib/random-alea from $lib/random-seeded and create_random_alea from toRandomSeeded

0.3.0

• break: remove toUuid, use platform crypto.randomUUID instead
• remove @lukeed/uuid as a peer dep
• add kleur as a peer dep

0.2.1

• fix exports (#3)

0.2.0

• break: require fully qualified imports for almost everything (#2)
• break: change to_json_type in $lib/json to return undefined instead of throwing (#2)
• break: rename camelCase filenames to dash-case, $lib/path from $lib/pathParsing and $lib/random-seeded from $lib/randomSeed (#2)

0.1.0

• publish (#1)