base library

Base cloning implementation and interface for custom cloning strategies.

This library provides the foundational types for building cloning implementations:

BaseCloner: Default deep-cloning implementation for collections and ICloneable types
ICloning + IClonerBuilding: Interfaces for creating custom cloning strategies

Difference from core.dart:

core.dart exports the high-level Cloner API for everyday use
base.dart exports lower-level primitives for advanced customization

When to use base.dart:

Implementing a custom ICloning strategy (e.g., logging, metrics, special type handling)
Directly instantiating BaseCloner with specific options using builder pattern
Building frameworks or libraries that extend cloning behavior

Example: Custom cloning implementation

import 'package:cloner/base.dart';
import 'package:cloner/core.dart';

class LoggingCloner implements ICloning {
  final ICloning _delegate;

  LoggingCloner([ICloning? delegate]) : _delegate = delegate ?? const BaseCloner(true);

  @override
  dynamic cloneValue(dynamic source) {
    print('Cloning: ${source.runtimeType}');
    return _delegate.cloneValue(source);
  }

  // ... implement other ICloning methods
}

// Replace global cloner
Cloner.builder = LoggingCloner();

Classes

Mixins

cloner package

base library