feat: Implement new config param, allowCircularReferences

[mountEvarus]

Context

Implementing the handling of circular dependencies/references with a flag.

How did you test your changes?

I have created a test file with several scenarios, and matched the results to what should happen in 100 cycles.

Types of changes

• Breaking change (a fix or a feature because of which an existing functionality doesn't work as expected anymore)
• New feature or improvement (a non-breaking change that adds functionality)
• Bug fix (a non-breaking change that fixes an issue)
• Additional language file, or a change to an existing language file (translations)
• Change to the documentation

Checklist:

• I have reviewed the guidelines about Contributing to HyperFormula and I confirm that my code follows the code style of this project.
• I have signed the Contributor License Agreement.
• My change is compliant with the OpenDocument standard.
• My change is compatible with Microsoft Excel.
• My change is compatible with Google Sheets.
• I described my changes in the CHANGELOG.md file.
• My changes require a documentation update.
• My changes require a migration guide.

[Copilot]

Pull Request Overview

This PR implements a new configuration parameter allowCircularReferences that enables handling of circular dependencies in formulas with iterative computation instead of throwing CYCLE errors. When enabled, the system performs up to 100 iterations to resolve circular references to stable values.

Key changes:

• Adds allowCircularReferences boolean configuration parameter with proper validation
• Implements iterative circular dependency resolution algorithm in the Evaluator
• Adds comprehensive test coverage for various circular reference scenarios

Reviewed Changes

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

File	Description
src/ConfigParams.ts	Adds allowCircularReferences parameter interface definition
src/Config.ts	Implements configuration parameter with validation and default value
src/Evaluator.ts	Adds circular dependency resolution logic with 100-iteration limit
test/circular-dependencies.spec.ts	Comprehensive test suite covering circular reference scenarios

---

_{Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.}

[AMBudnik]

Thank you for sharing the pull request and signing our CLA.

P.S. You have an impressive GitHub activity!

[sequba]

@mountEvarus, thank you for a solid implementation and many good-quality unit tests. It's almost ready to merge, but there are a few details that need to be tweaked.

[sequba]

Suggested change

	allowCircularReferences: boolean,
	enableIterativeCalculation: boolean,

I'd rename this option to make it similar to the analogues feature in other spreadsheet software.

[sequba]

This should be configurable. I'd introduce a new flag iterativeCalculationLimit

[sequba]

This loop should stop early if the cycle diverges, similarly to the analogues feature in Google Sheets.

I'd introduce a new flag iterativeCalculationThreshold.

[sequba]

I'll merge this into a local branch to make some changes. Then it will go to develop and be released.

@mountEvarus thank you for your contribution