docs(guide): named columns vs structured references (SU-637)

[AMBudnik]

https://app.clickup.com/t/9015210959/SU-637

Goal: Improve docs-assistant answer depth on HyperFormula named ranges / structured references
Change: Named-columns section: no Excel structured refs, why SUM(Name1:Name5) fails, $A:$A workaround.

Context

Adds the missing named-column recipe to the named-expressions guide so docs-assistant can retrieve it. Cross-links the existing range-restraint on cell-references.

How did you test your changes?

Read-through against naming rules (Name1 is A1) and range restraints (: cannot take named endpoints). Docs-only; no engine change.

Types of changes

• Change to the documentation

Related issues:

1. https://app.clickup.com/t/9015210959/SU-637

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.

Docs-only; no CHANGELOG

Made with Cursor and Ola :)

[cloudflare-workers-and-pages]

Deploying with    Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

Status	Name	Latest Commit	Preview URL	Updated (UTC)
✅ Deployment successful! View logs	hyperformula-docs	a1be6b1	Commit Preview URL Branch Preview URL	Aug 31 2026, 11:11 AM

[cursor]

Cursor Bugbot has reviewed your changes using default effort and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

Want higher recall? High effort reviews run extra passes and find more bugs. A team admin can switch effort levels in the Cursor dashboard.

^{Reviewed by Cursor Bugbot for commit 45325a3. Configure here.}

[github-actions]

Performance comparison of head (a1be6b1) vs base (114fd5d)

                                     testName |    base |   head | change
-------------------------------------------------------------------------
                                      Sheet A |  518.77 |  506.7 | -2.33%
                                      Sheet B |  169.82 |  169.1 | -0.42%
                                      Sheet T |  145.08 | 143.66 | -0.98%
                                Column ranges |  537.75 | 537.04 | -0.13%
                                Sorted lookup | 15419.6 |  15538 | +0.77%
Sheet A:  change value, add/remove row/column |   18.94 |  18.72 | -1.16%
 Sheet B: change value, add/remove row/column |  159.68 | 162.19 | +1.57%
                   Column ranges - add column |  170.41 | 172.77 | +1.38%
                Column ranges - without batch |  526.13 | 536.57 | +1.98%
                        Column ranges - batch |  128.93 | 137.62 | +6.74%

[sequba]

@cursor fix it

[cursor]

Done. Restructured the "Named columns" section:

1. Solution first — Shows how to use addNamedExpression('ColSales', '=Sheet1!$A:$A') with implementation details
2. Misconception second — New subsection "Why SUM(Name1:Name5) does not work" explaining the illegal name and range operator issues

Changes committed and pushed to the branch.

  

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 97.32%. Comparing base (114fd5d) to head (a1be6b1).

Additional details and impacted files

@@           Coverage Diff            @@
##           develop    #1753   +/-   ##
========================================
  Coverage    97.32%   97.32%           
========================================
  Files          195      195           
  Lines        15739    15739           
  Branches      3390     3390           
========================================
  Hits         15318    15318           
  Misses         421      421           

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.