cloner 1.0.1

cloner: ^1.0.1 copied to clipboard

Added #

• New CountedCloner and HashedCloner implementations:
  • CountedCloner enforces recursion depth and total clone count limits to prevent stack overflows and runaway cloning.
  • HashedCloner provides circular reference detection for collections, throwing CircularReferenceCloneException on cycles.
• LimitExceededException for reporting exceeded size/nesting limits during cloning.
• Benchmarks and performance recommendations for different cloner implementations (see doc/benchmarks)

Changed #

• Cloner now uses CountedCloner as the default global cloner instead of BaseCloner
• ICloning.replicate signature simplified: removed doCircRefCheck parameter (circular reference detection is now handled by HashedCloner)
• Collection extension methods (clone, cloneDynamic) no longer accept doCircRefCheck parameter
• Improved documentation and README with new "Benchmarks" and "Worth Noting" sections

Fixed #

• Improved test coverage for circular reference and limit enforcement scenarios

Initial version #

• ICloneable and ICopyable contracts for custom deep/shallow copy support
• Cloner facade with pluggable backend
• BaseCloner default implementation and ICloning interface for custom cloners
  • Element/value-wise deep cloning for List, Set, and Map
  • Optional circular-reference detection
• Collection extensions: List.clone() / Set.clone() / Map.clone()
• MapClone typed map wrapper for safe nested typed map cloning and copy()/clone() helpers
• Typed-clone safety checks and UnsupportedTypedCloneException for unsupported typed scenarios
• Preserves common concrete collection implementations (LinkedHashMap, HashMap) where possible