kolodny/immutability-helper

Features

• Command-Based Immutable Mutations - Provides a command-based system for creating modified copies of data structures without mutating the original.
• Command-Based State Mutation - Uses a declarative set of mutation commands and descriptors to apply data transformations to the state.
• Immutable Array Updates - Performs array operations on copies of arrays to avoid mutating the original source data.
• Immutable Element Updates - Updates data structures using a command-based syntax that returns new copies to preserve immutability.
• JSON Object Deep Cloning - Creates deep copies of nested structures to ensure mutations do not affect original source references.
• Immutable Value Transformers - Executes user-defined functions on specific values to produce new immutable versions of the data structure.
• Structure-Preserving Transformations - Applies mutation commands and custom logic to transform data while strictly preserving the original state.
• Functional Transformations - Applies custom transformation logic using pure functions to produce new immutable states from data structures.
• Immutable Data Libraries - Serves as a general-purpose library for creating modified copies of objects and arrays while ensuring original data remains unchanged.
• Deep Copying Libraries - Provides utilities for producing recursive deep copies of nested structures to prevent side effects during modification.
• Immutable Data Structures - Ensures the original data remains unmodified by creating copies of objects, arrays, maps, or sets.
• Complex State Mutation Commands - Ships built-in commands to perform complex operations like splicing and toggling within immutable structures.
• Command Objects - Uses descriptive command objects to modify deep data structures without requiring manual cloning.
• Data Transformation Commands - Implements a declarative command system for specifying modifications to immutable data structures.
• Immutable Object Merging - Combines properties from source objects into new immutable copies without altering the original data.
• Reference Equality Preservation - Returns the original object reference if no actual changes occur, enabling efficient state change detection.
• Immutable Update Utilities - Ships a set of utilities for merging, toggling, and updating complex data structures without side effects.
• Immutable State Copies - Implements patterns for creating modified copies of state objects to ensure immutable updates of complex data structures.
• Mutation Engines - Provides a pluggable engine that allows registering custom functions to handle specific data keys during updates.
• Custom Mutation Registries - Allows registering custom functions that apply domain-specific transformation logic during the update process.
• Custom Update Commands - Supports registering custom transformation functions to the update engine for specialized data mutation logic.
• Function Registries - Uses a lookup table to map identifiers to user-defined functions for specialized data transformations.
• Reference Equality Preservation - Ensures the original object reference is returned if no changes occur, facilitating efficient change detection.
• Poly-Type Copying Strategies - Applies different cloning and mutation mechanisms tailored to objects, arrays, maps, and sets.
• Reference Equality Workflows - Manages data changes while preserving reference equality and providing a history of unmodified state snapshots.
• Type-Safe Data Handling - Handles different data types using a consistent, type-safe approach to ensure correct mutation strategies.
• Mutation Mappers - Maps specific data keys to specialized transformation functions through a custom command registry.

Star history