feat(functions): Add mergeDocuments, cloneDocument, copyToDocument, moveToDocument

[donmccurdy]

Changes:

• BREAKING CHANGE: Removes Document#merge and Document#clone methods
• Adds mergeDocuments(target, source)
• Adds cloneDocument(source)
• Adds copyToDocument(target, source, sourceProperties)
• Adds moveToDocument(target, source, sourceProperties)

Example:

import { copyToDocument } from '@gltf-transform/functions';

// Copy materials from sourceDocument to targetDocument.
const map = copyToDocument(
  targetDocument,
  sourceDocument,
  [sourceMaterialA, sourceMaterialB]
);

// Find counterpart of sourceMaterialA in targetDocument.
const targetMaterialA = map.get(sourceMaterialA);

Related:

• Fixes #924
• Fixes #1363
• Fixes #1367

[elalish]

Excellent, thank you! I look forward to using these.

[marwie]

Oh great, thanks a lot!