rtfeldman/seamless-immutableArchived
Seamless Immutable
Dies ist eine JavaScript-Bibliothek für unveränderliche (immutable) Daten, die verwendet wird, um Objekte und Arrays zu erstellen, die direkte Mutationen verhindern. Sie dient als Immutable-State-Manager und Objekt-Wrapper, der darauf ausgelegt ist, Datenkonsistenz durch Blockierung von Modifikationen zu gewährleisten, während die Kompatibilität mit der Standard-JavaScript-Syntax erhalten bleibt.
Die Bibliothek fungiert als Konverter, der standardmäßige veränderbare Daten in eingefrorene Strukturen transformiert und diese für lokale Modifikationen wieder zurückkonvertieren kann. Dies ermöglicht einen Workflow, bei dem Daten zwischen unveränderlichen und veränderbaren Versionen gewechselt werden, um Massenbearbeitungen durchzuführen, bevor der Zustand wieder gesperrt wird.
Das Projekt bietet Funktionen für die Transformation verschachtelter Daten, einschließlich pfadbasierter Updates, Deep-Merging von Objekten und Abfragen von Werten innerhalb tiefer Hierarchien. Zudem unterstützt es Array-zu-Objekt-Transformationen, das Entfernen von Eigenschaften mittels Prädikaten sowie die Fähigkeit zu erkennen, ob eine Struktur unveränderlich ist.
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.
