core library

Core cloning API and contracts for the Cloner library.

This library provides the primary entry point for cloning operations:

Cloner: Static API with convenience methods and global reference management
ICloneable: Interface for types that support deep cloning
ICopyable: Interface for types that support shallow copying
UnsupportedTypedCloneException: Thrown when typed cloning fails
CircularReferenceCloneException: Thrown when circular references are detected
LimitExceededException: Thrown when a cloning operation exceeds a predefined resource or recursion limit

Difference from base.dart:

For most applications, import this library:

import 'package:cloner/core.dart';

final cloned = Cloner.instance().cloneValue(original);

To customize cloning behavior, see base.dart for implementing ICloning.

Classes

Provides access to the global cloning implementation.

ICloneable<T extends Object>

Contracts used by Cloner and collection helpers.

ICopyable<T extends Object>

Use for a shallow, element-wise copy.

Provides a contract for objects that can be restored to their initial state.

Contract for serializing an object O to data D.

Exceptions / Errors

Base exception for errors encountered during cloning operations.

Base class for serialization-related exceptions.

Thrown when a circular reference is detected during cloning.

Exception thrown on deserialization failure.

Exception thrown when the format of the data is invalid during deserialization.

Exception thrown when a deserialized value is of an unexpected type.

Thrown when some limit is exceeded.

Exception thrown on serialization failure.

Thrown when typed cloning encounters an unsupported nested structure.

Classes