This closes #2303, support 3D references across sheet ranges

[krystophny]

Description

Formulas of the shape SUM(Sheet1:SheetN!A1) previously failed with #NAME? invalid reference because parseReference split the reference on : and handed the leading sheet token to parseRef, which treats it as a cell name.

This change teaches parseReference to recognise references of the shape <sheet1>:<sheet2>!<ref>, expand them across the workbook-order sheet range, and evaluate each sheet's cell or range recursively. The resulting matrix is consumed unchanged by the existing aggregates (SUM, AVERAGE, MIN, MAX, COUNT, COUNTA, PRODUCT). Non-ASCII unquoted sheet names work too, e.g. SUM(Jänner:Dezember!$M$40).

The quoted-name form SUM('A':'B'!ref) is mis-tokenised by github.com/xuri/efp upstream of parseReference and is therefore out of scope here; it is tracked separately in #2309.

Related Issue

Partial closer for umbrella #2303; the quoted-form gap is tracked in #2309.

Documentation

Reference-site entries for this PR ship in a companion docs PR: xuri/excelize-doc#31. That PR covers the English version; other language versions follow the project's usual rollout cadence.

Motivation and Context

Workbooks with 3D aggregate totals (e.g. annual summaries across monthly sheets) currently cannot be recalculated through excelize — every such formula resolves to #NAME?. This is the narrowest fix that removes that failure without touching other code paths.

How Has This Been Tested

go test -skip TestZip64 -timeout 10m . passes cleanly. gofmt -s -l . and go vet ./... are clean. ARM cross-builds from .github/workflows/go.yml (GOARM=5|6|7, arm64, android/arm64) all build.

$ go test -run 'TestCalc3DRef$' -timeout 60s -v .
=== RUN   TestCalc3DRef
=== RUN   TestCalc3DRef/non-ascii_sheet_names
--- PASS: TestCalc3DRef (0.01s)
    --- PASS: TestCalc3DRef/non-ascii_sheet_names (0.00s)
PASS
ok  	github.com/xuri/excelize/v2	0.014s

TestCalc3DRef is table-driven and covers single-cell, range, degenerate single-sheet, multi-column, reversed range (#REF!), and missing sheet cases across all seven aggregates listed above. The non-ASCII sub-test covers Jänner:Dezember.

Types of changes

• Docs change / refactoring / dependency upgrade
• Bug fix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)
• Breaking change (fix or feature that would cause existing functionality to change)

Checklist

• My code follows the code style of this project.
• My change requires a change to the documentation.
• I have updated the documentation accordingly (see companion docs PR Update en version docs for File.Recalc, RecalcCell, RecalcOptions, ErrCellNoFormula, and 3D range support xuri/excelize-doc#31).
• I have read the CONTRIBUTING document.
• I have added tests to cover my changes.
• All new and existing tests passed.

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 99.60%. Comparing base (7240c79) to head (8f0f428).

Additional details and impacted files

@@           Coverage Diff           @@
##           master    #2310   +/-   ##
=======================================
  Coverage   99.60%   99.60%           
=======================================
  Files          32       32           
  Lines       26803    26855   +52     
=======================================
+ Hits        26697    26749   +52     
  Misses         55       55           
  Partials       51       51           

Flag	Coverage Δ
unittests	99.60% <100.00%> (+<0.01%)	⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[xuri]

Thanks for your PR. Could you grant sloppy-org:2303-3d-refs-cleanbranch push permission for me? So I can made some code review updates based on your branch.

[krystophny]

@xuri I sent an invite to the fork repo, since this pr based write access doesnt work cross-orga . Cheers!

[xuri]

Thanks for your contribution.