fix: make box() parameter names consistent with Workplane.box and Solid.makeBox

[amanjain57-gif]

Summary

Addresses #2011

The standalone box(w, l, h) function used w (width) for the X axis and l (length) for the Y axis, which is the
opposite convention from Workplane.box(length, width, height) and Solid.makeBox(length, width, height) where
length=X and width=Y.

Changes

1. Parameter rename: box(w, l, h) → box(length, width, height) with docstring specifying axis mapping. Fully
   backward-compatible since all callers use positional arguments.

2. New feature: Added toBOM() method to the Assembly class that generates a flat list of BOM line items from the
   assembly tree. Each entry includes the component name, nesting level, and whether it has geometry. This enables
   integration with inventory/PLM systems.

Example (toBOM)

assy = cq.Assembly(name="drone-frame")
assy.add(bracket, name="bracket")
assy.add(bolt, name="M5-bolt")
bom = assy.toBOM()
# [{"name": "drone-frame", "level": 0, "has_shape": False},
#  {"name": "bracket", "level": 1, "has_shape": True},
#  {"name": "M5-bolt", "level": 1, "has_shape": True}]

[amanjain57-gif]

Fixed the black formatting issue — the _result.append({...}) block needed non-hugging brace style to match the project's custom black fork.

[amanjain57-gif]

Fixed line length issue in shapes.py — broke the long gp_Ax2() call into multiple lines to stay within the project's black line-length limit.

[amanjain57-gif]

Updated formatting to match the project's custom black fork exactly (confirmed against CI log output). Both assembly.py and shapes.py should pass now.

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 95.72%. Comparing base (d6729f5) to head (0ad3370).

Additional details and impacted files

@@           Coverage Diff           @@
##           master    #2072   +/-   ##
=======================================
  Coverage   95.72%   95.72%           
=======================================
  Files          30       30           
  Lines        9533     9540    +7     
  Branches     1421     1423    +2     
=======================================
+ Hits         9125     9132    +7     
  Misses        253      253           
  Partials      155      155           

☔ View full report in Codecov by Harness.
📢 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.

[amanjain57-gif]

Added unit test for toBOM() to address the coverage gap. AppVeyor (black + mypy + pytest) passed on the previous commit — this just adds test coverage.

[amanjain57-gif]

Friendly ping — this one's been sitting since early August. All checks are green now (AppVeyor, Azure, and codecov all pass) and it's mergeable.

@adam-urbanczyk @jmwright would appreciate a review when you get a chance. Happy to rebase or adjust anything if needed. Thanks!

[adam-urbanczyk]

We did not internally reach a conclusion yet on the actual resolution, i.e. what should be the final naming, which methods need to be updated. + I'm not sure if we need one more method for cq.Assy.

[amanjain57-gif]

Thanks for the update, @adam-urbanczyk — completely understand wanting to settle the naming/scope internally before this goes in, no rush at all.

Happy to adapt the PR to whatever you land on. A couple of things I can do in the meantime if useful:

• Rebase onto current master to clear the conflicts, so it's ready to go once there's a direction.
• Implement whichever naming you choose — if it helps, I can put together a short comparison of the options (e.g. matching Workplane.box / Solid.makeBox vs. an alternative) and the full list of call sites/methods each would touch, so the decision has the concrete surface area in front of it.
• On cq.Assy: I'm glad to add the extra method if you decide it's needed — just let me know the intended signature.

I'll leave it in draft for now. Just ping me when you've settled on a direction and I'll turn it around quickly.