rtfeldman/seamless-immutableArchived
Seamless Immutable
This is a JavaScript immutable data library used to create objects and arrays that prevent direct mutation. It serves as an immutable state manager and object wrapper designed to ensure data consistency by blocking modifications while remaining compatible with standard JavaScript syntax.
The library functions as a converter that transforms standard mutable data into frozen structures and can convert them back for local modifications. This allows for a workflow where data is switched between immutable and mutable versions to perform bulk edits before locking the state again.
The project provides capabilities for nested data transformation, including path-based updates, deep merging of objects, and querying values within deep hierarchies. It also supports array-to-object transformations, property removal via predicates, and the ability to detect whether a structure is immutable.
Features
- Immutability Converters - Transforms plain JavaScript objects and arrays into immutable data structures that block mutation.
- Immutable Data Management - Prevents accidental state changes by providing objects and arrays that cannot be modified after creation.
- Immutability Converters - Creates shallow or deep mutable copies of immutable structures to enable standard JavaScript modifications.
- Immutable Array Updates - Produces new immutable structures by setting values or applying transformer functions to nested paths.
- Path-Based Value Retrieval - Fetches a specific value from a nested path within an immutable structure with default value fallback.
- Nested Data Extractors - Retrieves values from deep nested paths within immutable structures, providing a default value if the path is missing.
- Recursive Structure Processors - Traverses and transforms nested JavaScript objects and arrays into immutable versions using recursive locking.
- Mutable Stores - Transforms immutable objects and arrays back into standard mutable structures for state updates.
- Immutable Data Libraries - Provides a comprehensive set of immutable objects and arrays compatible with standard JavaScript syntax.
- Mutation Blocking Mechanisms - Prevents object modifications by overriding prototypes with frozen states or write-blocking proxies.
- Immutable Data Structures - Creates objects and arrays that cannot be modified after creation to ensure total data consistency.
- Immutable State Utilities - Provides tools for managing application state through deep merging and path-based immutable updates.
- Nested Data Transformers - Provides utilities for recursively traversing and transforming nested dictionaries and lists without mutation.
- Path-Based Tree Traversers - Implements algorithms for navigating and updating deep tree structures using specific access paths.
- Path-Based Nested Updates - Provides utilities for updating specific values within deeply nested objects using key paths.
- Predicate-Based Element Filtering - Allows removing elements from immutable collections based on a boolean predicate function.
- Immutability Wrappers - Wraps standard JavaScript collections to block direct modifications and ensure data consistency.
- Immutable Mutation Batching - Optimizes immutable updates by applying multiple changes to a temporary mutable copy before re-freezing.
- Map Key Removals - Excludes specific keys or elements from immutable objects or arrays based on a provided predicate.
- Object Property Omission - Creates new immutable objects by excluding specific keys or elements that match a predicate.
- State Consistency Patterns - Implements patterns to ensure predictable application state by enforcing immutable data structures.
- Immutable Value Transformers - Allows applying transformer functions to properties to calculate new values while maintaining immutability.
- Object Merging - Combines multiple objects into a single immutable structure with support for deep merge configurations.
- Immutable Object Merging - Provides logic to combine multiple data sources into a new frozen object without mutating original inputs.
