Add DefinitionBindingMap.AsEnumerable extension

[AleksandrFomenko]

Summary of the Pull Request

What is this about:

Adds an extension to enumerate project parameter bindings with LINQ.

Description:

DefinitionBindingMap.AsEnumerable() iterates the map and yields (Definition, ElementBinding) pairs, so callers can query bindings with standard LINQ instead of working with ForwardIterator() directly.

Readme and Changelog updated accordingly.

Quality Checklist

• My code follows the style guidelines of this project
• I have performed a self-review of my own code
• I have made corresponding changes to the documentation
• My changes generate no new warnings

[AleksandrFomenko]

😺

[Nice3point]

1. ParameterBindingKind enum Revit already models this distinction through InstanceBinding and TypeBinding types. Introducing a custom [Flags] enum duplicates that concept and disconnects users from the Revit type system they already know. The library's rule is wrap Revit, don't reimplement it. I'd prefer we stay closer to what Revit already provides here.
2. Sorting result.Sort() is an opinionated choice that isn't coming from the API. Some callers want alphabetical order, others want insertion order for predictable diffs, others don't care and just pay the sort cost for nothing. The library adds ergonomics, not behavior. let the caller decide.
3. Returning string instead of Definition Stripping down to names means any caller who actually needs the definition or binding has to iterate a second time

[Nice3point]

Better to add a custom enumeration and thats it.

    extension(DefinitionBindingMap map)
    {
        [Pure]
        public IEnumerable<(Definition Definition, ElementBinding Binding)> AsEnumerable()
        {
            var iterator = map.ForwardIterator();
            while (iterator.MoveNext())
            {
                if (iterator is { Key: { } definition, Current: ElementBinding binding })
                {
                    yield return (definition, binding);
                }
            }
        }
    }

Usage:

            foreach (var (definition, binding) in document.ParameterBindings.AsEnumerable())
            {
                
            }

[Copilot]

Pull request overview

This PR introduces a new DefinitionBindingMap extension to make iterating Revit project-parameter bindings easier (as (Definition, ElementBinding) pairs), and documents it in the README and CHANGELOG.

Changes:

• Add DefinitionBindingMapExtensions.AsEnumerable() to iterate bindings as tuple pairs for LINQ-friendly querying.
• Document the new enumeration pattern in README.md.
• Add a CHANGELOG entry for the new extension.

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 3 comments.

File	Description
source/Nice3point.Revit.Extensions/DefinitionBindingMapExtensions.cs	Adds AsEnumerable() for iterating DefinitionBindingMap bindings as (Definition, ElementBinding) tuples.
README.md	Adds a “Project parameters” section showing how to query document.ParameterBindings.AsEnumerable() with LINQ.
CHANGELOG.md	Records the new map.AsEnumerable() extension under 2027.0.3.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.