Define permuteddims as a generalization for PermutedDimsArray

[mtfishman]

The motivation is BlockSparseArrays.jl, where a lazily permuted block sparse array is represented as a lazily permuted array of lazily permuted arrays. At either level, this would allow outputting a lazily permuted array that isn't necessarily a PermutedDimsArray. This is analogous to adjoint/Adjoint and transpose/Transpose.

I'm defining it here since it is a core function that I want to use across various packages, like BlockSparseArrays.jl and KroneckerArrays.jl.

See JuliaLang/julia#53188.

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 73.95%. Comparing base (41f2ca2) to head (6381990).
⚠️ Report is 1 commits behind head on main.

Additional details and impacted files

@@            Coverage Diff             @@
##             main      #46      +/-   ##
==========================================
+ Coverage   73.82%   73.95%   +0.13%     
==========================================
  Files          10       12       +2     
  Lines         382      384       +2     
==========================================
+ Hits          282      284       +2     
  Misses        100      100              

Flag	Coverage Δ
docs	26.96% <0.00%> (-46.86%)	⬇️

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.